DEEPGRAM - TEXT-TO-SPEECH STREAMING ELEMENT =============================================

ELEMENT DESCRIPTION
----------------------------------
 DEEPGRAM - TEXT-TO-SPEECH STREAMING provides ultra-realistic voice-generated audio streaming directly, enabling real-time text-to-speech use cases.

STEP-BY-STEP SETUP
--------------------------------
 0) Register on DEEPGRAM website and get your DEEPGRAM API KEY on https://console.deepgram.com/signup?jump=keys

 1) Register on plugins.wiseable.io. Create a new Credential which associates your BUBBLE APP URL and your DEEPGRAM API KEY.
   The registration service will generate your PUBLIC ACCESS KEY. This key serves as a secure proxy for your real API key. It allows your application to communicate with the service without exposing your real API key. Since this PUBLIC ACCESS KEY is explicitly tied to your registered BUBBLE APP URL, it can only be used from that domain, ensuring that even if the key is publicly visible, it remains safe and cannot be misused by unauthorized sources.

 2) In the Plugin Settings, enter your PUBLIC ACCESS KEY generated at the previous step.

 3) Add an element supporting input text.

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

 FIELDS :
 - DISPLAY AUDIO CONTROLS : Display or hide audio controls.
 - OUTPUT FORMAT : Output format of the generated audio. Must be one of the SUPPORTED FORMATS element state.

 5) Integrate the logic into your application using the following DEEPGRAM - TEXT-TO-SPEECH STREAMING states and actions:

 EVENTS :
 - ERROR : Event triggered when an error occurs.
 - END OF STREAM : Event triggered when Stream has finished to download.
 - AUDIO FILE UPLOADED : Event triggers when the Audio File has been successfully uploaded, triggered using SAVE AUDIO action.


 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 TEXT-TO-SPEECH STREAMING :
 - SUPPORTED FORMATS : List of audio formats supported by the browser.
 - ERROR : Error message upon Error event trigger.
 - PLAYER STATUS : Return the player status. Valid values are ready | playing | paused | stopped | ended
 - CURRENT PLAYER SEEK TIME : Return the current player seek time in seconds.
 - TOTAL DURATION : Return the total duration of the audio in seconds.
 - AUDIO FILE URL : Return the Audio File URL upon AUDIO FILE UPLOADED event.



 ELEMENT ACTIONS - TRIGGERED IN WORKFLOW:
   - PAUSE AUDIO : Pause the audio stream.
   - RESUME AUDIO : Resume the audio stream.
   - SEEK AUDIO : Seek to a specific time in the audio stream.
  Inputs Fields :
       - SEEK TIME : Seek to a specific time in the audio stream.
   - GENERATE SPEECH : Generate speech from input.
  Inputs Fields :
       - MODEL : The model name. See https://developers.deepgram.com/docs/tts-models
       - VOICE : The voice name. See https://developers.deepgram.com/docs/tts-models
       - LANGUAGE : The 2-letter code language. See https://developers.deepgram.com/docs/tts-models
       - INPUT : The text to speak.
       - TITLE : Title of the media.
       - ARTIST : Artist of the media.
       - ALBUM : Album of the media.
       - COVERT ART : Covert Art image of the media.
   - SAVE AUDIO FILE : Save the latest audio output.
the can_do_text_to_speech property.
       - FILE NAME : File Name, without extension, of the audio file to save.
       - PRIVATE : Set to yes to set this file to private. ATTACHED TO must be provided to specify the thing to attach this audio file to.
       - ATTACHED TO : Unique ID of the thing to attach the Audio File to.


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.