GetTtsPlaybackState

From Wiki G1R-MP G1 Remake Multiplayer
Revision as of 23:50, 10 October 2026 by QCherry (talk | contribs) (Release 0.1.7 / BUILD199 / Protocol 39: current API availability, setup and improvements)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

getTtsPlaybackState

AVAILABLE SINCE UPDATE 0.1.7
This function is available since G1R:MP 0.1.7.

Reads an active playback/preload handle.

Syntax

table|false getTtsPlaybackState(number playback)

Parameters

Name Type Required Description
playback number yes Active playback/preload ID owned by this resource; not a job or ordinary sound handle.

Returns

A table {id, state, recipients}; state is preparing, playing or paused, and recipients is a count. Finished handles return false, reason; use terminal events to record results.

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.
  • playing means a common start has been scheduled (normally 500 ms ahead), not proof that a speaker already emitted sound.