ImportTtsPresets

From Wiki G1R-MP G1 Remake Multiplayer
Jump to navigation Jump to search

importTtsPresets

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

Validates an exported profile document and atomically replaces this resource's voices/presets.

Syntax

bool importTtsPresets(table document)

Parameters

Name Type Required Description
document table yes Exactly the schema, voices and presets fields from exportTtsPresets.

Returns

true after a complete valid import, or false, reason; no partial application on invalid data.

Examples

local text = readResourceData("tts_profiles")
if type(text) == "string" then
    local data = fromJSON(text)
    local ok, why = importTtsPresets(data)
    if not ok then outputDebugString(tostring(why)) end
end

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.
  • This replaces both collections rather than merging individual profiles. It never downloads samples or loads arbitrary model checkpoints.