AudioPlayer

非推奨を表示

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

AudioPlayer は、オーディオアセットを再生するために使用されます。単一の 出力 ピンを提供し、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()

概要

プロパティ

  • Asset:ContentId
    並列読み取り

    AudioPlayer にロードするアセット。

  • 並列読み取り

    Asset が割り当てられたときに自動的にロードされるかどうかを制御します。

  • Robloxのセキュリティ
    並列読み取り

    現在この AudioPlayer が再生中かどうかを示します。

  • 読み取り専用
    複製されていません
    並列読み取り

    この AudioPlayer がロード、バッファリング、再生できるかどうかを示します。

  • 並列読み取り

    秒単位の範囲で、この PlaybackRegionAudioPlayer 内で希望のループ開始とループ終了を表す。

  • 並列読み取り

    この AudioPlayer ループを制御します。

  • 並列読み取り

    秒単位の範囲で、指定された開始時間 (最小) と停止時間 (最大) を TimeLength 内に表示します。

  • 並列読み取り

    アセットがどれほど早く再生されるかを制御し、そのピッチを制御します。

  • 読み取り専用
    複製されていません
    並列読み取り

    ロードされたアセットの長さを示します。

  • 並列読み取り

    アセット内のプレイヘッドの現在の位置を追跡します。

  • 並列読み取り

    アセットがどれほど大声で再生されるかを制御します。

方法

イベント

プロパティ

Asset

ContentId
並列読み取り

AudioPlayer にロードするアセット。If AutoLoadtrue である場合、このプロパティが割り当てられるとすぐにアセットがロードされます。ロードが完了すると、IsReadytrue になります。

AutoLoad

並列読み取り

Asset が自動的にロードされるかどうかを制御します。false の場合、アセットは最初のプレイみでロードされます。

IsPlaying

Robloxのセキュリティ
並列読み取り

現在この AudioPlayer が再生中かどうかを示します。このプロパティは読み込み専用ですが、複製します。実行時に AudioPlayer を再生して停止するには、Play() および Stop() メソッドを使用します。

IsReady

読み取り専用
複製されていません
並列読み取り

この AudioPlayer がロード、バッファリング、再生できるかどうかを示します。アンコモンではありますが、AudioPlayers は実行時にアセットがロードされない可能性があり、その場合、IsReady は偽になります。

LoopRegion

並列読み取り

秒単位の範囲で、この PlaybackRegionAudioPlayer 内で希望のループ開始とループ終了を表す。

If the 最小値 が最小値 よりも大きい場合、ループは最小値 から始まります。

If the 最小値 が最小値 より少ない場合、ループは最小値 から始まります。

If the 最大値 が最大値 greater より大きい場合、ループは最大値 で終了します。

If the 最大値が 最大値より 少ない場合、ループは正確に 最大値で終了します。

If the LoopRegion 最小 equals 最大 LoopRegion は、AudioPlayer の代わりに PlaybackRegion プロパティを使用します。

Looping

並列読み取り

この AudioPlayer ループが、上限を超えたときにこの TimeLengthLoopRegion 、または 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 サウンドは全体で再生します。

PlaybackSpeed

並列読み取り

アセットがどれほど素早く再生されるかを制御するマルチプライヤーは、その感知されたピッチを直接制御します。範囲は 0 から 20 です。

TimeLength

読み取り専用
複製されていません
並列読み取り

ロードされた Asset の長さを秒で表示します。

TimePosition

並列読み取り

Asset 内のプレイヘッドの現在の位置を追跡し、数秒で制御します。

Volume

並列読み取り

出力オーディオストリームに乗算されるボリュームレベルで、アセットがどれほど大声で再生されるかを制御します。0から 3 の範囲。

方法

GetConnectedWires

Instances

指定されたピピン留めに接続された Wires のアレイを返します。AudioPlayer には「出力」ピン留めが 1 つあります。

パラメータ

pin: string
既定値: ""

戻り値

Instances

GetInputPins


戻り値

GetOutputPins


戻り値

Play

()

どこからでも を再生します。サーバーからクライアントにレプリケートします。


戻り値

()

Stop

()

どこでも が存在する場所を停止します。サーバーからクライアントへのレプリケーション。


戻り値

()

GetWaveformAsync

イールド

パラメータ

timeRange: NumberRange
既定値: ""
samples: number
既定値: ""

戻り値

イベント

Ended

AudioPlayer が再生を完了し停止した後の炎注: このイベントは、終了すると再生が続行されるため、音声にファイアは起こらないことに注意してください。このイベントは、オーディオが再生が完了する前に停止した場合にも 発火しません;このためには、 プロパティで使用します。

このイベントは、再生が完了したときに AudioPlayer を破壊するのによく使用されます。


Looped

AudioPlayer ループの後に発動するイベント。これは、オーディオがコンテンツの終わりに到達する (またはアクティブな場合は LoopRegion の終わり) と、 Loopingtrue になるときに発生します。

このイベントは、オーディオを手動でループさせて 炎上させない 、その TimePosition を変更することで再生されない。


WiringChanged

Wire が接続または切断された後に発生するイベント、および Wire が現在または以前に AudioPlayer および他のワイヤー可能なインスタンスのピンに接続されているか、接続されていました。

パラメータ

connected: boolean

インスタンスが接続されたか、切断されたか。

pin: string

ターゲットの AudioPlayer にピンを打った Wire

wire: Wire

Wire と他のインスタンスの間の AudioPlayer

instance: Instance

Wire を介して接続された他のインスタンス。