legacy:text-to-speech_guide:tts_http_protocol:start

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision		 Previous revision
text-to-speech_guide:tts_http_protocol:start [2015/03/03 20:56] – borjalegacy: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:start|Home]] >+[[vxi_installation_guide:start|Home]] >
  
 ===== 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 with the TTS engine treats your request. 
-  * The VoiceXML browser receives an audio file (cpataible with Asterisk) : it store its in cache and play it. +  * The VoiceXML browser receives an audio file (compatible with the Asterisk audio formats) : it stores the file in cache and plays it. 
-  * 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 after, the VoiceXML will check and use the cache content instead of requesting the TTS engine.
  
  
Line 22: Line 22:
  
   * **method** : When you set the 'method' with POST or GET the HTTP/TTS protocol is used to process <prompt> text contents. If you set the value ASTERISK, the VoiceXML browser will send the content to the Asterisk module (as a text/UTF8 or XML/UTF8 content).   * **method** : When you set the 'method' with POST or GET the HTTP/TTS protocol is used to process <prompt> text contents. If you set the value ASTERISK, the VoiceXML browser will send the content to the Asterisk module (as a text/UTF8 or XML/UTF8 content).
-  * **urivideo** : same as uri but when you sent the xml:language="video". 
   * **uri** : You need to set the 'uri' for the TTS (or TextToVideo) service (our scripts install the services in http://ip/tts/provider/tts.php).   * **uri** : You need to set the 'uri' for the TTS (or TextToVideo) service (our scripts install the services in http://ip/tts/provider/tts.php).
 +  * **urivideo** : same as uri but when you sent the xml:language="video".
   * **format** : Configure the audio file 'format' used, all the scripts not support all the format. Have a look on the install documentation to check and set the correct format.   * **format** : Configure the audio file 'format' used, all the scripts not support all the format. Have a look on the install documentation to check and set the correct format.
   * **formatvideo** : same as format but when you sent the xml:language="video".   * **formatvideo** : same as format but when you sent the xml:language="video".
   * **maxage** : The parameter 'maxage' force to refresh the cache after sometime. The value 0, disable the caching, the HTTP request will be use for each prompt. The value -1 define infinite age. If the file exist in the cache, it will be always used from the cache directly.   * **maxage** : The parameter 'maxage' force to refresh the cache after sometime. The value 0, disable the caching, the HTTP request will be use for each prompt. The value -1 define infinite age. If the file exist in the cache, it will be always used from the cache directly.
 +  * **checkBreak** : Allows to parse the prompt content (in SSML) an search for the <break> tag. The <break> tags are processed by the VoiceXML browser to make pauses in the prompt.
   * **cutPrompt** : The option 'cutPrompt', allows to slice the prompt in order to mutualize the maximal contents (cuts in '.', ',', ':' ...).   * **cutPrompt** : The option 'cutPrompt', allows to slice the prompt in order to mutualize the maximal contents (cuts in '.', ',', ':' ...).
   * **ssml** : The option 'ssml' for to send the text as a SSML/XML well formated content (with <?xml> and <ssml> roots tags).    * **ssml** : The option 'ssml' for to send the text as a SSML/XML well formated content (with <?xml> and <ssml> roots tags). 
Line 51: Line 52:
 #client.prompt.resource.0.password           VXIString   demo #client.prompt.resource.0.password           VXIString   demo
 client.prompt.resource.0.ssml               VXIInteger  0 client.prompt.resource.0.ssml               VXIInteger  0
 +</code>
 +
 +Most of this parameters can be change from the VoiceXML syntax using properties. Use the property name 'prompt' added with the parameter name.
 +
 +VoiceXML example :
 +
 +<code>
 +<property name="promptvoice" value="Poala"/>
 </code> </code>
 ===== HTTP Parameters ==== ===== HTTP Parameters ====
Line 57: 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 (3th parameter ex: "it-IT-Paola").
   * **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.
  • legacy/text-to-speech_guide/tts_http_protocol/start.1425416165.txt.gz
  • Last modified: 2017/07/28 22:29
  • (external edit)