INSTANT TEXT-TO-SPEECH ======================

ELEMENT DESCRIPTION
----------------------------------
 INSTANT TEXT TO SPEECH allows to access to in-browser capabilities to perform Instant Text-To-Speech.

 With speech synthesis in the browser, you can leverage speech interaction with your app's users, specifying language, pitch and volume.
The text to read may be plain or in SSML format.

STEP-BY-STEP SETUP
--------------------------------
 1) Add an element supporting input text.

 2) Add the INSTANT TEXT-TO-SPEECH to the page on which Text-to-Speech must be performed and configure its properties.

 FIELDS :
 - VOICE : Voice name used to read the text. The voice name is selected from the VOICES exposed state of the element.
 - VOLUME : A float that represents the volume value, between 0 (lowest) and 1 (highest.) If not set, the default value 1 will be used.
 - RATE : A float representing the rate value. It can range between 0.1 (lowest) and 10 (highest), with 1 being the default rate for the current platform or voice, which should correspond to a normal speaking rate. Other values act as a percentage relative to this, so for example 2 is twice as fast, 0.5 is half as fast, etc. If unset, a default value of 1 will be used.
 - PITCH : A float representing the pitch value. It can range between 0 (lowest) and 2 (highest), with 1 being the default pitch for the current platform or voice. If unset, a default value of 1 will be used.


 3) Integrate the logic into your application using the following INSTANT TEXT-TO-SPEECH, states and actions:

 EVENTS :
 - ERROR : Event triggered when an error occurs.

 EXPOSED STATES:
 Use any element able to show/process the data of interest (such as a Group with a Text field) stored within the result of the following states of the INSTANT TEXT TO SPEECH :
 - VOICES : List of Voice names concatenated with its ISO 639-1 Language Code.
 - SPEAKING ? : Boolean returning yes if the speech synthesis is in progress, otherwise no.
 - PAUSED ? : Boolean returning yes if the speech synthesis is paused, otherwise no.
 - ERROR : Error message upon Error event trigger

 ELEMENT ACTIONS - TRIGGERED IN WORKFLOW:
   - START TEXT TO SPEECH : Start Text-to-Speech utterance.
   - START TEXT TO SPEECH : Pause Text-to-Speech utterance.
  Inputs Fields :
    - TEXT : The text may be provided as plain text, or a well-formed SSML document. The SSML tags will be stripped away by devices that don't support SSML. A string representing the text to the synthesized. The maximum length of the text that can be spoken in each utterance is 32,767 character.
   - RESUME TEXT TO SPEECH : Resume Text-to-Speech utterance.


IMPLEMENTATION EXAMPLE
======================
Feel free to browse the app editor in the Service URL for an implementation example.

TROUBLESHOOTING
================
Any plugin related error will be posted to the the Logs tab, "Server logs" section of your App Editor.
 Make sure that "Plugin server side output" and "Plugin server side output" is selected in "Show Advanced".

> Server Logs Details: https://manual.bubble.io/core-resources/bubbles-interface/logs-tab#server-logs

PERFORMANCE CONSIDERATIONS
===========================
 N/A

QUESTIONS ?
===========
Contact us at [email protected] for any additional feature you would require or support question.