cast. framework. PlayerManager
Controla y supervisa la reproducción de contenido multimedia.
- Arroja
-
non-null Error
Si se usa el constructor 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 arreglo no nulo de cast.framework.events.EventType) Un tipo de evento o un arreglo de tipos de eventos |
eventListener |
function(no nulo cast.framework.events.Event) |
- Arroja
-
non-null Error
Si los argumentos especificados no son válidos.
addSupportedMediaCommand
addSupportedMediaCommand(supportedMediaCommands, broadcastStatus)
Agrega los nuevos comandos compatibles a la lista existente de comandos de contenido multimedia compatibles.
Parámetro |
|
---|---|
supportedMediaCommand |
número Una máscara de bits de comandos multimedia compatibles con la aplicación. |
Estado de transmisión |
Opcional boolean
|
- Consulta también
- cast.framework.messages.Command
Estado de transmisión
broadcastStatus(includeMedia, requestId, customData, includeQueueItems)
Envía un mensaje de estado de medios a todos los remitentes (enviar). Las aplicaciones usan esto para enviar un cambio de estado personalizado.
Parámetro |
|
---|---|
includeMedia |
Opcional boolean
|
requestId |
Opcional número Es el ID de la solicitud entrante que provocó esta respuesta. |
datospersonalizados |
Opcional Objeto 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 el número.
Convierte el tiempo de medios en tiempo absoluto de medios. El tiempo absoluto solo se aplica a las transmisiones en vivo.
Parámetro |
|
---|---|
MediaTime |
número Tiempo de medios. |
- Resultado que se muestra
-
nullable number
Tiempo absoluto onull
si no está disponible.
getAudioTracksManager.
getAudioTracksManager() muestra cast.framework.AudioTracksManager
Obtiene la instancia AudioTracksManager
.
- Resultado que se muestra
-
non-null cast.framework.AudioTracksManager
getBreakClipCurrentTimeSec
getBreakClipCurrentTimeSec() muestra el número
Muestra la hora actual del clip de pausa que se reproduce actualmente, en segundos.
- Resultado que se muestra
-
nullable number
Hora actual en segundos del clip de pausa actual.null
cuandoPlayer
no esté reproduciendo el clip de pausa.
getBreakClipDurationSec
getBreakClipDurationSec() muestra el número
Muestra la duración del clip de pausa que se reproduce actualmente en segundos.
- Resultado que se muestra
-
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
.
- Resultado que se muestra
-
non-null cast.framework.breaks.BreakManager
getBreaks
getBreaks() muestra el arreglo de cast.framework.messages.Break que no es nulo.
Muestra una lista de saltos de línea.
- Resultado que se muestra
-
non-null Array of non-null cast.framework.messages.Break
getCurrentSupportedMediaCommand
getCurrentSupportedMediaCommands() muestra el 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 el comando SEEK
no sea compatible.
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
- Resultado que se muestra
-
number
Una máscara de bits de comandos multimedia compatibles con la aplicación.
getCurrentTimeSec;
getCurrentTimeSec() muestra el número
Obtiene el tiempo de reproducción transcurrido del contenido multimedia actual.
- Resultado que se muestra
-
number
El tiempo transcurrido, en segundos. Este será0
si no se está reproduciendo contenido multimedia.
getDurationSec
getDurationSec() muestra el número
Obtiene la duración del contenido multimedia que se está reproduciendo, en segundos.
- Resultado que se muestra
-
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 se puede buscar en tiempo real, con hora de inicio y hora de finalización en segundos. Los valores se basan en el tiempo multimedia.
- Resultado que se muestra
getMediaInformation
getMediaInformation() muestra cast.framework.messages.MediaInformation
Obtiene información de medios del contenido multimedia actual.
- Resultado que se muestra
getMediaTimeForAbsoluteTime.
getMediaTimeForAbsoluteTime(absoluteTime) muestra el número
Convierte el tiempo absoluto de medios en tiempo multimedia. El tiempo absoluto solo se aplica a las transmisiones en vivo.
Parámetro |
|
---|---|
Tiempo absoluto |
número El tiempo absoluto del medio, como tiempo de época de UNIX (segundos desde el ciclo de entrenamiento de Unix). |
- Resultado que se muestra
-
nullable number
Tiempo de contenido multimedia onull
si no está disponible.
getPlaybackConfig.
getPlaybackConfig() muestra cast.framework.PlaybackConfig
Muestra la configuración de reproducción.
- Resultado que se muestra
-
nullable cast.framework.PlaybackConfig
Tasa de reproducción
getPlaybackRate() muestra el número.
Muestra la velocidad de reproducción actual.
Muestra 1
antes de que se llame al receptor CastRecevierContext#start
.
- Resultado que se muestra
-
number
Velocidad de reproducción actual.
getPlayerState.
getPlayerState() muestra cast.framework.messages.PlayerState.
Obtiene el estado Player
.
- Resultado que se muestra
-
non-null cast.framework.messages.PlayerState
Estado de laPlayer
actual.
Tasa de reproducción preferida
getPreferredPlaybackRate() muestra número.
Obtiene la velocidad de reproducción preferida. Se puede usar en eventos de apagado para guardar la velocidad de reproducción preferida más reciente en el almacenamiento continuo, de modo que se pueda usar en la próxima sesión en las opciones de transmisión.
- Resultado que se muestra
-
number
getPreferredTextLanguage.
getPreferredTextLanguage() muestra una string.
Obtiene el idioma de la pista de texto preferido.
- Resultado que se muestra
-
nullable string
getPreferredTextStyle
getPreferredTextStyle() muestra cast.framework.messages.TextTrackStyle
Obtiene el estilo de pista de texto preferido.
- Resultado que se muestra
getQueueManager.
getQueueManager() (cast.framework.QueueManager o no definido)
Obtiene la instancia QueueManager
.
- Resultado que se muestra
-
(non-null cast.framework.QueueManager or undefined)
getRawCurrentTimeSec;
getRawCurrentTimeSec() muestra el número
Obtiene el tiempo de reproducción transcurrido del contenido multimedia actual, sin restar el tiempo de pausa publicitaria.
- Resultado que se muestra
-
number
El tiempo transcurrido, en segundos. Este será0
si no se está reproduciendo contenido multimedia.
getStartAbsoluteTime
getStartAbsoluteTime() muestra el número
Obtiene la hora de inicio del contenido multimedia absoluto, como tiempo de época de UNIX (segundos desde el ciclo de entrenamiento de Unix). El tiempo absoluto solo se aplica a las transmisiones en vivo.
- Resultado que se muestra
-
nullable number
getStats
getStats() muestra cast.framework.Stats
Muestra estadísticas de reproducción. Las estadísticas se agregan durante toda la sesión de reproducción, según corresponda.
- Resultado que se muestra
-
non-null cast.framework.Stats
getSupportedMediaCommand
getSupportedMediaCommands() muestra el número
Obtiene los comandos multimedia compatibles con el receptor. Solo se debe llamar después de llamar a CastReceiverContext#start()
; de lo contrario, se muestra 0
. Solo la aplicación receptora controla el valor de los comandos multimedia compatibles .
No se actualiza automáticamente en función de una MediaStatus
.
- Consulta también
- cast.framework.messages.Command
- Resultado que se muestra
-
number
Una máscara de bits de comandos multimedia compatibles con la aplicación.
getTextTracksManager.
getTextTracksManager() muestra cast.framework.TextTracksManager
Obtiene la instancia TextTracksManager
.
- Resultado que se muestra
-
non-null cast.framework.TextTracksManager
getTimedMetadata
getTimedMetadata() muestra un arreglo de cast.framework.TimedMetadata no nulo.
Muestra los metadatos temporizados que se encontraron durante el análisis del manifiesto. Es #EXT-X-DATERANGE
en HLS y EventStream
en DASH.
- Resultado que se muestra
-
non-null Array of non-null cast.framework.TimedMetadata
load
load(loadRequest) muestra Promise que contiene void.
Inicia una solicitud para cargar medios.
Parámetro |
|
---|---|
loadRequest |
cast.framework.messages.LoadRequestData Una solicitud para cargar un medio. El valor no debe ser nulo. |
- Resultado que se muestra
-
non-null Promise containing void
: Es una promesa que se resuelve cuando se cierra una operación o se rechaza si falla.
pausar
pausa()
Pausa el contenido multimedia que se está reproduciendo.
reproducir
play()
Reproduce el contenido multimedia pausado actualmente.
removeEventListener
removeEventListener(eventType, eventListener)
Elimina el receptor de eventos agregado para un evento de reproducción determinado. Si no existe un objeto de escucha de eventos que coincida, se ignorará esta llamada.
Parámetro |
|
---|---|
eventType |
(cast.framework.events.EventType no nulo o arreglo no nulo de cast.framework.events.EventType) Un tipo de evento o arreglo de tipos de eventos |
eventListener |
function(no nulo cast.framework.events.Event) |
removeSupportedMediaCommand
removeSupportedMediaCommand(supportedMediaCommands, broadcastStatus)
Quita los comandos de la lista de comandos de contenido multimedia compatibles.
Parámetro |
|
---|---|
supportedMediaCommand |
número Una máscara de bits de comandos multimedia compatibles con la aplicación. |
Estado de transmisión |
Opcional boolean
|
- Consulta también
- cast.framework.messages.Command
seek
búsqueda(seekTime)
Busca en los medios actuales.
Parámetro |
|
---|---|
Hora de búsqueda |
número |
sendCustomState;
sendCustomState(estado)
Envía un estado personalizado desde la lógica de reproducción de una aplicación a la lógica de 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 que uno use la misma lógica de IU para la reproducción local y 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
Enviar error
sendError(senderId, requestId, tipo, motivo, customData)
Envía un error a un remitente específico.
Parámetro |
|
---|---|
ID del remitente |
string El ID de remitente. |
requestId |
número El ID de la solicitud entrante que causó este error. |
type |
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. |
datospersonalizados |
Opcional Objeto Datos personalizados específicos de la aplicación del mensaje de error. El valor puede ser nulo. |
EnviarLocalMediaRequest
sendLocalMediaRequest(solicitud)
Envía una solicitud de medios local.
Parámetro |
|
---|---|
solicitar |
cast.framework.messages.RequestData El valor no debe ser nulo. |
Enviar estado
sendStatus(senderId, requestId, includeMedia, customData y includeQueueItems)
Envía un mensaje de estado de medios a un remitente específico.
Parámetro |
|
---|---|
ID del remitente |
string El ID de remitente. |
requestId |
número Es el ID de la solicitud entrante que provocó esta respuesta. |
includeMedia |
Opcional boolean
|
datospersonalizados |
Opcional Objeto 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. |
Motivo de inactividad
setIdleReason(Motivo de inactividad)
Establece el motivo por el que el reproductor se encuentra en el estado IDLE
.
Esto permite que las aplicaciones que deseen forzar el estado IDLE
indiquen el motivo (por ejemplo, un error personalizado).
El motivo de inactividad se envía en el siguiente mensaje de estado.
Nota: La mayoría de las aplicaciones no necesitan establecer este valor. Solo es necesaria si la app necesita hacer que Player
pase al estado IDLE
en circunstancias especiales y si el motivo de inactividad predeterminado no refleja el comportamiento previsto.
Parámetro |
|
---|---|
Motivo de inactividad |
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 un Promise
de un HTMLMediaElement
, el contenido multimedia comienza la reproducción después de que se resuelve el Promise
.
Parámetro |
|
---|---|
elemento multimedia |
(HTMLMediaElement no nulo o no nulo que contiene HTMLMediaElement no nulo)
|
setMediaInformation
setMediaInformation(mediaInformation, opt_broadcast)
Establece la información del contenido multimedia.
Parámetro |
|
---|---|
Información de medios |
cast.framework.messages.MediaInformation El valor no debe ser nulo. |
optar por transmitir |
Opcional boolean |
setMediaPlaybackInfoHandler
setMediaPlaybackInfoHandler(controlador)
Configura un controlador que muestra o modifica 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 |
|
---|---|
handler |
function(no nulo cast.framework.messages.LoadRequestData, no nulo cast.framework.PlaybackConfig) Una función para proporcionar una configuración de reproducción específica de la solicitud. El valor puede ser nulo. |
setMediaUrlResolver
setMediaUrlResolver(agente de resolución)
Configura un controlador para que muestre la URL de contenido multimedia de una solicitud LOAD
.
Este controlador se puede usar para evitar que la URL del contenido multimedia se publique como parte del estado multimedia. De forma predeterminada, el contentId
de contenido multimedia se usa como la URL del contenido.
Parámetro |
|
---|---|
agente de resolución |
function(no nulo cast.framework.messages.LoadRequestData) Una función para resolver la URL de contenido multimedia. El valor puede ser nulo. |
setMessageInterceptor
setMessageInterceptor(tipo, interceptor)
Configura un interceptor de mensajes entrantes y salientes.
El interceptor puede actualizar los datos de solicitud y debe mostrar datos actualizados, un Promise
con datos actualizados (si los datos no se pueden mostrar de inmediato) o un null
si la solicitud no debe manejarse.
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 |
|
---|---|
type |
cast.framework.messages.MessageType El valor no debe ser nulo. |
interceptor |
function(no nulo cast.framework.messages.RequestData) El valor puede ser nulo. |
setPlaybackConfig.
setPlaybackConfig(playbackConfig)
Establece la configuración de reproducción en el elemento PlayerManager
.
Parámetro |
|
---|---|
playConfig |
El valor no debe ser nulo. |
setSupportedMediaCommand
setSupportedMediaCommand(supportedMediaCommands, broadcastStatus)
Establece los comandos multimedia compatibles con el receptor.
Parámetro |
|
---|---|
supportedMediaCommand |
número Una máscara de bits de comandos multimedia compatibles con la aplicación. |
Estado de transmisión |
Opcional boolean
|
- Consulta también
- cast.framework.messages.Command
stop
stop()
Detiene el contenido multimedia que se está reproduciendo.