AudioPlayer
*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
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
O recurso a ser carregado no AudioPlayer .
Controla se Asset carrega automaticamente uma vez atribuído.
Indica se este AudioPlayer está atualmente tocando.
Indica se este AudioPlayer é carregado, bufferizado e pronto para jogar.
Um alcance, em segundos, que denota o início e o fim do ciclo desejado dentro do PlaybackRegion deste AudioPlayer.
Controla se esses AudioPlayer são controlados.
Alcance em segundos denotando um tempo de início desejado (mínimo) e tempo de parada (máximo) dentro do TimeLength.
Controla quão rapidamente o recurso será reproduzido, o que controla seu tom.
Denota o comprimento do ativocarregado.
Rastreia a posição atual do cabeçalho de reprodução dentro do recurso.
Controla o quão alto a ativos serão tocados.
Métodos
Retorna um array de Wires que estão conectados ao marcarespecificado.
Reproduz o AudioPlayer de onde quer que seja o seu TimePosition.
Para o AudioPlayer onde quer que seu TimePosition esteja.
Eventos
Incêndios quando o AudioPlayer completou a reprodução e parou.
Incêndios quando os loops AudioPlayer são executados.
Incêndios quando outra instância está conectada ou desconectada do AudioPlayer através de um Wire .
Propriedades
Asset
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
Controla se Asset carrega automaticamente uma vez atribuído. Se false, o recurso será carregado na primeira tentativa de jogar.
IsPlaying
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
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
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
Controla se esses AudioPlayer loops quando excedem o fim de seu TimeLength, LoopRegion ou PlaybackRegion .
PlaybackRegion
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
Multiplicador que controla quão rapidamente o recurso será tocado, controlando diretamente sua percepção de pitch. Varia de 0 a 20.
TimePosition
Rastreia e controla a posição atual da cabeça de reprodução dentro do Asset, em segundos.
Volume
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
Retorna um array de Wires que estão conectados ao marcarespecificado. AudioPlayer tem um marcar"Saída".
Parâmetros
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
Parâmetros
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
Se a instância se conectou ou desconectou.
O pino no AudioPlayer que os alvos Wire alvo.
O Wire entre a AudioPlayer e a outra instância.