Migracja HLS do odtwarzacza Shaka

Przegląd

Pakiet Cast Web Receiver SDK obsługuje odtwarzanie treści za pomocą kilku web protokołów strumieniowania. W zależności od używanego protokołu pakiet SDK wczytuje odtwarzacz, który obsługuje odtwarzanie treści. W przypadku treści HLS wczytywana jest biblioteka Odtwarzacza (MPL). W przypadku treści DASH wczytywany jestShaka Player.

Zespoły inżynierów pakietu Cast SDK i odtwarzacza Shaka Player łączą siły, aby zwiększyć obsługę odtwarzania treści HLS w odtwarzaczu Shaka Player. Biblioteka MPL nie będzie już otrzymywać ważnych aktualizacji. Zalecamy, aby włączyć korzystanie z odtwarzacza Shaka Player do odtwarzania treści HLS w aplikacji.

Zalety odtwarzacza Shaka Player

Dzięki zmianie odtwarzacza aplikacje mogą korzystać z tych zalet:

• Bardziej stabilne sesje strumieniowania dla użytkowników dzięki poprawie czasu wczytywania i opóźnienia.
• Dalsze wdrażanie najnowszych funkcji HLS.
• Większa przejrzystość analizy przyczyn źródłowych problemów ze zgodnością odtwarzacza i treści dzięki otwartemu kodowi źródłowemu odtwarzacza Shaka Player.
• Otwarta baza kodu odtwarzacza umożliwia partnerom współtworzenie projektu Shaka Player.
• Znaczne skrócenie czasu wdrażania funkcji i poprawek błędów dzięki częstym wersjom odtwarzacza Shaka Player, które są niezależne od wersji pakietu Web Receiver SDK.
• Większa kontrola nad środowiskiem odtwarzania dzięki interfejsowi API shakaVersion.
• Większa obsługa odtwarzania ze strony Google dzięki zasobom inżynieryjnym skupionym na odtwarzaniu HLS w odtwarzaczu Shaka Player, co widać w planie działań.

Oś czasu

Pakiet Web Receiver SDK zacznie używać odtwarzacza Shaka Player jako domyślnego odtwarzacza do odtwarzania treści HLS. Będzie to odbywać się etapami, aby pomóc partnerom w procesie migracji.

Zespoły inżynierów pakietu Web Receiver SDK stosują podejście oparte na wydajności i przejdą do następnego etapu dopiero wtedy, gdy wydajność odtwarzacza Shaka Player będzie porównywalna z wydajnością biblioteki MPL. Informacje o tych zmianach będą publikowane w grupie dyskusyjnej cast-sdk-announcements i aktualizowane w tym przewodniku.

Włącz

Od wersji CAF 3.0.0105 dostępna jest konfiguracja na poziomie aplikacji, która umożliwia włączenie korzystania z odtwarzacza Shaka Player do odtwarzania HLS. Ta wersja wprowadza też interfejs API, który umożliwia wybranie obsługiwanej wersji odtwarzacza Shaka Player do wczytania. Te flagi są dostępne w klasie CastReceiverOptions za pomocą właściwości useShakaForHls i shakaVersion i są sprawdzane podczas uruchamiania the CastReceiverContext. Każda aplikacja, która włącza odtwarzacz Shaka Player do odtwarzania HLS, powinna ustawić wersję odtwarzacza Shaka Player co najmniej 4.15.55, aby korzystać z najnowszych ulepszeń HLS. Aby włączyć tę funkcję, użyj tego fragmentu kodu:

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

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

context.start(castReceiverOptions);

Sprawdzanie treści

Zanim partnerzy włączą korzystanie z odtwarzacza Shaka Player w swojej aplikacji produkcyjnej, powinni sprawdzić odtwarzanie treści w odtwarzaczu Shaka Player. Zalecamy przetestowanie każdej z tych odmian treści:

• Typy strumieni: LIVE lub VOD.
• Formaty kontenerów: TS, MP4 lub strumienie elementarne.
• Treści z przerwami lub osadzonymi reklamami.
• Odtwarzanie na tych typach urządzeń: inteligentne wyświetlacze, klucze Google Cast, urządzenia Android TV, telewizory z Google Cast, inteligentne głośniki.

Jeśli znajdziesz jakieś błędy lub nieoczekiwane zachowania, zgłoś błąd. Gdy upewnisz się, że w Twoich treściach nie występują krytyczne błędy odtwarzania, wprowadź zmiany w środowisku produkcyjnym.

Zrezygnuj

Zgodnie z osią czasu pakiet Web Receiver SDK przejdzie na model rezygnacji z odtwarzania treści HLS w odtwarzaczu Shaka Player. Właściwość useShakaForHls zmieni swoją wartość domyślną z false na true. W tym czasie aplikacje mogą wybrać bibliotekę MPL do odtwarzania HLS, ręcznie ustawiając tę właściwość na false. Gdy uruchomiony zostanie CastReceiverContext, pakiet Web Receiver SDK zacznie wczytywać bibliotekę MPL zamiast odtwarzacza Shaka Player. Poniżej znajdziesz przykład, 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 partnerów do zgłaszania wszelkich problemów, które napotkają podczas odtwarzania treści HLS. Jak już wspomnieliśmy, biblioteka MPL nie będzie już otrzymywać ważnych aktualizacji. Jeśli wystąpią problemy z biblioteką MPL, wykonaj czynności opisane w sekcji Włącz , aby sprawdzić, czy przejście na odtwarzacz Shaka Player rozwiąże Twój problem. Jeśli problem nadal występuje lub podczas przełączania odtwarzaczy napotkasz inny problem, wykonaj te czynności:

1. Aby rozwiązać problem, spróbuj ustawić shakaVersion na inną wersję gałęzi. Jeśli na przykład problem występuje w gałęzi 4.15, spróbuj ustawić najnowszą wersję w innej gałęzi. Informacje o wersjach odtwarzacza Shaka Player release notes znajdziesz w informacjach o wersji, aby znaleźć wersje z najbardziej odpowiednimi aktualizacjami. Pamiętaj, że interfejs API shakaVersion ma minimalną i maksymalną obsługiwaną wersję, jak opisano w dokumentacji referencyjnej. Jeśli zauważysz regresję, zgłoś problem w narzędziu do śledzenia problemów odtwarzacza Shaka Player.
2. Spróbuj zmienić parametry konfiguracji odtwarzacza. Odtwarzacz Shaka Player można skonfigurować za pomocą PlayerConfiguration obiektu. Pakiet Web Receiver SDK definiuje zestaw wartości domyślnych i umożliwia aplikacjom modyfikowanie tej konfiguracji za pomocą właściwości shakaConfig w obiekcie PlaybackConfig. Jest to sprawdzane podczas wczytywania, gdy tworzona jest instancja odtwarzacza. Więcej informacji znajdziesz w sekcji Konfiguracja i opcje aplikacji. Wartości domyślne ustawione przez pakiet Web Receiver SDK są zalecanymi wartościami.
3. Sprawdź, czy problem został zgłoszony w narzędziu do śledzenia problemów odtwarzacza Shaka Player lub w narzędziu do śledzenia problemów z Castem. Jeśli problem opisuje też Twój problem, dodaj komentarz i wszelkie istotne informacje.
4. Przetestuj swoje treści w witrynie demonstracyjnej odtwarzacza Shaka Player. Jeśli okaże się, że problem występuje w witrynie demonstracyjnej w przypadku Twoich treści, zgłoś błąd w projekcie Shaka Player.
5. Zgłoś błąd w narzędziu do śledzenia problemów z Castem, jeśli masz problem, który występuje tylko w odtwarzaczu Shaka Player w punktach końcowych Cast.

Najczęstsze pytania

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

Czy mam przejść na odtwarzacz Shaka Player?

Zachęcamy partnerów korzystających z treści HLS do jak najszybszego rozpoczęcia procesu migracji. Dzięki temu Twoja aplikacja będzie zapewniać użytkownikom bardziej stabilne strumieniowanie. Więcej korzyści znajdziesz w sekcji Zalety odtwarzacza Shaka Player w tym przewodniku. Aby zapewnić płynne przejście, partnerzy powinni sprawdzić, czy ich aplikacje działają prawidłowo w odtwarzaczu Shaka Player. Jeśli partnerzy nie sprawdzą, czy ich treści działają prawidłowo w odtwarzaczu Shaka Player, niektóre aplikacje mogą być narażone na problemy, gdy pakiet Web Receiver SDK przejdzie na model rezygnacji.

Jakiego nakładu pracy wymaga zmiana odtwarzacza?

Partnerzy będą musieli przetestować swoją aplikację i treści w środowisku testowym, aby upewnić się, że komfort użytkowania jest podobny lub lepszy niż w przypadku HLS. Aby to zrobić, partnerzy będą musieli włączyć tę funkcję w środowisku wewnętrznym i dokładnie przetestować, czy ich treści mogą być odtwarzane za pomocą odtwarzacza Shaka Player. Więcej informacji o tym, na jakich aspektach treści należy się skupić, znajdziesz w sekcji Sprawdzanie treści. Po sprawdzeniu partnerzy będą musieli dodać flagę, aby włączyć tę funkcję w środowisku aplikacji produkcyjnej i zacząć korzystać z zalet odtwarzacza Shaka Player. Na wysokim poziomie partnerzy muszą wprowadzić minimalne zmiany w oprogramowaniu i spełnić głównie wymagania dotyczące kontroli jakości, aby pomyślnie przeprowadzić migrację.

Moja aplikacja wkrótce zacznie używać HLS do strumieniowania treści. Co mam zrobić?

Nowe integracje powinny włączyć korzystanie z odtwarzacza Shaka Player do odtwarzania. Dzięki temu Twoja aplikacja będzie lepiej obsługiwana w dłuższej perspektywie i będzie korzystać z nowych funkcji HLS oraz ulepszeń wydajności. Jeśli w nowej integracji występują problemy, jak najszybciej zgłoś błąd, aby zespół inżynierów miał wystarczająco dużo czasu na jego rozwiązanie. Jeśli Twoja aplikacja ma krótki termin, podaj te informacje w raporcie o błędach, a także wpływ na priorytety. Nasz zespół inżynierów postara się znaleźć rozwiązanie, które zapewni odpowiednią obsługę Twoich użytkowników.

Moje treści lub aplikacja nie działają w odtwarzaczu Shaka Player. Co teraz?

Zgłoś błąd w projekcie Shaka Player lub w projekcie Cast (patrz Zgłaszanie problemów). Zespół inżynierów pakietu Cast SDK aktywnie monitoruje te narzędzia do śledzenia i będzie współpracować z Tobą w celu rozwiązania wszelkich problemów. Im wcześniej wykryte zostaną te problemy, tym więcej czasu będą mieli na ich rozwiązanie.

Biblioteka MPL nie otrzymuje już ważnych aktualizacji. Co to dokładnie oznacza?

W przeszłości biblioteka MPL wprowadzała nowe funkcje HLS i poprawiała poważne błędy za pomocą ważnych aktualizacji. Teraz, gdy biblioteka MPL nie będzie już otrzymywać tych aktualizacji, nowe funkcje HLS nie będą dodawane do odtwarzacza. Podobnie wszelkie zgłoszone problemy z odtwarzaniem HLS w bibliotece MPL nie zostaną w niej rozwiązane. Te problemy należy rozwiązać, przechodząc na odtwarzacz Shaka Player. Jeśli problemy nadal występują, należy zgłosić a błąd dotyczący problemów napotkanych w odtwarzaczu Shaka Player. Partnerzy powinni przestać używać biblioteki MPL.

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

Pliki binarne biblioteki MPL będą nadal hostowane i dostępne dla aplikacji odbiornika. Jednak wszelkie prośby o funkcje związane z protokołem Smooth Streaming i poprawki błędów nie będą obsługiwane, ponieważ specyfikacja protokołu Smooth Streaming nie była aktualizowana od ponad 4 lat. Aby nadal otrzymywać aktualizacje wydajności i pomoc dotyczącą treści, zalecamy migrację treści do protokołu strumieniowania DASH lub HLS.

Moje treści nie korzystają z protokołów HLS ani Smooth Stream. Jak to wpływa na moją aplikację?

Jeśli Twoja biblioteka treści nie korzysta z żadnego z tych protokołów strumieniowania, migracja nie będzie miała na nią wpływu. Nie musisz wprowadzać żadnych zmian w aplikacji.