Descripción general: SDK nativo de Brightcove para tvOS

Bienvenido a la documentación para desarrolladores de Native SDK for tvOS de Brightcove. Aquí encontrará información para reproducir contenido de video en Apple TV.

Resumen

El SDK nativo para tvOS le permite crear aplicaciones centradas en video para el Apple TV.

Los clientes de Video Cloud pueden reproducir el contenido de la biblioteca de Video Cloud
Los clientes de Brightcove Player pueden reproducir videos con URL accesibles en Internet

Al ingerir su contenido, le recomendamos que utilice un perfil de alta resolución para obtener las mejores interpretaciones para Apple TV. Para obtener más detalles, consulte Apple Formatos de video para Apple TV documentación.

Versiones admitidas

Apoyo activo

Brightcove proporciona soporte activo para el último SDK de tvOS en la última versión pública de las siguientes versiones de tvOS:

tvOS 16
tvOS 15.6
tvOS 14.7
tvOS 13.4.8

Soporte pasivo

Brightcove proporciona soporte pasivo para las siguientes versiones de tvOS:

tvOS 12.4.1
tvOS 11.4.1 (si desea utilizar anuncios IMA, necesitará tvOS 12.4.1 o posterior)

Comprender los niveles de soporte

El soporte se define en términos de [versión principal].[versión menor].[versión de parche] de un sistema operativo (por ejemplo: tvOS 11.4.1). Para aprovechar las últimas mejoras tecnológicas de Apple, ofrecemos dos niveles de soporte:

Activo: Brightcove probará y corregirá errores en estas versiones del sistema operativo.
Pasivo: Brightcove probará en estas versiones del sistema operativo, pero las correcciones de errores se manejarán caso por caso.

Generalmente, Brightcove proporciona soporte activo para las versiones del sistema operativo que utiliza el 80% de la base de usuarios y soporte pasivo para otras versiones utilizadas por al menos el 5% de la base de usuarios.

Empezar

Antes de comenzar el desarrollo con Native SDK para tvOS, hay algunos conceptos que debe conocer:

Medios de comunicación
La versión actual de Native SDK admite la reproducción de contenido desde su cuenta de Video Cloud a través de la API de reproducción o como activos remotos con URL accesibles por Internet.
Analítica
Con Native SDK, los clientes de Video Cloud obtienen automáticamente datos analíticos sólidos informados en Video Cloud.
SDK principal y dependencias
El SDK nativo de Brightcove para iOS y sus complementos se pueden agregar a su proyecto mediante el administrador de dependencias de CocoaPods . Los podspecs para todos los componentes del Brightcove Native SDK están alojados en el repositorio de BrightcoveSpecs .

Se requiere la versión 1.0 o posterior de CocoaPods.
Referencia de SDK nativo
Obtenga información sobre Native SDK, incluida la instalación, el inicio rápido y la arquitectura. Aprenderá cómo interactúan los componentes críticos para manejar las complejidades de controlar el reproductor de video nativo.

También encontrará la última versión beta del SDK, si existe.
Lista de correo
Únase a la lista de distribución de SDK nativos de Brightcove para mantenerse informado sobre los anuncios de lanzamiento de los SDK nativos.

Las publicaciones en el canal son para fines históricos. Registrarse lo agregará a la lista de correo electrónico para las versiones de SDK.

Descarga el SDK

El SDK nativo de Brightcove para tvOS está incluido en el SDK nativo para iOS. Aquí encontrará un marco de biblioteca dinámico que admite tvOS.

Obtenga la última versión de Brightcove Native SDK para iOS:

	Paquete (Repositorio de Github)	Podspec	Referencia Documentación	Notas	Muestra
SDK	SDK nativo para iOS 6.12.0	Especificaciones de la cubierta brillante	Referencia de SDK	Notas de versión	Muestra básica de Apple TV

o seleccione este botón:

Para ver las actualizaciones de productos para todos los SDK nativos y los complementos asociados, consulte la Notas de la versión de los SDK nativos de Brightcove documento.

Notas:

El objetivo de implementación mínimo para todos los frameworks de Brightcove Native Player para iOS ahora es iOS 12 y tvOS 12
Para mejorar el cumplimiento de CocoaPods, el SDK nativo para iOS 6.7.7 ha cambiado el nombre de algunos archivos Podspec. Para obtener más detalles, consulte la Referencia de SDK nativo.
Brightcove Native SDK para iOS 6.5.0+ requiere Xcode 11.0 o superior.
El recuento automático de referencias (ARC) es necesario en su proyecto. Este es el valor predeterminado actual para los proyectos de Xcode.
El SDK nativo de Brightcove para tvOS está escrito para permitirle crear aplicaciones personalizadas usando Obj-C y Swift, pero no es compatible con el lenguaje de marcado de televisión de Apple (TVML).
Un problema conocido de Apple con el contenido de transmisión de FairPlay es que no se procesará en el modo AirPlay Mirroring. Para obtener más detalles, consulte la Presentación WWDC: Protección de contenido para HLS (desplácese hasta la mitad de la transcripción).

Integraciones

La siguiente tabla contiene enlaces para integrar complementos con su implementación de SDK. Los complementos se pueden descargar de sus respectivos repositorios de Github, y cada repositorio contiene un archivo README detallado con instrucciones sobre cómo configurar el complemento.

Las aplicaciones de muestra demuestran la funcionalidad básica de cada complemento integrado con el SDK. Estas aplicaciones de muestra son una buena manera de aprender sobre cada complemento y sirven como punto de referencia al depurar.

Versiones de integración anteriores

Categoría	Enchufar (Repositorio de Github)	Podspec	Documentación de referencia	Aplicaciones de muestra	Complemento de socio / proveedor admitido
Publicidad	Complemento IMA 6.12.0 ^[1] ^[2]	Jugador de BrightCove - SDK-IMA	Referencia de IMA	Muestras de IMA de Google	SDK de anuncios de medios interactivos de Google 4.6.1
	Complemento FreeWheel 6.12.0	SDK-FW del reproductor de BrightCove	Referencia de FreeWheel	Muestras de FreeWheel	Administrador de anuncios FreeWheel 6.52.0
	Complemento de pulso 6.12.0	Pulso de reproductor Brightcove	Referencia de pulso	Muestras de pulso	Pulso SDK 2.6.21.6.0
	Complemento SSAI 6.12.0	SDK-FW del reproductor de BrightCove	Referencia SSAI	Muestras SSAI	Verificación de anuncios de VAST 4.1

Las siguientes notas se refieren a las integraciones en la tabla anterior.

^[1] La versión actual del complemento IMA es compatible con el SDK de IMA iOS v3 de Google, que es compatible con las versiones de iOS 9.0+. Para obtener más detalles, consulte Documentación de Google.

Compatibilidad con los SDK nativos de Brightcove VMAP Plantillas XML que contienen el protocolo VAST, incluido VAST 3.0 y soporte limitado para VAST 4.0. Para obtener más detalles sobre la compatibilidad de la versión VAST, consulte Documento de compatibilidad y soporte de Google para el SDK de IMA para iOS.

El SDK nativo para tvOS es compatible con el SDK de medición abierta de IAB v3.1.22.

^[2] Si usa Swift, debe agregar manualmente las bibliotecas IMA de Google, en lugar de usar CocoaPods. Esto se debe a que la biblioteca IMA de Google no admite marcos dinámicos y Swift no admite la creación de bibliotecas estáticas. Para obtener más información, consulte la sección Manual del complemento IMA para Brightcove Native SDK para la documentación de iOS . Aunque el complemento IMA de Brightcove utiliza un marco dinámico, la biblioteca IMA de Google solo se proporciona como marco estático.

Muestras

La siguiente tabla contiene vínculos a ejemplos de código que se suman a los ejemplos asociados con las integraciones de la sección anterior.

Aplicación de muestra	Descripción
Apple TV	Cree una aplicación básica que reproduzca videos de su biblioteca de Video Cloud.
Reproducción con FairPlay	Proteja su contenido con FPS (FairPlay Streaming). Para obtener una muestra completa, consulte el FairPlay básico Muestra de iOS.
Subtítulos Sidecar	Muestre los subtítulos de los videos que los incluyan en un archivo separado. Esta es una muestra de iOS, pero debería ser relevante para tvOS.

Guías de soluciones

La siguiente tabla contiene enlaces a documentos para desarrolladores que lo ayudarán a comenzar con su propia aplicación utilizando Brightcove Native SDK y lo guiarán a través de algunas de las características y funcionalidades disponibles.

Guía	Descripción
Trabajar con los controles de la interfaz de usuario de Apple TV	Aprenda a aprovechar el SDK nativo de Brightcove para tvOS para usar los controles del reproductor de TV.
Reproducción de video simple	Aprenda a crear una aplicación de vídeo sencilla con Brightcove Native SDK para tvOS.
Selección de fuente	Obtenga más información sobre el proceso de selección de fuente predeterminado al reproducir un video.
Uso de subtítulos WebVTT	Aprenda a configurar subtítulos WebVTT para videos HLS al usar el SDK nativo para tvOS.

Mejores prácticas

Aquí hay información adicional que puede resultarle útil cuando trabaje con Brightcove Native SDK.