AudioPlayer 用于播放音频资产。它提供一个单个 输出 接口,可以通过 Wires 连接到其他接口。
代码示例
local audioPlayer: AudioPlayer = Instance.new("AudioPlayer")
audioPlayer.Parent = workspace
audioPlayer.AssetId = "rbxassetid://9112854440"
local deviceOutput = Instance.new("AudioDeviceOutput")
deviceOutput.Parent = workspace
local wire = Instance.new("Wire")
wire.Parent = workspace
wire.SourceInstance = audioPlayer
wire.TargetInstance = deviceOutput
audioPlayer:Play()
概要
属性
要加载到 AudioPlayer 的资产。
控制是否在分配后自动加载 Asset。
表示这个 AudioPlayer 是否正在播放。
表示这个 AudioPlayer 是否已加载、缓冲和准备好播游玩。
在几秒内的范围,用于标示此 内的所需循环开始和循环结束。
控制这些 AudioPlayer 循环。
在 TimeLength 内表示希望的起始时间 (最小) 和停止时间 (最大) 的秒数范围。
控制资产播放的速度,从而控制其音高。
表示加载的素材长度。
跟踪素材内播放头的当前位置。
控制资产播放的音量。
方法
返回与指定的引置顶连接的 Wires 阵列。
从任何地方播放 AudioPlayer 从哪里它的 TimePosition 是。
停止任何地方的 AudioPlayer ,其 TimePosition 位于哪里。
活动
当 AudioPlayer 播放完成并停止时发生火灾
在 AudioPlayer 循环发生火灾。
当另一个实例通过 AudioPlayer 连接到或与 Wire 断开时发生火焰。
属性
IsReady
表示这个 AudioPlayer 是否已加载、缓冲和准备好播游玩。虽然不常见,AudioPlayers 可能在运行时加载资产,如果出现极端内存压力,那么IsReady 将变为 false。
LoopRegion
在几秒内的范围,用于标示此 内的所需循环开始和循环结束。
如果 最小值大于 最小值 ,循环从最小值 开始。
如果最小值 小于最小值 少于 ,循环从最小值 开始。
如果 最大值 大于 最大值,循环将在 最大值 最大值结束。
如果 最大值小于 最大值,循环将在正确的 最大值处结束。
如果 最小 等于 最大值,那么 使用的是 属性,而不是最大值。
PlaybackRegion
在 TimeLength 内表示希望的起始时间 (最小) 和停止时间 (最大) 的秒数范围。
如果最小值 大于 0,音效从最低值 的时间开始播放。
如果 最小值小于 0,声音从 0 开始播放。
如果 最大值 大于 最大值,声音将在 停止 在 。
如果 最大值小于 ,声音将在正确的 最大值停止。
如果 最小值 等于 最大值,音效将在整体播放。
方法
活动
Ended
在 AudioPlayer 播放完成并停止后发生火焰请注意,这个事件将不会 不 为音频发射,因为它继续播放到结束。此事件还将 不 在播放完成前停止音频时触发;为此,请在 IsPlaying 属性上使用 AudioPlayer:GetPropertyChangedSignal()。
这个事件经常用于在播放完成后摧毁一个 AudioPlayer 。
Looped
在 AudioPlayer 循环之后发生的事件。当音频到达内容的末端(或活动的末端,如果已启用)时,会发生这种情况。 LoopRegion 当音频到达内容的末端时,Looping 是 true 。
此事件如果音频通过手动循环改变其 TimePosition 而不发射,将不会发生 不 。
WiringChanged
在 Wire 连接或断开后发生的事件,该 Wire 现在或之前已连接到 AudioPlayer 上的某个引脚或其他可连接的实例。