roAudioPlayerMx
Este objeto le permite mezclar archivos de audio, así como transmisiones de audio HLS. Cada objeto roAudioPlayerMx contiene dos reproductores de audio internos: la lista de reproducción de audio principal consta de pistas de audio en cola que se reproducen secuencialmente, mientras que la superposición de audio reproduce archivos sobre la lista de reproducción principal. No se producirá un desvanecimiento si se llama mientras una superposición se está reproduciendo, pero la siguiente pista de audio comenzará a reproducirse como se espera.
Las pistas se ponen en cola para PlayFile() con sus parámetros de desvanecimiento especificados en un array asociativoarray asociativo. Estos son los parámetros que puede pasar a PlayFile():
- Nombre de archivo: El nombre de archivo de la pista
- FrontPorch: La duración (en milisegundos) que se omite desde el inicio de la pista. Este valor es 0 de forma predeterminada.
- FadeOutLocation: La ubicación (en milisegundos) del desvanecimiento de salida relativa al valor de FrontPorch. Si el valor de FrontPorch es 0 (que es la configuración predeterminada), y el valor de Duración del desvanecimiento es distinto de cero, entonces el desvanecimiento de salida se calcula hacia atrás desde el final del archivo.
- Duración del desvanecimiento: La duración del desvanecimiento de salida (en milisegundos). Este valor es 0 de forma predeterminada.
- SegueLocation: La ubicación (en milisegundos) del evento que activa la reproducción del siguiente archivo de audio. Esta ubicación es relativa al primer archivo de audio que se reproduce. Si el parámetro SegueLocation no se incluye, el valor toma el valor predeterminado de FadeOutLocation.
- BackPorchLocation: La ubicación (en milisegundos) del punto de terminación de la pista de audio. Esta ubicación es relativa al primer archivo de audio que se reproduce. Si el parámetro BackPorchLocation no se incluye, el archivo de audio se reproduce hasta el final. El valor es 0 de forma predeterminada, lo que deshabilita el back porch.
- Volumen de la pista: El volumen relativo de la pista de audio, medido como un porcentaje. Especifique el porcentaje usando valores entre 0 y 100.
- EventID: El ID de un evento de audio.
- EventTimeStamp: La marca de tiempo del evento de audio. Solo puede haber un evento por archivo de audio.
- QueueNext: La puesta en cola de una pista de audio. Configure el valor del parámetro en 1 para poner en cola un archivo de audio para reproducirse después de la pista actual.
- Superposición: La especificación de superposición de una pista de audio. Configure el valor del parámetro en 1 para reducir gradualmente el volumen de la lista de reproducción de audio principal mientras reproduce la pista de audio como una superposición. Las superposiciones tienen parámetros adicionales:
- AudioBedLevel: El porcentaje del nivel de volumen de la lista de reproducción de audio principal mientras se reproduce la superposición. Especifique el porcentaje usando valores entre 0 y 100.
- AudioBedFadeOutLength: La duración del desvanecimiento de salida de la lista de reproducción de audio principal.
- AudioBedFadeInLength: La duración del desvanecimiento de entrada para la pista de audio subyacente una vez que se activa la transición.
- FadeCurrentPlayNext: Un comando de desvanecimiento. Configure el valor del parámetro en 1 para desvanecer la pista actual de la lista de reproducción de audio principal y desvanecer de entrada el archivo de audio designado.
- CrossfadeCurrentPlayNext: Un comando de fundido cruzado. Configure el valor del parámetro en 1 para forzar un fundido cruzado inmediato entre la pista actual de la lista de reproducción de audio principal y el archivo de audio designado.
- CadenaDeUsuario: Una cadena que se puede establecer en un valor único para cada instancia de roAudioPlayerMx . Esta cadena se devuelve con cada evento generado por la instancia. Dado que todas las plataformas actuales pueden admitir múltiples instancias de roAudioPlayerMx ejecutándose al mismo tiempo, UserString permite que el script distinga entre los retornos de eventos.
El siguiente diagrama ilustra cómo algunos de estos parámetros de temporización funcionan juntos:
El siguiente script ilustra un fundido cruzado simple entre pistas de audio:
a = CreateObject("roAudioPlayerMx")
track1 = CreateObject("roAssociativeArray")
track1["Filename"] = "file1.mp3"
track1["FadeInLength"] = 4000
track1["FadeOutLength"] = 4000
track1["QueueNext"] = 1
track2 = CreateObject("roAssociativeArray")
track2["Filename"] = "file2.mp3"
track2["FadeInLength"] = 4000
track2["FadeOutLength"] = 4000
track2["QueueNext"] = 1
a.PlayFile(track1)
a.PlayFile(track2)ifMediaTransport
Consulte roVideoPlayer para obtener una descripción de los métodos de ifMediaTransport.
ifAudioControl
Consulte roAudioPlayer para obtener una descripción de los métodos de ifAudioControl.
ifSetMessagePort
SetPort(a As Object)
ifUserData
SetUserData(user_data As Object)
Establece los datos de usuario que se devolverán cuando se generen eventos.
GetUserData() As Object
Devuelve los datos de usuario que se establecieron previamente mediante SetUserData(). Devolverá Invalid si no se ha establecido ningún dato.
ifIdentity
GetIdentity() As Integer
La interfaz ifIdentity ha quedado obsoleta. Recomendamos usar la interfaz ifUserData en su lugar.