Présentation
Le SDK Cast Web Receiver permet de lire du contenu à l'aide de plusieurs protocoles de streaming. D'après les le protocole utilisé, le SDK charge un lecteur pour gérer la lecture du contenu. Dans le cas d'un contenu HLS, la bibliothèque Media Player (MPL) est chargée. Dans le cas d'une le contenu DASH, Shaka Player est chargé.
Désormais, les équipes d'ingénieurs du SDK Cast et de Shaka Player nous concentrons nos efforts pour améliorer la compatibilité de la lecture de contenu HLS sur Shaka. Lecteur. MPL ne recevra plus les mises à jour critiques. Nous vous recommandons d'activer afin d'utiliser Shaka Player pour la lecture du contenu HLS de votre application.
Avantages de Shaka Player
Lorsqu'elles changent de mode de jeu, les applications bénéficient des avantages suivants:
- Sessions de streaming plus robustes pour les utilisateurs, avec des temps de chargement réduits les défaillances et la latence.
- Adoption continue des dernières fonctionnalités HLS.
- Clarification de l'analyse des causes fondamentales concernant les contenus générés par les joueurs problèmes de compatibilité dus à la nature Open Source de Shaka Player.
- Le codebase d'un lecteur Open Source permet aux partenaires contribuent au projet Shaka Player.
- Une réduction significative du délai de mise en production des fonctionnalités et de correction des bugs Sortie de Shaka Player d'entraînement est fréquente et indépendamment des versions du SDK Web Receiver.
- Un meilleur contrôle de l'environnement de lecture fourni par le
API
shakaVersion. - Meilleure assistance Google pour la lecture grâce à des ressources techniques axée sur la lecture HLS sur Shaka Player, comme illustré sur feuille de route.
Chronologie
Le SDK Web Receiver va passer à l'utilisation de Shaka Player comme lecteur par défaut pour la lecture de contenu HLS. Cela se fera en plusieurs phases afin de guider partenaires tout au long du processus de migration.
| Phase | Date de début | Présentation |
|---|---|---|
| 1 | Oct. 2022 | Le SDK Cast Web Receiver permet d'activer des API pour lire du contenu HLS sur Shaka Player. |
| 2 | 2e sem. 2024 | Le SDK Cast Web Receiver définit le lecteur par défaut sur Shaka Player pour la lecture de contenu HLS. |
Les équipes d'ingénieurs du SDK Web Receiver adoptent une approche axée sur les performances et ne passera à la phase suivante que lorsque les performances de Shaka Player seront aux performances de référence de la MPL. Ces modifications seront annoncées dans la cast-sdk-announcements google group et mis à jour dans ce guide.
Activer
À partir de la version 3.0.0105 du fichier CAF, il existe un niveau d'application
configuration pour accepter d'utiliser le lecteur Shaka pour la lecture HLS. Cette version
Ajout d'une API permettant de choisir parmi une gamme de versions compatibles de Shaka Player
à charger. Ces indicateurs sont fournis
CastReceiverOptions via la classe
useShakaForHls et
shakaVersion et sont évaluées lorsque
la CastReceiverContext est démarrée. Toute application qui accepte Shaka pour le HLS
doit définir une version de Shaka Player d'au moins 4.3.4 pour bénéficier des avantages
les dernières améliorations du HLS. Pour ce faire, suivez l'extrait de code ci-dessous:
const context = cast.framework.CastReceiverContext.getInstance();
let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = true;
context.start(castReceiverOptions);
Valider le contenu
Les partenaires doivent valider la lecture de leurs contenus sur le lecteur Shaka avant d'activer ou de désactiver le service. pour utiliser Shaka Player dans son application de production. Nous vous recommandons de tester les variantes de votre contenu répertoriées ci-dessous:
- Types de flux: EN DIRECT ou VOD
- Formats de conteneurs: flux TS, MP4 ou flux élémentaires
- Contenu avec des discontinuités ou des annonces intégrées
- Lecture sur les types d'appareils suivants: écrans connectés, dongles Chromecast Appareils Android TV, téléviseurs avec Chromecast Intégré, enceintes intelligentes
Si vous rencontrez des erreurs ou constatez un comportement inattendu, signalez un bug. Une fois que vous êtes en mesure de vérifier qu'il n'y a pas d'erreurs de lecture critiques dans votre et déployer les modifications dans votre environnement de production.
Désactiver
Le SDK Web Receiver va passer à un modèle de désactivation pour Shaka Player HLS
le contenu doit être lu conformément à la chronologie. La propriété
useShakaForHls va modifier sa valeur par défaut
de false à true. À ce stade, les applications peuvent choisir d'utiliser MPL pour HLS.
en définissant manuellement cette propriété sur false. Lorsque
CastReceiverContext démarre, le SDK Web Receiver se chargera à nouveau
MPL au lieu de Shaka Player. Reportez-vous à l'exemple ci-dessous pour savoir comment procéder:
const context = cast.framework.CastReceiverContext.getInstance();
let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = false;
context.start(castReceiverOptions);
Signaler des problèmes
Nous encourageons nos partenaires à signaler tout problème rencontré lors de la lecture du HLS. contenus. Comme indiqué précédemment, MPL ne recevra plus les mises à jour critiques. Le cas échéant rencontrés avec la MPL, suivez les étapes de la section Activer du guide pour vérifier si le passage à Shaka Player débloque problème. Suivez les étapes ci-dessous si le problème persiste ou si vous rencontrez un problème différent lors du changement de joueur.
- Essayez de définir
shakaVersionsur version de branche différente pour résoudre le problème. Par exemple, si le problème expérimenté sur la branche4.3, essayez de le définir sur la dernière version dans les versions4.2.xou3.3.x. Vérifiez la version du lecteur Shaka notes pour trouver avec les mises à jour les plus pertinentes. Notez que L'APIshakaVersioncomporte des valeurs minimale et maximale compatible, comme indiqué dans la documentation de référence. Si vous observez qu'il y a une régression, signalez le problème dans le Shaka Player Issue Tracker. Essayez de modifier les paramètres de configuration du lecteur. Shaka Player est configurable via objet
PlayerConfiguration. Le Web Le SDK récepteur définit un ensemble de valeurs par défaut et permet aux applications modifier cette configuration via la PropriétéshakaConfigdansPlaybackConfig. Cette valeur est évaluée au moment du chargement, lorsque l'instance du lecteur est créé. Plus de résultats dans la catégoriela configuration d'application options. La valeur par défaut définies par le SDK Web Receiver sont les valeurs recommandées.
Vérifiez si le problème a été signalé dans le Issue Tracker Shaka ou Cast Issue Tracker Commentez le bug et ajoutez toute information pertinente informations s'il décrit également votre problème.
Testez votre contenu sur le site de démonstration du lecteur Shaaka. Si vous constatez que le problème se reproduit sur le site de démonstration pour votre contenu, envoyez une d'erreur dans le projet Shaka Player.
Signalez un bug dans l'outil Cast Issue Tracker si vous ont un problème propre à Shaka Player sur les points de terminaison de diffusion.
Questions fréquentes
Changer de joueur peut soulever de nombreuses questions. Vous trouverez ci-dessous les des réponses aux questions les plus fréquentes pour vous guider tout au long du processus de migration.
Dois-je migrer vers Shaka Player ?
Nous encourageons nos partenaires utilisant du contenu HLS à commencer le processus de migration dès que possible. Votre application fournira donc un streaming plus stable pour vos utilisateurs. D'autres avantages sont décrits dans le Shaka Player avantages de ce guide. Validation requise par les partenaires que leurs applications fonctionnent correctement. Pour cela, elle utilise Shaka Player transition. Certaines applications présentent un risque lorsque le SDK Web Receiver effectue une transition vers un modèle de désactivation si les partenaires ne valident pas leur identité. que son contenu est lu correctement à l'avance sur Shaka Player.
Quel est le niveau d'effort attendu lorsque vous changez de joueur ?
Les partenaires doivent tester leur application et leur contenu dans un environnement de test pour garantir que l'expérience utilisateur est semblable ou améliorée par rapport au HLS. Pour ce faire, les partenaires devront activer la fonctionnalité dans une de leur environnement interne et de tester minutieusement le contenu avec Shaka Player. Consultez la section Validation de contenu pour en savoir plus sur sur les aspects de votre contenu sur lesquels vous concentrer. Une fois la validation effectuée, les partenaires devront ajouter l'indicateur d'activation dans son environnement d'application de production pour commencer en tirant parti des avantages proposés par Shaka Player. Globalement, Il s'agit de modifications minimes lors du développement logiciel et principalement d'exigences de contrôle qualité pour réussir la migration.
Mon application utilisera bientôt le HLS pour diffuser du contenu. Que dois-je faire ?
Dans les nouvelles intégrations, vous devez activer le lecteur Shaka pour la lecture. Votre application sera mieux prise en charge à long terme et des nouvelles fonctionnalités et des améliorations des performances du HLS. Si votre nouveau s'affiche, signalez le bug dès que possible pour que de temps à l'équipe d'ingénierie pour résoudre le problème. Si votre application dispose d'un un délai serré, incluez ces informations dans le rapport de bug ainsi que l'impact à prioriser en conséquence. Notre équipe d'ingénieurs s'efforcera de trouver une solution pour aider correctement vos utilisateurs.
Mon contenu ou mon application ne fonctionnent pas avec Shaka Player. Que dois-je faire ?
Vous devez signaler un bug dans le projet Lecteur Shaka ou Cast. Pour en savoir plus, consultez Signaler des problèmes. L'équipe d'ingénieurs du SDK Cast est active en surveillant ces traceurs et travaillera avec vous pour résoudre tout problème actuel. Plus tôt ces problèmes sont détectés, plus ils auront besoin de apporter une solution.
MPL ne reçoit plus de mises à jour critiques. Qu’est-ce que cela signifie exactement ?
Auparavant, MPL a adopté de nouvelles fonctionnalités HLS et corrigé des bugs majeurs via les mises à jour critiques. Maintenant que MPL ne les recevra plus, un nouveau HLS fonctionnalités ne seront pas ajoutées au lecteur. De même, tout problème signalé pour le HLS la lecture en MPL ne sera pas fixe en MPL. Ces problèmes devraient être résolus d'ici le je passe sur Shaka Player pour la lecture. Si le problème persiste, bug doit être signalé avec le ou les problèmes rencontrés sur Shaka. Lecteur. Les partenaires doivent cesser d'utiliser la MPL.
Mon contenu utilise le protocole de streaming fluide. Quel est l'impact sur mon application ?
Les binaires MPL seront toujours hébergés et accessibles à votre récepteur. application. Toutefois, les demandes de fonctionnalités liées à Smooth Streaming et les éventuels bugs ne seront pas pris en charge, car La spécification Smooth Streaming n'a pas été mise à jour dans sur quatre ans. Nous vous recommandons de migrer votre contenu pour utiliser DASH ou HLS. pour continuer à recevoir les mises à jour de performances et la compatibilité avec votre contenu.
Mon contenu n'utilise pas les protocoles HLS ou Smooth Stream. En quoi cela affectera-t-il mon application ?
Si votre bibliothèque de contenu n'utilise aucun de ces protocoles de streaming, alors vous ne serez pas concerné par la migration. Aucune modification n'est requise dans votre application.