AudioPlayer

顯示已棄用項目

*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。

AudioPlayer 用於播放音頻資產。它提供一個單一的 輸出 端子，可以連接到其他端子 via Wires。

範例程式碼

Outputting Audio to Device
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()

概要

屬性

檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目

方法

檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目

屬性

AssetId

string
平行讀取

資產要載入到 AudioPlayer 中。如果 AutoLoad 是真的，資產會立即載入，一旦這個屬性被分配。載入完成後， IsReady 將變成真的。

AutoLoad

bool
平行讀取

控制是否 AssetId 會在指定後自動載入。如果為假，資產將在第一次嘗試播玩 遊玩時載入。

IsPlaying

bool
Roblox 安全性
平行讀取

指定此 AudioPlayer 是否正在播放。此屬性只閱取，但複製。要在執行階段時播放和停止 AudioPlayer，請使用 Class.AudioPlayer:Play()|Play() 2>Class.AudioPlayer:Stop()|Stop() 方法。

IsReady

bool
唯讀
未複製
平行讀取

指定此 AudioPlayer 是否載入、存取暫存欄位並準備好播玩 遊玩。雖然罕見，但 AudioPlayers 可能會在執行時卸載資源，如果發生極端的內存壓力，在此情況下 IsReady 將變成 false。

LoopRegion

NumberRange
平行讀取

在這個 AudioPlayer 的 Class.AudioPlayer.PlaybackRegion|PlaybackRegion 內，代表要求的循環開始和循環終點。

如果 LoopRegion 最低值是 大於 Class.AudioPlayer.PlaybackRegion|PlaybackRegion 的最低值，則循環從 PlaybackRegion 最低值開始。

如果 LoopRegion 最低值小於 少於 最低值 PlaybackRegion ，則循環從 1> Class.AudioPlayer.PlaybackRegion|PlaybackRegion1> 最低值開始。

如果 LoopRegion 最大值大於 Class.AudioPlayer.PlaybackRegion|PlaybackRegion 最大值，則循環將在 PlaybackRegion 最大值後結束。

如果 LoopRegion 最大值小於 更少 於 PlaybackRegion 最大值，則循環將在正確位置結束在 1> Class.AudioPlayer.LoopRegion|LoopRegion1> 最大值。

如果 LoopRegion 最低值 等於 最大值 LoopRegion，1> Class.AudioPlayer1> 會使用 4> Class.AudioPlayer.PlaybackRegion|PlaybackRegion4> 屬性。

Looping

bool
平行讀取

控制此 AudioPlayer 循環，當超過其 TimeLength ， LoopRegion 或 1>Class.AudioPlayer.PlaybackRegion|PlaybackRegion1> 時。

PlaybackRegion

NumberRange
平行讀取

以秒計時 (最小) 和以分鐘計時 (最大) 內的目標開始時間和停止時間。 Class.AudioPlayer.TimeLength|TimeLength 中的開始時間 (最小) 和停止時間 (最大) 。

如果 PlaybackRegion 最低值是 大於 0 以下 ，音效將從 PlaybackRegion 的最低時間開始播放。

如果 PlaybackRegion 最低值小於 0，音效將從 0 開始播放。

如果 PlaybackRegion 最大值大於 Class.AudioPlayer.TimeLength|TimeLength ，音效將在 TimeLength 停止。

如果 PlaybackRegion 最大值小於 小於 於 TimeLength 的音效停止在正確的 1> Class.AudioPlayer.PlaybackRegion|PlaybackRegion1> 最大值。

如果 PlaybackRegion 最低值 等於 最大值 PlaybackRegion，音效將在整個音效。

PlaybackSpeed

number
平行讀取

控制資產的播放速度，直接控制它的聲音感知度。範圍自 0 到 20。

TimeLength

number
唯讀
未複製
平行讀取

表示載入的 AssetId 的長度以秒計。

TimePosition

number
平行讀取

追蹤和控制播放頭的當前位置在 AssetId 中，以秒鐘速度。

Volume

number
平行讀取

音量等級，可乘以輸出音頻串流，控制音頻資產是否播放得很吵。音量等級為 0 至 3。

檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目

方法

GetConnectedWires

Instances

返回連接到指定釘置頂的 Wires 列表。 AudioPlayer 有一個「輸出」置頂子。

參數

pin: string

返回

Instances

Play

void

從任何地方播放 AudioPlayer 的 TimePosition。從伺服器複製到客戶端。


返回

void

Stop

void

停止 AudioPlayer 在任何地方的 TimePosition 。從服務器複製到客戶端。


返回

void

GetWaveformAsync

Array
暫停

參數

timeRange: NumberRange
samples: number

返回

Array
檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目

活動

Ended

發生在 AudioPlayer 完成播放後停止。注意此事件將在播放結束時發生 Class.AudioPlayer.Looped|Looped 設為 Looped 屬性

此事件通常用於摧毀 AudioPlayer 當它完成播放時。


Looped

發生在 AudioPlayer 循環後的事件。這是當音頻到達內容的終點 (或是 LoopRegion 如果啟用) 和 Looping 是 1> Class.AudioPlayer.Looping|Looping1> 的終點。

此事件發生時 不 發射音頻如果音頻被手動重複。


檢視繼承自Instance的所有項目
檢視繼承自Object的所有項目