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 分開時,發生火災。
屬性
LoopRegion
一個範圍,在秒內指示此 內的所需循環開始和循環結束。
如果 最小值大於 最小值,循環從 最小值開始。
如果最小值 小於最小值 少於 ,循環從最小值 開始。
如果 最大值 大於 最大值,循環將在 最大值 結束。
如果 最大值小於 最大值,循環將在正確的 最大值結束。
如果 LoopRegion 最小 等於 最大 LoopRegion,則 AudioPlayer 使用 PlaybackRegion 屬性取代。
PlaybackRegion
在 TimeLength 內指定想要的開始時間 (最少) 和停止時間 (最多) 的秒數範圍。
如果 最小值大於 0,聲音將從最低時間 開始播放。
如果 最小值小於 0,聲音從 0 開始播放。
如果 最大值大於 ,聲音將在 停止。
如果 最大值小於 ,聲音將在正確的 最大值停止。
如果 PlaybackRegion 最小 等於 最大 PlaybackRegion,聲音將全部播放。
方法
活動
Ended
在 AudioPlayer 播放完畢且停止後發生火災注意,此事件將 不 發射音頻,因為它在達到結束時仍在播放。此事件也不會在播放完成前停止音頻時發生;為此,請在屬性上使用 。
此事件通常用於在播放完成時摧毀 AudioPlayer 。
Looped
在 AudioPlayer 循環之後發生的事件。當音頻到達內容的盡頭(或活動的盡頭,如果已啟用)時,會發生這種情況。當 LoopRegion 是 Looping 時,音頻會變成 true 。
此事件不會在音頻被手動循環變更其 TimePosition 以發射,如果音頻被手動循環變更其 **** 。
WiringChanged
在 Wire 連接或解除連接後發生的事件,該 Wire 現在或之前已連接到 AudioPlayer 上的某個彈片或其他可連接的個體、實例。