Migracja HLS do odtwarzacza Shaka

Omówienie

SDK Cast Web Receiver obsługuje odtwarzanie treści na różnych stronach protokoły strumieniowego przesyłania danych. Na podstawie pakiet SDK wczytuje odtwarzacz, aby umożliwić odtwarzanie treści. W w przypadku treści HLS, zostanie wczytana biblioteka odtwarzacza Media Player (MPL). W przypadku Zawartość DASH, Odtwarzacz Shaka wczytano.

W przyszłości zespoły inżynierów Cast SDK i Shaka Player konsolidacja wysiłków na rzecz zwiększenia obsługi odtwarzania treści HLS w Shaka Odtwarzacz. MPL nie będzie już otrzymywać krytycznych aktualizacji. Zalecamy , aby używać odtwarzacza Shaka do odtwarzania treści HLS w aplikacji.

Korzyści, jakie daje aplikacja Shaka Player

Dzięki zmianie odtwarzacza aplikacje mają następujące zalety:

  • Bardziej niezawodne sesje strumieniowania dla użytkowników i krótszy czas wczytywania błędów i opóźnień.
  • Dalsze wdrażanie najnowszych funkcji HLS.
  • Bardziej przejrzyste analizy głównych przyczyn w przypadku treści graczy problemy ze zgodnością ze względu na charakter open source programu Shaka Player.
  • Baza kodu odtwarzaczy typu open source umożliwia partnerom wziąć wkład w projekt Shaka Player Project.
  • Znaczne skrócenie czasu wprowadzania funkcji i poprawek błędów na etap produkcyjny Premiera aplikacji Shaka Player kadencja jest częsta i niezależnie od wersji pakietu Web Receiver SDK.
  • Większa kontrola nad środowiskiem odtwarzania zapewniana przez Interfejs API shakaVersion.
  • Zwiększona obsługa odtwarzania od Google dzięki zasobom technicznym i koncentruje się na odtwarzaniu HLS w odtwarzaczu Shaka, jak widać na ekranie.

Oś czasu

W pakiecie SDK Web Receiver będzie używany odtwarzacz Shaka Player jako domyślny do odtwarzania treści HLS. Będzie to realizowane stopniowo, zgodnie z z partnerami podczas migracji.

Faza Data rozpoczęcia Omówienie
1 październik 2022 Pakiet Cast Web Receiver SDK wprowadza interfejsy API umożliwiające wyrażenie zgody na odtwarzanie treści HLS w odtwarzaczu Shaka.
2 II poł. 2024 roku Pakiet Cast Web Receiver SDK zmienia domyślny odtwarzacz na platformę Shaka Player służący do odtwarzania treści HLS.

Zespoły inżynierów pakietu Web Receiver SDK stosują podejście ukierunkowane na wydajność i przejdzie do kolejnej fazy dopiero wtedy, gdy gra Shaka jest włączona do wartości bazowej dla MPL. Ogłosimy te zmiany na cast-sdk-announcements google group i zaktualizowane w w tym przewodniku.

Włącz

Począwszy od CAF w wersji 3.0.0105, istnieje poziom aplikacji i wyrazić zgodę na używanie odtwarzacza Shaka do odtwarzania HLS. Ta wersja wprowadziliśmy też interfejs API umożliwiający wybór spośród obsługiwanych wersji odtwarzacza Shaka, . Te flagi znajdują się w CastReceiverOptions w ramach useShakaForHls i shakaVersion i są oceniane, gdy Uruchomiono CastReceiverContext. Każda aplikacja wyrażająca zgodę na Shaka na potrzeby HLS należy ustawić aplikację Shaka Player w wersji co najmniej 4.3.4, aby korzystać najnowszych ulepszeń HLS. Aby to zrobić, postępuj zgodnie z poniższym fragmentem kodu:

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

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

context.start(castReceiverOptions);

Zweryfikuj treści

Partnerzy powinni przed dokonaniem wyboru sprawdzić poprawność odtwarzania treści w odtwarzaczu Shaka. korzystać z aplikacji Shaka Player w wersji produkcyjnej. Zalecamy testowanie każdej z tych wartości odmiany Twoich treści wymienione poniżej:

  • Typy transmisji: NA ŻYWO lub VOD
  • Formaty kontenerów: TS, MP4 lub strumienie podstawowe
  • Treści z nieciągłościami lub umieszczone reklamy
  • Odtwarzanie na tych typach urządzeń: inteligentne ekrany, wtyczki do Chromecasta, Urządzenia z Androidem TV, telewizory z wbudowanym Chromecastem, inteligentne głośniki

Jeśli znajdziesz błędy lub nieoczekiwane działanie, zgłoś błąd. Po potwierdzeniu, że w filmie nie występują krytyczne błędy odtwarzania, wprowadź zmiany do środowiska produkcyjnego.

Zrezygnuj

Pakiet Web Receiver SDK zostanie przeniesiony na model rezygnacji w przypadku HLS odtwarzacza Shaka odtwarzania treści zgodnie z osią czasu. Obiekt useShakaForHls zmieni swoją wartość domyślną od false do true. Obecnie w aplikacjach można używać MPL na potrzeby HLS odtwarzania przez ręczne ustawienie tej właściwości na false. Gdy Uruchomiono CastReceiverContext, pakiet SDK odbiornika internetowego powróci do wczytywania MPL zamiast Shaka Player. Z tego przykładu dowiesz się, jak zrezygnować:

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

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

context.start(castReceiverOptions);

Zgłaszanie problemów

Zachęcamy naszych partnerów do zgłaszania wszelkich problemów, które znajdą podczas odtwarzania HLS treści. Jak już wspomnieliśmy, MPL nie będzie już otrzymywać krytycznych aktualizacji. Jeśli tak, w przypadku MPL, wykonaj czynności opisane w artykule na temat akceptacji w przewodniku, aby sprawdzić, czy przejście na aplikację Shaka Player odblokuje Google Cloud. Wykonaj te czynności, jeśli problem nadal występuje lub występuje inny problem przy zmianie odtwarzacza.

  1. Spróbuj ustawić shakaVersion na użyj innej wersji gałęzi, aby rozwiązać problem. Jeśli na przykład problem w gałęzi 4.3, spróbuj ustawić ją do najnowszej wersji w w wersji 4.2.x lub 3.3.x. Sprawdź wersję odtwarzacza Shaka Play notatki, aby znaleźć z najtrafniejszymi aktualizacjami. Pamiętaj, że parametr Interfejs API shakaVersion ma minimalną i maksymalną wartość zgodnie z opisem w dokumentacji referencyjnej. Jeśli zauważysz że wystąpiła regresja, zgłoś problem w aplikacji Shaka Player .
  2. Spróbuj zmienić parametry konfiguracji odtwarzacza. Odtwarzacz Shaka które można skonfigurować za pomocą PlayerConfiguration. Sieć SDK odbiornika definiuje zestaw wartości domyślnych i umożliwia aplikacjom modyfikuj tę konfigurację za pomocą Właściwość shakaConfig w obszarze PlaybackConfig obiektu. Jest to oceniane w czasie wczytywania, gdy instancja odtwarzacza jest Utworzono. Zobacz więcej w:

    konfiguracji aplikacji . Domyślny wartości ustawione przez pakiet Web Receiver SDK są zalecanymi wartościami.

  3. Sprawdź, czy problem został zgłoszony Narzędzie do śledzenia problemów z odtwarzaczem Shahaka Player lub funkcję Cast narzędzie do śledzenia problemów. Napisz w komentarzu do błędu i dodaj ewentualne które opisują Twój problem.

  4. Przetestuj swoje treści na stronie demonstracyjnej aplikacji Shaka Player. Jeśli że problem powtarza się w witrynie demonstracyjnej dla Twoich treści, prześlij plik z projektem Shaka Player.

  5. Zgłoś błąd w narzędziu Cast Issue Tracker, jeśli: występują w punktach końcowych przesyłania problemy występujące tylko w odtwarzaczu Shaka.

Najczęstsze pytania

Zmiana gracza może wywołać wiele pytań. Poniżej znajdziesz odpowiedzi na najczęstsze pytania, które pomogą Ci w przeprowadzeniu migracji.

Czy mam przejść na aplikację Shaka Player?

Zachęcamy naszych partnerów korzystających z treści HLS, aby rozpoczęli proces migracji. jak najszybciej. Dzięki temu aplikacja zapewni bardziej niezawodne przesyłanie strumieniowe z myślą o użytkownikach. Więcej korzyści znajdziesz w aplikacji Shaka Player korzyści w tym przewodniku. Partnerzy powinni przejść weryfikację ich prawidłowe działanie za pomocą odtwarzacza Shaka Player przejścia. Niektóre aplikacje mogą być zagrożone, gdy pakiet SDK odbiornika internetowego przechodzi na model rezygnacji, jeśli partnerzy nie przejdą weryfikacji; aby można było z wyprzedzeniem odtworzyć ich treści w odtwarzaczu Shaka.

Jaki jest oczekiwany poziom wysiłku przy zmianie graczy?

Partnerzy muszą przetestować swoją aplikację i treści w środowisku testowym aby wrażenia użytkowników były podobne lub lepsze w porównaniu z HLS. Aby to zrobić, partnerzy będą musieli wyrazić zgodę na tę funkcję na i dokładnie sprawdzić, czy treści na nim mogą być odtwarzane. za pomocą aplikacji Shaka Player. Więcej informacji znajdziesz w artykule na temat weryfikowania treści. na których aspektach treści się skupić. Po weryfikacji partnerzy będą musieli dodać flagę do wyrażenia zgody w produkcyjnym środowisku aplikacji, aby rozpocząć dzięki możliwościom oferowanym przez aplikację Shaka Player. Jest to bardzo ważne, to głównie minimalne zmiany w oprogramowaniu i głównie związane z kontrolą jakości partnerów, którzy mogli przeprowadzić migrację.

Moja aplikacja wkrótce będzie używać HLS do strumieniowego przesyłania treści. Co mam zrobić?

W przypadku nowych integracji należy włączyć używanie aplikacji Shaka Player do odtwarzania. Twoje może zapewnić lepsze wsparcie w dłuższej perspektywie i dzięki nowym funkcjom HLS i ulepszeniom wydajności. Jeśli Twój nowy występują problemy z integracją, zgłoś błąd jak najszybciej, aby zespół inżynierów będzie mieć wystarczająco dużo czasu na rozwiązanie problemu. Jeśli Twoja aplikacja ma doraźnego terminu, uwzględnij te informacje w raporcie o błędzie, a także wpływ i ustalić odpowiedni priorytet. Nasz zespół inżynierów zaproponuje rozwiązanie odpowiednio obsługiwać użytkowników.

Moja treść lub aplikacja nie działa z odtwarzaczem Shaka. Co teraz?

Błąd możesz zgłosić w projekcie Shaka Player lub Cast. (zobacz Zgłaszanie problemów). Zespół inżynierów Cast SDK aktywnie pracuje monitorują urządzenia śledzące i będą współpracować z Tobą przy rozwiązywaniu ewentualnych problemów. Im wcześniej te problemy zostaną wykryte, tym więcej czasu będzie trzeba na wykonanie tych czynności i wprowadzić poprawki.

MPL nie otrzymuje już krytycznych aktualizacji. Co to dokładnie oznacza?

W przeszłości MPL stosowało nowe funkcje HLS i naprawiła poważne błędy, krytycznych aktualizacji. Ponieważ MPL nie będzie już ich otrzymywać, nowy HLS funkcje nie będą dodawane do odtwarzacza. Podobnie wszystkie zgłoszone problemy z HLS w MPL nie można naprawić błędów. Te problemy należy rozwiązać do przełączając się na aplikację Shaka Player. Jeśli problemy nie ustąpią, bug należy zgłosić razem z problemami, które napotkały w Shace. Odtwarzacz. Partnerzy powinni zrezygnować z MPL.

Moje treści korzystają z protokołu Smooth Streaming. Jak wpłynie to na moją aplikację?

Pliki binarne MPL nadal będą hostowane i dostępne dla odbiorcy aplikacji. Jednak wszelkie prośby o dodanie funkcji oraz błędy w tej funkcji nie będą obsługiwane, ponieważ Specyfikacja płynnego strumieniowego przesyłania danych nie została zaktualizowana w przez ponad 4 lata. Zalecamy migrację treści do DASH lub HLS. streaming, aby dalej otrzymywać aktualizacje dotyczące wydajności swoje treści.

Moja treść nie korzysta z protokołów HLS ani Smooth Stream. Jak to wpłynie na moją aplikację?

Jeśli Twoja biblioteka treści nie korzysta z żadnego z tych protokołów, migracja nie wpłynie na Twoje konto. Nie musisz wprowadzać żadnych zmian w aplikacji.