AudioPlayer

Visualizza obsoleti

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

AudioPlayer viene utilizzato per riprodurre risorse audio. Fornisce un singolo Output pin che può essere collegato ad altre 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

Eventi

Proprietà

Asset

ContentId
Lettura Parallela

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

AutoLoad

Lettura Parallela

Controlla se Asset carica automaticamente una volta assegnata. Se false , l'asset verrà caricato al primo tentativo di Giocare.

IsPlaying

Sicurezza Roblox
Lettura Parallela

Indica se questo AudioPlayer sta attualmente giocando.Questa proprietà è solo letta, ma si replica.Per giocare e interrompere un AudioPlayer durante l'Tempo esecuzione, usa i metodi Play() e Stop().

IsReady

Sola Lettura
Non Replicato
Lettura Parallela

Indica se questo AudioPlayer è caricato, bufferizzato e pronto a Giocare.Sebbene non comune, AudioPlayers potrebbe avere le sue risorse caricate a runtime se c'è una pressione di memoria estrema, in tal caso IsReady diventerà falso.

LoopRegion

Lettura Parallela

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

Se il minimo è maggiore del minimo, il ciclo inizia dal minimo .

Se il minimo di LoopRegion è inferiore rispetto al minimo di PlaybackRegion, il ciclo inizia dal minimo di PlaybackRegion.

Se il massimo di LoopRegion è maggiore del massimo di PlaybackRegion, il ciclo termina al massimo di PlaybackRegion.

Se il massimo di LoopRegion è meno del massimo di PlaybackRegion, il ciclo termina esattamente al massimo di LoopRegion.

Se il minimo uguale il massimo, il utilizza la proprietà invece.

Looping

Lettura Parallela

Controlla se questi AudioPlayer loop quando superano la fine del suo TimeLength, LoopRegion, o PlaybackRegion .

PlaybackRegion

Lettura Parallela

Intervallo in secondi che denota un'ora di inizio desiderata (minima) e un'ora di stop (massima) all'interno del TimeLength .

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

Se il minimo di PlaybackRegion è inferiore a 0, il suono inizia a giocare da 0.

Se il massimo di PlaybackRegion è maggiore di quello di TimeLength, il suono si ferma a TimeLength .

Se il massimo di PlaybackRegion è minore rispetto al TimeLength, il suono si ferma esattamente al massimo di PlaybackRegion.

Se il minimo uguale il massimo, il suono si riproduce nella sua interezza.

PlaybackSpeed

Lettura Parallela

Moltiplicatore che controlla quanto rapidamente verrà riprodotta l'asset, controllando direttamente il suo pitch percepito. Varia da 0 a 20.

TimeLength

Sola Lettura
Non Replicato
Lettura Parallela

Indica la lunghezza del caricato Asset in secondi.

TimePosition

Lettura Parallela

Traccia e controlla la posizione attuale del playhead all'interno del Asset, in secondi.

Volume

Lettura Parallela

Livello di volume che viene moltiplicato sul Flussoaudio di output, controllando quanto fortemente verrà riprodotta l'asset. Varia da 0 a 3.

Metodi

GetConnectedWires

Instances

Restituisce un array di Wires che sono connessi al pin specificato. AudioPlayer ha un pin "Output".

Parametri

pin: string
Valore predefinito: ""

Restituzioni

Instances

GetInputPins


Restituzioni

GetOutputPins


Restituzioni

Play

()

Riproduce il AudioPlayer da dove è il suo TimePosition. Si replica dal server al client.


Restituzioni

()

Stop

()

Ferma il AudioPlayer ovunque sia il suo TimePosition. Replica dal server al client.


Restituzioni

()

GetWaveformAsync

Resa

Parametri

timeRange: NumberRange
Valore predefinito: ""
samples: number
Valore predefinito: ""

Restituzioni

Eventi

Ended

Fuochi dopo che il AudioPlayer ha completato il riproduzione e si è fermato.Nota che questo evento non non brucerà per l'audio con Looped impostato su true poiché continuerà a riprodursi dopo aver raggiunto la Terminare.Questo evento non si attiverà anche non quando l'audio viene interrotto prima che il riproduzione sia completata; per questo, usa AudioPlayer:GetPropertyChangedSignal() sulla ProprietàIsPlaying.

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


Looped

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

Questo evento non fa fuoco se l'audio viene riprodotto manualmente cambiando il suo TimePosition .


WiringChanged

Evento che si attiva dopo che un Wire diventa connesso o disconnesso, e che Wire è ora o era precedentemente connesso a un pin sulla AudioPlayer e a qualche altra esempiowirable.

Parametri

connected: boolean

Se l'istanza è stata connessa o disconnessa.

pin: string

Il pin sul AudioPlayer che i bersagli Wire .

wire: Wire

Il Wire tra la AudioPlayer e l'altra esempio.

instance: Instance

L'altra istanza che è o era connessa attraverso il Wire .