Descripción general
El SDK de receptor web de transmisión admite la reproducción de contenido a través de varios sitios web protocolos de transmisión. Según el protocolo utilizado, el SDK carga un reproductor para controlar la reproducción del contenido. En la caso de contenido HLS, se carga la biblioteca del reproductor multimedia (MPL). En el caso de Contenido DASH, Shaka Player es cargado.
En adelante, los equipos de ingeniería del SDK de Cast y del reproductor de Shaka Consolidación de las iniciativas para aumentar la compatibilidad con la reproducción de contenido de HLS en Shaka Jugador. MPL ya no recibirá actualizaciones críticas. Te recomendamos que habilites esta opción para usar Shaka Player en la reproducción de contenido HLS de tu aplicación.
Beneficios del reproductor de Shaka
Cuando cambian a los jugadores, las aplicaciones aprovechan los siguientes beneficios:
- Sesiones de transmisión más sólidas para los usuarios, con mejoras en el tiempo de carga las fallas y la latencia.
- Adopción continua de las funciones de HLS más recientes.
- Mayor claridad en el análisis de la causa raíz para el contenido de los jugadores. de compatibilidad debido a la naturaleza de código abierto de Shaka Player.
- La base de código del reproductor de código abierto permite que los socios contribuir al proyecto del reproductor de Shaka
- Una reducción significativa en el tiempo de producción y corrección de errores Lanzamiento de Shaka Player La cadencia es frecuente y es independiente de las versiones del SDK del receptor web.
- Mayor control sobre el entorno de reproducción proporcionado por la
API de
shakaVersion. - Mayor compatibilidad con la reproducción de Google con recursos de ingeniería enfocados en la reproducción HLS en Shaka Player, como se ve en el hoja de ruta.
Cronograma
El SDK del receptor web comenzará a usar Shaka Player como reproductor predeterminado para la reproducción de contenido HLS. Esto se realizará en etapas para guiar y a los socios durante el proceso de migración.
| Fase | Fecha de inicio | Descripción general |
|---|---|---|
| 1 | Octubre de 2022 | El SDK de Cast Web Receiver presenta las APIs para habilitar la reproducción de contenido HLS en Shaka Player. |
| 2 | Segundo semestre de 2024 | El SDK de Cast Web Receiver cambia el reproductor predeterminado a Shaka Player para la reproducción de contenido HLS. |
Los equipos de ingeniería del SDK del receptor web están adoptando un enfoque basado en el rendimiento y solo pasará a la siguiente fase cuando el rendimiento de Shaka Player esté activado y el rendimiento de referencia de MPL. Estos cambios se anunciarán en el cast-sdk-announcements Google Group y se actualizó en en esta guía.
Habilitar
A partir de la versión 3.0.0105 de CAF, hay un nivel de aplicación
configuración para habilitar el uso de Shaka Player para la reproducción en HLS. Esta versión
también incluye una API para seleccionar entre un rango compatible de versiones del reproductor de Shaka
cargar. Estas marcas se proporcionan en el
CastReceiverOptions mediante
useShakaForHls y
shakaVersion y se evalúan cuando
se inicia el CastReceiverContext. Cualquier aplicación que habilite Shaka para HLS
debes establecer una versión de Shaka Player de al menos 4.3.4 para aprovechar el
las mejoras más recientes de HLS. Para habilitar esta opción, sigue el siguiente fragmento de código:
const context = cast.framework.CastReceiverContext.getInstance();
let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = true;
context.start(castReceiverOptions);
Valida el contenido
Los socios deben validar la reproducción de su contenido en Shaka Player antes de habilitar la opción. para usar Shaka Player en su aplicación de producción. Recomendamos probar cada uno las variaciones en tu contenido que se enumeran a continuación:
- Tipos de transmisión: LIVE o VOD
- Formatos de contenedor: TS, MP4 o transmisiones elementales
- Contenido con discontinuidades o anuncios incorporados
- Reproducción en los siguientes tipos de dispositivos: pantallas inteligentes, llaves de Chromecast, Dispositivos Android TV, TVs con Chromecast integrado, bocinas inteligentes
Si encuentras algún error o comportamiento inesperado, informa un error. Una vez que puedas verificar que no haya fallas de reproducción críticas en tu contenido, envía los cambios a tu entorno de producción.
Inhabilitar
El SDK del receptor web pasará a un modelo de inhabilitación para el reproductor de Shaka HLS
Reproducción de contenido según el cronograma. La propiedad
useShakaForHls cambiará su valor predeterminado
de false a true. En ese momento, las aplicaciones pueden optar por usar MPL para HLS
la reproducción estableciendo manualmente esta propiedad en false. Cuando
Se inició CastReceiverContext, el SDK del receptor web volverá a cargarse
MPL en lugar de Shaka Player Consulta el siguiente ejemplo para ver cómo inhabilitar la función:
const context = cast.framework.CastReceiverContext.getInstance();
let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = false;
context.start(castReceiverOptions);
Cómo informar problemas
Recomendamos a nuestros socios que informen los problemas que encuentren al jugar HLS contenido. Como se mencionó, MPL ya no recibirá actualizaciones críticas. Si corresponde problemas con la MPL, sigue los pasos que se indican en la sección Cómo habilitar de la guía para verificar si el cambio a Shaka Player desbloqueará tu problema. Sigue los pasos que se indican a continuación si el problema persiste o si experimentas un problema diferente al cambiar de reproductor.
- Intenta configurar el
shakaVersionen una o a una versión diferente de la rama para resolver el problema. Por ejemplo, si el problema se experimenta en la rama4.3, intenta configurarla en la versión más reciente en las versiones4.2.xo3.3.x. Consulta la versión de Shaka Player notas para encontrar con las actualizaciones más relevantes. Ten en cuenta que La API deshakaVersiontiene un valor mínimo y uno máximo una versión compatible, como se detalla en la documentación de referencia. Si observas hay una regresión, informa el problema en el reproductor de Shaka rastreador de problemas. Cambia los parámetros de configuración del reproductor. Shaka Player es configurables a través del Objeto
PlayerConfiguration. La Web El SDK receptor define un conjunto de valores predeterminados y permite que las aplicaciones modificar esta configuración mediante PropiedadshakaConfigenPlaybackConfig. Se evalúa durante el tiempo de carga, cuando la instancia crear. Ver más enla configuración de la aplicación y de la aplicación. Predeterminado que establece el SDK del receptor web son los recomendados.
Consulta si el problema se informó en el Shaka Player issuetracker o Cast seguimiento de problemas. Comenta el error y agrega información relevante información adicional si también describe tu problema.
Prueba tu contenido en el sitio de demostración del reproductor Shaka. Si Si el problema se reproduce en el sitio de demostración de su contenido, presente una error con el proyecto del reproductor de Shaka.
Informa un error en la Herramienta de seguimiento de errores de Cast si tienen un problema exclusivo de Shaka Player en los extremos de transmisión.
Preguntas frecuentes
Cambiar de jugador puede generar muchas preguntas. A continuación, encontrarás los respuestas a preguntas comunes para guiarte en el proceso de migración.
¿Debo migrar a Shaka Player?
Recomendamos a nuestros socios que usen contenido HLS para que comiencen el proceso de migración, ya que lo antes posible. Como resultado, tu app proporcionará una transmisión más sólida para los usuarios. Más beneficios se describen en el reproductor de Shaka beneficios de esta guía. Los socios deben verificar que sus aplicaciones funcionen correctamente con Shaka Player para garantizar un transición. Algunas apps pueden estar en riesgo cuando el SDK del receptor web pasa a un modelo de inhabilitación si los socios no realizan la verificación. que su contenido se reproduzca correctamente en Shaka Player con anticipación.
¿Cuál es el nivel de esfuerzo esperado al cambiar de jugador?
Los socios deberán probar su aplicación y contenido en un entorno de pruebas. para garantizar que la experiencia del usuario sea similar o mejorada en comparación con HLS. Para ello, los socios deberán habilitar la función en un en un entorno interno y probar minuciosamente que su contenido pueda reproducirse con Shaka Player. Consulta validación de contenido para obtener más información en qué aspectos de tu contenido debes enfocarte. Una vez validados, los socios deberán y agregar la marca para habilitar la versión en el entorno de producción de su aplicación aprovechar los beneficios que ofrece Shaka Player. A grandes rasgos, son cambios mínimos en el desarrollo de software y, principalmente, requisitos de QA para nuestros y socios migrarán correctamente.
Mi aplicación pronto usará HLS para transmitir contenido. ¿Qué debo hacer?
Las nuevas integraciones deben habilitar el uso de Shaka Player para la reproducción. Tu su aplicación será mejor a largo plazo y también tardará aprovechar las nuevas funciones de HLS y las mejoras en el rendimiento. Si el nuevo si hay problemas en la integración, informa el error lo antes posible para darle al el equipo de ingeniería de software el tiempo suficiente para resolver el problema. Si tu aplicación tiene un elemento fecha límite ajustada, incluye esa información en el informe de errores, así como el impacto priorizar en consecuencia. Nuestro equipo de ingeniería trabajará para brindar una solución para brindar asistencia adecuada a tus usuarios.
Mi contenido o app no funciona con Shaka Player, ¿qué debo hacer?
Debes informar un error con el proyecto del reproductor de Shaka o con el proyecto de transmisión. (consulta Cómo informar problemas). El equipo de ingeniería del SDK de Cast supervisar estos rastreadores y trabajará con usted para resolver cualquier problema a mano. Cuanto antes se detecten estos problemas, más tiempo tendrán para entregar una solución.
La MPL ya no recibe actualizaciones críticas, ¿qué significa eso exactamente?
Históricamente, la MPL ha adoptado nuevas funciones HLS y ha corregido los principales errores a través de actualizaciones críticas. Ahora que MPL ya no los recibirá, el nuevo servicio HLS funciones no se agregarán al reproductor. Asimismo, los problemas informados para HLS la reproducción en MPL no se corregirá en MPL. Estos problemas deberían resolverse antes del cambiando a Shaka Player para la reproducción. Si los problemas persisten, se mostrará El error debe presentarse con los problemas relevantes que se presentan en Shaka. Jugador. Los socios deberían dejar de usar MPL.
Mi contenido usa el protocolo Smooth Streaming, ¿cómo afecta esto a mi aplicación?
Los objetos binarios de la MPL seguirán alojados y tu receptor podrá acceder a ellos. y mantener la integridad de su aplicación. Sin embargo, las solicitudes de funciones relacionadas con Smooth Streaming y los errores correcciones de errores no serán compatibles No se actualizó la especificación de Smooth Streaming en en cuatro años. Recomendamos migrar el contenido para usar DASH o HLS protocolo de transmisión continua para seguir recibiendo actualizaciones de rendimiento y asistencia para tu contenido.
Mi contenido no usa los protocolos HLS o Smooth Stream, ¿cómo afecta esto a mi app?
Si tu biblioteca de contenido no usa ninguno de estos protocolos de transmisión, no te afectará la migración. No se requieren cambios en tu y mantener la integridad de su aplicación.