GetTtsJobState

From Wiki G1R-MP G1 Remake Multiplayer
Revision as of 22:48, 8 October 2026 by QCherry (talk | contribs) (Document upcoming 0.1.7: optional server TTS, 33 functions, 4 events, English voice/setup guides and NPC meleeSkillTier; not a release)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

getTtsJobState

PLANNED FOR UPDATE 0.1.7
This function is planned for G1R:MP 0.1.7. It is not included in the public 0.1.6 release.

Reads the current job information (both getters return the same information table).

Syntax

table|false getTtsJobState(number job)

Parameters

Name Type Required Description
job number yes Job ID owned by this resource, returned by renderTts/generateTts/loadTtsAudio.

Returns

Table with id, state, error, source; name when named; sha256, bytes, duration (seconds), codec and sampleRate when audio is retained. Invalid/released handles return false, reason.

Notes

  • Server-side only. Coming in 0.1.7 — not released yet; not included in public 0.1.6.
  • 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.
  • States: queued, running, ready, failed, cancelled, expired. source may be empty before readiness, then generated, disk or memory. Do not assume every optional field exists or every state transition emits an event.