For ONVIF TTS audio proposal, to support device with TTS function #694

Peggy0422 · 2025-12-03T10:54:56Z

To support audio product with TTS function, several operation should be done:

Added TTSCapabilities(Optional): indicate whether the device is capable of TTS function and its corresponding TTS configuration. So add complex type "TTSCapabilities" to the existing complex type "AudioClipCapabilities".
Parameter:

MaxContentLength: indicates the max length of content of a text for device to convert to an audio clip;
TTSLanguage: indicates what language(s) the device supports for TTS function.
TTSVoiceType: indicates voice types that device supports for TTS function.

Add “AddTTSAudioClip”and "AddTTSAudioClipResponse": to send a text, TTS configuration and audio clip configuration to device, device could convert the text to an audio clip based on TTS Configuration. Subsequently, the device will play this audio clip based on configuration.
Parameter:

Token(Optional): token for the audio clip.
Configuration: audio clip configuration to add, see element "Configuration" .
TTSConfiguration: for TTS audio clip, it specifies the audio content, language and voice type when device play this audio clip.
Reponse:
Token: unique token of the TTS audio clip to be uploaded.

media2.wsdl

Updated complexType "AudioClipCapabilities" with element "TTSCapabilities"; added complexType "TTSCapabilities" with attributes "MaxContentLength", "TTSLanguage" and "TTSVoiceType"; added simpleType "TTSLanguage" and "TTSVoiceType".
Added elements "AddTTSAudioClip" and "AddTTSAudioClipResponse" for sending a text, TTS configuration and audio clip configuration to the device.
Added complexType "TTSAudio" for element "TTSConfiguration". It includes parameters such as Content, Language, VoiceType.
Added "AddTTSAudioClipRequest" and "AddTTSAudioClipResponse"

media2.xml and documentation

Added detail descriptions for AddTTSAudioClip operations, explaining their purpose, parameters, and responses.
Updated audio clip capabilities with TTSCapabilities.

1. Added AddTTSAudioClip request and AddTTSAudioClip response for sending a text and its TTS configuration to the device（1621-1652）（2036-2041）（2418-2422）（2935-2943）. 2. Added complex types "TTS Audio" （1465-1485）for TTSConfiguration to support TTS function. It includes parameters Content, Language, VoiceType. 3. updated AudioClipCapabilities with TTSCapabilities（177-181）, and added complex types for TTSCapabilities（201-220）to indicate the device supports TTS function and its corresponding configuration. complex types TTSCapabilities includes MaxContentLength, TTSLanguage and TTSVoiceType. 4. Added simpleType TTSLanguage（220-231） and TTSVoiceType（232-238）.

1. Added detailed descriptions for AddTTSAudioClip operations, explaining their purpose, parameters, and responses.（2359-2416） 2. updated audio clip Capabilities with TTSCapabilities.（2698-2700）

update code line information for TTS function

correct some editorial errors

Updated the description of the AddTTSAudioClip operation to clarify the parameters and response. Updated the description of TTScapabilities.

TTS audio clip pull request was firstly created as number 668

Updated TTS configuration description and added TTSCapabilities entry.

sujithhanwha · 2025-12-04T12:34:32Z

OLD PR for reference
#668

venki5685 · 2025-12-09T07:14:24Z

doc/Media2.xml

+          </varlistentry>
+        </variablelist>
+        <para></para>
+        <para><emphasis role="bold">Note:</emphasis> Audio clip uploads to the device can fail in the following scenarios, and a specific HTTP error code should be returned to the client when an upload fails.</para>


this note seems not applicable for TTSAudioClip

Yes, it is not for TTS, I will delete it.

delete inappropriate note for OPTION AddTTSAudioClip

johado

Some small textual comments.

johado · 2025-12-16T11:24:51Z

doc/Media2.xml

+        <title>AddTTSAudioClip</title>
+        <para>This operation adds a text, audio clip configuration and TTS configuration to the device, for device converting the text to an audio clip based on the TTS configuration. 
+			The response to the command includes a unique token for this converted audio clip. 
+			If the device is unable to support language specified in the TTS configuration, the associated configuration will deleted from the device.</para>


add "be" to "will be deleted"

Okay, got it.

johado · 2025-12-16T11:25:39Z

doc/Media2.xml

+            <term>response</term>
+            <listitem>
+              <para role="param">Token - [tt:ReferenceToken]</para>
+              <para role="text">Unique token of the TTS audio clip to be uploaded.</para>             


Change "to be uploaded" to "that was added" ?

johado · 2025-12-16T11:26:51Z

doc/Media2.xml

+        </varlistentry>
+		<varlistentry>
+          <term>TTSCapabilities</term>
+          <listitem><para>Indicates device supports TTS function and TTS configuration.See tr2: TTSCapabilities.</para></listitem>


Add space after .: "..configuration. See tr2:..."

Okay, thank you.

johado · 2025-12-16T11:32:09Z

wsdl/ver20/media/wsdl/media.wsdl

+                 </xs:element>
+                 <xs:element name="Language" type="xs:string">
+                     <xs:annotation>
+                         <xs:documentation>Language for the TTS audio clip playback. See tr2: TTSLanguage. </xs:documentation>


Change to "See tr2:TTSLanguage and TTSCapabilities." ?

Thank you for your option. TTSLanguage is an attribute within TTSCapability already. If we want to point out that the language for TTS audio clip playback must be one of the languages that supported by the device, we could consider revise the explanation to clearly indicate this, such as: "The language which is supported and used for TTS audio clip playback. "

johado · 2025-12-16T11:32:50Z

wsdl/ver20/media/wsdl/media.wsdl

+                 </xs:element>
+                 <xs:element name="VoiceType" type="xs:string">
+                     <xs:annotation>
+                         <xs:documentation>The voice type for the TTS audio clip playback. See tr2: TTSVoiceType.</xs:documentation>


Change to "See tr2:TTSVoiceType and TTSCapabilities." ?

I propose to update the explanation for TTSVoiceType, just like commit for TTSLanguage

robberos · 2025-12-16T12:04:07Z

wsdl/ver20/media/wsdl/media.wsdl

+					<xs:sequence>
+						<xs:element name="Token" type="tt:ReferenceToken">						
+							<xs:annotation>
+								<xs:documentation>Unique token of the TTS audio clip to be uploaded.</xs:documentation>


change "to be uploaded" to something more relevant. converted, generated, ..?

robberos · 2025-12-16T13:02:51Z

wsdl/ver20/media/wsdl/media.wsdl

+                <xs:anyAttribute processContents="lax"/>
+            </xs:complexType>
+            <!--===============TTS Language================-->
+            <xs:simpleType name="TTSLanguage">


What is reasoning behind decision of languages in below list?

Is there any standard for offical language names that can be refered to?

TTSCapabilities and TTSAudio uses open strings, so enum should provide a good pattern.

https://en.wikipedia.org/wiki/List_of_ISO_639_language_codes ?

robberos · 2025-12-16T15:24:43Z

doc/Media2.xml

        </itemizedlist>              
-      </section>    
+      </section>  
+	  <section xml:id="section_wvd_dzg_rye">


id should be unique in xml, right? seems as it is a copy of SetAudioClip section below

Yes, thank you for the suggestion. I have revised it accordingly.

update description for TTSLanguage and TTSVoiceType

Peggy0422 added 9 commits November 10, 2025 10:50

Update Media2.xml

d2607c7

1. Added detailed descriptions for AddTTSAudioClip operations, explaining their purpose, parameters, and responses.（2359-2416） 2. updated audio clip Capabilities with TTSCapabilities.（2698-2700）

Update media.wsdl

043366e

update code line information for TTS function

Update media.wsdl

43f83bf

correct some editorial errors

Merge branch 'onvif:video/TTS-audio-clip' into video/TTS-audio-clip

46b11bb

Update Media2.xml

ea5b5dd

Updated the description of the AddTTSAudioClip operation to clarify the parameters and response. Updated the description of TTScapabilities.

Merge pull request #692 from Peggy0422/video/TTS-audio-clip

823e174

TTS audio clip pull request was firstly created as number 668

Revise TTS configuration text and add capabilities entry

65f8b9c

Updated TTS configuration description and added TTSCapabilities entry.

Update documentation for TTS attributes and elements

7b61dc7

ocampana-videotec mentioned this pull request Dec 4, 2025

For ONVIF TTS audio proposal, to support device with TTS function #692

Merged

ocampana-videotec added the WG_enh label Dec 4, 2025

ocampana-videotec mentioned this pull request Dec 4, 2025

video/tts audio clip #668

Closed

ocampana-videotec added 26.06 IPR needed labels Dec 4, 2025

ocampana-videotec added this to the 26.06 milestone Dec 4, 2025

venki5685 reviewed Dec 9, 2025

View reviewed changes

Update Media2.xml

e4703a2

delete inappropriate note for OPTION AddTTSAudioClip

johado reviewed Dec 16, 2025

View reviewed changes

robberos reviewed Dec 16, 2025

View reviewed changes

Peggy0422 added 3 commits January 5, 2026 10:29

Fix typos in Media2.xml documentation

61ff3ab

Rename section from 'section_wvd_dzg_rye' to 'section_AddTTSAudioClip'

a9f7585

Update media.wsdl

baa4502

update description for TTSLanguage and TTSVoiceType

For ONVIF TTS audio proposal, to support device with TTS function #694

Are you sure you want to change the base?

For ONVIF TTS audio proposal, to support device with TTS function #694

Conversation

Peggy0422 commented Dec 3, 2025

Uh oh!

sujithhanwha commented Dec 4, 2025

Uh oh!

venki5685 Dec 9, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

johado left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

robberos Dec 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

robberos Dec 16, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

venki5685 Dec 9, 2025 •

edited

Loading

robberos Dec 16, 2025 •

edited

Loading

robberos Dec 16, 2025 •

edited

Loading