UDP Requests

General

Speak

Speak the given message with the provided voice alias.

{
  "request": "Speak",
  "id": "<id>",
  "voice": "<voice alias>",
  "message": "<message>"
}

Stop

If TTS is currently speaking, stop only the current speech.

{
  "request": "Stop",
  "id": "<id>"
}

Enable

Enable the TTS engine (if it has been disabled)

{
  "request": "Enable",
  "id": "<id>"
}

The on command provides the same functionality as enable

{
  "request": "On",
  "id": "<id>"
}

Disable

Disable the TTS engine

{
  "request": "Disable",
  "id": "<id>"
}

The off command provides the same functionality as disable

{
  "request": "Off",
  "id": "<id>"
}

Select Profile

Switch to the requested profile.

To deselect any profile, you can pass none as the profile name.

{
  "request": "Profile",
  "id": "<id>",
  "profile": "<profile name>"
}

Queue

Pause

Pause the TTS event queue

{
  "request": "Pause",
  "id": "<id>"
}

Resume

Resume the TTS event queue

{
  "request": "Resume",
  "id": "<id>"
}

Clear

Clear all pending events in the TTS event queue.

{
  "request": "Clear",
  "id": "<id>"
}

Events

On

Enable TTS for incoming events.

Equivalent to selecting the Enable checkbox in the Speaker.bot application for a respective event.

{
  "request": "Events",
  "id": "<id>",
  "value": "<event name>",
  "state": "on"
}

Off

Disable TTS for incoming events.

Equivalent to deselecting the Enable checkbox in the Speaker.bot application for a respective event.

{
  "request": "Events",
  "id": "<id>",
  "value": "<event name>",
  "state": "off"
}

Users

Add Regular

Add a user to the regular users group.

{
  "request": "Reg",
  "id": "%userId%",
  "mode": "add",
  "user": "%user%"
}

Remove Regular

Remove a user from the regular users group.

{
  "request": "Reg",
  "id": "%userId%",
  "mode": "del",
  "user": "%user%"
}

Set Nickname

Set the nickname of a user.

{
  "request": "Set",
  "id": "<id>",
  "method": "nickname",
  "username": "%user%",
  "nickname": "<new nickname>"
}

Assign Last Voice

Set the last random voice to be a user's permanent voice.

An alias is created for the user with the assigned voice and settings applied to it.

{
  "request": "Assign",
  "id": "<id>",
  "method": "last",
  "username": "%user%"

Toggle Sticky Voice

When sticky mode is enabled, the first voice a user receieves will be "stuck" to them until it is reset.

Enable sticky mode by passing true

{
  "request": "Set",
  "id": "<id>",
  "method": "sticky",
  "value": true
}

Disable sticky mode by passing false

{
  "request": "Set",
  "method": "sticky",
  "value": false
}