AudioTextToSpeech

显示已弃用

*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处

不可浏览

AudioTextToSpeech 用于播放文本为语音音频。它提供了一个单个 输出 端子,可以通过 Wires 连接到其他端子。此 API 仍在开发中,尚未向公众提供。

代码示例

Outputting Text as Speech

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()

概要

属性

方法

活动

属性

IsLoaded

只读
未复制
读取并联

表示是否加载了 AudioTextToSpeech 对象、已缓冲且准备好播游玩。虽然不常见,AudioTextToSpeech 对象可能在运行时未载入资产,如果出现极端内存压力,那么 IsLoaded 将变为 false。

IsPlaying

Roblox 安全性
读取并联

表示 AudioTextToSpeech 对象目前是否正在播放。该属性是只读的,但复制。要在执行时间时播放并停止 AudioTextToSpeech 对象,请使用 Play()Pause() 方法。

Looping

读取并联

控制 whether AudioTextToSpeech 对象循环在超过其 TimeLength 的末端时是否继续。

Pitch

读取并联

音乐半音中的值。生成的语音的音调从默认值移出 AudioTextToSpeech.Pitch 半音。范围为 -12.0 到 12.0。

PlaybackSpeed

读取并联

乘数控制音频播放的速度,直接控制其感知的音高。范围为 0 到 20。

Speed

读取并联

控制生成的语音频速度的倍数。范围为 0.5 到 2.0。

Text

读取并联

将被 AudioTextToSpeech 转换为语音的文本。

TimeLength

只读
未复制
读取并联

表示在秒内生成的语音音频。

TimePosition

读取并联

在生成的语音频中跟踪和控制播放头的当前位置,在几秒钟内。

VoiceId

读取并联

AudioTextToSpeech 使用的语音风格。

Volume

读取并联

乘以输出音频串流的音量级别,控制生成的语音音频播放的音量。范围为 0 到 3。

方法

GetConnectedWires

Instances

返回连接到指定端置顶的 Wires 阵列。 AudioTextToSpeech 有一个 "输出" 置顶。

参数

pin: string
默认值:""

返回

Instances

Pause

()

在任何地方暂停 AudioTextToSpeech 对象,其 TimePosition 是从服务器复制到客户端。


返回

()

Play

()

从任何地方播放 AudioTextToSpeech 从哪里它的 TimePosition 。从服务器复制到客户端。


返回

()

Unload

()

通过卸载生成的语音音频来释放资源。


返回

()

GetWaveformAsync

暂停

参数

timeRange: NumberRange
默认值:""
samples: number
默认值:""

返回

暂停

阻止调用,开始基于当前参数生成语音的生成。直到语音生成完成或失败为止将继续生成。状态由资产获取状态值返回。


返回

活动

Ended

AudioTextToSpeech 对象完成播放并暂停后发生火焰。请注意,这个事件将不会 不 为音频发射,因为它继续播放到结束。此事件还将在播放完成前暂停音频时不会触发;为此,请在 属性上使用 。

此事件可能用于在播放完成后摧毁一个 AudioTextToSpeech 对象。


Looped

事件发生在 AudioTextToSpeech 对象循环之后。当音频达到内容的最后时,Loopingtrue

此事件如果音频通过手动循环改变其 TimePosition 而不发射,将不会发生


WiringChanged

Wire 连接或断开后发生的事件,该 Wire 现在或之前已连接到 AudioTextToSpeech 上的某个引脚或其他可连接的实例。

参数

connected: boolean

实例是否连接或断开。

pin: string

AudioTextToSpeech 上的按钮,用于 Wire 目标。

wire: Wire

之间的 Wire 和其他实例之间的 AudioTextToSpeech

instance: Instance

连接到 Wire 通过的另一个实例。