AudioPlayer
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
AudioPlayer se usa para reproducir recursos de audio. Proporciona un puerto de salida único que se puede conectar a otros pines a través de Class.Wire|Wires .
Muestras 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()Resumen
Propiedades
El activo para ser cargado en el AudioPlayer .
Controla si AssetId carga automáticamente una vez asignado.
Indica si este AudioPlayer está reproduciendo actualmente.
Indica si este AudioPlayer está cargado, búfalo y listo para jugar.
Un rango, en segundos, que denota el inicio y el final de la cadena de forma deseado dentro de la PlaybackRegion de este AudioPlayer.
Controla si estos ciclos de AudioPlayer están activados.
Alcance en segundos que denota un tiempo de inicio deseado (mínimo) y un tiempo de detención (máximo) dentro del TimeLength .
Controla con qué rapidez se reproducirá el activo, lo que controla su tono.
Indica la longitud de la recursode activos.
Rastrea la posición actual de la cabeza de reproducción dentro del recurso.
Controla el volumen de reproducción del activo.
Métodos
Devuelve un arreglo de Wires que están conectados a la anclarespecificada.
Reproduce el AudioPlayer desde donde sea su TimePosition .
Detiene el AudioPlayer dondequiera que esté su TimePosition .
Eventos
Se activa cuando el AudioPlayer ha completado la reproducción y se ha detenido.
Activa cuando se activan los ciclos de AudioPlayer .
Propiedades
AssetId
El activo para ser cargado en el AudioPlayer . Si AutoLoad es cierto, el activo se carga inmediatamente una vez que se asigna esta propiedad. Cuando se carga completamente, IsReady se vuelve cierto.
AutoLoad
Controla si AssetId carga automáticamente una vez asignado. Si se selecciona false, el activo se cargará en la primera oportunidad de jugar.
IsPlaying
Indica si este AudioPlayer está reproduciendo. Esta propiedad es solo de lectura, pero se replica. Para reproducir y dejar de reproducir un AudioPlayer en tiempo de ejecución, usa los métodos Class.AudioPlayer:Play()|Play() y 1> Class.AudioPlayer:Stop()|Stop() .
IsReady
Indica si este AudioPlayer está cargado, búfalo y listo para jugar. Aunque poco común, AudioPlayers puede tener sus recursos no cargados en tiempo de ejecución si hay presión de memoria extrema, en cuyo caso IsReady se volverá falso.
LoopRegion
Un rango, en segundos, que denota el inicio y el final de la cadena de forma deseado dentro de la PlaybackRegion de este AudioPlayer.
Si el mínimo de LoopRegion es mayor que el mínimo de PlaybackRegion, la vuelta comienza desde el mínimo de 2>Class.AudioPlayer.LoopRegion2>.
Si el mínimo de LoopRegion es menos que el mínimo de PlaybackRegion, la ronda comienza desde el 2>Class.AudioPlayer.PlaybackRegion|PlaybackRegion2> mínimo.
Si el límite de LoopRegion es mayor que el máximo de PlaybackRegion, la cadena termina en el máximo de 2>Class.AudioPlayer.PlaybackRegion|PlaybackRegion2>.
Si el límite de LoopRegion es menos que el límite de PlaybackRegion, la ronda termina exactamente en el límite de 1> Class.AudioPlayer.LoopRegion|LoopRegion1> .
Si el LoopRegion mínimo iguala el máximo LoopRegion 2>más2> el 5> Class.AudioPlayer.PlaybackRegion5> propiedad. El 8> Class.AudioPlayer8> usa la propiedad LoopRegion1> en su lugar.
Looping
Controla si este AudioPlayer ciclos cuando exceden el final de su TimeLength , LoopRegion o 1> Class.AudioPlayer.PlaybackRegion|PlaybackRegion1> .
PlaybackRegion
Alcance en segundos que denota un tiempo de inicio deseado (mínimo) y un tiempo de detención (máximo) dentro del TimeLength .
Si el mínimo de PlaybackRegion es mayor que 0, el sonido comienza a reproducirse desde el mínimo de tiempo PlaybackRegion.
Si el mínimo de PlaybackRegion es menos que 0, el sonido comienza a reproducirse desde 0.
Si el máximo de PlaybackRegion es mayor que el máximo de TimeLength, el sonido se detiene en 2>Class.AudioPlayer.TimeLength|TimeLength2>.
Si el límite de PlaybackRegion es menos que el límite de TimeLength, el sonido se detiene exactamente en el límite de 2>Class.AudioPlayer.PlaybackRegion2>.
Si el PlaybackRegion mínimo iguala el PlaybackRegion máximo, el sonido se reproducirá en su totalidad.
PlaybackSpeed
Multiplicador que controla con qué rapidez se reproducirá el activo, controlando directamente su percepción de tonalidad. Rango de 0 a 20.
Volume
Volumen nivel que se multiplica sobre el flujo de audio de salida, controlando cuánto volumen tendrá el activo en reproducción. Rango de 0 a 3.
Métodos
GetConnectedWires
Devuelve un arreglo de Wires que están conectados a la anclarespecificada. AudioPlayer tiene una anclarde salida.
Parámetros
Devuelve
Play
Reproduce el AudioPlayer desde donde sea su TimePosition . Se replica desde el servidor al cliente.
Devuelve
Stop
Detiene el AudioPlayer dondequiera que esté su TimePosition . Se replica desde el servidor al cliente.
Devuelve
Eventos
Ended
Se activa después de que el AudioPlayer haya completado la reproducción y se haya detenido. Tenga en cuenta que este evento no se activará para el audio con Class.AudioPlayer.Looped|Loop
Este evento a menudo se usa para destruir un AudioPlayer cuando ha completado el reproducción.
Looped
Evento que se activa después de que sucedan los ciclos de AudioPlayer . Esto ocurre cuando el audio llega al final de su contenido (o el final de la LoopRegion si es activo) y Looping es 1> Class.AudioPlayer.Looping|Looping1> .
Este evento no dispara si el audio se engraba manualmente cambiando su Class.AudioPlayer.TimePosition|TimePosition .