GenerateTts: Difference between revisions
Jump to navigation
Jump to search
Document upcoming 0.1.7: optional server TTS, 33 functions, 4 events, English voice/setup guides and NPC meleeSkillTier; not a release |
Release 0.1.7 / BUILD199 / Protocol 39: current API availability, setup and improvements |
||
| Line 1: | Line 1: | ||
= generateTts = | = generateTts = | ||
<div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;"> | <div style="background:#fff5f5; border:1px solid #d13b3b; border-left:5px solid #d13b3b; color:#111111; padding:0.85rem 1rem; margin:0.75rem 0 1rem;"> | ||
<div style="color:#111111; font-weight:bold; letter-spacing:0.04em;"> | <div style="color:#111111; font-weight:bold; letter-spacing:0.04em;">AVAILABLE SINCE UPDATE 0.1.7</div> | ||
<div style="color:#111111; margin-top:0.25rem;">This function is | <div style="color:#111111; margin-top:0.25rem;">This function is available since G1R:MP 0.1.7.</div> | ||
</div> | </div> | ||
| Line 25: | Line 25: | ||
== Notes == | == Notes == | ||
* Server-side only. | * Server-side only. Available since 0.1.7. | ||
* See [[Server TTS]], [[TTS configuration]] and [[TTS voices]] for installation, options, ownership, cache and examples. | * 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. | * 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. | ||
Latest revision as of 23:50, 10 October 2026
generateTts
AVAILABLE SINCE UPDATE 0.1.7
This function is available since G1R:MP 0.1.7.
Queues asynchronous speech rendering with persistent cache reuse; generateTts and renderTts are aliases.
Syntax
number|false generateTts(string text, table options)
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
text |
string |
yes | Nonempty UTF-8 text: at most 12000 bytes and 4000 Unicode characters. |
options |
table |
yes | engine + language, or an existing voice/preset (not both). Optional seed, reference/hash, parameters and saveAs. See Server TTS and TTS voices. |
Returns
A resource-owned job ID, or false, reason. Acceptance is not completion: wait for onTtsReady or onTtsError.
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.
- The exact text/options/model revision/reference hash form the cache request. Identical requests are reused. saveAs creates a stable resource-private name; a different recording cannot silently overwrite it.
- Overrides replace top-level fields; replacing parameters uses defaults for omitted parameter keys. Release completed job handles with releaseTtsJob; stored recordings remain.