Ulepszanie odtwarzania multimediów: szczegółowe omówienie interfejsu PreloadManager w Media3 – część 2
Czas czytania: 9 min
Witamy w drugiej części naszej 3-częściowej serii o wstępnym wczytywaniu multimediów za pomocą Media3. Ta seria ma na celu przeprowadzenie Cię przez proces tworzenia w aplikacjach na Androida multimediów o wysokiej czułości i niskim opóźnieniu.
- Część 1. Wstęp do wstępnego wczytywania za pomocą Media3 zawiera podstawowe informacje. Omówiliśmy różnicę między PreloadConfiguration w przypadku prostych playlist a bardziej zaawansowanym DefaultPreloadManager w przypadku dynamicznych interfejsów użytkownika. Wiesz już, jak wdrożyć podstawowy cykl życia interfejsu API: dodawać multimedia za pomocą funkcji add(), pobierać przygotowane źródło MediaSource za pomocą funkcji getMediaSource(), zarządzać priorytetami za pomocą funkcji setCurrentPlayingIndex() i invalidate() oraz zwalniać zasoby za pomocą funkcji remove() i release().
- Część 2 (ten post): w tym poście na blogu omawiamy zaawansowane funkcje DefaultPreloadManager. Dowiesz się, jak uzyskiwać statystyki za pomocą PreloadManagerListener, wdrażać sprawdzone metody gotowe do wykorzystania w środowisku produkcyjnym, takie jak udostępnianie podstawowych komponentów ExoPlayerowi, oraz opanować wzorzec okna przesuwnego, aby skutecznie zarządzać pamięcią.
- Część 3. Ostatnia część tej serii będzie dotyczyć integracji PreloadManager z trwałą pamięcią podręczną na dysku, co pozwoli Ci zmniejszyć zużycie danych dzięki zarządzaniu zasobami i zapewnić płynne działanie.
Jeśli dopiero zaczynasz korzystać z wstępnego wczytywania w Media3, przed przejściem dalej zdecydowanie zalecamy przeczytanie części 1. Jeśli chcesz wyjść poza podstawy, dowiedz się, jak ulepszyć implementację odtwarzania multimediów.
Nasłuchiwanie: pobieranie statystyk za pomocą interfejsu PreloadManagerListener
Gdy chcesz wprowadzić funkcję w środowisku produkcyjnym, jako deweloper aplikacji chcesz też poznać i przeanalizować związane z nią dane. How can you be certain that your preloading strategy is effective in a real-world environment? Odpowiedź na to pytanie wymaga danych o wskaźnikach sukcesu, niepowodzeniach i wydajności. Podstawowym mechanizmem zbierania tych danych jest interfejs PreloadManagerListener.
PreloadManagerListener udostępnia 2 kluczowe wywołania zwrotne, które dostarczają ważnych informacji o procesie i stanie wstępnego wczytywania.
- onCompleted(MediaItem mediaItem): to wywołanie zwrotne jest wywoływane po pomyślnym zakończeniu żądania wstępnego wczytania, zgodnie z definicją w TargetPreloadStatusControl.
- onError(PreloadException error): to wywołanie zwrotne może być przydatne do debugowania i monitorowania. Jest wywoływana, gdy wstępne wczytywanie się nie powiedzie, i podaje powiązany wyjątek.
Możesz zarejestrować detektor za pomocą jednego wywołania metody, jak pokazano w tym przykładowym kodzie:
val preloadManagerListener = object : PreloadManagerListener {
override fun onCompleted(mediaItem: MediaItem) {
// Log success for analytics.
Log.d("PreloadAnalytics", "Preload completed for $mediaItem")
}
override fun onError( preloadError: PreloadException) {
// Log the specific error for debugging and monitoring.
Log.e("PreloadAnalytics", "Preload error ", preloadError)
}
}
preloadManager.addListener(preloadManagerListener)Wyciąganie wniosków na podstawie informacji o słuchaczach
Te wywołania zwrotne detektora można podłączyć do potoku analitycznego. Przekazując te zdarzenia do silnika analitycznego, możesz znaleźć odpowiedzi na kluczowe pytania, takie jak:
- Jaki jest wskaźnik sukcesu wstępnego wczytywania? (stosunek liczby zdarzeń onCompleted do łącznej liczby prób wstępnego wczytania).
- Które sieci CDN lub formaty wideo wykazują najwyższe współczynniki błędów? (przez analizowanie wyjątków z onError).
- Jaki jest nasz współczynnik błędów wstępnego wczytywania? (stosunek liczby zdarzeń onError do łącznej liczby prób wstępnego ładowania)
Te dane mogą dostarczyć Ci ilościowych informacji na temat strategii wstępnego wczytywania, co umożliwi przeprowadzanie testów A/B i wprowadzanie ulepszeń opartych na danych, które poprawią wrażenia użytkowników. Te dane mogą Ci pomóc w inteligentnym dostosowywaniu czasu wstępnego wczytywania i liczby filmów, które chcesz wstępnie wczytać, a także przydzielanych buforów.
Więcej niż debugowanie: używanie onError do płynnego przełączania interfejsu
Nieudane wstępne wczytywanie jest silnym wskaźnikiem nadchodzącego zdarzenia buforowania dla użytkownika. Wywołanie zwrotne onError umożliwia reagowanie na błędy. Zamiast tylko rejestrować błąd, możesz dostosować interfejs. Jeśli na przykład nie uda się wstępnie załadować kolejnego filmu, aplikacja może wyłączyć autoodtwarzanie przy następnym przesunięciu palcem, co będzie wymagało od użytkownika kliknięcia, aby rozpocząć odtwarzanie.
Dodatkowo, sprawdzając typ PreloadException, możesz zdefiniować bardziej inteligentną strategię ponawiania prób. Aplikacja może natychmiast usunąć nieprawidłowe źródło z menedżera na podstawie komunikatu o błędzie lub kodu stanu HTTP. Element należy usunąć ze strumienia interfejsu, aby problemy z ładowaniem nie wpływały na wrażenia użytkownika. Możesz też uzyskać bardziej szczegółowe dane z PreloadException, np. HttpDataSourceException, aby dokładniej zbadać błędy. Dowiedz się więcej o rozwiązywaniu problemów z ExoPlayerem.
System partnerski: dlaczego udostępnianie komponentów ExoPlayerowi jest konieczne?
DefaultPreloadManager i ExoPlayer zostały zaprojektowane tak, aby ze sobą współpracować. Aby zapewnić stabilność i wydajność, muszą one współdzielić kilka podstawowych komponentów. Jeśli działają one z osobnymi, nieskoordynowanymi komponentami, może to mieć wpływ na bezpieczeństwo wątków i użyteczność wstępnie wczytanych ścieżek w odtwarzaczu, ponieważ musimy mieć pewność, że wstępnie wczytane ścieżki będą odtwarzane w odpowiednim odtwarzaczu. Oddzielne komponenty mogą też konkurować o ograniczone zasoby, takie jak przepustowość sieci i pamięć, co może prowadzić do pogorszenia wydajności. Ważną częścią cyklu życia jest odpowiednie usuwanie. Zalecana kolejność usuwania to najpierw PreloadManager, a potem ExoPlayer.
Klasa DefaultPreloadManager.Builder została zaprojektowana, aby ułatwić to udostępnianie, i zawiera interfejsy API do tworzenia instancji zarówno klasy PreloadManager, jak i połączonej instancji odtwarzacza. Zobaczmy, dlaczego komponenty takie jak BandwidthMeter, LoadControl, TrackSelector i Looper muszą być udostępniane. Sprawdź wizualną reprezentację interakcji tych komponentów z odtwarzaniem ExoPlayer.
Zapobieganie konfliktom przepustowości za pomocą udostępnionego licznika BandwidthMeter
BandwidthMeter podaje szacunkową dostępną przepustowość sieci na podstawie historycznych szybkości transferu. Jeśli PreloadManager i odtwarzacz używają oddzielnych instancji, nie są świadome swojej aktywności sieciowej, co może prowadzić do błędów. Rozważmy na przykład sytuację, w której użytkownik ogląda film, połączenie sieciowe się pogarsza, a wstępnie wczytany MediaSource jednocześnie rozpoczyna agresywne pobieranie przyszłego filmu. Wstępne wczytywanie MediaSource zużywałoby przepustowość potrzebną aktywnemu odtwarzaczowi, co powodowałoby zatrzymanie bieżącego filmu. Zatrzymanie odtwarzania to poważny błąd, który negatywnie wpływa na wrażenia użytkowników.
Dzięki udostępnianiu jednego obiektu BandwidthMeter obiekt TrackSelector może wybierać ścieżki o najwyższej jakości, biorąc pod uwagę bieżące warunki sieciowe i stan bufora podczas wstępnego wczytywania lub odtwarzania. Dzięki temu może podejmować inteligentne decyzje, aby chronić aktywną sesję odtwarzania i zapewnić płynne działanie.
preloadManagerBuilder.setBandwidthMeter(customBandwidthMeter)
Zapewnianie spójności z udostępnionymi komponentami LoadControl, TrackSelector i Renderer odtwarzacza ExoPlayer
- LoadControl: ten komponent określa zasady buforowania, takie jak ilość danych do zbuforowania przed rozpoczęciem odtwarzania oraz moment rozpoczęcia lub zatrzymania wczytywania kolejnych danych. Udostępnianie LoadControl zapewnia, że zużycie pamięci przez odtwarzacz i PreloadManager jest kontrolowane przez jedną, skoordynowaną strategię buforowania zarówno w przypadku wstępnie załadowanych, jak i aktywnie odtwarzanych multimediów, co zapobiega rywalizacji o zasoby. Aby zapewnić spójność, musisz odpowiednio przydzielić rozmiar bufora, biorąc pod uwagę liczbę wstępnie wczytywanych elementów i czas ich trwania. W przypadku problemów odtwarzacz będzie traktować priorytetowo odtwarzanie bieżącego elementu wyświetlanego na ekranie. W przypadku współdzielonego elementu LoadControl menedżer wstępnego wczytywania będzie kontynuować wstępne wczytywanie, dopóki docelowe bajty bufora przydzielone do wstępnego wczytywania nie osiągną górnego limitu. Nie będzie czekać na zakończenie wczytywania na potrzeby odtwarzania.
Uwaga: udostępnianie LoadControl w najnowszej wersji Media3 (1.8) zapewnia, że Allocator może być prawidłowo udostępniany PreloadManager i odtwarzaczowi. Używanie LoadControl do skutecznego kontrolowania wstępnego wczytywania to funkcja, która będzie dostępna w nadchodzącej wersji Media3 1.9.
preloadManagerBuilder.setLoadControl(customLoadControl)
- TrackSelector: ten komponent odpowiada za wybór ścieżek (np. filmu w określonej rozdzielczości, dźwięku w określonym języku) do wczytania i odtworzenia. Udostępnianie gwarantuje, że ścieżki wybrane podczas wstępnego wczytywania będą tymi samymi, których użyje odtwarzacz. Pozwala to uniknąć niepotrzebnego wstępnego wczytywania ścieżki wideo 480p, która zostanie natychmiast odrzucona przez odtwarzacz i zastąpiona ścieżką 720p podczas odtwarzania.< br /> Menedżer wstępnego wczytywania NIE powinien udostępniać odtwarzaczowi tej samej instancji TrackSelector. Zamiast tego powinny używać innej instancji TrackSelector, ale o tej samej implementacji. Dlatego w DefaultPreloadManager.Builder ustawiamy TrackSelectorFactory, a nie TrackSelector.
preloadManagerBuilder.setTrackSelectorFactory(customTrackSelectorFactory)
- Renderer: ten komponent odpowiada za rozpoznawanie możliwości odtwarzacza bez tworzenia pełnych modułów renderujących. Sprawdza ten schemat, aby dowiedzieć się, które formaty wideo, audio i tekstu będą obsługiwane przez odtwarzacz. Dzięki temu może on inteligentnie wybierać i pobierać tylko zgodną ścieżkę multimedialną, co zapobiega marnowaniu przepustowości na treści, których odtwarzacz nie może odtworzyć.
preloadManagerBuilder.setRenderersFactory(customRenderersFactory)
Dowiedz się więcej o komponentach ExoPlayer.
Złota zasada: wspólny odtwarzacz w pętli, który wszystkim rządzi
Wątek, w którym można uzyskać dostęp do instancji ExoPlayera, można wyraźnie określić, przekazując pętlę podczas tworzenia odtwarzacza. Looper wątku, z którego należy uzyskać dostęp do odtwarzacza, można sprawdzić za pomocą metody Player.getApplicationLooper. Dzięki utrzymaniu wspólnego Loopera między odtwarzaczem a PreloadManagerem wszystkie operacje na tych udostępnionych obiektach multimedialnych są serializowane w kolejce komunikatów pojedynczego wątku. Może to zmniejszyć liczbę błędów równoczesności.
Wszystkie interakcje między PreloadManagerem a odtwarzaczem ze źródłami multimediów, które mają zostać załadowane lub wstępnie załadowane, muszą odbywać się w tym samym wątku odtwarzania. Udostępnianie Looper jest konieczne ze względu na bezpieczeństwo wątków, dlatego musimy udostępniać PlaybackLooper między PreloadManager a odtwarzaczem.
PreloadManager przygotowuje w tle obiekt MediaSource ze stanem. Gdy kod interfejsu wywołuje funkcję player.setMediaSource(mediaSource), następuje przekazanie tego złożonego, stanowego obiektu z wstępnie wczytywanego obiektu MediaSource do odtwarzacza. W tym scenariuszu cały obiekt PreloadMediaSource jest przenoszony z menedżera do odtwarzacza. Wszystkie te interakcje i przekazywanie powinny odbywać się w ramach tego samego obiektu PlaybackLooper.
Jeśli PreloadManager i ExoPlayer działałyby w różnych wątkach, mogłoby dojść do sytuacji wyścigu. Wątek PreloadManager może modyfikować stan wewnętrzny MediaSource (np.zapisywać nowe dane w buforze) dokładnie w momencie, gdy wątek odtwarzacza próbuje odczytać z niego dane. Prowadzi to do nieprzewidywalnego działania i błędu IllegalStateException, który jest trudny do debugowania.
preloadManagerBuilder.setPreloadLooper(playbackLooper)
Zobaczmy, jak możesz udostępniać wszystkie powyższe komponenty między ExoPlayerem a DefaultPreloadManagerem w samej konfiguracji.
val preloadManagerBuilder =
DefaultPreloadManager.Builder(context, targetPreloadStatusControl)
// Optional - Share components between ExoPlayer and DefaultPreloadManager
preloadManagerBuilder
.setBandwidthMeter(customBandwidthMeter)
.setLoadControl(customLoadControl)
.setMediaSourceFactory(customMediaSourceFactory)
.setTrackSelectorFactory(customTrackSelectorFactory)
.setRenderersFactory(customRenderersFactory)
.setPreloadLooper(playbackLooper)
val preloadManager = val preloadManagerBuilder.build()Wskazówka: jeśli używasz domyślnych komponentów w ExoPlayerze, takich jak DefaultLoadControl, nie musisz ich wyraźnie udostępniać w DefaultPreloadManager. Jeśli tworzysz instancję ExoPlayera za pomocą metody buildExoPlayer klasy DefaultPreloadManager.Builder, te komponenty są automatycznie powiązane ze sobą, jeśli używasz domyślnych implementacji z domyślnymi konfiguracjami. Jeśli jednak używasz komponentów niestandardowych lub konfiguracji niestandardowych, musisz wyraźnie powiadomić o nich DefaultPreloadManager za pomocą powyższych interfejsów API.
Wstępne wczytywanie gotowe do wykorzystania w środowisku produkcyjnym: wzorzec okna przesuwnego
W dynamicznym pliku danych użytkownik może przewijać praktycznie nieskończoną ilość treści. Jeśli będziesz stale dodawać filmy do DefaultPreloadManager bez odpowiedniej strategii usuwania, nieuchronnie spowoduje to błąd OutOfMemoryError. Każdy wstępnie załadowany obiekt MediaSource zawiera obiekt SampleQueue, który przydziela bufor pamięci. Gdy się nagromadzą, mogą wyczerpać przestrzeń sterty aplikacji. Rozwiązaniem jest algorytm, który być może już znasz, zwany przesuwanym oknem. Wzorzec przesuwanego okna utrzymuje w pamięci niewielki, łatwy w zarządzaniu zestaw elementów, które są logicznie powiązane z bieżącą pozycją użytkownika w kanale. Gdy użytkownik przewija stronę, to „okno” zarządzanych elementów przesuwa się wraz z nim, dodając nowe elementy, które pojawiają się w widoku, i usuwając elementy, które są już daleko.
Wdrażanie wzorca okna przesuwnego
Ważne jest, aby pamiętać, że PreloadManager nie udostępnia wbudowanej metody setWindowSize(). Przesuwane okno to wzorzec projektowy, który Ty jako deweloper musisz zaimplementować za pomocą podstawowych metod add() i remove(). Logika aplikacji musi łączyć zdarzenia interfejsu, takie jak przewijanie lub zmiana strony, z tymi wywołaniami interfejsu API. Jeśli chcesz zobaczyć przykładowy kod, mamy ten wzorzec okna przesuwnego zaimplementowany w przykładzie socialite, który zawiera też PreloadManagerWrapper imitujący okno przesuwne.
Pamiętaj, aby dodać w swojej implementacji metodę preloadManager.remove(mediaItem), gdy dany element nie będzie już prawdopodobnie wyświetlany użytkownikowi. Nieusunięcie elementów, które nie znajdują się już w pobliżu użytkownika, jest główną przyczyną problemów z pamięcią w przypadku implementacji wstępnego wczytywania. Wywołanie remove() zapewnia zwolnienie zasobów, co pomaga utrzymać wykorzystanie pamięci przez aplikację na stałym poziomie.
Dostosowywanie strategii wstępnego wczytywania według kategorii za pomocą TargetPreloadStatusControl
Teraz, gdy już określiliśmy, co ma być wstępnie wczytywane (elementy w naszym oknie), możemy zastosować dobrze zdefiniowaną strategię dotyczącą tego, ile danych ma być wstępnie wczytywanych w przypadku każdego elementu. W części 1 pokazaliśmy, jak osiągnąć tę szczegółowość za pomocą konfiguracji TargetPreloadStatusControl.
Przypominamy, że element na pozycji +/- 1 może mieć większe prawdopodobieństwo odtworzenia niż element na pozycji +/- 4. Możesz przydzielić więcej zasobów (sieć, procesor, pamięć) elementom, które użytkownik najprawdopodobniej wyświetli jako następne. Tworzy to strategię „wstępnego wczytywania” opartą na bliskości, która jest kluczem do równoważenia natychmiastowego odtwarzania z efektywnym wykorzystaniem zasobów.
Aby określić strategię dotyczącą czasu trwania wstępnego wczytywania, możesz użyć danych analitycznych z interfejsu PreloadManagerListener, jak opisano we wcześniejszych sekcjach.
Podsumowanie i dalsze kroki
Masz teraz zaawansowaną wiedzę, która pozwoli Ci tworzyć szybkie, stabilne i wydajne pod względem zasobów kanały multimedialne za pomocą klasy DefaultPreloadManager biblioteki Media3.
Podsumujmy najważniejsze informacje:
- Używaj interfejsu PreloadManagerListener do zbierania statystyk i wdrażania rzetelnej obsługi błędów.
- Zawsze używaj jednego obiektu DefaultPreloadManager.Builder do tworzenia instancji menedżera i odtwarzacza, aby mieć pewność, że ważne komponenty są udostępniane.
- Zaimplementuj wzorzec okna przesuwnego, aktywnie zarządzając wywołaniami add() i remove(), aby zapobiec błędowi OutOfMemoryError.
- Użyj TargetPreloadStatusControl, aby utworzyć inteligentną, wielopoziomową strategię wstępnego wczytywania, która równoważy wydajność i zużycie zasobów.
Co dalej w części 3: buforowanie z użyciem wstępnie wczytanych multimediów
Wstępne wczytywanie danych do pamięci zapewnia natychmiastową poprawę wydajności, ale może wiązać się z kompromisami. Po zamknięciu aplikacji lub usunięciu wstępnie załadowanych multimediów z menedżera dane zostaną utracone. Aby uzyskać bardziej trwały poziom optymalizacji, możemy połączyć wstępne wczytywanie z pamięcią podręczną na dysku. Ta funkcja jest obecnie rozwijana i będzie dostępna już wkrótce.
Czy chcesz podzielić się opinią? Chętnie poznamy Twoją opinię.
Bądź na bieżąco i przyspiesz odtwarzanie filmów. 🚀
-
Wiadomości o usłudzeUlepszanie odtwarzania multimediów: wprowadzenie do wstępnego wczytywania za pomocą Media3 – część 1
W dzisiejszych aplikacjach multimedialnych płynne i nieprzerwane odtwarzanie jest kluczem do zapewnienia użytkownikom wygody. Użytkownicy oczekują, że filmy będą się uruchamiać natychmiast i odtwarzać płynnie, bez przerw.
Mayuri Khinvasara Khabya • Czas czytania: 8 min -
Wiadomości o usłudzeUnity obsługuje ponad połowę wszystkich tytułów mobilnych na świecie, dlatego pierwsze wrażenie jest bardzo ważne. Dla deweloperów gier płynne i niezawodne wprowadzenie graczy jest kluczowe dla utrzymania ich od pierwszego dnia i zapewnienia długoterminowego zaangażowania.
Michelle Martin • Czas czytania: 1 min -
Wiadomości o usłudzeOd pełnej immersji w domu po szybkie sprawdzanie informacji w podróży – tworzenie aplikacji na Androida XR pozwala dotrzeć do użytkowników w każdym momencie i w całym spektrum aplikacji przestrzennych. Podczas Android Dev Summit osiągnęliśmy ważny kamień milowy, wprowadzając na rynek XREAL AURA.
Amy Zeppenfeld, Vinny DaSilva • Czas czytania: 3 min
Otrzymuj co tydzień najnowsze informacje o tworzeniu aplikacji na Androida na swoją skrzynkę odbiorczą.