Text-to-Speech
Text-to-Speech, or the Station Alert - Voice Turnout as it is referred to on the store, is a paid Addon that adds text-to-speech reading of messages sent in SA.
The Voice Turnout Addon also adds support for Sonoran Radio, for more info, see here.
How to configure TTS
See here.
TTS Tips
When creating messages for use with TTS, here's a few tips we have to get the best output:
1. Use commas and periods
If you do not use commas (,) and/or periods (.), the TTS will not "take a breath" in places a human would.
Strategically placed commas and periods can make a message sound 10x better.
Consider the examples below:
No commas or periods
Ladder 7 Rescue 7 Carson Avenue intersection of Davis Avenue Strawberry Los Santos Vehicle Accident possible persons trapped Postal 0 9 0.
With commas and periods
Ladder 7, Rescue 7. Carson Avenue intersection of Davis Avenue, Strawberry, Los Santos. Vehicle Accident, possible persons trapped. Postal 0 9 0.
2. Use spaces
Especially in numbers, spaces ( ) force the TTS to read out letter-by-letter.
Consider the examples below:
No spaces
Ladder 7, Rescue 7. Vehicle Accident. Map page 50, reference 754719. Postal 175.
With spaces
Ladder 7, Rescue 7. Vehicle Accident. Map page 50, reference 7 5 4 7 1 9. Postal 1 7 5.
3. Avoid abbreviations
Generally, the TTS will read exactly what you provide it; it doesn't understand abbreviations.
Where possible, use full-words, or logical shortenings, not abbreviation.
4. Use phonetics
If you ask the TTS to read "D", it'll give you "D" ("dee").
You probably wanted "Delta" or "David" - you need to write this instead!
Word Replacement
Variables
On some exports and events, TTS supports variables, which are words inserted into an Alert that are then replaced by the script.
For example, -station- when used with the newAlertNearestStation server export will be replaced with the name of the station that gets picked.
Below is a table of variables, what they work with, and what they do.
| Variable | Works with | Description |
|---|---|---|
-station- | - newAlertNearestStation- newAlertNearestStationWithPlayers | Replaced with the name of the Station that gets selected. |
-stations- | - /alert- newAlert | Replaced with the names of the Stations selected. |
-doors- & -units- | - /alert- newAlert- newAlertNearestStation- newAlertNearestStationWithPlayers | Replaced with the names of the doors selected to open. |
Word Replacement File
The tts-replace.json file allows for replacing of words with other words.
An example might be replacing A, B, & C with Alpha, Bravo, and Charlie.
Only whole words will be matched and replaced.
For example, if Alpha replaces A, This is a Bannanna would become This is Alpha Bananna, not This is Alpha BAlphanAlphannAlpha.
The file also supports Regex, if you want to get more advanced with your replacements.
Simply add re: to the start of your entry and SA will treat it as Regex.
{
"P10": "Pumper 10",
"St": "Street",
"LS": "Los Santos",
"re:\\bunit\\s+(\\d+)\\b": "Fire Unit $1"
}