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 włączenie korzystania 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 w zakresie błędów czasu wczytywania i opóźnień.
- 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.
- Otwarty kod źródłowy 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 cyklom wydawniczym odtwarzacza Shaka Player, które są niezależne od aktualizacji pakietu Web Receiver SDK.
- Większa kontrola nad środowiskiem odtwarzania dzięki interfejsowi
shakaVersionAPI. - 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.
| Faza | Data rozpoczęcia | Przegląd |
|---|---|---|
| 1 | Październik 2022 r. | Pakiet Cast Web Receiver SDK wprowadził interfejsy API umożliwiające włączenie odtwarzania treści HLS w odtwarzaczu Shaka Player. |
| 2 | 18 maja 2026 r. | Pakiet Cast Web Receiver SDK zmienił domyślny odtwarzacz na Shaka Player do odtwarzania treści HLS. |
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ą bazową 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.35, 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 poprawności treści
Zanim partnerzy włączą korzystanie z odtwarzacza Shaka Player w swojej aplikacji produkcyjnej, powinni sprawdzić, czy odtwarzanie treści w odtwarzaczu Shaka Player działa prawidłowo. Zalecamy przetestowanie każdej z tych odmian treści wymienionych poniżej:
- 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 uruchomisz 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 Akceptacja , 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:
- Aby rozwiązać problem, spróbuj ustawić
shakaVersionna inną wersję gałęzi. Jeśli na przykład problem występuje w gałęzi4.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 interfejsshakaVersionAPI ma minimalną i maksymalną obsługiwaną wersję, jak opisano w dokumentacji. Jeśli zauważysz regresję, zgłoś problem w narzędziu do śledzenia problemów odtwarzacza Shaka Player. - Spróbuj zmienić parametry konfiguracji odtwarzacza. Odtwarzacz Shaka Player można
skonfigurować za pomocą
PlayerConfigurationobiektu. Pakiet Web Receiver SDK definiuje zestaw wartości domyślnych i umożliwia aplikacjom modyfikowanie tej konfiguracji za pomocą właściwościshakaConfigw obiekciePlaybackConfig. 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. - 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 Cast. Jeśli problem jest podobny do Twojego, dodaj komentarz i wszelkie istotne informacje.
- 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.
- Zgłoś błąd w narzędziu do śledzenia problemów z Cast, 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 rodzić 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ą wcześniej, 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 w porównaniu z 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 w odtwarzaczu Shaka Player. Więcej informacji o tym, na jakich aspektach treści należy się skupić, znajdziesz w sekcji Sprawdzanie poprawności treści. Po sprawdzeniu poprawności 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 zmiany w programowaniu oprogramowania są minimalne, a wymagania dotyczące kontroli jakości są głównie dla naszych partnerów, 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, a także będzie korzystać z nowych funkcji HLS i 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ę Twoim użytkownikom.
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 będzie już otrzymywać 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, do odtwarzacza nie będą dodawane nowe funkcje HLS. 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łynie 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 Smooth Streaming i poprawki błędów nie będą obsługiwane, ponieważ specyfikacja Smooth Streaming nie była aktualizowana od ponad 4 lat. Aby nadal otrzymywać aktualizacje wydajności i pomoc dotyczącą treści, zalecamy przeniesienie treści na protokół strumieniowania DASH lub HLS.
Moje treści nie korzystają 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 strumieniowania, migracja nie będzie miała na nią wpływu. Nie musisz wprowadzać żadnych zmian w aplikacji.