Controles de la interfaz de usuario de Apple TV con el SDK nativo para tvOS

En este tema, aprenderá sobre los controles de reproducción proporcionados por Brightcove Player SDK para tvOS.

Resumen

Cuando cree aplicaciones de Apple TV con Brightcove Native SDK para tvOS, obtendrá un conjunto de controles de reproducción para permitir a los usuarios navegar a través del contenido de video, cambiar la relación de aspecto del video, obtener información de video y administrar subtítulos y configuraciones de audio.

Los controles proporcionados por Brightcove Native SDK para tvOS incluyen lo siguiente:

  • Barra de progreso que también puede mostrar la hora del reloj
  • Barra de pestañas superior para información de video, subtítulos y audio
  • Posibilidad de agregar sus propias vistas y controles personalizados en la barra de pestañas superior

Los controles y gestos utilizados resultarán familiares para los usuarios, ya que son similares a los que se encuentran en la interfaz de AVKit.

Con Brightcove Server-Side Ad Insertion (SSAI), los usuarios verán un aspecto personalizado durante la reproducción de anuncios.

Para obtener detalles sobre el uso del SDK nativo, consulte la Descripción general de Brightcove Player SDK para tvOS documento.

Versiones admitidas

Los controles de la interfaz de usuario de Apple TV están disponibles en las siguientes versiones:

Versión del sistema operativo del dispositivo

tvOS 9+

Versión del SDK nativo

SDK nativo de Brightcove para iOS versión 6.3.0+

Siri Remote

El Siri Remote te permite controlar tu Apple TV. Estas son algunas de las formas en que se puede usar:

  • Pídele a Siri que encuentre lo que quieres ver.
  • Utilice la superficie Touch para moverse por la pantalla, deslizar, resaltar y seleccionar elementos.
  • Presione los botones de control para reproducir / pausar contenido rápidamente, ajustar el volumen y navegar a las pantallas de inicio y menú.
Siri Remote
Siri Remote

Para obtener más detalles, consulte Apple Usa tu Siri Remote con Apple TV documento.

Controles de reproducción

La reproducción se controla mediante gestos y pulsaciones de botones en el Apple Siri Remote. A continuación, se muestran algunas de las acciones que puede utilizar con su aplicación. Para obtener más información, consulte lo siguiente:

Barra de progreso

Un solo toque en el trackpad Apple Siri Remote mostrará / ocultará la barra de progreso. Cuando la reproducción está en pausa, desplazarse hacia la izquierda y hacia la derecha navegará hacia atrás y hacia adelante a través de su video.

Para desplazarse, el usuario puede hacer clic y mantener presionado y luego desplazarse hacia la izquierda o hacia la derecha para avanzar o retroceder rápidamente a través de un video.

Mientras se reproduce el video, el usuario puede hacer doble clic en el cuarto izquierdo del trackpad de Siri Remote para retroceder 10 segundos o hacer doble clic en el cuarto derecho del trackpad para avanzar 10 segundos.

Barra de progreso
Barra de progreso

Relación de aspecto de video

Un doble toque en el trackpad Apple Siri Remote recorrerá tres relaciones de aspecto de video estándar:

  • Formato de pantalla ancha para respetar la relación de aspecto (se muestra el video completo)
  • Pantalla completa con relación de aspecto respetada (el video puede estar recortado)
  • Vista ampliada para ajustarse a pantalla completa (se ignora la relación de aspecto)

Barra de pestañas superior

Al deslizar el dedo hacia abajo en el trackpad Apple Siri Remote, se mostrará el menú superior y se ocultará la vista de progreso. Una vez visible, deslizar hacia arriba ocultará el menú superior.

La barra de pestañas tiene los siguientes elementos predeterminados:

  • Info
  • Subtítulos
  • Audio

Puede modificar las etiquetas de texto asociadas con cada elemento de la barra de pestañas o puede crear sus propias vistas personalizadas en la barra de pestañas.

Info

Seleccionando el Info El elemento del menú superior muestra el título, la descripción y la duración asociados con el video cargado actualmente. Estos datos se recuperan de los metadatos del video en la API de reproducción, pero puede configurar su propio texto cuando se carga el video.

Elemento de la barra de pestañas de información
Elemento de la barra de pestañas de información

Subtítulos

Seleccionando el Subtítulos El elemento del menú superior muestra opciones para mostrar subtítulos asociados con el video. Aquí, puede administrar los subtítulos / leyendas que se mostrarán durante la reproducción.

Elemento de la barra de pestañas de subtítulos
Elemento de la barra de pestañas de subtítulos

Audio

Seleccionando el Audio El elemento del menú superior muestra las opciones de audio disponibles durante la reproducción de video.

Elemento de la barra de pestañas de audio
Elemento de la barra de pestañas de audio

Personalizado

Con Brightcove Native SDK para tvOS, puede agregar fácilmente sus propias vistas en la barra de pestañas. Sus vistas pueden contener cualquier vista o control UIKit estándar que necesite.

Vista de barra de pestañas personalizada
Vista de barra de pestañas personalizada

Publicidad con SSAI

Además de la reproducción de contenido, hemos agregado un modo de publicidad al usar la inserción de anuncios del lado del servidor (SSAI) de Brightcove. Este modo incluye las siguientes características:

  • Capacidad para evitar que el usuario borre anuncios pasados
  • Mostrar comentarios sobre el tiempo y los anuncios que quedan en una pausa publicitaria
Anuncio de SSAI
Anuncio de SSAI

Muestra

Para experimentar los controles de Apple TV y ver cómo crear una vista de elemento de barra de pestañas personalizada, consulte el siguiente ejemplo de código:

DVR en vivo / en vivo

Al trabajar con su aplicación Apple TV, Brightcove Native SDK para tvOS admite transmisiones en vivo y DVR en vivo. DVR live permite a los usuarios hacer lo siguiente:

  • Usa la barra de progreso para buscar momentos pasados
  • Regrese al momento en vivo actual para ver contenido en tiempo real

Implementando la reproducción

Para reproducir una transmisión de DVR en vivo o en vivo desde su aplicación Apple TV, haga lo siguiente:

  1. Empiece con el código de muestra básico de Apple TV. Abra el proyecto en Xcode y abra el ViewController.swift expediente.
  2. En el createTVPlayerView() función, configure el playerType a cualquiera live o liveDVR.

    playerView = BCOVTVPlayerView(options: options)
    if (playerView != nil) {
    playerView!.frame = self.videoContainerView.bounds
    playerView!.playerType = BCOVTVPlayerType.liveDVR;
    self.videoContainerView.addSubview(playerView!)
    }
  3. Localizar el viewDidLoad() función.
  4. La llamada a la createSampleTabBarItemView() La función es opcional y le muestra cómo crear una vista personalizada en la barra de pestañas. Para este ejemplo, comentaremos la llamada a esta función.
  5. Comenta la llamada al requestContentFromPlaybackService() función.
  6. En el viewDidLoad() función, antes del corchete de cierre, agregue código para hacer lo siguiente:

    override func viewDidLoad()
    {
    super.viewDidLoad()
    // Do any additional setup after loading the view, typically from a nib.
    
    createTVPlayerView()
    
    //        createSampleTabBarItemView()
    
    // Create and configure the playback controller
    playbackController.delegate = self
    playbackController.isAutoAdvance = true
    playbackController.isAutoPlay = true
    
    // Link the playback controller to the Player View
    playerView?.playbackController = playbackController
    
    //        requestContentFromPlaybackService()
    
    // live stream
    let url = URL(string: "your live stream url")
    
    let video: BCOVVideo = BCOVVideo(hlsSourceURL:url )
    self.playbackController.setVideos([video] as NSArray)
    }
    • Defina la cadena de URL para su transmisión de DVR en vivo o en vivo.
    • Crear un BCOVVideo objeto utilizando la URL de transmisión de DVR en vivo o en vivo del paso anterior.
    • Llama a setVideos() función para agregar su transmisión en vivo a la playbackControllercola de reproducción, que está configurada para comenzar a reproducir automáticamente.

Indicador de transmisión en vivo

La barra de progreso proporcionada por el SDK nativo para tvOS no se completará para las transmisiones en vivo. Un indicador debajo de la barra de progreso informará al usuario cuando la transmisión esté en vivo y cuando esté en pausa:

Transmisión en vivo
Transmisión en vivo

Barra de progreso de DVR en vivo

Un indicador debajo de la barra de progreso informará al usuario cuando la transmisión esté en vivo y cuando esté en pausa.

Mientras ve la transmisión en vivo en tiempo real, la barra de progreso se llenará por completo. La búsqueda de un tiempo anterior en la transmisión se verá similar a esto:

Transmisión de DVR en vivo
Transmisión de DVR en vivo