cast. framework. PlayerManager
Controla y supervisa la reproducción de contenido multimedia.
- Arroja
-
non-null Error
Si el constructor se usa directamente. Solo se debe acceder aPlayerManager
llamando a cast.framework.CastReceiverContext#getPlayerManager.
Métodos
addEventListener
addEventListener(eventType, eventListener)
Agrega un objeto de escucha de eventos que escucha eventos de reproducción.
Parámetro |
|
---|---|
eventType |
(cast.framework.events.EventType no nulo o array no nulo de cast.framework.events.EventType no nulo) Un tipo de evento o un array de tipos de eventos |
eventListener |
function(non-null cast.framework.events.Event) |
- Arroja
-
non-null Error
Si los argumentos proporcionados no son válidos.
addSupportedMediaCommands
addSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Agrega nuevos comandos compatibles a la lista existente de comandos multimedia compatibles.
Parámetro |
|
---|---|
supportedMediaCommands |
número Es una máscara de bits de comandos multimedia compatibles con la app. |
broadcastStatus |
Opcional boolean
|
- Consulta también
- cast.framework.messages.Command
broadcastStatus
broadcastStatus(includeMedia, requestId, customData, includeQueueItems)
Envía un mensaje de estado de medios a todos los remitentes (broadcast). Las aplicaciones lo usan para enviar un cambio de estado personalizado.
Parámetro |
|
---|---|
includeMedia |
Opcional boolean
|
requestId |
Opcional número El ID de la solicitud entrante que causó esta respuesta. |
customData |
Opcional Objeto Son los datos personalizados específicos de la aplicación del mensaje de estado. El valor puede ser nulo. |
includeQueueItems |
Opcional boolean Indica si se deben incluir elementos de cola en el mensaje de estado. De forma predeterminada, no se incluyen. |
getAbsoluteTimeForMediaTime
getAbsoluteTimeForMediaTime(mediaTime) muestra un número
Convierte el tiempo multimedia en tiempo absoluto de contenido multimedia. El tiempo absoluto se aplica solo a las transmisiones en vivo.
Parámetro |
|
---|---|
mediaTime |
número Tiempo de medios. |
- Devuelve
-
nullable number
Tiempo absoluto onull
si no está disponible.
getAudioTracksManager
getAudioTracksManager() devuelve cast.framework.AudioTracksManager.
Obtiene la instancia AudioTracksManager
.
- Devuelve
-
non-null cast.framework.AudioTracksManager
getBreakClipCurrentTimeSec
getBreakClipCurrentTimeSec() muestra un número.
Muestra la hora actual del clip de pausa que se está reproduciendo actualmente, en segundos.
- Devuelve
-
nullable number
Tiempo actual en segundos dentro del clip de pausa actual.null
cuandoPlayer
no está reproduciendo el clip de pausa.
getBreakClipDurationSec
getBreakClipDurationSec() muestra un número.
Muestra la duración del clip de pausa que se está reproduciendo actualmente en segundos.
- Devuelve
-
nullable number
Duración del clip de pausa actual.null
cuandoPlayer
no está reproduciendo un clip de pausa.
getBreakManager
getBreakManager() muestra cast.framework.breaks.BreakManager.
Obtiene la instancia BreakManager
.
- Devuelve
-
non-null cast.framework.breaks.BreakManager
getBreaks
getBreaks() muestra el array de cast.framework.messages.Break que no es nulo.
Muestra una lista de saltos.
- Devuelve
-
non-null Array of non-null cast.framework.messages.Break
getCurrentSupportedMediaCommands
getCurrentSupportedMediaCommands() muestra un número
Obtiene los comandos multimedia compatibles con el receptor actual.
A diferencia de getSupportedMediaCommands()
, el valor que se muestra de este método cambia de forma dinámica según el estado de reproducción actual. Por ejemplo, durante la reproducción de anuncios, es posible que no se admita el comando SEEK
.
Solo se debe llamar a este método después de llamar al receptor CastReceiverContext#start
; de lo contrario, mostrará 0
.
- Consulta también
- cast.framework.messages.Command
- Devuelve
-
number
Es una máscara de bits de los comandos multimedia compatibles con la app.
getCurrentTimeSec
getCurrentTimeSec() muestra un número.
Obtiene el tiempo de reproducción transcurrido del contenido multimedia actual.
- Devuelve
-
number
Es el tiempo transcurrido, en segundos. Será0
si no se está reproduciendo contenido multimedia.
getDurationSec
getDurationSec() muestra un número.
Obtiene la duración del contenido multimedia que se está reproduciendo en el momento, en segundos.
- Devuelve
-
number
Duración del contenido multimedia.NaN
si no se está reproduciendo contenido multimedia.
getLiveSeekableRange
getLiveSeekableRange() muestra cast.framework.messages.LiveSeekableRange.
Muestra el rango que puede buscar en vivo con la hora de inicio y la hora de finalización en segundos. Los valores se basan en el tiempo del contenido multimedia.
- Devuelve
getMediaInformation
getMediaInformation() muestra cast.framework.messages.MediaInformation.
Obtiene información del contenido multimedia del contenido multimedia actual.
- Devuelve
getMediaTimeForAbsoluteTime
getMediaTimeForAbsoluteTime(AbsoluteTime) muestra un número
Convierte el tiempo absoluto de contenido multimedia en tiempo multimedia. El tiempo absoluto solo se aplica a las transmisiones en vivo.
Parámetro |
|
---|---|
absoluteTime |
número El tiempo absoluto del medio, como tiempo de época UNIX (segundos desde el tiempo Unix) |
- Devuelve
-
nullable number
Tiempo de medios onull
si no está disponible
getPlaybackConfig
getPlaybackConfig() muestra cast.framework.PlaybackConfig.
Muestra la configuración de reproducción o null
si no se anularon los valores predeterminados.
- Devuelve
-
nullable cast.framework.PlaybackConfig
getPlaybackRate
getPlaybackRate() muestra número
Muestra la velocidad de reproducción actual.
Muestra 1
antes de que se llame al receptor CastReceiverContext#start
.
- Devuelve
-
number
Velocidad de reproducción actual.
getPlayerState
getPlayerState() muestra cast.framework.messages.PlayerState.
Obtiene el estado Player
.
- Devuelve
-
non-null cast.framework.messages.PlayerState
Es el estado delPlayer
actual.
getPreferredPlaybackRate
getPreferredPlaybackRate() muestra un número
Obtén la velocidad de reproducción preferida. Se puede usar en un evento de cierre para guardar la velocidad de reproducción preferida más reciente en el almacenamiento persistente, de modo que pueda usarse en la próxima sesión en las opciones de transmisión.
- Devuelve
-
number
getPreferredTextLanguage
getPreferredTextLanguage() muestra una cadena.
Obtiene el idioma preferido de la pista de texto.
- Devuelve
-
nullable string
getPreferredTextStyle
getPreferredTextStyle() muestra cast.framework.messages.TextTrackStyle.
Obtiene el estilo de pista de texto preferido.
- Devuelve
getQueueManager
getQueueManager() returns (cast.framework.QueueManager or undefined)
Obtiene la instancia QueueManager
.
- Devuelve
-
(non-null cast.framework.QueueManager or undefined)
getRawCurrentTimeSec
getRawCurrentTimeSec() muestra número
Obtiene el tiempo de reproducción transcurrido del contenido multimedia actual, sin restar el tiempo de la pausa publicitaria.
- Devuelve
-
number
Es el tiempo transcurrido, en segundos. Será0
si no se está reproduciendo contenido multimedia.
getStartAbsoluteTime
getStartAbsoluteTime() muestra un número
Obtiene la hora de inicio del contenido multimedia absoluto, como tiempo de época UNIX (segundos desde el tiempo de época Unix). El tiempo absoluto se aplica solo a las transmisiones en vivo.
- Devuelve
-
nullable number
getStats
getStats() returns cast.framework.stats.Stats
Muestra las estadísticas de reproducción. Las estadísticas se agregan durante toda la sesión de reproducción cuando corresponde.
- Devuelve
-
non-null cast.framework.stats.Stats
getSupportedMediaCommands
getSupportedMediaCommands() muestra un número
Obtiene los comandos multimedia compatibles con el receptor. Solo se debe llamar después de llamar a CastReceiverContext#start()
; de lo contrario, muestra 0
. El valor de los comandos multimedia compatibles lo controla solo la aplicación del receptor .
No se actualiza automáticamente en función de un MediaStatus
.
- Consulta también
- cast.framework.messages.Command
- Devuelve
-
number
Es una máscara de bits de los comandos multimedia compatibles con la app.
getTextTracksManager
getTextTracksManager() muestra cast.framework.TextTracksManager.
Obtiene la instancia TextTracksManager
.
- Devuelve
-
non-null cast.framework.TextTracksManager
getTimedMetadata
getTimedMetadata() muestra un array de cast.framework.TimedMetadata que no es nulo.
Muestra los metadatos temporizados que se encontraron durante el análisis del manifiesto. Es #EXT-X-DATERANGE
en HLS y EventStream
en DASH.
- Devuelve
-
non-null Array of non-null cast.framework.TimedMetadata
load
load(loadRequest) muestra una promesa que contiene void.
Inicia una solicitud para cargar medios.
Parámetro |
|
---|---|
loadRequest |
cast.framework.messages.LoadRequestData Es una solicitud para cargar un contenido multimedia. El valor no debe ser nulo. |
- Devuelve
-
non-null Promise containing void
Es la promesa que se resuelve cuando la operación se completa correctamente o se rechaza si falla.
pausa
pausa()
Pausa el contenido multimedia que se está reproduciendo.
reproducir
play()
Reproduce el contenido multimedia actualmente detenido.
removeEventListener
removeEventListener(eventType, eventListener)
Elimina el objeto de escucha de eventos agregado a un evento de reproducción determinado. Si no hay un objeto de escucha de eventos que coincida, se ignora esta llamada.
Parámetro |
|
---|---|
eventType |
(cast.framework.events.EventType no nulo o array no nulo de cast.framework.events.EventType no nulo) Un eventType o un array de tipos de eventos |
eventListener |
function(non-null cast.framework.events.Event) |
removeSupportedMediaCommands
removeSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Quita comandos de la lista de comandos de contenido multimedia compatibles.
Parámetro |
|
---|---|
supportedMediaCommands |
número Es una máscara de bits de comandos multimedia compatibles con la app. |
broadcastStatus |
Opcional boolean
|
- Consulta también
- cast.framework.messages.Command
llegar
buscar(hora(seekTime)
Busca en el contenido multimedia actual.
Parámetro |
|
---|---|
seekTime |
número |
sendCustomState
sendCustomState(state)
Envía un estado personalizado desde una lógica de reproducción de la aplicación a la lógica de la IU.
Este método ayuda a habilitar la separación de la lógica de reproducción y la IU.
Mantener la separación entre la lógica y la IU permite usar la misma lógica de la IU tanto para la reproducción local como para el control remoto.
El estado personalizado que envía este método está disponible para la IU a través de PlayerData
.
Parámetro |
|
---|---|
state |
Objeto Objeto de estado personalizado. El valor no debe ser nulo. |
- Consulta también
- cast.framework.ui.PlayerData#customState
sendError
sendError(senderId, requestId, type, reason, customData)
Envía un error a un remitente específico.
Parámetro |
|
---|---|
senderId |
cadena Es el ID del remitente. |
requestId |
número El ID de la solicitud entrante que causó el error. |
tipo |
cast.framework.messages.ErrorType El tipo de error. El valor no debe ser nulo. |
Reason |
Opcional cast.framework.messages.ErrorReason El motivo del error. El valor puede ser nulo. |
customData |
Opcional Objeto Es el mensaje de error sobre datos personalizados específicos de la aplicación. El valor puede ser nulo. |
sendLocalMediaRequest
sendLocalMediaRequest(request)
Envía una solicitud de medios locales.
Parámetro |
|
---|---|
solicitud |
cast.framework.messages.RequestData El valor no debe ser nulo. |
sendStatus
sendStatus(senderId, requestId, includeMedia, customData, includeQueueItems)
Envía un mensaje de estado de contenido multimedia a un remitente específico.
Parámetro |
|
---|---|
senderId |
cadena Es el ID del remitente. |
requestId |
número El ID de la solicitud entrante que causó esta respuesta. |
includeMedia |
Opcional boolean
|
customData |
Opcional Objeto Son los datos personalizados específicos de la aplicación del mensaje de estado. El valor puede ser nulo. |
includeQueueItems |
Opcional boolean Indica si se deben incluir elementos de cola en el mensaje de estado. De forma predeterminada, no se incluyen. |
setIdleReason
setIdleReason(idleReason)
Establece el motivo por el que el reproductor está en el estado IDLE
.
Esto permite que las aplicaciones que desean forzar el estado IDLE
indiquen el motivo (por ejemplo, un error personalizado).
El motivo de la inactividad se envía en el siguiente mensaje de estado.
Nota: La mayoría de las aplicaciones no necesitan establecer este valor. Solo es necesario si la app necesita hacer que Player
pase al estado IDLE
en circunstancias especiales y el estado inactivo predeterminado no refleja el comportamiento previsto.
Parámetro |
|
---|---|
idleReason |
cast.framework.messages.IdleReason El motivo para estar en el estado El valor no debe ser nulo. |
setMediaElement
setMediaElement(mediaElement)
Configura el HTMLMediaElement
que se usará. Si se configura una Promise
de una HTMLMediaElement
, el contenido multimedia comenzará a reproducirse después de que se resuelva el Promise
.
Parámetro |
|
---|---|
mediaElement |
(HTMLMediaElement no nulo o promesa no nula que contenga HTMLMediaElement no nulo)
|
setMediaInformation
setMediaInformation(mediaInformation, opt_broadcast)
Establece la información del contenido multimedia.
Parámetro |
|
---|---|
mediaInformation |
cast.framework.messages.MediaInformation El valor no debe ser nulo. |
opt_broadcast |
Opcional boolean |
setMediaPlaybackInfoHandler
setMediaPlaybackInfoHandler(handler)
Configura un controlador para mostrar o modificar cast.framework.PlaybackConfig para una solicitud de carga específica. Los parámetros del controlador son LoadRequestData
y PlaybackConfig
predeterminado para el receptor (proporcionado en CastReceiverOptions
). El controlador debe mostrar una configuración de reproducción modificada o null
para evitar que se reproduzca el contenido multimedia. El valor que se muestra también puede ser un Promise
para permitir la espera de datos del servidor.
Parámetro |
|
---|---|
controlador |
function(non-null cast.framework.messages.LoadRequestData, non-null cast.framework.PlaybackConfig) Una función para proporcionar una solicitud de configuración de reproducción específica. El valor puede ser nulo. |
setMediaUrlResolver
setMediaUrlResolver(resolver)
Configura un controlador para mostrar la URL de medios de una solicitud LOAD
.
Este controlador se puede usar para evitar que la URL de contenido multimedia se publique como parte del estado de contenido multimedia. De forma predeterminada, se usa el contentId
multimedia como URL de contenido.
Parámetro |
|
---|---|
agente de resolución |
function(non-null cast.framework.messages.LoadRequestData) Una función para resolver URL de contenido multimedia. El valor puede ser nulo. |
setMessageInterceptor
setMessageInterceptor(type, interceptor)
Establece un interceptor de mensajes entrantes y salientes.
El interceptor puede actualizar los datos de la solicitud y debe mostrar datos actualizados, una Promise
con datos actualizados (si los datos no se pueden mostrar de inmediato) o null
si no se debe procesar la solicitud.
Nota: Si se proporciona un interceptor de mensajes LOAD
, pero no se proporciona un interceptor PRELOAD
independiente, se llamará al interceptor LOAD
para los mensajes PRELOAD
.
Parámetro |
|
---|---|
tipo |
cast.framework.messages.MessageType El valor no debe ser nulo. |
interceptor |
function(non-null cast.framework.messages.RequestData) El valor puede ser nulo. |
setPlaybackConfig
setPlaybackConfig(playbackConfig)
Establece la configuración de reproducción en el PlayerManager
.
Parámetro |
|
---|---|
playbackConfig |
El valor no debe ser nulo. |
setSupportedMediaCommands
setSupportedMediaCommands(supportedMediaCommands, broadcastStatus)
Configura los comandos multimedia que admite la app receptora.
Parámetro |
|
---|---|
supportedMediaCommands |
número Es una máscara de bits de comandos multimedia compatibles con la app. |
broadcastStatus |
Opcional boolean
|
- Consulta también
- cast.framework.messages.Command
escala
stop()
Detiene el contenido multimedia que se está reproduciendo.