AudioPlayer

Visualizza obsoleti

*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

AudioPlayer è usato per riprodurre risorse audio. Fornisce un singolo Output pin che può essere connesso ad altri pin tramite Wires .

Campioni di codice

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()

Sommario

Proprietà

Metodi

Proprietà

AssetId

Lettura Parallela

L'asset da caricare nel AudioPlayer . Se AutoLoad è vero, l'asset viene caricato immediatamente una volta che questa proprietà viene assegnata. Quando il caricamento è completato, IsReady diventa vero.

AutoLoad

Lettura Parallela

Controlla se AssetId viene caricato automaticamente una volta assegnato. Se falso, l'asset viene caricato alla prima tentativa di Giocare.

IsPlaying

Lettura Parallela
Sicurezza Roblox

Indica se questo AudioPlayer sta attualmente giocando. Questa proprietà è read-only, ma si replica. Per giocare e fermare un AudioPlayer in Tempo esecuzione, usa i metodi Play() e 1> Class.AudioPlayer:Stop()|Stop()1>.

IsReady

Sola Lettura
Non Replicato
Lettura Parallela

Denota se questo AudioPlayer è caricato, Buffered e pronto per il Giocare. Anche se non comune, AudioPlayers potrebbe avere le loro risorse non caricate in tempo esecuzione se ci sono estreme pressioni di memoria, in cui caso IsReady diventerà falso.

LoopRegion

Lettura Parallela

Un intervallo, in secondi, che denota l'inizio e la fine del ciclo desiderato all'interno della PlaybackRegion di questo AudioPlayer .

Se il minimo LoopRegion è maggiore rispetto al minimo PlaybackRegion, il loop inizia dal minimo 1> Class.AudioPlayer.LoopRegion|LoopRegion1> .

Se il minimo LoopRegion è meno rispetto al minimo PlaybackRegion, il loop inizia dal minimo 1> Class.AudioPlayer.PlaybackRegion|PlaybackRegion1> .

Se il LoopRegion massimo è maggiore rispetto al massimo di PlaybackRegion, il loop termina al massimo di 1> Class.AudioPlayer.PlaybackRegion|PlaybackRegion1> .

Se il LoopRegion massimo è meno di PlaybackRegion massimo, il loop termina esattamente al 2>Class.AudioPlayer.LoopRegion|LoopRegion2> massimo.

Se il LoopRegion minimo uguagli il LoopRegion massimo, il 1> Class.AudioPlayer1> usa la proprietà 4> Class.AudioPlayer.PlaybackRegion|PlaybackRegion4> invece.

Looping

Lettura Parallela

Controlla se questo AudioPlayer loop quando supera la fine del suo TimeLength , LoopRegion , o 1> Class.AudioPlayer.PlaybackRegion|PlaybackRegion1> .

PlaybackRegion

Lettura Parallela

Range in secondi denoting a desired start time (minimum) e stop time (maximum) within the TimeLength .

Se il minimo PlaybackRegion è maggiore di 0, il suono inizia a giocare dal minimo PlaybackRegion .

Se il minimo PlaybackRegion è meno di 0, il suono inizia a suonare da 0.

Se il PlaybackRegion massimo è maggiore di TimeLength, il suono si ferma a 2> Class.AudioPlayer.TimeLength|TimeLength2> .

Se il PlaybackRegion massimo è meno di TimeLength, il suono si ferma esattamente al 2>Class.AudioPlayer.PlaybackRegion2> massimo.

Se il minimo PlaybackRegion uguale il massimo PlaybackRegion , il suono viene riprodotto nella sua interezza.

PlaybackSpeed

Lettura Parallela

Multiplicatore che controlla quanto velocemente verrà riprodotto l'asset, controllando direttamente il suo pitch percepito. Dalle 0 alle 20.

TimeLength

Sola Lettura
Non Replicato
Lettura Parallela

Denota la lunghezza del caricato AssetId in secondi.

TimePosition

Lettura Parallela

Tracks and controls the current position of the playhead within the AssetId , in seconds.

Volume

Lettura Parallela

Livello di volume che viene moltiplicato sulla Flussoaudio di uscita, controllando quanto forte sarà riprodotto l'asset. Vai da 0 a 3.

Metodi

GetConnectedWires

Instances

Restituisce un'area di Wires che sono connessi alla pin specificata. AudioPlayer ha una sola pin "Output".

Parametri

pin: string

Restituzioni

Instances

Play

void

Riproduce il AudioPlayer da dove si trova la sua TimePosition . Riproduce dal server al client.


Restituzioni

void

Stop

void

Interrompe il AudioPlayer ovunque si trovi la sua TimePosition . Si replica dal server al client.


Restituzioni

void

GetWaveformAsync

Resa

Parametri

timeRange: NumberRange
samples: number

Restituzioni

Eventi

Ended

Fires after the AudioPlayer has completed playback and stopped. Note this event will not fire for audio with Looped Proprietàto

Questo evento viene spesso utilizzato per distruggere un AudioPlayer quando ha completato il playback.


Looped

Evento che si attiva dopo i cicli AudioPlayer . Questo accade quando l'audio raggiunge la fine del suo contenuto (o la fine del LoopRegion se è attivo) e Looping è 1> true1> .

Questo evento non brucia se l'audio è riprodotto manualmente cambiando la sua TimePosition .