AudioPlayer
*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。
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 がロード、バッファリング、再生できるかどうかを示します。
秒単位の範囲で、この PlaybackRegion の AudioPlayer 内で希望のループ開始とループ終了を表す。
この AudioPlayer ループを制御します。
秒単位の範囲で、指定された開始時間 (最小) と停止時間 (最大) を TimeLength 内に表示します。
アセットがどれほど早く再生されるかを制御し、そのピッチを制御します。
ロードされたアセットの長さを示します。
アセット内のプレイヘッドの現在の位置を追跡します。
アセットがどれほど大声で再生されるかを制御します。
方法
指定されたピンに接続された Wires のアレイを返します。
どこからでも AudioPlayer を再生します。その TimePosition はどこでもあります。
どこでも AudioPlayer が存在する場所を停止します。TimePosition が存在する場所です。
イベント
AudioPlayer が再生を完了し停止したときに発火します。
AudioPlayer ループが発動するときに発火します。
別のインスタンスが を介して接続されたり、切断されたりしたときに発火します。
プロパティ
Asset
AudioPlayer にロードするアセット。If AutoLoad が true である場合、このプロパティが割り当てられるとすぐにアセットがロードされます。ロードが完了すると、IsReady が true になります。
IsPlaying
現在この AudioPlayer が再生中かどうかを示します。このプロパティは読み込み専用ですが、複製します。実行時に AudioPlayer を再生して停止するには、Play() および Stop() メソッドを使用します。
IsReady
この AudioPlayer がロード、バッファリング、再生できるかどうかを示します。アンコモンではありますが、AudioPlayers は実行時にアセットがロードされない可能性があり、その場合、IsReady は偽になります。
LoopRegion
秒単位の範囲で、この PlaybackRegion の AudioPlayer 内で希望のループ開始とループ終了を表す。
If the 最小値 が最小値 よりも大きい場合、ループは最小値 から始まります。
If the 最小値 が最小値 より少ない場合、ループは最小値 から始まります。
If the 最大値 が最大値 greater より大きい場合、ループは最大値 で終了します。
If the 最大値が 最大値より 少ない場合、ループは正確に 最大値で終了します。
If the LoopRegion 最小 equals 最大 LoopRegion は、AudioPlayer の代わりに PlaybackRegion プロパティを使用します。
Looping
この AudioPlayer ループが、上限を超えたときにこの TimeLength 、LoopRegion 、または PlaybackRegion の終わりに達するかどうかを制御します。
PlaybackRegion
秒単位の範囲で、指定された開始時間 (最小) と停止時間 (最大) を TimeLength 内に表示します。
最小値が0より大きい場合、サウンドは最小時間から再生開始します。If the minimum is greater than 0, the sound begins playing from the minimum time.
最小値 が 0 より少ない場合、サウンドは 0 から再生開始します。
If the 最大値が より大きい場合、サウンドは で停止します。
If the 最大値が より小さい場合、サウンドは正確に 最大値に停止します。
If the 最小 PlaybackRegion 最大 equals 最大 PlaybackRegion サウンドは全体で再生します。
方法
GetConnectedWires
指定されたピピン留めに接続された Wires のアレイを返します。AudioPlayer には「出力」ピン留めが 1 つあります。
パラメータ
戻り値
Play
どこからでも を再生します。サーバーからクライアントにレプリケートします。
戻り値
Stop
どこでも が存在する場所を停止します。サーバーからクライアントへのレプリケーション。
戻り値
イベント
Ended
AudioPlayer が再生を完了し停止した後の炎注: このイベントは、終了すると再生が続行されるため、音声にファイアは起こらないことに注意してください。このイベントは、オーディオが再生が完了する前に停止した場合にも 発火しません;このためには、 プロパティで使用します。
このイベントは、再生が完了したときに AudioPlayer を破壊するのによく使用されます。
Looped
AudioPlayer ループの後に発動するイベント。これは、オーディオがコンテンツの終わりに到達する (またはアクティブな場合は LoopRegion の終わり) と、 Looping が true になるときに発生します。
このイベントは、オーディオを手動でループさせて 炎上させない 、その TimePosition を変更することで再生されない。
WiringChanged
Wire が接続または切断された後に発生するイベント、および Wire が現在または以前に AudioPlayer および他のワイヤー可能なインスタンスのピンに接続されているか、接続されていました。