diff --git a/doc/Media2.xml b/doc/Media2.xml index 717edabb6..602f62098 100644 --- a/doc/Media2.xml +++ b/doc/Media2.xml @@ -2355,7 +2355,65 @@ When the size of the audio clip upload exceeds the MaxAudioClipSize parameter in KB, the device should return an HTTP 413, Request Entity Too Large error to the client. - + +
+ AddTTSAudioClip + 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. + + + request + + Token - optional[tt:ReferenceToken] + Optional token associated with the audio clip. + Configuration - + [tr2:AudioClip] + Audio clip configuration to add. + TTSConfiguration - + [tr2:TTSAudio] + TTS configuration to add. + + + + response + + Token - [tt:ReferenceToken] + Unique token of the TTS audio clip to be uploaded. + + + + faults + + env:Receiver - ter:Action - ter:MaxAudioClipLimit + The maximum number of audio clip configurations supported by the device has been reached. + env:Sender - ter:InvalidArgVal - ter:InvalidConfig + The configuration parameters are not possible to set. + env:Sender - ter:InvalidArgVal - ter:InvalidLanguage + The language is not supported. + + + + access class + + WRITE_SYSTEM + + + + + Note: 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. + + + When the upload URL has expired, the device should return an HTTP 410 error to the client. + + + When the format of the audio clip upload does not match the Type parameter in the audio clip configuration, the device should return an HTTP 415 Unsupported Media Type error to the client. + + + When the size of the audio clip upload exceeds the MaxAudioClipSize parameter in KB, the device should return an HTTP 413, Request Entity Too Large error to the client. + + +
SetAudioClip This operation modifies the existing audio clip configuration on the device. @@ -2754,6 +2812,10 @@ The following audio clip Capabilities are available: + + TTSCapabilities + Indicates device supports TTS function and TTS configuration. + MaxAudioClipLimit Indicates the maximum number of audio clips that can be uploaded to the device. diff --git a/wsdl/ver20/media/wsdl/media.wsdl b/wsdl/ver20/media/wsdl/media.wsdl index 8212b02c7..7d7334656 100644 --- a/wsdl/ver20/media/wsdl/media.wsdl +++ b/wsdl/ver20/media/wsdl/media.wsdl @@ -202,6 +202,13 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO + + + + Indicates device has TTS capability. + + + @@ -222,6 +229,50 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO + + + + + + + + Indicates the maximum length of content of a text for device to convert to an audio clip. + + + + + Indicates what language(s) the device supports for TTS function. + + + + + Indicates the voice type for TTS funciton. + + + + + + + + + + + + + + + + + + + + + + + + + + @@ -1445,8 +1496,30 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO - - + + + + + + Content of the audio clip. + + + + + Language for the audio clip content, it is the same as the language during playback. + + + + + The voice type of audio clip playback. + + + + + + + + @@ -1579,7 +1652,40 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO - + + + + + + + Optional token associated with the audio clip. + + + + + Audio clip configuration to add. + + + + + The configuration for the TTS audio clip to add. + + + + + + + + + + + Unique token of the TTS audio clip to be uploaded. + + + + + + @@ -2018,6 +2124,14 @@ IN NO EVENT WILL THE CORPORATION OR ITS MEMBERS OR THEIR AFFILIATES BE LIABLE FO + + + + + + + + @@ -2412,6 +2526,13 @@ image will be updated automatically and independent from calls to GetSnapshotUri + + + This operation sends a text and its configuartion to device that supports TTS function, so that device could convert the text into an audio clip and play it according to audio clip Configuration and TTS Configuration. + + + + This operation modifies the existing audio clip configuration on the device. @@ -2940,6 +3061,17 @@ image will be updated automatically and independent from calls to GetSnapshotUri + + + + + + + + + + +