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 Saída pino 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 AssetId carrega automaticamente uma vez atribuído.
Denota se este AudioPlayer está atualmente tocando.
Denota se este AudioPlayer está carregado, tamperado e pronto para jogar.
Um valor, em segundos, denotando o início e o fim de um loop desejado dentro da PlaybackRegion deste AudioPlayer.
Controla se este AudioPlayer loops.
Alcance em segundos denotando um tempo de inicialização desejado (mínimo) e tempo de parada (máximo) dentro do TimeLength.
Controla a rapidez com que o recurso será tocado, o que controla sua tonalidade.
Denota a longura do recurso ativo.
Rastreia a posição atual do cabeça de reprodução dentro do ativo.
Controla o volume do recurso.
Métodos
Retorna um array de Wires que estão conectados ao marcarespecificado.
Reproduz o AudioPlayer de onde quer que esteja seu TimePosition.
Interrompe o AudioPlayer onde quer que esteja TimePosition.
Eventos
Fires quando o AudioPlayer completou a reprodutão e parou.
Ativado quando os loops de AudioPlayer.
Propriedades
AssetId
O recurso para ser carregado no AudioPlayer . Se AutoLoad estiver verdadeiro, o recurso será carregado imediatamente uma vez que essa propriedade for atribuída. Quando a carregagem estiver concluída, IsReady se torna verdadeiro.
AutoLoad
Controla se AssetId carrega automaticamente uma vez atribuído. Se for falso, o recurso será carregado na primeira tentativa de jogar.
IsPlaying
Denota se este AudioPlayer está atualmente tocando. Essa propriedade é de leitura apenas, mas se replica. Para jogar e parar um AudioPlayer em tempo de execução, use os métodos Class.AudioPlayer:Play()|Play() e 1> Class.AudioPlayer:Stop()|Stop() .
IsReady
Denota se este AudioPlayer está carregado, búfalo e pronto para jogar. Embora não seja comum, AudioPlayers pode ter seus recursos não carregados em tempo de execução se houver pressão de memória extrema, neste caso IsReady se tornará falso.
LoopRegion
Um valor, em segundos, denotando o início e o fim de um loop desejado dentro da PlaybackRegion deste AudioPlayer.
Se o LoopRegion mínimo for menor que o mínimo Class.AudioPlayer.PlaybackRegion|PlaybackRegion, o loop começa a partir do mínimo PlaybackRegion.
Se o LoopRegion mínimo for menor que o mínimo de PlaybackRegion, o loop começa a partir do 1> Class.AudioPlayer.PlaybackRegion|PlaybackRegion1> mínimo.
Se o limite de LoopRegion for maior que o limite de Class.AudioPlayer.PlaybackRegion|PlaybackRegion, o loop termina no máximo de PlaybackRegion.
Se o LoopRegion máximo for menos que o máximo de PlaybackRegion, o loop termina exatamente no 2>Class.AudioPlayer.LoopRegion|LoopRegion2> máximo.
Se o LoopRegion mínimo Class.AudioPlayer.LoopRegion|LoopRegion igual a LoopRegion máximo, o 2>Class.AudioPlayer2> usa a propriedade 5>Class.AudioPlayer.PlaybackRegion|PlaybackRegion5> em vez disso.
Looping
Controla se este AudioPlayer loops quando exceder o fim de seu TimeLength , LoopRegion ou 1> Class.AudioPlayer.PlaybackRegion|PlaybackRegion1> .
PlaybackRegion
Alcance em segundos denotando um tempo de inicialização desejado (mínimo) e tempo de parada (máximo) dentro do TimeLength.
Se o Class.AudioPlayer.PlaybackRegion|PlaybackRegion mínimo for maior que 0, o som começa a tocar a partir do Class.AudioPlayer.PlaybackRegion|PlaybackRegion mínimo.
Se o PlaybackRegion mínimo for menos que 0, o som começa a tocar a partir de 0.
Se o PlaybackRegion máximo for Class.AudioPlayer.TimeLength|TimeLength maior, o som para para em TimeLength.
Se o PlaybackRegion máximo for menos que o TimeLength, o som para exatamente a 2>Class.AudioPlayer.PlaybackRegion|PlaybackRegion2> máximo.
Se o PlaybackRegion mínimo equivalente ao máximo PlaybackRegion, o som é tocado em sua totalidade.
PlaybackSpeed
Multiplicador controlando quão rápido o recurso será jogado, diretamente controlando sua nota percebida. Vários de 0 a 20.
TimePosition
Rastreia e controla a posição atual do cabeça de reprodução dentro do AssetId, em segundos.
Volume
Volume nível que é multiplicado para o stream de saída de áudio, controlando o quão alto o recurso será tocado. Vários de 0 a 3.
Métodos
GetConnectedWires
Retorna uma matriz de Wires que estão conectados ao marcarespecificado. AudioPlayer tem um marcarde saída.
Parâmetros
Devolução
Play
Reproduz o AudioPlayer a partir de onde estiver seu TimePosition . Replicam do servidor para o cliente.
Devolução
Eventos
Ended
Fires after the AudioPlayer has completed playback and stopped. Note this event will not fire for audio with Looped set to 1>
Este evento é muitas vezes usado para destruir um AudioPlayer quando ele completou o playback.
Looped
Evento que ocorre depois que os loops de AudioPlayer. Isso acontece quando o áudio atinge o fim de seu conteúdo (ou o fim de LoopRegion se ele estiver ativo) e Looping é 1> true1> .
Este evento não não fire if the audio is looped manually by changing its TimePosition .