Documentation

Support

Vivox Core SDK

Vivox Core SDK

Text-to-speech destinations

Choose destinations for text-to-speech output.
Read time 1 minuteLast updated 20 hours ago
Text-to-speech (TTS) messages are injected to destinations. Destinations determine two factors: output and mechanism.
  • Output is where the synthesized speech plays to and decides who hears the TTS message. Each destination uses one of the following outputs:
    • Local Playback - Messages injected here play back locally on the user’s default render device (for example, loudspeakers or headphones).
    • Remote Transmission - Messages injected here are sent to remote participants in connected sessions according to transmission policies (the same sessions that basic voice transmits to).
    • Local and Remote - Messages injected here are simultaneously injected to Local Playback and Remote Transmission.
  • Mechanism is how new messages are handled when there is an ongoing message playing. Each destination uses one of the following injection mechanisms:
    • Simple - Destinations using this mechanism mix together new messages and ongoing messages to play them concurrently.
    • Queue - Destinations using this mechanism queue new messages in the order they are sent. When the ongoing message finishes playing, this mechanism auto-triggers the message that is next in line.
    • Replace - Destinations using this mechanism cancel any ongoing message and then replaces it with the new message.
You can inject synthesized speech into the following destinations:
  • Remote Transmission
    • Enum value: 
      tts_dest_remote_transmission
    • Output: Remote Transmission
    • Mechanism: Simple
  • Local Playback
    • Enum value: 
      tts_dest_local_playback
    • Output: Local Playback
    • Mechanism: Simple
  • Remote Transmission with Local Playback
    • Enum value: 
      tts_dest_remote_transmission_with_local_playback
    • Output: Local and Remote
    • Mechanism: Simple
  • Queued Remote Transmission
    • Enum value: 
      tts_dest_queued_remote_transmission
    • Output: Remote Transmission
    • Mechanism: Queue
    • Caveat: Shares queue with Queued Remote Transmission with Local Playback
  • Queued Local Playback
    • Enum value: 
      tts_dest_queued_local_playback
    • Output: Local Playback
    • Mechanism: Queue
  • Queued Remote Transmission with Local Playback
    • Enum value: 
      tts_dest_queued_remote_transmission_with_local_playback
    • Output: Local and Remote
    • Mechanism: Queue
    • Caveat: Shares queue with Queued Remote Transmission
  • Screen Reader
    • Enum value: 
      tts_dest_screen_reader
    • Output: Local Playback
    • Mechanism: Replace