Two actions are required, firstly to get the list of the available voices, depending on the chosen language, gender, voice type, and secondly for the text-to-speech itself.
0 : GET LIST OF VOICES
====================

ACTION DESCRIPTION
--------------------------------
 GET LIST OF VOICES returns the available voices in the specified region.

STEP-BY-STEP SETUP
--------------------------------
 0) Sign-up for MICROSOFT AZURE - COGNITIVES SERVICES by following this link: https://azure.microsoft.com/free/cognitive-services/

 1) Create a SPEECH SERVICE INSTANCE with a STANDARD PRICING TIER (S0) by following this link https://portal.azure.com/#create/Microsoft.CognitiveServicesSpeechServices

 2) In KEYS & REGION section of the created SPEECH INSTANCE, note the KEY, REGION and enter those in the PLUGIN SETTINGS.

 3) Set up a repeating group that will contain the results.

 4) Set up a DISPLAY LIST IN REPEATING GROUP action with the DATA SOURCE  "MICROSOFT AZURE - GET LIST OF VOICES" in the workflow set as GET DATA FROM AN EXTERNAL API.

     - REGION : Region on which the SPEECH SERVICE INSTANCE has been deployed.
   Output Fields :
     - BODY : Returns a list of voices with their properties, such as language code, gender, voice name.

 3) Set-up a visual element supporting a list to allow the user to select the required voice. Please refer to the demo for this specific implementation

1 : SYNTHESIZE SPEECH
====================

ACTION DESCRIPTION
--------------------------------
 SYNTHESIZE SPEECH from plain text, returning the audio file.

STEP-BY-STEP SETUP
--------------------------------
 1)  Set-up an audio player element supporting audio file as Dynamic Link, such as "Circle Music Player". Please refer to the demo for this specific implementation

 2)  Set up the Dynamic Link as GET DATA FROM AN EXTERNAL API set as  "MICROSOFT AZURE - SYNTHESIZE SPEECH (SYNC)"

   Inputs Fields :
     - REGION : Region on which the SPEECH SERVICE INSTANCE has been deployed.
     - X-MICROSOFT-OUTPUT-FORMAT : Each format incorporates a bit rate and encoding type. The Speech service supports 48-kHz, 24-kHz, 16-kHz, and 8-kHz audio outputs. Each prebuilt neural voice model is available at 24kHz and high-fidelity 48kHz. Full list available at : https://learn.microsoft.com/en-us/azure/cognitive-services/speech-service/rest-text-to-speech?tabs=streaming#audio-outputs
     - TEXT : Text to synthesize.
     - GENDER : Voice Gender as per the output of GET VOICES LIST action.
     - VOICE NAME : Voice ShortName as per the output of GET VOICES LIST action. Example : en-US-JennyNeural

   Output Fields :
     - FILE : Returns the audio file.

 2) Set-up an audio player element, such as "Circle Music Player", then set as input of this element the output of the previous action.
   Please refer to the demo for this specific implementation.


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

ADDITIONAL INFORMATION
======================
> Supported Regions : https://learn.microsoft.com/en-us/azure/cognitive-services/speech-service/regions#speech-service
> Supported Languages & Voice Support :  https://learn.microsoft.com/en-us/azure/cognitive-services/speech-service/language-support?tabs=tts#supported-languages

> MICROSOFT AZURE TEXT-TO-SPEECH service limits : https://learn.microsoft.com/en-us/azure/cognitive-services/speech-service/speech-services-quotas-and-limits#text-to-speech-quotas-and-limits-per-resource

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
===========================

GENERAL
-------------
 N/A

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