Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
text-to-speech_guide:tts_http_protocol:start [2015/03/03 20:54] – [Description] borja | legacy:text-to-speech_guide:tts_http_protocol:start [2017/07/31 16:17] (current) – ↷ Links adapted because of a move operation javier | ||
---|---|---|---|
Line 1: | Line 1: | ||
====== HTTP/TTS Protocol ====== | ====== HTTP/TTS Protocol ====== | ||
- | [[:vxi_installation_guide: | + | [[vxi_installation_guide: |
===== Description ===== | ===== Description ===== | ||
- | Our VoiceXML browser can connect to a TTS engine using HTTP. | + | The VoiceXML browser can connect to a TTS engine using HTTP. |
The HTTP protocol is used to transform the prompt text to an audio file. | The HTTP protocol is used to transform the prompt text to an audio file. | ||
The audio file can be store in a cache directory in order to optimize the TTS ressources using. | The audio file can be store in a cache directory in order to optimize the TTS ressources using. | ||
Line 12: | Line 12: | ||
This protocol is simple : | This protocol is simple : | ||
* From the VoiceXML browser, you configure to use HTTP, a (POST recommended) request containing mainly the text content and additional parameters (like language, voice...). | * From the VoiceXML browser, you configure to use HTTP, a (POST recommended) request containing mainly the text content and additional parameters (like language, voice...). | ||
- | * The server treats your request. | + | * The web server |
- | * The VoiceXML browser receives an audio file (cpataible | + | * The VoiceXML browser receives an audio file (compatible |
- | * If you try to use the same content, the VoiceXML will check and use the cache content instead of requesting the TTS engine. | + | * If you try to use the same content |
Line 21: | Line 21: | ||
The main TTS configuration is set in / | The main TTS configuration is set in / | ||
- | * **method** : When you set the **method** with POST or GET the HTTP/TTS protocol is used to process < | + | * **method** : When you set the 'method' |
- | * **uri** : You need to set the **uri** for the TTS (or TextToVideo) service (our scripts install the services in http:// | + | * **uri** : You need to set the 'uri' |
- | * **format** : Configure | + | * **urivideo** : same as uri but when you sent the xml: |
- | * **maxage** : The parameter | + | * **format** |
- | * **cutPrompt** : The option | + | * **formatvideo** : same as format but when you sent the xml: |
- | * **ssml** : The option | + | * **maxage** |
+ | * **checkBreak** : Allows to parse the prompt content (in SSML) an search for the < | ||
+ | * **cutPrompt** | ||
+ | * **ssml** : The option | ||
Line 49: | Line 52: | ||
# | # | ||
client.prompt.resource.0.ssml | client.prompt.resource.0.ssml | ||
+ | </ | ||
+ | |||
+ | Most of this parameters can be change from the VoiceXML syntax using properties. Use the property name ' | ||
+ | |||
+ | VoiceXML example : | ||
+ | |||
+ | < | ||
+ | < | ||
</ | </ | ||
===== HTTP Parameters ==== | ===== HTTP Parameters ==== | ||
Line 55: | Line 66: | ||
* **language** : the language used (en-GB, fr-FR...) : from the xml:lang attribut. | * **language** : the language used (en-GB, fr-FR...) : from the xml:lang attribut. | ||
* **format** : the audio format to return (wav, gsm, mp4... formats supported by Asterisk) : from the configuration. | * **format** : the audio format to return (wav, gsm, mp4... formats supported by Asterisk) : from the configuration. | ||
- | * **voice** : the voice (Carla, Marcos... depends on the TTS provider) : from the xml:lang attribut. | + | * **voice** : the voice (Carla, Marcos... depends on the TTS provider) : from the xml:lang attribut |
* **size*** : the size of the image : from the property promptsize. | * **size*** : the size of the image : from the property promptsize. | ||
* **backgroud*** : the image reference or color used for the background : from the property promptbackground. | * **backgroud*** : the image reference or color used for the background : from the property promptbackground. |