AudioPlayer

Mostrar obsoleto

*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

AudioPlayer é usado para tocar recursos de áudio. Ele fornece um único pino Saída que pode ser conectado a outros pinos via Wires .

Amostras de código

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

Resumo

Propriedades

Métodos

Eventos

Propriedades

Asset

ContentId
Ler Parallel

O recurso a ser carregado no AudioPlayer .Se AutoLoad for true, o recurso carrega imediatamente assim que essa propriedade for atribuída.Quando o carregamento estiver completo, IsReady se torna true .

AutoLoad

Ler Parallel

Controla se Asset carrega automaticamente uma vez atribuído. Se false, o recurso será carregado na primeira tentativa de jogar.

IsPlaying

Segurança Roblox
Ler Parallel

Indica se este AudioPlayer está atualmente tocando.Essa propriedade é apenas de leitura, mas replica.Para jogar e parar um AudioPlayer na tempo de execução, use os métodos Play() e Stop().

IsReady

Somente leitura
Não replicado
Ler Parallel

Indica se este AudioPlayer é carregado, bufferizado e pronto para jogar.Embora não seja comum, AudioPlayers pode ter seus recursos carregados na hora de executar se houver pressão extrema de memória, caso em que IsReady se tornará falso.

LoopRegion

Ler Parallel

Um alcance, em segundos, que denota o início e o fim do ciclo desejado dentro do PlaybackRegion deste AudioPlayer.

Se o mínimo de for menor que o mínimo de maior , o ciclo começa a partir do mínimo de .

Se o mínimo de LoopRegion for menor que o mínimo de PlaybackRegion, o ciclo começa a partir do mínimo de PlaybackRegion.

Se o máximo de LoopRegion for maior que o máximo de PlaybackRegion, o ciclo termina no máximo de PlaybackRegion.

Se o máximo de LoopRegion for menor que o máximo de PlaybackRegion, o ciclo termina exatamente no máximo de LoopRegion.

Se o mínimo LoopRegion igualar o máximo LoopRegion, o AudioPlayer usa a propriedade PlaybackRegion em vez disso.

Looping

Ler Parallel

Controla se esses AudioPlayer loops quando excedem o fim de seu TimeLength, LoopRegion ou PlaybackRegion .

PlaybackRegion

Ler Parallel

Alcance em segundos denotando um tempo de início desejado (mínimo) e tempo de parada (máximo) dentro do TimeLength.

Se o mínimo PlaybackRegion for maior que 0, o som começa a tocar a partir do tempo mínimo PlaybackRegion.

Se o mínimo de for menor que 0, o som começa a tocar a partir de 0.

Se o máximo de PlaybackRegion for maior que o de TimeLength, o som para em TimeLength.

Se o máximo de PlaybackRegion for menor que o de TimeLength, o som para em exatamente o máximo de PlaybackRegion.

Se o mínimo PlaybackRegion igualar o máximo PlaybackRegion, o som toca em sua totalidade.

PlaybackSpeed

Ler Parallel

Multiplicador que controla quão rapidamente o recurso será tocado, controlando diretamente sua percepção de pitch. Varia de 0 a 20.

TimeLength

Somente leitura
Não replicado
Ler Parallel

Denota o comprimento do carregado Asset em segundos.

TimePosition

Ler Parallel

Rastreia e controla a posição atual da cabeça de reprodução dentro do Asset, em segundos.

Volume

Ler Parallel

Nível de volume que é multiplicado no stream de áudio de saída, controlando o quão alto o recurso será tocado. Varia de 0 a 3.

Métodos

GetConnectedWires

Instances

Retorna um array de Wires que estão conectados ao marcarespecificado. AudioPlayer tem um marcar"Saída".

Parâmetros

pin: string
Valor Padrão: ""

Devolução

Instances

GetInputPins


Devolução

GetOutputPins


Devolução

Play

()

Reproduz o AudioPlayer de onde quer que seja seu TimePosition. Replica do servidor para o cliente.


Devolução

()

Stop

()

Para o AudioPlayer onde quer que seu TimePosition esteja. Replica do servidor para o cliente.


Devolução

()

GetWaveformAsync

Rendimentos

Parâmetros

timeRange: NumberRange
Valor Padrão: ""
samples: number
Valor Padrão: ""

Devolução

Eventos

Ended

Incêndios após o AudioPlayer ter completado a reprodução e parado.Observe que este evento não não disparará por áudio com Looped definido para true desde que continuará tocando após chegar ao terminar/parar/sair.Este evento também não disparará quando o áudio for interrompido antes que a reprodução tenha terminado; para isso, use AudioPlayer:GetPropertyChangedSignal() na propriedade IsPlaying.

Este evento é frequentemente usado para destruir um AudioPlayer quando ele concluiu a reprodução.


Looped

Evento que dispara após os AudioPlayer ciclos.Isso ocorre quando o áudio chega ao fim de seu conteúdo (ou ao fim do LoopRegion se estiver ativo) e Looping é true.

Este evento não dispara se o áudio for loopado manualmente alterando seu .


WiringChanged

Evento que dispara depois que um Wire se conecta ou se desconecta, e que Wire está agora conectado ou foi previamente conectado a um pino no AudioPlayer e a alguma outra instância viável.

Parâmetros

connected: boolean

Se a instância se conectou ou desconectou.

pin: string

O pino no AudioPlayer que os alvos Wire alvo.

wire: Wire

O Wire entre a AudioPlayer e a outra instância.

instance: Instance

A outra instância que está ou esteve conectada através do Wire .