SetTtsDistance
Jump to navigation
Jump to search
setTtsDistance
AVAILABLE SINCE UPDATE 0.1.7
This function is available since G1R:MP 0.1.7.
Changes attenuation distances; this does not alter sample generation.
Syntax
bool setTtsDistance(number playback, number minimumMetres, number maximumMetres)
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
playback |
number |
yes | Active playback/preload ID owned by this resource; not a job or ordinary sound handle. |
minimumMetres |
number |
yes | Finite value >= 0.1. |
maximumMetres |
number |
yes | Finite value >= minimumMetres and <= 1000. |
Returns
true when accepted, or false, reason.
Notes
- Server-side only. Available since 0.1.7.
- See Server TTS, TTS configuration and TTS voices for installation, options, ownership, cache and examples.
- Invalid requests return false, reason. Profiles, jobs and playback handles belong to the calling resource; do not use handles from another resource or a previous resource lifetime.
- No onTtsPlaybackStateChange event is promised for every control call. Query getTtsPlaybackState when appropriate. Distances affect spatial audio, not the voice/model configuration.