SetTtsPosition
setTtsPosition
AVAILABLE SINCE UPDATE 0.1.7
This function is available since G1R:MP 0.1.7.
Moves an independent 3D playback; rejects 2D and attached playback.
Syntax
bool setTtsPosition(number playback, table position)
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
playback |
number |
yes | Active playback/preload ID owned by this resource; not a job or ordinary sound handle. |
position |
table |
yes | Exactly {x,y,z} in metres, finite components with absolute value <= 1000000. |
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.