HLS bei der Migration von Shaka-Spielern

Übersicht

Das Cast Web Receiver SDK unterstützt die Wiedergabe von Inhalten mit verschiedenen Web streamingprotokollen. Je nach verwendetem Protokoll lädt das SDK einen Player, um die Wiedergabe der Inhalte zu verarbeiten. Bei HLS-Inhalten wird die Mediaplayer Library (MPL) geladen. Bei DASH-Inhalten wird Shaka Player geladen.

Die Entwicklerteams des Cast SDK und des Shaka Player arbeiten künftig zusammen, um die Unterstützung für die Wiedergabe von HLS-Inhalten im Shaka Player zu verbessern. MPL erhält keine kritischen Updates mehr. Wir empfehlen Ihnen, Shaka Player für die Wiedergabe von HLS-Inhalten in Ihrer Anwendung zu verwenden.

Vorteile von Shaka Player

Durch den Wechsel des Players profitieren Anwendungen von folgenden Vorteilen:

  • Robustere Streaming-Sitzungen für Nutzer mit Verbesserungen bei Fehlern bei der Ladezeit und der Latenz.
  • Kontinuierliche Einführung der neuesten HLS-Funktionen.
  • Bessere Klarheit bei der Ursachenanalyse für Kompatibilitätsprobleme zwischen Player und Inhalten aufgrund der Open-Source-Natur von Shaka Player.
  • Die Open-Source -Player-Codebasis ermöglicht es Partnern, zum Shaka Player-Projekt beizutragen.
  • Deutlich kürzere Zeit bis zur Bereitstellung von Funktionen und Fehlerbehebungen , da Shaka Player's Veröffentlichungs kadenz häufig ist und unabhängig von den Releases des Web Receiver SDK ist.
  • Bessere Kontrolle über die Wiedergabeumgebung durch die shakaVersion API.
  • Erweiterte Wiedergabeunterstützung durch Google mit technischen Ressourcen die auf die HLS-Wiedergabe im Shaka Player ausgerichtet sind, wie in der Roadmap zu sehen.

Zeitachse

Das Web Receiver SDK wird auf Shaka Player als Standardplayer für die Wiedergabe von HLS-Inhalten umgestellt. Dies erfolgt schrittweise, um Partner durch den Migrationsprozess zu führen.

Phase Startdatum Übersicht
1 Oktober 2022 Im Cast Web Receiver SDK wurden APIs eingeführt, mit denen Sie die Wiedergabe von HLS-Inhalten im Shaka Player aktivieren können.
2 18. Mai 2026 Im Cast Web Receiver SDK wurde Shaka Player als Standardplayer für die Wiedergabe von HLS-Inhalten festgelegt.

Die Entwicklerteams des Web Receiver SDK verfolgen einen leistungsbezogenen Ansatz und gehen erst dann zur nächsten Phase über, wenn die Leistung von Shaka Player mit der Baseline-Leistung von MPL vergleichbar ist. Diese Änderungen werden in der Google-Gruppe cast-sdk-announcements angekündigt und in diesem Leitfaden aktualisiert.

Aktivieren

Ab der CAF-Version 3.0.0105 gibt es eine Konfiguration auf Anwendungsebene, mit der Sie die Verwendung von Shaka Player für die HLS-Wiedergabe aktivieren können. In dieser Version wird auch eine API eingeführt, mit der Sie eine unterstützte Version von Shaka Player zum Laden auswählen können. Diese Flags werden in der CastReceiverOptions Klasse über die useShakaForHls und shakaVersion Properties bereitgestellt und ausgewertet, wenn die CastReceiverContext gestartet wird. Jede Anwendung, die Shaka Player für HLS verwendet, sollte eine Shaka Player-Version von mindestens 4.15.53 festlegen, um die neuesten HLS-Verbesserungen zu nutzen. Folgen Sie dem Code-Snippet unten, um die Funktion zu aktivieren:

const context = cast.framework.CastReceiverContext.getInstance();

let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = true;

context.start(castReceiverOptions);

Inhalt validieren

Partner sollten die Wiedergabe ihrer Inhalte im Shaka Player validieren, bevor sie die Verwendung von Shaka Player in ihrer Produktions-App aktivieren. Wir empfehlen, die folgenden Varianten Ihrer Inhalte zu testen:

  • Streamtypen: LIVE oder VOD
  • Containerformate: TS, MP4 oder Elementarstreams
  • Inhalte mit Unterbrechungen oder eingebetteten Anzeigen
  • Wiedergabe auf den folgenden Gerätetypen: Smart Displays, Google Cast-Dongles, Android TV-Geräte, Fernseher mit Google Cast, Smart Speaker

Wenn Sie Fehler oder unerwartetes Verhalten feststellen, melden Sie einen Fehler. Sobald Sie bestätigen können, dass es bei der Wiedergabe Ihrer Inhalte keine kritischen Fehler gibt, übertragen Sie die Änderungen in Ihre Produktionsumgebung.

Deaktivieren

Das Web Receiver SDK wird gemäß der Zeitachse auf ein Deaktivierungsmodell für die Wiedergabe von HLS Inhalten im Shaka Player umgestellt. Der Standardwert der Property useShakaForHls ändert sich von false in true. Zu diesem Zeitpunkt können Anwendungen MPL für die HLS-Wiedergabe verwenden, indem sie diese Property manuell auf false setzen. Wenn CastReceiverContext gestartet wird, lädt das Web Receiver SDK wieder MPL anstelle von Shaka Player. Im folgenden Beispiel sehen Sie, wie Sie die Funktion deaktivieren:

const context = cast.framework.CastReceiverContext.getInstance();

let castReceiverOptions = new cast.framework.CastReceiverOptions();
castReceiverOptions.useShakaForHls = false;

context.start(castReceiverOptions);

Probleme melden

Wir empfehlen unseren Partnern, alle Probleme zu melden, die bei der Wiedergabe von HLS-Inhalten auftreten. Wie bereits erwähnt, erhält MPL keine kritischen Updates mehr. Wenn Probleme mit MPL auftreten, folgen Sie der Anleitung im Abschnitt Aktivieren dieses Leitfadens, um zu prüfen, ob ein Wechsel zu Shaka Player Ihr Problem behebt. Folgen Sie der Anleitung unten, wenn das Problem weiterhin besteht oder wenn beim Wechsel des Players ein anderes Problem auftritt.

  1. Versuchen Sie, shakaVersion auf eine andere Branch-Version zu setzen, um das Problem zu beheben. Wenn das Problem beispielsweise im Branch 4.15 auftritt, setzen Sie es auf die neueste Version in einem anderen Branch. In den Shaka Player-Versions hinweisen finden Sie Releases mit den relevantesten Updates. Beachten Sie, dass die shakaVersion API eine minimale und maximale unterstützte Version hat, wie in der Referenzdokumentation beschrieben. Wenn Sie eine Regression feststellen, melden Sie das Problem im Shaka Player Issue Tracker.
  2. Versuchen Sie, die Konfigurationsparameter des Players zu ändern. Shaka Player kann über das PlayerConfiguration Objekt konfiguriert werden. Das Web Receiver SDK definiert eine Reihe von Standardwerten und ermöglicht Anwendungen, diese Konfiguration über die shakaConfig Property im PlaybackConfig Objekt zu ändern. Dies wird während der Ladezeit ausgewertet, wenn die Player-Instanz erstellt wird. Weitere Informationen finden Sie unter Anwendungskonfiguration und Optionen. Die vom Web Receiver SDK festgelegten Standardwerte sind die empfohlenen Werte.
  3. Prüfen Sie, ob das Problem im Shaka Player-Issue Tracker oder im Cast Issue Tracker gemeldet wurde. Kommentieren Sie den Fehler und fügen Sie alle relevanten Informationen hinzu, wenn er auch Ihr Problem beschreibt.
  4. Testen Sie Ihre Inhalte auf der Shaka Player-Demowebsite. Wenn das Problem auf der Demowebsite für Ihre Inhalte reproduziert wird, melden Sie einen Fehler beim Shaka Player-Projekt.
  5. Melden Sie einen Fehler im Cast-Issue Tracker , wenn Sie ein Problem haben, das nur bei Shaka Player auf Cast-Endpunkten auftritt.

Häufig gestellte Fragen

Der Wechsel des Players kann viele Fragen aufwerfen. Im Folgenden finden Sie Antworten auf die häufigsten Fragen, die Sie durch den Migrationsprozess führen sollen.

Sollte ich zu Shaka Player migrieren?

Wir empfehlen unseren Partnern, die HLS-Inhalte verwenden, so schnell wie möglich mit der Migration zu beginnen. Dadurch bietet Ihre App Ihren Nutzern ein robusteres Streaming-Erlebnis. Weitere Vorteile finden Sie im Abschnitt Vorteile von Shaka Player dieses Leitfadens. Partner sollten prüfen, ob ihre Apps mit Shaka Player ordnungsgemäß funktionieren, um einen reibungslosen Übergang zu gewährleisten. Bei einigen Apps besteht das Risiko, dass sie nicht mehr funktionieren, wenn das Web Receiver SDK auf ein Deaktivierungsmodell umgestellt wird, wenn Partner nicht rechtzeitig prüfen, ob ihre Inhalte im Shaka Player ordnungsgemäß wiedergegeben werden.

Wie viel Aufwand ist mit dem Wechsel des Players verbunden?

Partner müssen ihre Anwendung und ihre Inhalte in einer Testumgebung testen, um sicherzustellen, dass die Nutzererfahrung im Vergleich zu HLS ähnlich oder besser ist. Dazu müssen Partner die Funktion in einer internen Umgebung aktivieren und gründlich testen, ob ihre Inhalte mit Shaka Player wiedergegeben werden können. Unter Inhalte validieren finden Sie Details zu den Aspekten Ihrer Inhalte, auf die Sie sich konzentrieren sollten. Nach der Validierung müssen Partner das Flag zum Aktivieren in ihrer Produktionsanwendungsumgebung hinzufügen, um die Vorteile von Shaka Player zu nutzen. Im Großen und Ganzen sind nur minimale Änderungen an der Softwareentwicklung und hauptsächlich QA-Anforderungen für unsere Partner erforderlich, um die Migration erfolgreich durchzuführen.

Meine Anwendung verwendet bald HLS zum Streamen von Inhalten. Was soll ich tun?

Bei neuen Integrationen sollte die Wiedergabe mit Shaka Player aktiviert werden. Ihre Anwendung wird langfristig besser unterstützt und profitiert auch von den neuen HLS-Funktionen und Leistungsverbesserungen. Wenn bei Ihrer neuen Integration Probleme auftreten, melden Sie so schnell wie möglich einen Fehler, damit das Entwicklerteam genügend Zeit hat, das Problem zu beheben. Wenn Ihre Anwendung eine enge Frist hat, geben Sie diese Informationen im Fehlerbericht an und legen Sie die Priorität entsprechend fest. Unser Entwicklerteam arbeitet an einer Lösung, um Ihre Nutzer angemessen zu unterstützen.

Meine Inhalte oder meine App funktionieren nicht mit Shaka Player. Was soll ich tun?

Melden Sie einen Fehler entweder beim Shaka Player-Projekt oder beim Cast-Projekt (siehe Probleme melden). Das Entwicklerteam des Cast SDK beobachtet diese Tracker aktiv und arbeitet mit Ihnen zusammen, um alle Probleme zu beheben. Je früher diese Probleme erkannt werden, desto mehr Zeit haben sie, eine Lösung zu finden.

MPL erhält keine kritischen Updates mehr. Was bedeutet das genau?

Bisher wurden in MPL neue HLS-Funktionen eingeführt und wichtige Fehler durch kritische Updates behoben. Da MPL diese Updates nicht mehr erhält, werden dem Player keine neuen HLS-Funktionen hinzugefügt. Ebenso werden alle gemeldeten Probleme bei der HLS-Wiedergabe in MPL nicht behoben. Diese Probleme sollten durch den Wechsel zu Shaka Player für die Wiedergabe behoben werden. Wenn die Probleme weiterhin bestehen, sollte ein Fehler mit den entsprechenden Problemen gemeldet werden, die bei Shaka Player auftreten. Partner sollten MPL nicht mehr verwenden.

Meine Inhalte verwenden das Smooth Streaming-Protokoll. Wie wirkt sich das auf meine Anwendung aus?

Die MPL-Binärdateien werden weiterhin gehostet und sind für Ihre Receiver-Anwendung zugänglich. Funktionsanfragen und Fehlerbehebungen im Zusammenhang mit Smooth Streaming werden jedoch nicht unterstützt, da die Smooth Streaming-Spezifikation seit über vier Jahren nicht mehr aktualisiert wurde. Wir empfehlen, Ihre Inhalte auf das DASH- oder HLS-Streamingprotokoll zu migrieren, um weiterhin Leistungsupdates und Support für Ihre Inhalte zu erhalten.

Meine Inhalte verwenden nicht das HLS- oder Smooth Streaming-Protokoll. Wie wirkt sich das auf meine Anwendung aus?

Wenn in Ihrer Inhaltsbibliothek keines dieser Streamingprotokolle verwendet wird, hat die Migration keine Auswirkungen auf Sie. In Ihrer Anwendung sind keine Änderungen erforderlich.

Zurück
Hauptfunktionen
Weiter
Style den Player