HLS bei der Migration von Shaka-Spielern

Übersicht

Das Cast Web Receiver SDK unterstützt die Wiedergabe von Inhalten über verschiedene Web- Streamingprotokolle. Basierend auf den verwendet, lädt das SDK einen Player, um die Wiedergabe des Inhalts zu verarbeiten. Im bei HLS-Inhalten, wird die Media Player Library (MPL) geladen. Im Fall von DASH-Content, der Shaka Player ist geladen.

Künftig sind die Entwicklerteams von Cast SDK und Shaka Player Konsolidierung der Bemühungen zur verstärkten Unterstützung der Wiedergabe von HLS-Inhalten auf Shaka Spieler. MPL erhält keine wichtigen Updates mehr. Wir empfehlen Ihnen, , um Shaka Player für die Wiedergabe von HLS-Inhalten Ihrer Anwendung zu verwenden.

Shaka Player-Vorteile

Bei einem Spielerwechsel profitieren Anwendungen von folgenden Vorteilen:

• Robustere Streamingsitzungen für Nutzer mit verbesserter Ladezeit Störungen und Latenz.
• Kontinuierliche Einführung der neuesten HLS-Funktionen.
• Klarere Ursachenanalyse für Player-Inhalte Kompatibilitätsprobleme aufgrund der Open-Source-Art von Shaka Player.
• Mithilfe der Open-Source-Player-Codebasis können Partner beteiligt am Shaka Player Project.
• Deutlich schnellere Produktion von Funktionen und Fehlerkorrekturen: Veröffentlichung von Shaka Player Schrittfrequenz: häufig und unabhängig von den Releases des Web Receiver SDK.
• Mehr Kontrolle über die Wiedergabeumgebung shakaVersion API
• Bessere Unterstützung bei der Wiedergabe durch Google dank Entwicklerressourcen auf der HLS-Wiedergabe im Shaka Player, wie im roadmap erstellen.

Zeitachse

Das Web Receiver SDK wird auf die Verwendung des Shaka Players als Standardplayer umgestellt für die Wiedergabe von HLS-Inhalten. Dies erfolgt schrittweise, um die Partner bei der Migration unterstützen.

Phase	Startdatum	Übersicht
1	Okt. 2022	Im Cast Web Receiver SDK werden APIs eingeführt, die für die Wiedergabe von HLS-Inhalten im Shaka Player aktiviert werden können.
2	2. Halbjahr 2024	Das Cast Web Receiver SDK ändert den Standardplayer für die Wiedergabe von HLS-Inhalten in den Shaka Player.

Die Entwicklungsteams des Web Receiver SDK verfolgen einen leistungsorientierten Ansatz und geht erst dann in die nächste Phase über, wenn Shaka Player mit der Basisleistung von MPL. Diese Änderungen werden im cast-sdk-announcements Google-Gruppe und aktualisiert in dieses Leitfadens.

Aktivieren

Ab CAF-Version 3.0.0105 gibt es eine Anwendungsebene Konfiguration für die Aktivierung des Shaka Players für die HLS-Wiedergabe. Diese Version Außerdem wird eine API eingeführt, mit der Sie aus einer Reihe unterstützter Shaka Player-Versionen auswählen können. geladen werden. Diese Flags werden in der CastReceiverOptions-Klasse durch die useShakaForHls und shakaVersion-Properties und werden ausgewertet, CastReceiverContext wird gestartet. Jede Anwendung, die Shaka für HLS aktiviert sollte mindestens 4.3.4 als Shaka Player-Version festlegen, um die neuesten HLS-Verbesserungen. Verwenden Sie dazu das folgende Code-Snippet:

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

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

context.start(castReceiverOptions);

Hinweis: Wenn diese Eigenschaft festgelegt ist, wird die Shaka Player-Version durch die Eigenschaft shakaVersion angepinnt. Dieses überschreibt den vom Web Receiver SDK definierten Standardwert. Wir empfehlen, Entfernen des Attributs shakaVersion, sobald die Standardversion des Shaka Players als die von Ihnen festgelegte Version. So bleibt Ihre Anwendung auf dem neuesten Stand mit den neuesten Änderungen am Web Receiver SDK. Änderungen am Standard-Shaka-Player Version finden Sie in den Versionshinweisen und die über die Google-Gruppe „cast-sdk-announcements“.

Inhalte validieren

Partner sollten die Wiedergabe ihrer Inhalte im Shaka Player vor der Aktivierung validieren. um Shaka Player in ihrer Produktions-App zu verwenden. Wir empfehlen, für jede der folgenden Variationen in deinem Content:

• Streamtypen: LIVE oder VOD
• Containerformate: TS, MP4 oder Elementarstreams
• Inhalte mit Diskontinuitäten oder eingebetteten Anzeigen
• Wiedergabe auf den folgenden Gerätetypen: Smart Displays, Chromecast-Dongles, Android TV-Geräte, Fernseher mit integrierter Chromecast-Technologie, intelligente Lautsprecher

Wenn Sie Fehler oder unerwartetes Verhalten feststellen, melden Sie den Fehler. Sobald Sie überprüft haben, dass keine kritischen Wiedergabefehler vorliegen, Inhalte in Ihre Produktionsumgebung übertragen.

Deaktivieren

Das Web Receiver SDK wird auf ein Opt-out-Modell für Shaka Player HLS umgestellt die Wiedergabe von Inhalten gemäß dem Zeitplan erfolgt. Die Eigenschaft useShakaForHls ändert den Standardwert von false bis true. Dann können Anwendungen MPL für HLS verwenden. Wiedergabe, indem du diese Eigenschaft manuell auf false setzt. Wenn der Parameter CastReceiverContext wurde gestartet, das Web Receiver SDK wird wieder geladen MPL anstelle von Shaka Player. Im folgenden Beispiel sehen Sie, wie Sie die automatische Migration 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, Probleme zu melden, die beim Abspielen von HLS auftreten. Inhalte. Wie bereits erwähnt, erhält MPL keine wichtigen Updates mehr. Falls vorhanden Probleme mit dem MPL auftreten, folgen Sie den Schritten in der Anleitung zum Aktivieren der Anleitung, um zu überprüfen, ob durch den Wechsel zu Shaka Player die Blockierung Problem. Führen Sie die folgenden Schritte aus, wenn das Problem weiterhin besteht oder wenn ein anderes Problem beim Spielerwechsel.

1. Setzen Sie shakaVersion auf einen eine andere Zweigversion, um das Problem zu beheben. Wenn beispielsweise das Problem im Zweig 4.3 auftritt, versuchen Sie, ihn auf den neuesten Release in Version 4.2.x oder 3.3.x. Shaka Player-Veröffentlichung überprüfen Notizen, um die Releases mit den relevantesten Updates. Das Feld shakaVersion API hat einen Mindest- und Höchstwert unterstützten Version, wie in der Referenzdokumentation beschrieben. Wenn Sie wenn es zu einer Regression kommt, melden Sie das Problem im Shaka Player Issue Tracker

2. Versuche, die Konfigurationsparameter des Players zu ändern. Shaka Player ist Konfiguration über die PlayerConfiguration-Objekt. Das Web Das Receiver SDK definiert eine Reihe von Standardwerten und ermöglicht Anwendungen, können Sie diese Konfiguration Property shakaConfig in PlaybackConfig -Objekt enthält. Dies wird während der Ladezeit ausgewertet, wenn die Player-Instanz erstellt. Weitere Informationen unter

   Anwendungskonfiguration und Optionen. Standardeinstellung vom Web Receiver SDK festgelegte Werte sind die empfohlenen Werte.

3. Prüfen Sie im Problemverfolgung des Shaka-Players oder Cast Issuetracker Kommentieren Sie den Fehler und fügen Sie relevante Informationen hinzu. falls es auch Ihr Problem beschreibt.

4. Teste deine Inhalte auf der Shaka Player-Demowebsite. Wenn Sie stellen Sie fest, dass das Problem auf der Demo-Website für Ihre Inhalte reproduziert wird, reichen Sie einen Bug mit dem Shaka Player-Projekt.

5. Melden Sie Fehler im Problem-Tracker für Google Cast, wenn Sie haben ein spezielles Problem für Shaka Player auf Cast-Endpunkten.

Häufig gestellte Fragen

Der Wechsel der Spieler kann viele Fragen aufwerfen. Nachfolgend finden Sie die Antworten auf häufig gestellte Fragen, um Sie durch den Migrationsprozess zu führen.

Soll ich zum Shaka Player migrieren?

Wir empfehlen unseren Partnern, die HLS-Inhalte verwenden, den Migrationsprozess so schnell wie möglich. Dadurch bietet Ihre App ein robusteres Streaming eine positive Nutzererfahrung bieten. Weitere Vorteile findest du im Shaka Player. dieses Leitfadens. Partner sollten Ihre Identität bestätigen dass seine Apps ordnungsgemäß funktionieren, indem Sie Shaka Player verwenden, um eine reibungslose zu übertragen. Bei einigen Apps besteht unter Umständen ein Risiko, wenn das Web Receiver SDK wird auf auf ein Opt-out-Modell umgestellt, wenn Partner nicht bestätigen damit ihre Inhalte im Shaka Player korrekt wiedergegeben werden.

Mit welchem Aufwand wird beim Spielerwechsel erwartet?

Partner müssen ihre Anwendung und Inhalte in einer Testumgebung testen. damit die Nutzererfahrung im Vergleich zu HLS ähnelt oder verbessert wird. Dazu müssen Partner die Funktion in einem internen Umgebung zu testen und zu testen, ob die Inhalte mit Shaka Player. Weitere Informationen finden Sie unter Inhalte überprüfen. auf welche Aspekte Ihrer Inhalte Sie sich konzentrieren sollten. Nach der Validierung müssen die Partner das Flag hinzufügen, um sie in ihrer Produktionsumgebung zu aktivieren, und nutzt die Vorteile von Shaka Player. Ganz allgemein mit minimalen Änderungen an der Softwareentwicklung und meist der Qualitätssicherung für unsere Partner migrieren.

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

Bei neuen Integrationen sollte die Verwendung des Shaka Players für die Wiedergabe aktiviert werden. Ihr langfristig besser unterstützt und auch von den neuen HLS-Funktionen und Leistungsverbesserungen zu profitieren. Wenn Ihr neuer dass bei der Integration Probleme auftreten, melde den Fehler so schnell wie möglich, Engineering-Team genug Zeit, um das Problem zu lösen. Wenn Ihre Anwendung über eine Frist einhalten, sollten Sie diese Informationen in den Fehlerbericht aufnehmen und die Auswirkungen entsprechend zu priorisieren. Unser Entwicklerteam wird daran arbeiten, eine Lösung zu finden. um Ihre Nutzenden angemessen zu unterstützen.

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

Du solltest entweder beim Shaka Player Project oder beim Cast-Projekt einen Fehler melden (siehe Probleme melden). Das Entwicklungsteam des Cast SDK arbeitet diese Tracker überwachen und mit Ihnen zusammenarbeiten, um eventuelle Probleme zu beheben. Je früher diese Probleme erkannt werden, desto mehr Zeit bleibt ihnen eine Lösung zu finden.

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

In der Vergangenheit hat MPL neue HLS-Funktionen übernommen und schwerwiegende Fehler wichtige Updates zu erhalten. Da MPL sie nicht mehr erhält, werden dem Player keine Funktionen hinzugefügt. Für HLS gemeldete Probleme Wiedergabe auf MPL wird in MPL nicht behoben. Diese Probleme sollten behoben werden, für die Wiedergabe zu Shaka Player wechseln. Wenn die Probleme weiterhin bestehen, bug sollte mit den relevanten Problemen gemeldet werden, denen Shaka gegenübersteht. Spieler. Partner sollten auf MPL verzichten.

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

Die MPL-Binärprogramme werden weiterhin gehostet und der Empfänger kann weiterhin darauf zugreifen . Alle Funktionsanfragen im Zusammenhang mit Smooth Streaming sowie werden nicht unterstützt, da die Smooth Streaming-Spezifikation wurde nicht aktualisiert in über einen Zeitraum von vier Jahren. Wir empfehlen Ihnen, Ihren Content zur Verwendung von DASH oder HLS zu migrieren Streaming-Protokoll weiter Leistungsaktualisierungen und Unterstützung für für Ihre Inhalte.

Meine Inhalte verwenden nicht die HLS- oder Smooth Stream-Protokolle. Wie wirkt sich das auf meine Anwendung aus?

Wenn deine Inhaltsbibliothek keines dieser Streaming-Protokolle verwendet, sind Sie von der Migration nicht betroffen. Es sind keine Änderungen an Ihrem .