AudioTextToSpeech 用于播放文本为语音音频。它提供了一个单个 输出 端子,可以通过 Wires 连接到其他端子。此 API 仍在开发中,尚未向公众提供。
代码示例
local audioTextToSpeech : AudioTextToSpeech = Instance.new("AudioTextToSpeech")
audioTextToSpeech.Parent = workspace
audioTextToSpeech.Text = "Hello! Converting text into speech is fun!"
audioTextToSpeech.VoiceId = "1"
local deviceOutput = Instance.new("AudioDeviceOutput")
deviceOutput.Parent = workspace
local wire = Instance.new("Wire")
wire.Parent = workspace
wire.SourceInstance = audioTextToSpeech
wire.TargetInstance = deviceOutput
local count = 0
local connection = nil
connection = audioTextToSpeech.Ended:Connect(function()
audioTextToSpeech.Text = "I can count to " .. count .. " because I am very smart"
audioTextToSpeech.VoiceId = "2"
audioTextToSpeech.TimePosition = 0
audioTextToSpeech:Play()
count += 1
if count > 10 then
connection:Disconnect()
end
end)
audioTextToSpeech:Play()
概要
属性
表示是否加载了 AudioTextToSpeech 对象、已缓冲且准备好播游玩。
表示 AudioTextToSpeech 对象目前是否正在播放。
控制是否循环 AudioTextToSpeech 对象。
控制生成的语音音频的音调,这将与其速度无关。
控制语言音频播放的速度,从而控制其音高。
控制生成的语音频速度,这将与其音调无关。
将被 AudioTextToSpeech 转换为语音的文本。
表示生成的语音音频长度。
跟踪生成的语音频中播放头的当前位置。
由 AudioTextToSpeech 使用的语音风格。
控制生成的语音音频播放的音量。
方法
返回与指定的引置顶连接的 Wires 阵列。
暂停在任何地方的 AudioTextToSpeech 对象,其 TimePosition 是在哪里。
从任何地方播放 AudioTextToSpeech 从哪里它的 TimePosition 是。
卸载生成的语音音频。
生成语音频。
活动
当 AudioTextToSpeech 对象完成播放并暂停时发生火焰。
当 AudioTextToSpeech 对象循环时发生火焰。
当另一个实例通过 AudioTextToSpeech 连接到或与 Wire 断开时发生火焰。
属性
IsLoaded
表示是否加载了 AudioTextToSpeech 对象、已缓冲且准备好播游玩。虽然不常见,AudioTextToSpeech 对象可能在运行时未载入资产,如果出现极端内存压力,那么 IsLoaded 将变为 false。
IsPlaying
表示 AudioTextToSpeech 对象目前是否正在播放。该属性是只读的,但复制。要在执行时间时播放并停止 AudioTextToSpeech 对象,请使用 Play() 和 Pause() 方法。
方法
Unload
通过卸载生成的语音音频来释放资源。
返回
LoadAsync
阻止调用,开始基于当前参数生成语音的生成。直到语音生成完成或失败为止将继续生成。状态由资产获取状态值返回。
返回
活动
Ended
在 AudioTextToSpeech 对象完成播放并暂停后发生火焰。请注意,这个事件将不会 不 为音频发射,因为它继续播放到结束。此事件还将在播放完成前暂停音频时不会触发;为此,请在 属性上使用 。
此事件可能用于在播放完成后摧毁一个 AudioTextToSpeech 对象。
Looped
事件发生在 AudioTextToSpeech 对象循环之后。当音频达到内容的最后时,Looping 是 true 。
此事件如果音频通过手动循环改变其 TimePosition 而不发射,将不会发生 不 。
WiringChanged
在 Wire 连接或断开后发生的事件,该 Wire 现在或之前已连接到 AudioTextToSpeech 上的某个引脚或其他可连接的实例。