El objeto PTMediaPlayer representa el reproductor multimedia. Un PTMediaPlayerItem representa audio o vídeo en el reproductor.
Una vez cargado correctamente un recurso de medios, TVSDK crea una instancia de la clase PTMediaPlayerItem
para proporcionar acceso a ese recurso.
El PTMediaPlayer
resuelve el recurso de medios, carga el archivo de manifiesto asociado y analiza el manifiesto. Esta es la parte asíncrona del proceso de carga de recursos. La instancia PTMediaPlayerItem
se produce después de que el recurso se haya resuelto y esta instancia es una versión resuelta de un recurso de medios. TVSDK proporciona acceso a la instancia PTMediaPlayerItem
recién creada mediante PTMediaPlayer.currentItem
.
Debe esperar a que el recurso se cargue correctamente antes de acceder al elemento del reproductor de contenidos.
Desde el momento en que crea la instancia PTMediaPlayer
hasta el momento en que la cierra (vuelve a utilizar o elimina), esta instancia completa una serie de transiciones de un estado a otro.
Algunas operaciones solo se permiten cuando el reproductor está en un estado concreto. Por ejemplo, no se permite llamar a play
en PTMediaPlayerStatusCreated
. Puede llamar a este estado solo después de que el reproductor alcance el estado PTMediaPlayerStatusReady
.
Para trabajar con estados:
PTMediaPlayer.status
.PTMediaPlayerStatus
.Diagrama de transición de estado para el ciclo vital de una instancia de MediaPlayer:
En la tabla siguiente se proporcionan detalles adicionales:
PTMediaPlayerStatus | Ocurre cuando |
---|---|
PTMediaPlayerStatusCreated |
Su aplicación solicitó un nuevo reproductor de contenidos llamando a playerWithMediaPlayerItem. El reproductor recién creado está esperando a que especifique un elemento del reproductor de contenidos. Este es el estado inicial del reproductor de contenidos. |
PTMediaPlayerStatusInitialization |
La aplicación llama a PTMediaPlayer.replaceCurrentItemWithPlayerItem y se está cargando el reproductor de medios. |
PTMediaPlayerStatusInitialized |
TVSDK estableció correctamente el elemento del reproductor de medios. |
PTMediaPlayerStatusReady |
El contenido está preparado y se han insertado anuncios en la cronología, o el procedimiento de publicidad ha fallado. Puede comenzar el almacenamiento en búfer o la reproducción. |
PTMediaPlayerStatusPlaying |
La aplicación ha llamado play, por lo que TVSDK está intentando reproducir el vídeo. Puede que se produzca algún almacenamiento en búfer antes de que se reproduzca realmente el vídeo. |
PTMediaPlayerStatusPaused |
A medida que la aplicación reproduce y pone en pausa el contenido, el reproductor multimedia se mueve entre este estado y PTMediaPlayerStatusPlaying. |
PTMediaPlayerStatusCompleted |
El reproductor ha llegado al final de la emisión y la reproducción se ha detenido. |
PTMediaPlayerStatusStopped |
La aplicación ha lanzado el reproductor de contenido, que también libera todos los recursos asociados. Ya no se puede usar esta instancia |
PTMediaPlayerStatusError |
Error durante el proceso. Un error también podría afectar a lo que puede hacer la aplicación a continuación. |
Puede utilizar el estado para proporcionar comentarios sobre el proceso (por ejemplo, un control de número mientras espera el siguiente cambio de estado) o para dar el siguiente paso en la reproducción del contenido, como esperar al estado adecuado antes de llamar al siguiente método.