Media3

Media3

  Przykładowy kod

Dokumentacja API
androidx.media3.common

Biblioteki pomocy w przypadku zastosowań multimedialnych.

Najnowsza aktualizacja	Wersja stabilna	Wersja kandydująca do publikacji	Wersja beta	Wersja Alfa
20 listopada 2025 r.	1.8.0	-	1.9.0-beta01	1.9.0-alpha01

Deklarowanie zależności

Aby dodać zależność od Media3, musisz dodać repozytorium Google Maven do projektu. Więcej informacji znajdziesz w repozytorium Maven Google.

Dodaj zależności dotyczące potrzebnych artefaktów w pliku build.gradle aplikacji lub modułu:

Odlotowe

dependencies {
    def media3_version = "1.8.0"

    // For media playback using ExoPlayer
    implementation "androidx.media3:media3-exoplayer:$media3_version"

    // For DASH playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-dash:$media3_version"
    // For HLS playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-hls:$media3_version"
    // For SmoothStreaming playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-smoothstreaming:$media3_version"
    // For RTSP playback support with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-rtsp:$media3_version"
    // For MIDI playback support with ExoPlayer (see additional dependency requirements in
    // https://github.com/androidx/media/blob/release/libraries/decoder_midi/README.md)
    implementation "androidx.media3:media3-exoplayer-midi:$media3_version"
    // For ad insertion using the Interactive Media Ads SDK with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-ima:$media3_version"

    // For loading data using the Cronet network stack
    implementation "androidx.media3:media3-datasource-cronet:$media3_version"
    // For loading data using the OkHttp network stack
    implementation "androidx.media3:media3-datasource-okhttp:$media3_version"
    // For loading data using librtmp
    implementation "androidx.media3:media3-datasource-rtmp:$media3_version"

    // For building media playback UIs using Compose
    implementation "androidx.media3:media3-ui-compose:$media3_version"
    // For building media playback UIs using Views
    implementation "androidx.media3:media3-ui:$media3_version"
    // For building media playback UIs using Jetpack Compose
    implementation "androidx.media3:media3-ui-compose:$media3_version"
    // For building media playback UIs for Android TV using the Jetpack Leanback library
    implementation "androidx.media3:media3-ui-leanback:$media3_version"

    // For exposing and controlling media sessions
    implementation "androidx.media3:media3-session:$media3_version"

    // For extracting data from media containers
    implementation "androidx.media3:media3-extractor:$media3_version"

    // For integrating with Cast
    implementation "androidx.media3:media3-cast:$media3_version"

    // For scheduling background operations using Jetpack Work's WorkManager with ExoPlayer
    implementation "androidx.media3:media3-exoplayer-workmanager:$media3_version"

    // For transforming media files
    implementation "androidx.media3:media3-transformer:$media3_version"

    // For applying effects on video frames
    implementation "androidx.media3:media3-effect:$media3_version"

    // For muxing media files
    implementation "androidx.media3:media3-muxer:$media3_version"

    // Utilities for testing media components (including ExoPlayer components)
    implementation "androidx.media3:media3-test-utils:$media3_version"
    // Utilities for testing media components (including ExoPlayer components) via Robolectric
    implementation "androidx.media3:media3-test-utils-robolectric:$media3_version"

    // Common functionality for reading and writing media containers
    implementation "androidx.media3:media3-container:$media3_version"
    // Common functionality for media database components
    implementation "androidx.media3:media3-database:$media3_version"
    // Common functionality for media decoders
    implementation "androidx.media3:media3-decoder:$media3_version"
    // Common functionality for loading data
    implementation "androidx.media3:media3-datasource:$media3_version"
    // Common functionality used across multiple media libraries
    implementation "androidx.media3:media3-common:$media3_version"
    // Common Kotlin-specific functionality
    implementation "androidx.media3:media3-common-ktx:$media3_version"
}

Kotlin

dependencies {
    val media3_version = "1.8.0"

    // For media playback using ExoPlayer
    implementation("androidx.media3:media3-exoplayer:$media3_version")

    // For DASH playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-dash:$media3_version")
    // For HLS playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-hls:$media3_version")
    // For SmoothStreaming playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-smoothstreaming:$media3_version")
    // For RTSP playback support with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-rtsp:$media3_version")
    // For MIDI playback support with ExoPlayer (see additional dependency requirements in
    // https://github.com/androidx/media/blob/release/libraries/decoder_midi/README.md)
    implementation("androidx.media3:media3-exoplayer-midi:$media3_version")
    // For ad insertion using the Interactive Media Ads SDK with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-ima:$media3_version")

    // For loading data using the Cronet network stack
    implementation("androidx.media3:media3-datasource-cronet:$media3_version")
    // For loading data using the OkHttp network stack
    implementation("androidx.media3:media3-datasource-okhttp:$media3_version")
    // For loading data using librtmp
    implementation("androidx.media3:media3-datasource-rtmp:$media3_version")

    // For building media playback UIs using Compose
    implementation("androidx.media3:media3-ui-compose:$media3_version")
    // For building media playback UIs using Views
    implementation("androidx.media3:media3-ui:$media3_version")
    // For building media playback UIs using Jetpack Compose
    implementation("androidx.media3:media3-ui-compose:$media3_version")
    // For building media playback UIs for Android TV using the Jetpack Leanback library
    implementation("androidx.media3:media3-ui-leanback:$media3_version")

    // For exposing and controlling media sessions
    implementation("androidx.media3:media3-session:$media3_version")

    // For extracting data from media containers
    implementation("androidx.media3:media3-extractor:$media3_version")

    // For integrating with Cast
    implementation("androidx.media3:media3-cast:$media3_version")

    // For scheduling background operations using Jetpack Work's WorkManager with ExoPlayer
    implementation("androidx.media3:media3-exoplayer-workmanager:$media3_version")

    // For transforming media files
    implementation("androidx.media3:media3-transformer:$media3_version")

    // For applying effects on video frames
    implementation("androidx.media3:media3-effect:$media3_version")

    // For muxing media files
    implementation("androidx.media3:media3-muxer:$media3_version")

    // Utilities for testing media components (including ExoPlayer components)
    implementation("androidx.media3:media3-test-utils:$media3_version")
    // Utilities for testing media components (including ExoPlayer components) via Robolectric
    implementation("androidx.media3:media3-test-utils-robolectric:$media3_version")

    // Common functionality for reading and writing media containers
    implementation("androidx.media3:media3-container:$media3_version")
    // Common functionality for media database components
    implementation("androidx.media3:media3-database:$media3_version")
    // Common functionality for media decoders
    implementation("androidx.media3:media3-decoder:$media3_version")
    // Common functionality for loading data
    implementation("androidx.media3:media3-datasource:$media3_version")
    // Common functionality used across multiple media libraries
    implementation("androidx.media3:media3-common:$media3_version")
    // Common Kotlin-specific functionality
    implementation("androidx.media3:media3-common-ktx:$media3_version")
}

Więcej informacji o zależnościach znajdziesz w artykule Dodawanie zależności kompilacji.

Opinia

Twoja opinia pomoże nam ulepszyć Jetpacka. Aby znaleźć odpowiedzi na pytania, poznać znane problemy i prośby o dodanie funkcji oraz zgłaszać nowe problemy, możesz skorzystać z narzędzia do śledzenia problemów w Media3.

Wersja 1.9.0

1.9.0-beta01

20 listopada 2025 r.

Publikacja androidx.media3:media3-*:1.9.0-beta01 Wersja 1.9.0-beta01 zawiera te zatwierdzenia.

• ExoPlayer:
  • Dodano cloneAndSet(int, int) do ShuffleOrder z domyślną implementacją (#2834).
  • Dołączanie przesunięcia wznowienia treści podczas pomijania odtwarzania reklam po dostosowaniu wyszukiwania lub automatycznym przejściu (2484).
• Ekstraktory:
  • MP3: zwiększ limit sprawdzania do 128 KB, aby był zgodny z dotychczasowym limitem wyszukiwania bajtu synchronizacji (#2713).
• Film:
  • Ponowne włączenie obejścia problemu z nieprawidłowo raportowanymi punktami wydajności w przypadku bezpiecznych kodeków (#2856).
• Skutek:
  • Dodaj Presentation.copyWithUnsetSideRoundedTo, aby zaokrąglić nieustawioną stronę wyjściową, gdy Presentation jest tworzony z jedną długością boku.
• Rozszerzenie IMA:
  • Rozwiązaliśmy problem, który powodował błędne zgłaszanie błędu przygotowania treści po reklamie jako błędu odtwarzania reklamy (#2656).
• Sesja:
  • Dodaj CommandButton.executeAction, aby kontrolery mogły łatwiej wywoływać zamierzone działanie. Umożliwia też określanie parametrów niektórych poleceń odtwarzacza i sesji, aby zdefiniować, które działanie ma zostać wywołane.
  • Dodano zgodność wsteczną w przypadku instancji CommandButton, które używają Player.Command lub niestandardowego elementu SessionCommand do określania działania. Są one teraz prawidłowo reprezentowane w sesjach multimedialnych platformy, np. w interfejsie systemu lub Androidzie Auto.
  • Rozwiązanie problemu polegającego na tym, że ten sam Bitmap jest kompresowany wielokrotnie podczas łączenia MediaController z sesją multimedialną platformy.
• UI:
  • Użyj BidiFormatter, aby prawidłowo wyświetlać znaki interpunkcyjne w napisach w językach RTL (#11214).
  • Dodaj funkcję TimeText do funkcji media3-ui-compose-material3, aby wyświetlać postępy gracza w formie tekstowej. Można go skonfigurować tak, aby wyświetlał bieżącą pozycję, czas trwania lub pozostały czas.
• Rozszerzenie HLS:
  • Dodaj HlsInterstitialsAdsLoader.skipCurrentAd() i skipCurrentAdGroup() oraz odpowiednie metody, aby pomijać reklamy i grupy reklam według indeksu.
  • Dodaj HlsInterstitialsAdsLoader.Listener.onAdStarted, aby zgłosić początek okresu wyświetlania reklamy (#2859).
  • Akceptuj spację jako separator daty i godziny w ciągach daty i godziny w formacie ISO 8601.

Wersja 1.9.0-alpha01

22 października 2025 r.

Publikacja androidx.media3:media3-*:1.9.0-alpha01 Wersja 1.9.0-alpha01 zawiera te zatwierdzenia.

• Biblioteka wspólna:
  • Zaktualizuj minSdk do 23 zgodnie z innymi bibliotekami AndroidX.
  • Dodaj PlayerTransferState, który ułatwia przenoszenie stanu odtwarzania między instancjami Player.
  • Dodaj do klasy Player metody void mute() i void unmute(), które zachowują, a następnie przywracają głośność odtwarzacza przed i po ustawieniu jej na zero.
  • Opublikowano klasy narzędziowe WakeLockManager, WifiLockManager, AudioFocusManager, AudioBecomingNoisyManager i StuckPlayerDetector, które były wcześniej używane wewnętrznie przez ExoPlayer, aby umożliwić ponowne wykorzystanie przez innych graczy (#1893).
  • Poprawiono obsługę ForwardingPlayer odbiorników, gdy podstawowy odtwarzacz delegowany używa porównania referencyjnego do porównywania instancji odbiorników (#2675).
  • Dodaj w bibliotece media3-common-ktx funkcję zawieszania rozszerzenia Player.listenTo, która określa konkretny Player.Events, na którym ma zostać wykonana akcja.
  • Naprawiono błąd w BasePlayer.getBufferedPercentage spowodowany przepełnieniem liczby całkowitej, gdy zgłoszona pozycja buforowana jest nieprawdopodobnie większa niż zgłoszony czas trwania (#2750).
• ExoPlayer:
  • Dodaj wykrywanie zablokowanego odtwarzacza, które w przypadku zablokowania odtwarzacza wywołuje StuckPlayerExceptionbłąd odtwarzacza. Dzieje się tak w tych przypadkach, w których każdy domyślny limit czasu można w razie potrzeby skonfigurować w ExoPlayer.Builder:
    • Po 10 minutach STATE_BUFFERING podczas próby odtwarzania bez buforowania.
    • Po 10 sekundach STATE_READY podczas próby odtwarzania i braku postępu odtwarzania.
    • Po minucie STATE_READY poza zadeklarowanym czasem trwania bez osiągnięcia końca elementu.
    • Po 10 minutach z powodem wstrzymania odtwarzania podczas próby odtworzenia.
  • Domyślnie włącz obsługę blokady wybudzania, aby rozwiązać problemy z buforowaniem podczas odtwarzania w tle. Jest to odpowiednik ustawienia wartości ExoPlayer.Builder.setWakeMode na C.WAKE_MODE_LOCAL.
  • Dodaj logikę nasłuchiwania, aby automatycznie aktualizować identyfikator urządzenia wirtualnego, gdy zmiana zostanie zgłoszona do Context pierwotnie przekazanego do ExoPlayer.Builder.
  • Dodaj ExoPlayer.setVirtualDeviceId, aby ręcznie zaktualizować identyfikator urządzenia wirtualnego uzyskany z Context przekazanego do ExoPlayer.Builder.
  • Upewnij się, że renderery nie pobierają danych z następnego elementu na liście odtwarzania dłużej niż 10 sekund przed końcem bieżącego elementu.
  • Dodaj setSeekBackIncrementMs, setSeekForwardIncrementMs i setMaxSeekToPreviousPositionMs do ExoPlayer, aby zaktualizować te ustawienia po utworzeniu (#2736).
  • Dodano funkcję wstępnego buforowania w DefaultPreloadManager. Aplikacje mogą teraz zwracać wartość DefaultPreloadManager.PreloadStatus.specifiedRangeCached(startPositionMs, durationMs) lub DefaultPreloadManager.PreloadStatus.specifiedRangeCached(durationMs) za pomocą TargetPreloadStatusControl.getTargetPreloadStatus(T rankingData), aby wskazać, że element multimedialny musi zostać wstępnie zapisany w pamięci podręcznej.
  • Użyj funkcji wstępnego buforowania DefaultPreloadManager w aplikacji demonstracyjnej krótkich filmów.
  • Dodaj ustawienia DefaultLoadControl.Builder dla odtwarzania lokalnego i dostosuj wartości domyślne DefaultLoadControl, aby dobrze współpracowały z szeroką gamą plików lokalnych.
  • Naprawiono błąd, w którym ustawienie pustej playlisty mogło pozostawić odtwarzacz w stanie STATE_READY lub STATE_BUFFERING.
  • Ulepsz interfejsy API menedżera wstępnego wczytywania:
    • Dodaj addMediaItems(List<MediaItem>, List<T>) i addMediaSources(List<MediaSource>, List<T>), które dodają elementy multimedialne lub źródła multimediów w partiach, a następnie automatycznie wywołują invalidate().
    • Dodaj funkcje removeMediaItems((List<MediaItem>) i removeMediaSources(List<MediaSource>), które usuwają elementy multimedialne lub źródła multimediów w partiach, i upewnij się, że menedżer wstępnego wczytywania nie rozpoczyna ani nie kontynuuje wstępnego wczytywania żadnego z nich po usunięciu.
    • Zezwól na automatyczne unieważnianie DefaultPreloadManager.setCurrentPlayingIndex(int). Po zaktualizowaniu bieżącego indeksu odtwarzania aplikacje nie muszą już jawnie wywoływać invalidate().
  • Dodanie możliwości pomijania resetowania klatki kluczowej w przypadku przewijania do przodu w tej samej grupie zdjęć w trybie przewijania.
  • Dodaj DefaultLoadControl.Builder.setPlayerTargetBufferBytes(String, int) w przypadku aplikacji, aby ustawić wartość docelowych bajtów bufora dla odtwarzacza z określonym playerName. DefaultLoadControl może teraz podejmować decyzje dotyczące każdego odtwarzacza osobno na podstawie przydzielonych mu bajtów i docelowych bajtów bufora.
  • Dodaj parametr SkipInfo do parametru AdPlaybackState.AdGroup, aby przekazywać informacje o możliwości pominięcia reklamy w przypadku każdej reklamy w grupie reklam.
  • Rozwiązaliśmy problem, który powodował awarię podczas wywoływania funkcji removeMediaItems(List) w trakcie odtwarzania reklamy po zakończeniu filmu (#2746).
  • Naprawiliśmy problem z zacinaniem się podczas odtwarzania playlist, gdy ramki były błędnie ustawiane jako ostatnia próbka i renderowane.
  • Włączanie ścieżki ponawiania, jeśli odtwarzacz nie może wygenerować identyfikatora sesji audio (#2382, #2678).
  • Dodano obsługę sterowania łączną liczbą bajtów bufora dla źródeł w DefaultPreloadManager, aby uniknąć dowolnego zwiększania łącznej liczby bajtów bufora na potrzeby wstępnego wczytywania. Aby użyć domyślnej logiki sterowania, aplikacje mogą ustawić docelową liczbę bajtów bufora do wstępnego wczytywania za pomocą DefaultLoadControl.Builder.setPlayerTargetBufferBytes(String, int) dla playerName o wartości PlayerId.Preload.name („preload”) i wstrzyknąć utworzony DefaultLoadControl za pomocą DefaultPreloadManager.Builder.setLoadControl(LoadControl).
• CompositionPlayer:
  • Opublikuj CompositionPlayer pod nową adnotacją @ExperimentalApi, aby wskazać, że jest ona dostępna do eksperymentowania, ale nadal jest w fazie rozwoju. Niektóre interfejsy API prawdopodobnie ulegną znacznym zmianom w przyszłych wersjach. W przypadku niektórych zastosowań występują znane problemy i ograniczenia (niektóre nie są udokumentowane).
  • Dodaliśmy obsługę właściwości COMMAND_SET_AUDIO_ATTRIBUTES i zarządzania fokusem dźwięku w CompositionPlayer.
  • Dodaliśmy obsługę zmiany prędkości w sekwencjach dodatkowych w CompositionPlayer.
• Transformer:
  • Używaj InAppMp4Muxer jako domyślnego multipleksera.
  • Dodano EditedMediaItem.Builder#setSpeed() i wycofano Effects#createExperimentalSpeedChangingEffects().
  • Zastąp forceAudioTrack i forceVideoTrack znakiem trackTypes w EditedMediaItemSequence.
• Wybór ścieżki:
  • Dodaj TrackSelectionParameters.selectTextByDefault, aby preferować wybór dowolnej ścieżki tekstowej bez określania innych, bardziej szczegółowych preferencji.
  • Dodaj preferredVideoLabels, preferredAudioLabels i preferredTextLabels w TrackSelectionParameters, aby określić preferencje dotyczące ścieżek z określoną etykietą, np. odczytanych z tagów HLS NAME (#1666).
• Ekstraktory:
  • FLAC: poprawiliśmy wykrywanie nagłówków, aby zmniejszyć prawdopodobieństwo znalezienia fałszywych nagłówków w zakodowanych danych FLAC, co powodowało błędy dekodowania (#558).
  • MP3: zezwalaj na przerwy między tagami ID3 (i przed nimi) na początku plików MP3 (#811, #5718).
  • MP4: rozróżniaj typy MIME audio/mpeg (MP3), audio/mpeg-L1 i audio/mpeg-L2, sprawdzając wartość warstwy pierwszej próbki przed wyemitowaniem formatu ścieżki z ekstraktora (#2683).
  • MP4: poprawa skuteczności wykrywania bardzo dużych plików przez założenie, że pole a stbl większe niż 1 MB oznacza, że plik nie może być podzielony na fragmenty (#2650).
  • Matroska: dodano obsługę wykrywania DTS-HD (#6225).
  • Rozwiązaliśmy problem w MatroskaExtractor, który powodował, że w przypadku plików z wieloma ścieżkami przewijanie mogło być niedokładne. Punkty wskazujące są teraz prawidłowo powiązane z odpowiednimi ścieżkami, co zapewnia dokładniejsze wyszukiwanie.
  • MP4: dodano obsługę metadanych ©mvn (nazwa części) i ©mvi (indeks części), które są teraz emitowane jako obiekty TextInformationFrame w Format.metadata z identyfikatorami MVNM i MVIN (#2754).
  • MPEG-TS: poprawiono IllegalArgumentException z ReorderingBufferQueue spowodowane przez pakiety PES bez sygnatury czasowej (#2764).
  • MP4: ignoruj ścieżki, w których brakuje pola stsd (zamiast nie analizować całego pliku).
  • Dodano obsługę wyodrębniania zdjęć Live Photo w formacie HEIC. HeifExtractor może teraz analizować pliki HEIC zawierające osadzone ścieżki wideo i audio.
  • MP3: zmiana FLAG_ENABLE_INDEX_SEEKING na preferowanie wyszukiwania informacji z nagłówków metadanych (takich jak Xing i VBRI), jeśli są dostępne, i przechodzenie do wyszukiwania opartego na indeksie, jeśli nie ma innych informacji o wyszukiwaniu. Poprawia to wydajność w przypadku plików z metadanymi wyszukiwania (#2839).
• Inspektor:
  • Wprowadziliśmy nowy moduł :media3-inspector, który będzie służyć jako dedykowane miejsce na narzędzia do sprawdzania multimediów. Ten moduł zawiera teraz nowy interfejs androidx.media3.inspector.MetadataRetriever, który zapewnia ujednolicony interfejs API do wyodrębniania metadanych i klatek. Obecna wersja androidx.media3.exoplayer.MetadataRetriever została wycofana na rzecz tej nowej wersji.
  • Wprowadziliśmy androidx.media3.inspector.FrameExtractor, nowy publiczny interfejs API do wyodrębniania klatek. Ta AutoCloseable klasa umożliwia wyodrębnianie klatek z obsługą filmów HDR, efektów wideo i wyboru niestandardowego dekodera. Należy ją utworzyć za pomocą Builder dla konkretnego MediaItem.
  • FrameExtractor: dodano getThumbnail(), aby wyodrębniać reprezentatywną klatkę miniatury z pliku multimedialnego bez konieczności podawania konkretnego znacznika czasu.
• Dźwięk:
  • Umożliwia instancjom AudioProcessor wykrywanie przewijania.
  • Zezwalaj na wstrzykiwanie nowego interfejsu AudioOutputProvider do DefaultAudioSink.Builder w celu obsługi niestandardowych ścieżek wyjścia audio. Wartość domyślna to AudioTrackAudioOutputProvider.
  • Obsługa przewijania w GainProcessor.
  • Sprawdź, czy format ścieżki obsługuje profil i poziom dekodera AC-4 (#2580).
  • Unikaj potencjalnych opóźnień spowodowanych obsługą wywołań zwrotnych zmiany routingu na początku odtwarzania (#2646).
  • Zezwalaj na ponowne użycie kodeka w przypadku formatów EAC3, EAC3-JOC i AC-4 (#1346).
  • Dodaliśmy obsługę próbek PCM zmiennoprzecinkowych w Sonic.
  • Dodano obsługę 16-bitowych próbek PCM w ToFloatPcmAudioProcessor.
• Film:
  • Wyłącz ponowne użycie kodeka w przypadku treści Dolby Vision z różnymi profilami.
• Tekst:
  • Poprawiono analizowanie napisów CEA-6/708 w treściach Dolby Vision (#2775).
• Obraz:
  • Rozwiązaliśmy problem z trybem przewijania, w którym odtwarzacz zawieszał się podczas przewijania ścieżki miniatur DASH (#2815).
• DRM:
  • Zmieniono typ zwracany metod MediaDrmCallback z byte[] na nowy typ MediaDrmCallback.Response, aby umożliwić zwracanie dodatkowych informacji opcjonalnych. Jest to zmiana powodująca niezgodność na poziomie źródła, ale niezgodności można łatwo rozwiązać, opakowując poprzednią wartość zwracaną byte[] za pomocą new Response przed zwróceniem.
  • Dodaj do niego informacje o żądaniu klucza, takie jak adres URL i opóźnienie AnalyticsListener.onDrmKeysLoaded (#1001).
  • Przenieś dane żądania obsługi administracyjnej z parametru adresu URL do treści żądania POST.
• Muxers:
  • Dodaj MediaMuxerCompat, zamiennik frameworka MediaMuxer.
  • Dodaj MuxerUtil.createMotionPhotoFromJpegImageAndBmffVideo(), aby zezwolić na tworzenie zdjęć w ruchu.
  • Dodaj WebmMuxer, aby umożliwić multipleksowanie strumieni multimediów OPUS, VORBIS, VP8 i VP9 do formatu pliku webm.
• Rozszerzenie IMA:
  • Usunięcie niestandardowych reguł ProGuard, aby aplikacje mogły zamiast nich używać reguł opublikowanych w archiwum IMA na Androida.
  • Dodano ImaServerSideAdInsertionUriBuilder.setNetworkCode, nowy interfejs API do ustawiania kodu sieci Google Ad Managera, aby pakiet IMA SDK mógł obsługiwać identyfikatory reklam zgodnie z ustawieniami Google Ad Managera. Kody sieciowe są opcjonalne, ale zalecane w przypadku żądań strumienia pełnej usługi. Aby znaleźć kod sieci, zapoznaj się z tym artykułem.
  • Zwiększono zależność IMA do wersji 3.37.0, co wymaga włączenia usuwania zbędnych elementów z biblioteki podstawowej. Musi być też włączona w zależnych aplikacjach. Zapoznaj się z uwagami dotyczącymi konfiguracji IMA.
  • Obsługa niestandardowych opcji interfejsu IMA DAI w narzędziu do tworzenia identyfikatorów URI SSAI. Opcje niestandardowego interfejsu wstawiania reklam po stronie serwera obejmują obsługę renderowania „Można pominąć” i „O tej reklamie”. Ta funkcja jest obecnie dostępna dla wybranych wydawców, którzy znajdują się na liście dozwolonych. Ta zmiana powoduje też uaktualnienie pakietu IMA SDK do wersji 3.38.0 (informacje o wersji), aby umożliwić dostęp do interfejsu API opcji niestandardowego interfejsu.
• Sesja:
  • Dodano nowy parametr do MediaSession.Callback.onPlaybackResumption, aby wskazywać, czy wywołanie służy tylko do zbierania informacji, czy do rozpoczęcia odtwarzania (#1764).
  • Zaktualizuj MediaSession.ControllerInfo.isTrusted, aby deklarować kontrolery z własnej aplikacji jako zaufane (#2542).
  • Dodano MediaSessionService.triggerNotificationUpdate, aby ręcznie wywoływać aktualizację powiadomienia (#1833).
  • Dodaj ProgressListener do metod poleceń niestandardowych.
  • Zmień domyślną wartość parametru MediaLibrarySession.Builder.setLibraryErrorReplicationMode na non fatal.
  • Dodaj parametr Context do MediaButtonReceiver.onForegroundServiceStartNotAllowedException (#2625).
  • Odczytuj identyfikator sterowania głośnością z platformy PlaybackInfo zamiast pobierać go za pomocą interfejsu Binder. Dzięki temu typ odtwarzania i identyfikator sterowania głośnością są odczytywane niepodzielnie i pasują do siebie.
  • Naprawiono błąd, który powodował, że kluczowe zdarzenia ACTION_UP były odfiltrowywane przed przekazaniem ich do wywołania zwrotnego w celu niestandardowej obsługi. Dzięki temu zachowamy spójność z tym, co robił element media1, i z tym, co robi platforma (#2637).
  • Usunęliśmy błąd, który powodował, że funkcja getCurrentTimeline() była wywoływana przez funkcję PlayerWrapper nawet wtedy, gdy polecenie nie było dostępne (#2665).
  • Naprawiono błąd, który powodował pozostawienie wiadomości w kolejce wiadomości głównego loopera, co po zakończeniu działania usługi powodowało wyciek pamięci (#2692).
  • Po połączeniu ze starszą aplikacją sesji z symbolem MediaBrowser niestandardowe polecenia są wysyłane do sesji tylko wtedy, gdy działanie niestandardowe jest reklamowane jako działanie niestandardowe w PlaybackStateCompat starszej sesji. Wszystkie inne działania niestandardowe są wysyłane do usługi.
  • Wdrożono metodę onAudioSessionIdChanged, która powiadamia kontrolery multimediów, gdy identyfikator sesji audio jest ustawiany przez sesję (#244).
  • Naprawiliśmy błąd, który powodował, że po nadejściu zdarzenia klawisza multimedialnego Intent w onStartCommand() nie uruchamiał się odtwarzacz KEYCODE_HEADSETHOOK. Problem został rozwiązany przez obsługę kodu „KEYCODE_HEADSETHOOK” tak samo jak KEYCODE_MEDIA_PLAY_PAUSE (#2816).
  • Usunięto błąd, w którym rozmiar powierzchni nie był przekazywany między sesją a kontrolerem, co powodowało niepowodzenie zastosowania efektów wideo w sesji demonstracyjnej. Jeśli używasz kontrolera, może to być zmiana powodująca błędy, jeśli odtwarzacz nie obsługuje wywołania setVideoSurfaceHolder.
  • Naprawiono propagację wartości metadanych innych niż String CharSequence, takich jak ciągi znaków w stylu span (#2853).
• UI:
  • Dodaj klasę ProgressStateWithTickInterval i odpowiedni komponent rememberProgressStateWithTickInterval do modułu media3-ui-compose. Ten obiekt stanu jest używany w demo-composedo wyświetlania bieżącej pozycji i czasu trwania w formie tekstowej.
  • Dodaj do ui-compose element MuteButtonState, który obsługuje wyciszanie Player. Ten obiekt stanu jest używany w demo-compose do wyświetlania przycisku przełączania wyciszania/wyłączania wyciszenia.
  • Dodaj klasy ProgressStateWithTickCount i odpowiedni komponent rememberProgressStateWithTickCount do modułu media3-ui-compose. Ten obiekt stanu jest używany w demo-compose do wyświetlania postępu w postaci poziomego paska postępu tylko do odczytu.
  • Dodaj element ContentFrame Composable do elementu media3-ui-compose, który łączy zarządzanie PlayerSurface ze zmianą rozmiaru proporcji i zasłanianiem za pomocą migawki.
  • Obejście znanego błędu platformy API 34, który powoduje rozciąganie lub przycinanie filmów podczas używania elementu SurfaceView w kompozycji AndroidView, a tym samym wpływa na funkcje kompozycyjne ContentFrame i PlayerSurface z elementem SURFACE_TYPE_SURFACE_VIEW (#1237, #2811).
  • Utwórz nowy media3-ui-compose-material3moduł i dodaj do niego komponenty z motywem Material3 (PlayPauseButton, NextButton, PreviousButton, SeekBackButton, SeekForwardButton, RepeatButton, ShuffleButton, MuteButton).
  • Dodaliśmy obsługę umieszczania przycisku trasy multimediów w PlayerView.
• Rozszerzenie HLS:
  • Analizowanie atrybutów pomijania reklam pełnoekranowych HLS.
  • Mapuj atrybuty sterowania pomijaniem z listy odtwarzania HLS i dokumentu listy zasobów na AdPlaybackState w celu uzyskania dostępu publicznego.
  • Rozwiązaliśmy problem polegający na tym, że czas rozpoczęcia playlisty był pomijany, gdy z playlisty usuwano tag EXT-X-PROGRAM-START-DATE określający czas rozpoczęcia (#2760).
  • Użyj wyszukiwania binarnego, aby znaleźć indeks segmentu dla danej pozycji na liście odtwarzania (#2826).
• Rozszerzenie DASH:
  • Naprawiono UnsupportedOperationException podczas odtwarzania strumieni DASH z niehierarchicznym plikiem manifestu URI data: (#2688).
  • Zresetuj wartość LiveConfiguration do wartości podanej przez MediaItem w przypadku DashMediaSource w momencie udostępnienia i aktualizacji elementu multimedialnego przez użytkownika (#2606).
  • Zapobieganie awariom spowodowanym przez nieprawidłowe aktualizacje pliku manifestu, które nie zostały zgłoszone jako błędy odtwarzacza (#2805).
• Rozszerzenie RTSP:
  • Obsługa błędu braku pakietów RTP podczas przetwarzania podzielonych jednostek NAL dla H264 i H265 (#2613).
• Rozszerzenia dekodera (FFmpeg, VP9, AV1 itp.):
  • Rozszerzenie AV1: dekoder oprogramowania AV1 korzysta teraz z wydajnej biblioteki dav1d, która zastępuje poprzednią implementację libgav1, co zwiększa szybkość dekodowania.
• Rozszerzenie Cast:
  • Dodaj CastPlayer.Builder, co umożliwia CastPlayer odtwarzanie lokalne i przesyłanie. Aby zachować stare zachowanie CastPlayer, które obsługuje tylko odtwarzanie na urządzeniu Cast, możesz użyć RemoteCastPlayer. Wcześniej istniejące konstruktory CastPlayer zachowują swoje stare działanie, ale są wycofywane na rzecz konstruktorów CastPlayer lub RemoteCastPlayer.
  • Przestań wymuszać typ MIME inny niż null w DefaultMediaItemConverter.
  • Użyj MediaItem.mediaMetadata.mediaType, aby wywnioskować typ multimediów Cast MEDIA_TYPE do użycia w DefaultCastOptionsProvider#toMediaQueueItem, jeśli jest dostępny.
  • Włącz przesyłanie z urządzenia zdalnego na lokalne w DefaultCastOptionsProvider.
  • Dodaj obsługę przesyłania w wersji demonstracyjnej sesji.
  • Dodano obsługę wyświetlania przycisku trasy multimediów w interfejsie Composable.
  • Dodano obsługę wyświetlania przycisku trasy multimediów w menu paska działań.
  • Dodaliśmy obsługę wyświetlania przycisku trasy multimediów jako interfejsu View.
• Narzędzia testowe:
  • Dodaj maksymalną różnicę czasu dla automatycznego przełączania w FakeClock. Domyślnie wynosi 1 sekundę, ale można ją skonfigurować za pomocą parametru FakeClock.Builder.
  • Dodaj maksymalną różnicę czasu między wiadomościami dla RobolectricUtil.runMainLooperUntil (i runLooperUntil). Domyślnie wynosi ona 1 sekundę, ale można ją skonfigurować za pomocą nowych przeciążeń tych metod.
  • Przenieś CapturingRenderersFactory z kampanii test-utils do kampanii test-utils-robolectric.
• Usuń symbole, które nie są już używane:
  • Usuń wycofany konstruktor DefaultPreloadManager. Zamiast niej używaj zasady DefaultPreloadManager.Builder.
  • Usunięto wycofane konstruktory EditedMediaItemSequence. Zamiast niej używaj zasady EditedMediaItemSequence.Builder.

Wersja 1.8.0

Wersja 1.8.0

30 lipca 2025 r.

Wersja 1.8.0 zawiera te zatwierdzenia.

• Biblioteka wspólna:
  • Dodaliśmy obsługę zastępowania odtwarzacza w elemencie ForwardingSimpleBasePlayer.
• ExoPlayer:
  • Dodanie funkcji pobierającej tryb odtwarzania losowego do interfejsu ExoPlayer (#2522).
  • Wyraźniejsze zgłaszanie wyjątku, jeśli do DefaultAudioSink uzyskuje się dostęp z wielu wątków. Jeśli dzieje się tak z powodu wywołania RendererCapabilities.getFormatSupport poza odtwarzaczem, wywołaj tę metodę w tym samym wątku co wątek odtwarzania ExoPlayera lub użyj innej instancji niż ta, która jest używana do odtwarzania (#1191).
  • Naprawiliśmy błąd, który powodował, że formaty dźwięku inne niż stereo na telewizorach mogły być oznaczane przez DefaultTrackSelector jako nieobsługiwane.
  • Sprawdź, czy ostatnia klatka jest prawidłowo renderowana podczas korzystania z flagi DECODE_ONLY MediaCodec (która jest domyślnie włączona w trybie przewijania).
  • Dodano obsługę identyfikatora urządzenia wirtualnego z Context przekazywanego do ExoPlayer.Builder.
  • Domyślnie włącz dynamiczne planowanie w trybie przewijania.
  • Unikaj niepotrzebnego ponownego wczytywania źródła podczas przewijania do końca elementu.
  • Domyślnie używaj MediaCodec.BUFFER_FLAG_DECODE_ONLY w trybie przewijania.
  • Wywołaj wyjątek IllegalStateException, gdy element PreloadMediaSource jest odtwarzany przez element ExoPlayer z wątkiem odtwarzania innym niż wątek wstępnego wczytywania (#2495).
  • Dodano cloneAndMove do ShuffleMode z domyślnym wdrożeniem (#2226).
  • Zmień domyślne działanie funkcji Renderer.getMinDurationToProgressUs, aby zwracała większą wartość, jeśli nie jest wymagane wywołanie funkcji render.
  • Usunięto błąd polegający na tym, że wewnętrzne planowanie opóźniało ostatnią klatkę podczas przewijania do końca w trybie wstrzymania. Obecnie poprawka błędu działa tylko wtedy, gdy włączona jest zasada ExoPlayer.Builder.experimentalSetDynamicSchedulingEnabled.
  • Dodaj metodę ExoPlayer.setScrubbingModeEnabled(boolean). Optymalizuje to odtwarzacz pod kątem wielu częstych przewijań (np. gdy użytkownik przeciąga suwak). Działanie trybu przewijania można dostosować za pomocą setScrubbingModeParameters(..) na ExoPlayer i ExoPlayer.Builder.
  • Zezwalaj na dostosowywanie tolerancji ułamkowego przewijania w trybie przewijania.
  • Zwiększ szybkość działania kodeka w trybie przewijania.
  • Naprawiono błąd, w którym błędy przygotowania w treści elementu AdsMediaSource mogły nigdy nie być zgłaszane (#2337).
  • Naprawiono wyciek pamięci w MergingMediaSource, np. podczas wczytywania napisów z zewnętrznego źródła (#2338).
  • Umożliwia zwrócenie przez CmcdConfiguration.Factory wartości null, aby wyłączyć rejestrowanie CMCD w przypadku określonych elementów multimedialnych (#2386).
  • Zwiększ domyślny rozmiar bufora obrazu ze 128 KB (błąd kopiowania i wklejania ze ścieżek tekstowych) do 26 MB, co wystarczy na obrazy Ultra HDR o rozdzielczości 50 MP (#2417).
  • Dodaj PreCacheHelper, który umożliwia aplikacjom wstępne buforowanie pojedynczego pliku multimedialnego z określoną pozycją początkową i czasem trwania.
  • Dodano obsługę wstępnego wczytywania od określonej pozycji w DefaultPreloadManager.
• Transformer:
  • Dodaj CodecDbLite, które umożliwia optymalizację ustawień kodowania wideo pod kątem konkretnego chipsetu.
  • Dodaj flagę setEnableCodecDbLite do DefaultEncoderFactory, aby włączyć optymalizację ustawień CodecDB Lite. Domyślnie ta flaga jest ustawiona na false.
  • Wypełnienie początkowej luki (dodanej za pomocą addGap()) cichym dźwiękiem wymaga teraz wyraźnego ustawienia experimentalSetForceAudioTrack(true) w EditedMediaItemSequence.Builder. Jeśli przerwa występuje w środku sekwencji, ten flag nie jest wymagany.
  • Przenieś interfejs Muxer z media3-transformer do media3-muxer.
  • Ustawienie MediaItem.Builder().setImageDuration(long) musi być obowiązkowe, aby zaimportować element multimedialny jako obraz.
  • Dodaj Transformer.Builder().experimentalSetMp4EditListTrimEnabled(boolean) zawierający listę edycji MP4 podczas przycinania, aby poinstruować odtwarzacze, aby ignorowały próbki między klatką kluczową przed punktem rozpoczęcia przycinania a punktem rozpoczęcia przycinania.
  • Zaktualizuj aplikację Composition Demo, aby używała języka Kotlin i biblioteki Jetpack Compose, oraz dodaj niestandardowy element VideoCompositorSettings do rozmieszczania sekwencji w układzie 2x2 lub PiP.
• Ekstraktory:
  • Parsowanie metadanych z fragmentowanych plików MP4 (#2084).
  • JPEG: obsługa zdjęć ruchomych, które nie mają segmentu Exif na początku (#2552).
  • Dodano obsługę przewijania w przypadku podzielonych plików MP4 z wieloma atomami sidx. Możesz włączyć to zachowanie za pomocą flagi FLAG_MERGE_FRAGMENTED_SIDX w FragmentedMp4Extractor (#9373).
  • Ignoruj puste tabele wyszukiwania w plikach FLAC (w tym te, które zawierają tylko zastępcze punkty wyszukiwania) i w przypadku znanej długości pliku przełączaj się na wyszukiwanie binarne (#2327).
  • Poprawiono analizowanie jednostek SEI H.265, aby w pełni pomijać nierozpoznane typy SEI (#2456).
  • Zaktualizuj WavExtractor, aby podczas analizowania pliku typu WAVE_FORMAT_EXTENSIBLE używać danych SubFormat z rozszerzenia nagłówka w przypadku formatu audio.
  • MP4: dodano obsługę pól ipcm i fpcm definiujących ścieżki audio PCM w formacie surowym (64-bitowy PCM zmiennoprzecinkowy nie jest obsługiwany).
  • MP4: obsługa części związanej z obrotem w tkhd macierzach przekształceń, które obracają i odbijają film. Dzięki temu odbite filmy nagrane przednim aparatem iPhone’a są wyświetlane w prawidłowej orientacji, ale nieprawidłowo odbite w osi Y (#2012).
  • MP3: używaj czasu trwania i rozmiaru danych z nieprzeszukiwalnych metadanych Xing, VBRI i podobnych metadanych o zmiennej szybkości transmisji, gdy wracasz do wyszukiwania ze stałą szybkością transmisji z powodu FLAG_ENABLE_CONSTANT_BITRATE_SEEKING(_ALWAYS) (#2194).
• Dźwięk:
  • Rozwiązanie problemu polegającego na tym, że funkcja AnalyticsListener.onAudioPositionAdvancing nie była wywoływana, gdy odtwarzanie dźwięku rozpoczynało się bardzo blisko końca multimediów.
  • Dodanie obsługi wszystkich formatów próbek liniowego PCM w ChannelMappingAudioProcessor i TrimmingAudioProcessor.
  • Dodaliśmy obsługę przerw w dźwięku w elemencie CompositionPlayer.
  • Usuń fałszywe połączenie do: BaseAudioProcessor#flush() od: BaseAudioProcessor#reset().
  • Zezwalaj na miksowanie w górę i w dół ze stałą mocą w DefaultAudioMixer.
  • Udostępnij ChannelMappingAudioProcessor, TrimmingAudioProcessor i ToFloatPcmAudioProcessor jako publiczne (#2339).
  • Użyj AudioTrack#getUnderrunCount() w AudioTrackPositionTracker, aby wykrywać niedobory w DefaultAudioSink zamiast szacowania opartego na najlepszych dostępnych danych.
  • Poprawia wygładzanie sygnatur czasowych dźwięku w przypadku nieoczekiwanego dryfowania pozycji z urządzenia wyjściowego audio.
  • Naprawiono błąd, w wyniku którego synchronizacja audio-wideo była przerywana przez pierwsze 10 sekund po wznowieniu odtwarzania po wstrzymaniu, gdy słuchawki były połączone z urządzeniami Bluetooth.
  • Rozwiązanie problemu polegającego na tym, że funkcja AnalyticsListener.onAudioPositionAdvancing nie podawała czasu rozpoczęcia odtwarzania dźwięku, ale czas pierwszego pomiaru.
  • Poprawiono przywracanie dźwięku wielokanałowego po przełączeniu na dźwięk stereo na niektórych urządzeniach (#2258).
• Film:
  • Rozszerzenie obejścia problemu z odłączonym urządzeniem Surface na urządzenia „lenovo” i „motorola” (#2059).
  • Poprawiono płynne odtwarzanie klatek wideo na początku, gdy próbki dźwięku nie zaczynają się dokładnie w żądanej pozycji.
  • Rozszerzenie obejścia odłączonej powierzchni na urządzenia „realme” (#2059).
  • Dodano eksperymentalny interfejs API ExoPlayer, który zawiera flagę MediaCodec.BUFFER_FLAG_DECODE_ONLY podczas kolejkowania buforów wejściowych tylko do dekodowania. Ten flag wskaże dekoderowi, aby pominął bufory tylko do dekodowania, co przyspieszy wyszukiwanie. Włącz ją za pomocą DefaultRenderersFactory.experimentalSetEnableMediaCodecBufferDecodeOnlyFlag.
  • Ulepszanie sprawdzania wydajności kodeków wideo w przypadku kodeków wideo w oprogramowaniu. Może to spowodować oznaczenie niektórych dodatkowych ścieżek jako EXCEEDS_CAPABILITIES.
  • Rozwiązano problemy z odtwarzaniem VP9 Widevine na niektórych urządzeniach (#2408).
• Tekst:
  • Dodanie obsługi ścieżek VobSub w plikach MP4 (#2510).
  • Naprawiono problem z zacinaniem się odtwarzania, gdy segment napisów początkowo nie wczytuje się, a później wczytuje się prawidłowo, po czym następuje kilka pustych segmentów napisów (#2517).
  • Poprawiono SSA i SubRip, aby wyświetlać w trakcie włączania napisów wskazówkę o postępie (#2309).
  • Naprawiono problem z zawieszaniem się odtwarzania podczas przełączania ze strumienia z błędem napisów na transmisję na żywo z pustą ścieżką napisów (#2328).
  • Rozwiązanie problemu z zniekształconymi napisami CEA-608 podczas odtwarzania strumieni H.262 zawierających klatki B (#2372).
  • Dodaliśmy obsługę napisów SSA z właściwością CodecId = S_TEXT/SSA w plikach Matroska. Wcześniej MatroskaExtractor obsługiwał tylko CodecId = S_TEXT/ASS, co miało oznaczać „zaawansowaną” (v4+) wersję napisów SubStation Alpha (ale logika parsowania ExoPlayera jest taka sama w przypadku obu wersji) (#2384).
  • Dodano obsługę właściwości layer w plikach napisów SubStation Alpha (SSA), która służy do określania kolejności wyświetlania wskazówek, gdy na ekranie jednocześnie pojawia się więcej niż jedna (#2124).
• Metadane:
  • Dodano obsługę pobierania czasu trwania multimediów i Timeline do MetadataRetriever oraz przeniesiono ją do interfejsu API opartego na instancjach AutoCloseable. Użyj nowego znaku Builder, aby utworzyć instancję dla MediaItem, a następnie wywołaj retrieveTrackGroups(), retrieveTimeline() i retrieveDurationUs(), aby uzyskać ListenableFuture dla metadanych. Poprzednie metody statyczne zostały wycofane (#2462).
• Obraz:
  • Ogranicz dekodowane mapy bitowe do rozmiaru wyświetlacza w BitmapFactoryImageDecoder, aby uniknąć awarii aplikacji z Canvas: trying to draw too large bitmap. z PlayerView podczas próby wyświetlenia bardzo dużych obrazów (np. 50 MP).
  • Zmień sygnaturę funkcji DefaultRenderersFactory.getImageDecoderFactory(), aby przyjmowała parametr Context.
  • Dopasuj maksymalny rozmiar wyjściowy mapy bitowej używany w CompositionPlayer do rozmiaru używanego już w Transformer (co oznacza, że CompositionPlayer nie uwzględnia rozmiaru wyświetlacza podczas dekodowania map bitowych, w przeciwieństwie do ExoPlayer).
• DRM:
  • Dodaj nowe przeciążenie funkcji OfflineLicenseHelper.newWidevineInstance akceptujące MediaItem.DrmConfiguration, aby nagłówki żądań HTTP mogły być prawidłowo stosowane (#2169).
• Skutek:
  • Dodaj Presentation.createForShortSide(int), który tworzy Presentation, aby krótszy bok zawsze pasował do podanej wartości, niezależnie od orientacji danych wejściowych.
• Muxers:
  • Naprawiliśmy błąd, który powodował, że w przypadku próbek audio w sfragmentowanym MP4 nie były ustawiane prawidłowe flagi próbek.
  • writeSampleData() Interfejs API używa teraz klasy BufferInfo zamiast MediaCodec.BufferInfo.
  • Dodaj atrybut Muxer.Factory#supportsWritingNegativeTimestampsInEditList, który domyślnie ma wartość „false”.
• Rozszerzenie IMA:
  • Naprawiliśmy błąd, który powodował, że błąd ładowania w jednej reklamie mógł przypadkowo unieważnić inną grupę reklam.
  • Naprawiliśmy błąd, który powodował, że grupy reklam po zakończeniu okna VOD zatrzymywały odtwarzanie. Grupy reklam z czasem rozpoczęcia po upływie okresu nie są już umieszczane w kolejceMediaPeriodQueue (#2215).
• Sesja:
  • Naprawiono błąd, w którym połączenia z kontrolerów Media3 innych firm bez uprawnień były ignorowane.
  • Usuń sprawdzanie dostępnych poleceń podczas wysyłania poleceń niestandardowych do starszego urządzenia MediaBrowserServiceCompat. Jest to zgodne z działaniem starszych kontrolerów i przeglądarek połączonych ze starszą aplikacją.
  • Naprawiliśmy błąd, który powodował nieprawidłowe traktowanie pierwszego błędu odtwarzania jako trwałego wyjątku niestandardowego. Uniemożliwia to przywrócenie aplikacji.
  • Naprawiliśmy błąd, w którym niektóre zmiany kontrolera nieobsługiwane przez sesję mogą powodować IllegalStateExceptions.
  • Naprawiono błąd, który powodował, że działania kontrolera nieobsługiwane przez sesję mogły pozostawiać kontroler w nieprawidłowym stanie.
  • Naprawiono ostrzeżenie o naruszeniu bezpieczeństwa podczas uruchamiania w trybie StrictMode (#2330).
  • Naprawiliśmy błąd, który powodował, że wywoływanie funkcji setSessionExtras z wątku głównego podczas uruchamiania odtwarzacza z innego wątku aplikacji niż wątek główny powodowało błąd IllegalStateException (#2265).
  • Nie wyświetlaj automatycznie powiadomienia, jeśli odtwarzacz jest skonfigurowany z elementami multimedialnymi bez ich przygotowywania lub odtwarzania (#2423 https://github.com/androidx/media/issues/2423). To zachowanie można skonfigurować za pomocą MediaSessionService.setShowNotificationForIdlePlayer.
  • Dodaj niestandardowe PlaybackException dla wszystkich lub wybranych kontrolerów.
  • Naprawiono błąd, w którym przewijanie transmisji na żywo na urządzeniu MediaController mogło powodować IllegalArgumentException.
  • W przypadku transmisji na żywo przestań publikować pozycję odtwarzania i możliwość przewijania bieżącego elementu w kontrolerach multimediów platformy, aby uniknąć artefaktów pozycji w interfejsie Androida Auto (i innych kontrolerach korzystających z tych informacji z sesji multimediów platformy) (#1758).
  • Naprawiliśmy błąd, który powodował, że przekazanie wartości null do parametru getLibraryRoot w przypadku elementu MediaBrowser połączonego ze starszym elementem MediaBrowserServiceCompat powodowało zwrócenie wartości NullPointerException.
  • Naprawiono błąd, który powodował, że wysyłanie działań niestandardowych, wyników wyszukiwania lub żądania getItem powodowało awarię starszej aplikacji sesji z błędem ClassNotFoundException.
  • Naprawiliśmy błąd, który powodował, że MediaItem.LocalConfiguration.uri było udostępniane w MediaMetadata sesji platformy. Aby celowo udostępnić identyfikator URI, aby umożliwić kontrolerom ponowne żądanie multimediów, ustaw wartość MediaItem.RequestMetadata.mediaUri.
• UI:
  • Rozwiązaliśmy błąd, który powodował, że element PlayerSurface w komponentach wielokrotnego użytku, takich jak LazyColumn, nie działał prawidłowo (#2493).
  • Naprawiono błąd w Compose, który powodował przerwę między ustawieniem początkowych stanów przycisków a zaobserwowaniem zmiany stanu (np. kształtów ikon lub włączenia). Wszystkie zmiany wprowadzone w odtwarzaczu poza okresem obserwacji są teraz uwzględniane (#2313).
  • Dodaj do modułu media3-ui-compose elementy przechowujące stan i funkcje kompozycyjne dla SeekBackButtonState i SeekForwardButtonState.
  • Dodaj do elementu PlayerControlView obsługę trybu przewijania ExoPlayera. Gdy ta opcja jest włączona, odtwarzacz przechodzi w tryb przewijania, gdy użytkownik zaczyna przeciągać pasek przewijania. W przypadku każdego ruchu wysyłane jest wywołanie player.seekTo, a tryb przewijania jest wyłączany, gdy użytkownik odsunie palec od ekranu. Tę integrację można włączyć za pomocą elementu time_bar_scrubbing_enabled = true w XML lub metody setTimeBarScrubbingEnabled(boolean) w kodzie Java/Kotlin.
  • Spraw, aby funkcja PlayerSurface akceptowała argument z wartością null Player.
• Pobrane:
  • Dodaliśmy obsługę częściowego pobierania w przypadku strumieni progresywnych. Aplikacje mogą przygotować strumień progresywny za pomocą DownloadHelper i poprosić o DownloadRequest z pomocniczego interfejsu API, określając czasowe pozycje początkową i końcową multimediów, które mają być objęte pobieraniem. Zwrócony obiekt DownloadRequest zawiera rozwiązany zakres bajtów, za pomocą którego można utworzyć obiekt ProgressiveDownloader i pobrać odpowiednie treści.
  • Dodaj DownloadHelper.Factory, którym zastąpione zostaną metody statyczne DownloadHelper.forMediaItem().
  • Dodaj Factory do implementacji SegmentDownloader.
  • Dodano obsługę częściowego pobierania w przypadku strumieni adaptacyjnych. Aplikacje mogą przygotować strumień adaptacyjny z DownloadHelper i poprosić o DownloadRequest z pomocnika, określając czasowe pozycje początkowe i końcowe multimediów, które powinny być objęte pobieraniem. Zwrócony element DownloadRequestzawiera rozwiązany zakres czasu, na podstawie którego można utworzyć konkretny element SegmentDownloader i pobrać odpowiednie treści.
• Rozszerzenie Cronet:
  • Dodanie automatycznej obsługi plików cookie (#5975).
• Rozszerzenie HLS:
  • Naprawiono błąd, który powodował, że HlsSampleStreamWrapper próbuje wyszukać w buforze, gdy nie ma w nim żadnych fragmentów #2598.
  • Naprawiono błąd, w wyniku którego po załadowaniu części o niskim opóźnieniu zmieniał się wybór ścieżki, a wskazówki dotyczące wstępnego wczytywania mogły powodować zawieszenie odtwarzania (#2299).
  • Zapobieganie nadmiernemu ponownemu ładowaniu przez odczekanie połowy docelowego czasu trwania, gdy serwer nie uwzględnia parametru CAN-BLOCK-RELOAD=YES (#2317).
  • Naprawiono błąd, który powodował zatrzymanie odtwarzania podczas uruchamiania strumienia reklam pełnoekranowych przed reklamą w trakcie filmu, a rozpoznawanie listy komponentów było podejmowane w przypadku nieprawidłowej reklamy (#2558).
  • Poprawiono analizowanie playlisty, aby akceptować znak \f (form feed) w wartościach atrybutów w cudzysłowie (#2420).
  • Obsługa aktualizowania reklam pełnoekranowych o tym samym identyfikatorze (#2427).
  • Naprawiliśmy błąd, który powodował, że błędy ładowania playlisty nie były czasami propagowane, gdy w transmisji na żywo zabrakło segmentów do załadowania (#2401https://github.com/androidx/media/issues/2401).
  • Grupuj wersje napisów według tagu NAME, podobnie jak wersje audio (#1666).
  • Obsługa list X-ASSET-LIST i transmisji na żywo z HlsInterstitialsAdsLoader.
• Rozszerzenie DASH:
  • Rozwiązanie problemu polegającego na tym, że zestaw adaptacyjny z szybkim przewijaniem jest łączony z głównym zestawem adaptacyjnym, tworząc nieprawidłowy element TrackGroup (#2148).
  • Naprawiono błąd, który powodował, że skracanie okresu DASH mogło wywoływać wyjątek, gdy potok renderowania odczytał już próbki wykraczające poza nowy czas trwania (#2440).
  • Rozwiązaliśmy błąd, który powodował, że przekierowanie nie było śledzone podczas używania parametrów zapytania CMCD (#2475).
• Rozszerzenie RTSP:
  • Dodano obsługę pakietu agregacji RTP dla H265 zgodnie z RFC 7798#4.4.2 (#2413).
  • Poprawiono RtspClient, aby podczas przetwarzania odpowiedzi HTTP 302 używać identyfikatora URI lokalizacji podanego w odpowiedzi (#2398).
  • Dodano obsługę analizowania opisów sesji zawierających wiersze z białymi znakami na końcu (#2357).
• Rozszerzenia dekodera (FFmpeg, VP9, AV1 itp.):
  • Naprawiono błąd, w wyniku którego parametr DefaultTrackSelector.setAllowInvalidateSelectionsOnRendererCapabilitiesChange nie miał wpływu na rozszerzenia dekodera audio (#2258).
• Rozszerzenie Cast:
  • Dodano obsługę setVolume() i getVolume() (#2279).
  • Zapobiegaj przechodzeniu CastPlayer w stan STATE_BUFFERING, gdy oś czasu jest pusta.
  • Dodano obsługę getDeviceVolume(), setDeviceVolume(), getDeviceMuted() i setDeviceMuted() (#2089).
• Narzędzia testowe:
  • Dodaj advance(player).untilPositionAtLeast i untilMediaItemIndex do TestPlayerRunHelper, aby przesunąć gracza do określonej pozycji. W większości przypadków te metody są bardziej niezawodne niż dotychczasowe metody untilPosition i untilStartOfMediaItem.
  • Przenieś FakeDownloader do modułu test-utils-robolectric, aby można było go używać w innych testach.
  • Usunięto: transformer.TestUtil.addAudioDecoders(String...), transformer.TestUtil.addAudioEncoders(String...) i transformer.TestUtil.addAudioEncoders(ShadowMediaCodec.CodecConfig, String...). Zamiast tego skonfiguruj enkodery i dekodery cieni za pomocą ShadowMediaCodecConfig.
  • W nazwach kodeków zgłaszanych przez ShadowMediaCodecConfig prefiks „exotest” został zastąpiony prefiksem „media3”.
• Usuń symbole, które nie są już używane:
  • Usunięto wycofany konstruktor SegmentDownloader SegmentDownloader(MediaItem, Parser<M>, CacheDataSource.Factory, Executor) i odpowiednie konstruktory w jego podklasach: DashDownloader, HlsDownloader i SsDownloader.
  • Usunięto wycofane Player.hasNext(), Player.hasNextWindow(). Zamiast niej używaj zasady Player.hasNextMediaItem().
  • Usunięto wycofaną funkcję Player.next(). Zamiast niej użyj zasady Player.seekToNextMediaItem().
  • Usunięto wycofaną funkcję Player.seekToPreviousWindow(). Zamiast niej używaj zasady Player.seekToPreviousMediaItem().
  • Usunięto wycofaną funkcję Player.seekToNextWindow(). Zamiast niej używaj zasady Player.seekToNextMediaItem().
  • Usunięto wycofany element BaseAudioProcessor w module exoplayer. Użyj opcji BaseAudioProcessor w module common.
  • Usuń wycofany konstruktor MediaCodecVideoRendererMediaCodecVideoRenderer(Context, MediaCodecAdapter.Factor, MediaCodecSelector, long, boolean, @Nullable Handler, @Nullable VideoRendererEventListener, int, float, @Nullable VideoSinkProvider).

Wersja 1.8.0-rc02

24 lipca 2025 r.

Używaj stabilnej wersji 1.8.0.

Wersja 1.8.0-rc01

16 lipca 2025 r.

Używaj stabilnej wersji 1.8.0.

Wersja 1.8.0-beta01

2 lipca 2025 r.

Używaj stabilnej wersji 1.8.0.

Wersja 1.8.0-alpha01

19 maja 2025 r.

Używaj stabilnej wersji 1.8.0.

Wersja 1.7.0

Wersja 1.7.1

16 maja 2025 r.

Ta wersja ma ten sam kod co wersja 1.6.1 i została opublikowana, aby była traktowana jako „nowsza” niż wersja 1.7.0, która była wersją alfa przypadkowo oznaczoną jako stabilna (patrz poniżej).

Wersja 1.7.0

16 maja 2025 r.

Ta wersja powinna mieć oznaczenie 1.7.0-alpha01, ale na maven.google.com została omyłkowo oznaczona jako 1.7.0 (czyli stabilna). Nie używaj jej. Pozostań przy wersji 1.6.1 lub uaktualnij ją do wersji 1.7.1 (która ma ten sam kod co wersja 1.6.1).

Wersja 1.6.0

1.6.1

14 kwietnia 2025 r.

Publikacja androidx.media3:media3-*:1.6.1 Wersja 1.6.1 zawiera te zmiany.

• Biblioteka wspólna:
  • Dodano metodę PlaybackParameters.withPitch(float), która ułatwia kopiowanie elementu a PlaybackParameters z nową wartością pitch (#2257).
• ExoPlayer:
  • Rozwiązanie problemu polegającego na tym, że przejście między elementami multimedialnymi kończyło się niepowodzeniem z powodu błędu odtwarzacza, który można było naprawić, podczas inicjowania następnego elementu multimedialnego (#2229).
  • Rozwiązanie problemu polegającego na tym, że funkcja ProgressiveMediaPeriod zgłaszała błąd IllegalStateException, gdy funkcja PreloadMediaSource próbowała wywołać funkcję getBufferedDurationUs() przed jej przygotowaniem (#2315).
  • Naprawiono wysyłanie CmcdData w żądaniach manifestu w przypadku DASH, HLS i SmoothStreaming (#2253).
  • Upewnij się, że po usunięciu grup reklam możesz nadal używać AdPlaybackState.withAdDurationsUs(long[][]). Użytkownik nadal musi przekazywać tablicę czasów trwania usuniętych grup reklam, która może być pusta lub mieć wartość null (#2267).
• Ekstraktory:
  • MP4: przeanalizuj alternate_group z pola tkhd i udostępnij go jako wpis Mp4AlternateGroupData w Format.metadata każdego ścieżki (#2242).
• Dźwięk:
  • Rozwiązano problem z przekazywaniem, w którym pozycja mogła się zablokować podczas odtwarzania playlisty z krótkimi treściami (#1920).
• Sesja:
  • Zmniejsz limit czasu oczekiwania na wywołania zwrotne platformy MediaSession z 500 ms do 100 ms i dodaj eksperymentalny setter, aby umożliwić aplikacjom konfigurowanie tej wartości.
  • Rozwiązaliśmy problem, który powodował, że powiadomienia pojawiały się ponownie po ich zamknięciu przez użytkownika (#2302).
  • Naprawiliśmy błąd polegający na tym, że sesja zwracała oś czasu z 1 elementem, gdy opakowany odtwarzacz był pusty. Dzieje się tak, gdy w odtwarzaczu opakowanym nie jest dostępna funkcja COMMAND_GET_TIMELINE, a funkcja COMMAND_GET_CURRENT_MEDIA_ITEM jest dostępna i odtwarzacz opakowany jest pusty (#2320).
  • Rozwiązanie problemu polegającego na tym, że wywołanie funkcji MediaSessionService.setMediaNotificationProvider jest cicho ignorowane po innych interakcjach z usługą, takich jak setForegroundServiceTimeoutMs (#2305).
• UI:
  • Włącz PlayerSurface, aby korzystać z ExoPlayer.setVideoEffects i CompositionPlayer.
  • Naprawiono błąd, który uniemożliwiał ponowne utworzenie PlayerSurface za pomocą nowego Player.
• Rozszerzenie HLS:
  • Rozwiązaliśmy problem polegający na tym, że czas trwania fragmentu nie był ustawiony w CmcdData w przypadku multimediów HLS, co powodowało błąd asercji podczas przetwarzania zaszyfrowanych segmentów multimediów (#2312).
• Rozszerzenie RTSP:
  • Dodano obsługę identyfikatora URI ze schematem RTSPT jako sposobu konfigurowania sesji RTSP do korzystania z TCP (#1484).
• Rozszerzenie Cast:
  • Dodanie obsługi metadanych playlisty (#2235).

1.6.0

26 marca 2025 r.

Publikacja androidx.media3:media3-*:1.6.0 Wersja 1.6.0 zawiera te zmiany.

• Biblioteka wspólna:
  • Dodaj AudioManagerCompat i AudioFocusRequestCompat, aby zastąpić równoważne klasy w androidx.media.
  • Zaktualizuj język Kotlin z wersji 1.9.20 do 2.0.20 i użyj wtyczki Gradle kompilatora Compose. Uaktualniliśmy bibliotekę KotlinX Coroutines z wersji 1.8.1 do 1.9.0.
  • Usuń metodę Format.toBundle(boolean excludeMetadata) i użyj zamiast niej metody Format.toBundle().
  • Usunęliśmy błąd w SimpleBasePlayer, który powodował, że ustawienie nowego currentMediaItemIndex w State po setPlaylist z null MediaMetadata nie powodowało ponownej oceny metadanych (#1940).
  • Zmień dostęp do SimpleBasePlayer.State z chronionego na publiczny, aby ułatwić obsługę aktualizacji w innych klasach (#2128).
• ExoPlayer:
  • Dodaj MediaExtractorCompat, nową klasę, która zapewnia funkcje równoważne z platformą MediaExtractor.
  • Dodano eksperymentalną obsługę wstępnego rozgrzewania „ExoPlayera” do odtwarzania za pomocą MediaCodecVideoRenderer. Możesz skonfigurować DefaultRenderersFactory za pomocą experimentalSetEnableMediaCodecVideoRendererPrewarming, aby zapewnić dodatkowy MediaCodecVideoRenderer dla ExoPlayer. Jeśli ta opcja jest włączona, ExoPlayer wstępnie przetwarza film z kolejnych elementów multimedialnych podczas odtwarzania, aby zmniejszyć opóźnienie przejścia między elementami multimedialnymi.
  • Zmniejsz wartości domyślne parametrów bufferForPlaybackMs i bufferForPlaybackAfterRebufferMs w DefaultLoadControl do odpowiednio 1000 i 2000 ms.
  • Asynchroniczne inicjowanie DeviceInfo i głośności urządzenia (jeśli jest włączone za pomocą setDeviceVolumeControlEnabled). Te wartości nie są dostępne od razu po wywołaniu ExoPlayer.Builder.build(), a Player.Listener powiadamia o zmianach za pomocą onDeviceInfoChanged i onDeviceVolumeChanged.
  • Początkowy identyfikator sesji audio nie jest już dostępny od razu po utworzeniu odtwarzacza. W razie potrzeby możesz użyć przycisku AnalyticsListener.onAudioSessionIdChanged, aby odsłuchać początkową aktualizację.
  • Podczas wybierania ścieżki wideo weź pod uwagę język. Domyślnie wybierz „główną” ścieżkę wideo, która pasuje do języka wybranej ścieżki audio, jeśli jest dostępna. Wyraźne preferencje dotyczące języka filmu można wyrazić za pomocą parametru TrackSelectionParameters.Builder.setPreferredVideoLanguage(s).
  • Dodaj parametr selectedAudioLanguage do metody DefaultTrackSelector.selectVideoTrack().
  • Dodaj parametr retryCount do metod MediaSourceEventListener.onLoadStarted i odpowiednich metod MediaSourceEventListener.EventDispatcher.
  • Naprawiliśmy błąd, w którym elementy playlisty lub okresy w strumieniach DASH z wieloma okresami o czasie trwania niezgodnym z rzeczywistą treścią mogły powodować zamrożenie klatek na końcu elementu (#1698).
  • Przenieś BasePreloadManager.Listener na najwyższy poziomPreloadManagerListener.
  • RenderersFactory.createSecondaryRenderer można wdrożyć, aby zapewnić dodatkowe mechanizmy renderowania do wstępnego rozgrzewania. Wstępne wczytywanie umożliwia szybsze przechodzenie między elementami multimedialnymi podczas odtwarzania.
  • Włącz wysyłanie CmcdData w przypadku żądań manifestu w adaptacyjnym strumieniowym przesyłaniu danych w formatach DASH, HLS i SmoothStreaming (#1951).
  • Podaj MediaCodecInfo kodeka, który zostanie zainicjowany w MediaCodecRenderer.onReadyToInitializeCodec(#1963).
  • Zmień AdsMediaSource, aby umożliwić AdPlaybackStates powiększanie się przez dodawanie grup reklam. Wykryte nieprawidłowe modyfikacje powodują zgłoszenie wyjątku.
  • Rozwiązaliśmy problem polegający na tym, że po reklamie w trakcie filmu podczas przechodzenia do treści multimedialnych w szybkim tempie mogły być wyświetlane dodatkowe ramki tylko do dekodowania.
  • Spraw, aby DefaultRenderersFactory dodać 2 instancje MetadataRenderer, aby aplikacje domyślnie otrzymywały 2 różne schematy metadanych.
  • Ponownie oceń, czy trwające wczytywanie fragmentu powinno zostać anulowane, gdy odtwarzanie jest wstrzymane (#1785).
  • Dodanie opcji ClippingMediaSource, która umożliwia wycinanie fragmentów z mediów, których nie można przewijać.
  • Naprawiliśmy błąd, który powodował, że przewijanie z wstępnym buforowaniem mogło blokować przejście do następnego elementu multimedialnego.
  • Usunęliśmy błąd, w którym ExoPlayer.isLoading() pozostawał true, mimo że przeszedł w stan STATE_IDLE lub STATE_ENDED (#2133).
  • Dodano lastRebufferRealtimeMs do LoadControl.Parameter (#2113).
• Transformer:
  • Dodanie obsługi transkodowania do alternatywnych formatów zgodnych wstecznie.
  • Dodano obsługę transkodowania i transmuksowania formatu Dolby Vision (profil 8).
  • Zaktualizuj parametry VideoFrameProcessor.registerInputStream i VideoFrameProcessor.Listener.onInputStreamRegistered, aby korzystały z Format.
  • Generuj statyczne metadane HDR, gdy używasz DefaultEncoderFactory.
  • Włącz obsługę diagnostyki platformy Android za pomocą MediaMetricsManager. Moduł Transformer przekazuje do platformy zdarzenia edycji i dane o wydajności, co pomaga dostarczać na urządzeniu informacje o wydajności systemu i debugowaniu. Dane te mogą być też gromadzone przez Google, jeśli użytkownik urządzenia włączy udostępnianie danych o użyciu i diagnostyce. Aplikacje mogą zrezygnować z przesyłania danych na potrzeby diagnostyki platformy dla narzędzia Transformer za pomocą parametru Transformer.Builder.setUsePlatformDiagnostics(false).
  • Podziel InAppMuxer na InAppMp4Muxer i InAppFragmentedMp4Muxer. InAppMp4Muxer służy do tworzenia niesfragmentowanego pliku MP4, a InAppFragmentedMp4Muxer – do tworzenia sfragmentowanego pliku MP4.
  • Przenieś interfejs Muxer z media3-muxer do media3-transformer.
  • Dodaj MediaProjectionAssetLoader, który udostępnia multimedia z MediaProjection na potrzeby nagrywania ekranu, i dodaj obsługę nagrywania ekranu do aplikacji demonstracyjnej Transformer.
  • Dodaj #getInputFormat() do interfejsu Codec.
  • Przenieś odpowiedzialność za zwolnienie GlObjectsProvider na dzwoniącego w przypadku połączeń w DefaultVideoFrameProcessor i DefaultVideoCompositor, gdy jest to możliwe.
• Ekstraktory:
  • AVI: poprawiono obsługę plików z audio skompresowanym ze stałą szybkością transmisji, w których nagłówek strumienia zawiera liczbę bajtów zamiast liczby fragmentów.
  • Poprawiono obsługę jednostek NAL o długości wyrażonej w 1 lub 2 bajtach (zamiast 4).
  • Naprawiono błąd ArrayIndexOutOfBoundsException na listach edycji MP4, gdy lista edycji zaczyna się od klatki niesynchronizowanej bez poprzedzającej klatki synchronizacji (#2062).
  • Rozwiązanie problemu polegającego na tym, że strumienie TS mogą się zawieszać na niektórych urządzeniach (#2069).
  • FLAC: dodaliśmy obsługę 32-bitowych plików FLAC. Wcześniej nie można było ich odtworzyć w IllegalStateException: Playback stuck buffering and not loading (#2197).
• Dźwięk:
  • Poprawiono wywoływanie funkcji onAudioPositionAdvancing po wznowieniu odtwarzania (wcześniej była wywoływana po wstrzymaniu odtwarzania).
  • Nie pomijaj SonicAudioProcessor, gdy SpeedChangingAudioProcessor jest skonfigurowany z parametrami domyślnymi.
  • Rozwiązaliśmy problem z niedomiarem w Sonic#getOutputSize(), który mógł powodować zatrzymanie DefaultAudioSink.
  • Popraw MediaCodecAudioRenderer.getDurationToProgressUs() i DecoderAudioRenderer.getDurationToProgressUs(), aby prawidłowo resetować podane czasy trwania.
  • Ustawić numer androidx.media3.common.audio.SonicAudioProcessor jako stały.
  • Dodaliśmy obsługę zmiennoprzecinkowego PCM do elementów ChannelMappingAudioProcessor i TrimmingAudioProcessor.
• Film:
  • Zmień MediaCodecVideoRenderer.shouldUsePlaceholderSurface na protected, aby aplikacje mogły zastępować blokowanie użycia powierzchni zastępczych (#1905).
  • Dodano eksperymentalną analizę zależności próbki AV1 ExoPlayer, aby przyspieszyć wyszukiwanie. Włącz go za pomocą nowego interfejsu API DefaultRenderersFactory.experimentalSetParseAv1SampleDependencies.
  • Dodano eksperymentalny interfejs API ExoPlayer, który umożliwia odrzucanie opóźnionych buforów wejściowych dekodera MediaCodecVideoRenderer, od których nie zależy działanie dekodera. Włącz ją za pomocą DefaultRenderersFactory.experimentalSetLateThresholdToDropDecoderInputUs.
  • Rozwiązaliśmy problem polegający na tym, że odtwarzacz bez powierzchni był od razu gotowy i bardzo wolno dekodował oczekujące klatki (#1973).
  • Wykluczanie urządzeń Xiaomi i OPPO z trybu odłączonej powierzchni, aby uniknąć migotania ekranu (#2059).
• Tekst:
  • Dodano obsługę napisów VobSub (#8260).
  • Zaprzestanie wczytywania z wyprzedzeniem wszystkich plików z napisami skonfigurowanych za pomocą parametru MediaItem.Builder.setSubtitleConfigurations i wczytywanie tylko jednego z nich, jeśli zostanie wybrany przez funkcję wyboru ścieżki (#1721).
  • TTML: dodano obsługę odwoływania się do tts:origin i tts:extent za pomocą style (#2953).
  • Ogranicz znaczniki czasu WebVTT i SubRip do dokładnie 3 miejsc po przecinku. Wcześniej nieprawidłowo analizowaliśmy dowolną liczbę miejsc po przecinku, ale zawsze zakładaliśmy, że wartość jest podana w milisekundach, co prowadziło do nieprawidłowych sygnatur czasowych (#1997).
  • Naprawiono zawieszanie się odtwarzania, gdy playlista zawierała przycięte elementy z napisami CEA-608 lub CEA-708.
  • Naprawiono IllegalStateException, gdy plik SSA zawierał wskazówkę o zerowym czasie trwania (czas rozpoczęcia i zakończenia były takie same) (#2052).
  • Tłumienie (i rejestrowanie) błędów analizowania napisów, gdy są one multipleksowane w tym samym kontenerze co audio i wideo (#2052).
  • Poprawiono obsługę wielobajtowych znaków UTF-8 w plikach WebVTT z zakończeniami wierszy CR (#2167).
• DRM:
  • Naprawiono błąd MediaCodec$CryptoException: Operation not supported in this configuration podczas odtwarzania treści ClearKey na urządzeniach z interfejsem API w wersji starszej niż 27 (#1732).
• Skutek:
  • Przeniesiono funkcję OverlaySettings do StaticOverlaySettings. OverlaySettings można podzielić na klasy podrzędne, aby umożliwić dynamiczne ustawienia nakładki.
• Muxers:
  • Przeniesiono MuxerException z interfejsu Muxer, aby uniknąć bardzo długiej, w pełni kwalifikowanej nazwy.
  • Zmieniono nazwę metody setSampleCopyEnabled() na setSampleCopyingEnabled() w przypadku Mp4Muxer.Builder i FragmentedMp4Muxer.Builder.
  • Mp4Muxer.addTrack() i FragmentedMp4Muxer.addTrack() zwracają teraz identyfikator ścieżki int zamiast TrackToken.
  • Metody Mp4Muxer i FragmentedMp4Muxer nie implementują już interfejsu Muxer.
  • Wyłącz domyślnie Mp4Muxer próbkowanie i kopiowanie.
  • Napraw błąd w FragmentedMp4Muxer, który powoduje tworzenie wielu fragmentów, gdy zapisywana jest tylko ścieżka audio.
• Sesja:
  • Utrzymanie stanu usługi na pierwszym planie przez dodatkowe 10 minut, gdy odtwarzanie zostanie wstrzymane, zatrzymane lub zakończy się niepowodzeniem. Dzięki temu użytkownicy mogą wznowić odtwarzanie w tym czasie bez ryzyka ograniczeń dotyczących usług na pierwszym planie na różnych urządzeniach. Pamiętaj, że wywołanie player.pause() nie może już służyć do zatrzymywania usługi na pierwszym planie przed stopSelf() podczas zastępowania onTaskRemoved. Zamiast tego użyj MediaSessionService.pauseAllPlayersAndStopSelf().
  • Zachowaj widoczność powiadomienia, gdy odtwarzanie przejdzie w stan błędu lub zatrzymania. Powiadomienie jest usuwane tylko wtedy, gdy playlista zostanie wyczyszczona lub odtwarzacz zostanie zwolniony.
  • Ulepszono obsługę działań ACTION_PLAY i ACTION_PAUSE w MediaSession na platformie Android, aby ustawiać tylko jedno z nich zgodnie z dostępnymi poleceniami, a także akceptować sytuację, w której ustawione jest tylko jedno z nich.
  • Dodanie Context jako parametru do MediaButtonReceiver.shouldStartForegroundService (#1887).
  • Naprawiono błąd, który powodował, że wywołanie metody Player na połączonym MediaController z sesją starszego typu powodowało utratę zmian z oczekującej aktualizacji.
  • Umożliwienie funkcji MediaSession.setSessionActivity(PendingIntent) akceptowania wartości null (#2109).
  • Usunęliśmy błąd, który powodował, że po wyczyszczeniu playlisty nadal wyświetlało się nieaktualne powiadomienie (#2211).
• UI:
  • Dodaj do modułu media3-ui-compose elementy przechowujące stan i funkcje kompozycyjne dla PlayerSurface, PresentationState, PlayPauseButtonState, NextButtonState, PreviousButtonState, RepeatButtonState, ShuffleButtonState i PlaybackSpeedState.
• Pobrane:
  • Naprawiono błąd w CacheWriter, który powodował, że źródła danych pozostawały otwarte, a obszary pamięci podręcznej były zablokowane, jeśli źródło danych zgłaszało błąd Exception inny niż IOException (#9760).
• Rozszerzenie HLS:
  • Dodaj pierwszą wersję HlsInterstitialsAdsLoader. Moduł wczytywania reklam odczytuje reklamy pełnoekranowe HLS z playlisty multimediów HLS i mapuje je na AdPlaybackState, które jest przekazywane do AdsMediaSource. Ta początkowa wersja obsługuje tylko strumienie VOD HLS z atrybutami X-ASSET-URI.
  • Dodaj HlsInterstitialsAdsLoader.AdsMediaSourceFactory. Aplikacje mogą go używać do tworzenia instancji AdsMediaSource, które w wygodny i bezpieczny sposób korzystają z HlsInterstitialsAdsLoader.
  • Analizowanie tagu SUPPLEMENTAL-CODECS z playlisty HLS w celu wykrywania formatów Dolby Vision (#1785).
  • Złagodzenie warunku wyszukiwania pozycji do synchronizacji w strumieniu HLS (#2209).
• Rozszerzenie DASH:
  • Dodanie obsługi formatu AC-4 Level-4 w przypadku DASH (#1898).
  • Rozwiązano problem z obliczaniem interwału aktualizacji wstawiania reklam w transmisjach na żywo z wieloma okresami (#1698).
  • Analizowanie atrybutu scte214:supplementalCodecs z pliku manifestu DASH w celu wykrywania formatów Dolby Vision (#1785).
  • Poprawiono obsługę przejść między okresami w transmisjach na żywo, w których okres zawiera próbki multimediów wykraczające poza zadeklarowany czas trwania okresu (#1698).
  • Rozwiązanie problemu, w którym zestawy adaptacyjne oznaczone symbolem adaptation-set-switching, ale z różnymi językami lub flagami ról są łączone ze sobą (#2222).
• Rozszerzenia dekodera (FFmpeg, VP9, AV1 itp.):
  • Dodano moduł dekodera MPEG-H, który używa wbudowanego dekodera MPEG-H do dekodowania dźwięku MPEG-H (#1826).
• Rozszerzenie MIDI:
  • Przekazywanie niestandardowych instancji AudioSink i AudioRendererEventListener do MidiRenderer.
• Rozszerzenie Cast:
  • Zaktualizuj zależność play-services-cast-framework do wersji 21.5.0, aby naprawić FLAG_MUTABLE awarię w aplikacjach kierowanych na interfejs API 34 lub nowszy na urządzeniach z zainstalowanymi, ale wyłączonymi usługami Google Play (#2178).
• Aplikacja w wersji demonstracyjnej:
  • Rozszerz możliwości demo-compose o dodatkowe przyciski i ulepsz integrację PlayerSurface dzięki obsłudze skalowania i migawki.
• Usuń symbole, które nie są już używane:
  • Usuń wycofaną metodę AudioMixer.create(). Zamiast niej używaj zasady DefaultAudioMixer.Factory().create().
  • Usuń te wycofane metody Transformer.Builder:
    • setTransformationRequest(), użyj zamiast niej zasad setAudioMimeType(),setVideoMimeType() i setHdrMode().
    • setAudioProcessors(), ustaw procesor dźwięku w EditedMediaItem.Builder.setEffects() i przekaż go do Transformer.start().
    • setVideoEffects(), ustaw efekt wideo w EditedMediaItem.Builder.setEffects() i przekaż go do Transformer.start().
    • setRemoveAudio(), użyj EditedMediaItem.Builder.setRemoveAudio(), aby usunąć dźwięk z EditedMediaItem przekazywanego do Transformer.start().
    • setRemoveVideo(), użyj EditedMediaItem.Builder.setRemoveVideo(), aby usunąć film z EditedMediaItem przekazanego do Transformer.start().
    • setFlattenForSlowMotion(), użyj EditedMediaItem.Builder.setFlattenForSlowMotion(), aby spłaszczyć EditedMediaItem przekazane do Transformer.start().
    • setListener(), użyj addListener(), removeListener() lub removeAllListeners().
  • Usuń te wycofane metody Transformer.Listener:
    • onTransformationCompleted(MediaItem), użyj onCompleted(Composition, ExportResult).
    • onTransformationCompleted(MediaItem, TransformationResult), użyj onCompleted(Composition, ExportResult).
    • onTransformationError(MediaItem, Exception), użyj onError(Composition, ExportResult, ExportException).
    • onTransformationError(MediaItem, TransformationException), użyj onError(Composition, ExportResult, ExportException).
    • onTransformationError(MediaItem, TransformationResult, TransformationException), użyj onError(Composition, ExportResult, ExportException).
    • onFallbackApplied(MediaItem, TransformationRequest, TransformationRequest), użyj onFallbackApplied(Composition, TransformationRequest, TransformationRequest).
  • Usuń wycofane zajęcia TransformationResult. Zamiast niej użyj zasady ExportResult.
  • Usuń wycofane zajęcia TransformationException. Zamiast niej użyj zasady ExportException.
  • Usuń wycofane Transformer.PROGRESS_STATE_NO_TRANSFORMATION. Zamiast niej używaj zasady Transformer.PROGRESS_STATE_NOT_STARTED.
  • Usuń wycofane Transformer.setListener(). Zamiast niej używaj kolumn Transformer.addListener(), Transformer.removeListener() lub Transformer.removeAllListeners().
  • Usuń wycofane Transformer.startTransformation(). Zamiast niej używaj zasady Transformer.start(MediaItem, String).
  • Usuń wycofane SingleFrameGlShaderProgram. Zamiast niej używaj zasady BaseGlShaderProgram.
  • Usuń Transformer.flattenForSlowMotion. Zamiast niej używaj zasady EditedMediaItem.flattenForSlowMotion.
  • Usunięto: ExoPlayer.VideoComponent, ExoPlayer.AudioComponent, ExoPlayer.TextComponent i ExoPlayer.DeviceComponent.
  • Użytkownik androidx.media3.exoplayer.audio.SonicAudioProcessor został usunięty.
  • Usunęliśmy te wycofane metody DownloadHelper:
    • Konstruktor DownloadHelper(MediaItem, @Nullable MediaSource, TrackSelectionParameters, RendererCapabilities[]), użyj DownloadHelper(MediaItem, @Nullable MediaSource, TrackSelectionParameters, RendererCapabilitiesList).
    • getRendererCapabilities(RenderersFactory), równoważną funkcję można uzyskać, tworząc DefaultRendererCapabilitiesList z RenderersFactory i wywołując DefaultRendererCapabilitiesList.getRendererCapabilities().
  • Usunięto metodę PlayerNotificationManager.setMediaSessionToken(MediaSessionCompat). Użyj funkcji PlayerNotificationManager.setMediaSessionToken(MediaSession.Token) i przekaż wartość (MediaSession.Token) compatToken.getToken().

1.6.0-rc02

19 marca 2025 r.

Używaj stabilnej wersji 1.6.0.

1.6.0-rc01

12 marca 2025 r.

Używaj stabilnej wersji 1.6.0.

1.6.0-beta01

26 lutego 2025 r.

Używaj stabilnej wersji 1.6.0.

Wersja 1.6.0-alpha03

6 lutego 2025 r.

Używaj stabilnej wersji 1.6.0.

Wersja 1.6.0-alpha02

30 stycznia 2025 r.

Używaj stabilnej wersji 1.6.0.

Wersja 1.6.0-alpha01

20 grudnia 2024 r.

Używaj stabilnej wersji 1.6.0.

Wersja 1.5

Wersja 1.5.1

19 grudnia 2024 r.

Publikacja androidx.media3:media3-*:1.5.1 Wersja 1.5.1 zawiera te zmiany.

• ExoPlayer:
  • Wyłączyliśmy używanie asynchronicznego odszyfrowywania w klasie MediaCodec, aby uniknąć zgłaszanych problemów z przekroczeniem limitu czasu kodeka w tym interfejsie API platformy (#1641).
• Ekstraktory:
  • MP3: nie przerywaj odtwarzania przedwcześnie, gdy VBRItabela treści ramki nie obejmuje wszystkich danych MP3 w pliku (#1904).
• Film:
  • Wycofanie używania podanych wartości współczynnika proporcji piksela MediaCodecAdapter podczas przetwarzania onOutputFormatChanged (#1371).
• Tekst:
  • Naprawiliśmy błąd w ReplacingCuesResolver.discardCuesBeforeTimeUs, który powodował, że wskazówka aktywna w timeUs (rozpoczęta wcześniej, ale jeszcze nie zakończona) była nieprawidłowo odrzucana (#1939).
• Metadane:
  • Wyodrębnianie numerów dysków/ścieżek i gatunku z komentarzy Vorbis do MediaMetadata(#1958).

Wersja 1.5.0

27 listopada 2024 r.

Publikacja androidx.media3:media3-*:1.5.0 Wersja 1.5.0 zawiera te zmiany.

• Biblioteka wspólna:
  • Dodaj ForwardingSimpleBasePlayer, które umożliwia przekazywanie do innego odtwarzacza z niewielkimi korektami, przy jednoczesnym zachowaniu pełnej spójności i obsługi odbiorników (#1183).
  • Zastąp SimpleBasePlayer.State.playlist metodą getPlaylist().
  • Dodaj zastąpienie dla SimpleBasePlayer.State.Builder.setPlaylist(), aby bezpośrednio określić Timeline i bieżące Tracks oraz Metadata zamiast tworzyć strukturę playlisty.
  • Zwiększ minSdk do 21 (Android Lollipop). Jest to zgodne ze wszystkimi innymi bibliotekami AndroidX.
  • Dodaj artefakt androidx.media3:media3-common-ktx, który zapewnia funkcje specyficzne dla języka Kotlin oparte na bibliotece Common.
  • Dodaj do biblioteki media3-common-ktx funkcję rozszerzenia zawieszania Player.listen, aby uruchomić korutynę do nasłuchiwania Player.Events.
  • Usuń adnotacje @DoNotInline z ręcznie wyodrębnionych klas wewnętrznych, które mają zapobiegać błędom weryfikacji klas w czasie działania. Najnowsze wersje R8 automatycznie przenoszą takie wywołania poza funkcję, aby uniknąć błędów w czasie działania (ręczne przenoszenie nie jest już wymagane). Wszyscy użytkownicy Gradle korzystający z tej biblioteki muszą już używać wersji wtyczki Gradle na Androida, która korzysta z wersji R8, która to robi, z powodu compileSdk = 35. Użytkownicy biblioteki z systemami kompilacji innymi niż Gradle będą musieli zadbać o to, aby ich odpowiednik R8 wykonujący krok zmniejszania/zaciemniania kodu przeprowadzał podobny automatyczny proces wyodrębniania, aby uniknąć błędów weryfikacji klas w czasie działania. Ta zmiana została już wprowadzona w innych bibliotekach AndroidX.
• ExoPlayer:
  • MediaCodecRenderer.onProcessedStreamChange() można teraz wywołać w przypadku każdego elementu multimedialnego. Wcześniej nie było to wymagane w przypadku pierwszego konta. Aby to zrobić, użyj MediaCodecRenderer.experimentalEnableProcessedStreamChangedAtStart()
  • Dodano element PreloadMediaSource.PreloadControl.onPreloadError, aby umożliwić implementacjom PreloadMediaSource.PreloadControl podejmowanie działań w przypadku wystąpienia błędu.
  • Dodaj BasePreloadManager.Listener, aby przekazywać zdarzenia wstępnego wczytywania do aplikacji.
  • Zezwalaj na zmianę czasu oczekiwania klienta SNTP i ponawianie prób połączenia z alternatywnymi adresami po przekroczeniu czasu oczekiwania (#1540).
  • Usuń pole MediaCodecAdapter.Configuration.flags, ponieważ zawsze miało wartość zero.
  • Umożliwia użytkownikowi wybranie wbudowanego głośnika do odtwarzania na Wear OS w przypadku API w wersji 35 lub nowszej (jeśli urządzenie obsługuje tę funkcję).
  • Odłóż blokowanie połączenia do Context.getSystemService(Context.AUDIO_SERVICE), aż zostanie włączona obsługa skupienia dźwięku. Dzięki temu połączenie blokujące nie zostanie wykonane, jeśli obsługa fokusu audio nie jest włączona (#1616).
  • Zezwalaj na odtwarzanie niezależnie od czasu buforowania, gdy ładowanie się nie powiedzie (#1571).
  • Dodaj AnalyticsListener.onRendererReadyChanged(), aby zasygnalizować, kiedy poszczególne renderery zezwalają na odtwarzanie.
  • Naprawiono błąd, który powodował, że funkcja MediaCodec.CryptoException była czasami zgłaszana jako „nieoczekiwany błąd podczas działania”, gdy funkcja MediaCodec działała w trybie asynchronicznym (domyślne zachowanie w przypadku interfejsu API w wersji 31 lub nowszej).
  • Przekaż bufferedDurationUs zamiast bufferedPositionUs z parametrem PreloadMediaSource.PreloadControl.onContinueLoadingRequested(). Zmienia też DefaultPreloadManager.Status.STAGE_LOADED_TO_POSITION_MS na DefaultPreloadManager.Status.STAGE_LOADED_FOR_DURATION_MS. Aplikacje muszą wtedy przekazywać wartość reprezentującą określony czas trwania od domyślnej pozycji początkowej, dla której odpowiednie źródło multimediów ma być wstępnie wczytane za pomocą tego IntDef, zamiast pozycji.
  • Dodaj implementację ForwardingRenderer, która przekazuje wszystkie wywołania metod do innego renderera (1703).
  • Dodaj wstępne wczytywanie playlisty dla następnego elementu na playliście. Aplikacje mogą włączyć wstępne wczytywanie, wywołując odpowiednią funkcję ExoPlayer.setPreloadConfiguration(PreloadConfiguration). Wstępne wczytywanie jest domyślnie wyłączone. Jeśli użytkownik wyrazi na to zgodę, aby nie zakłócać odtwarzania, DefaultLoadControl ogranicza wstępne wczytywanie do momentu, gdy odtwarzacz nie wczytuje treści do odtworzenia. Aplikacje mogą zmienić to zachowanie, implementując odpowiednio LoadControl.shouldContinuePreloading() (np. podczas zastępowania tej metody w DefaultLoadControl). Domyślna implementacja LoadControl wyłącza wstępne wczytywanie, jeśli aplikacja używa niestandardowej implementacji LoadControl.
  • Dodano metodę MediaSourceEventListener.EventDispatcher.dispatchEvent(), która umożliwia wywoływanie zdarzeń detektorów podklas (1736).
  • Dodaj DefaultPreloadManager.Builder, które tworzy instancje DefaultPreloadManager i ExoPlayer ze spójnymi, udostępnionymi konfiguracjami.
  • Usuń parametr Renderer[] z funkcji LoadControl.onTracksSelected(), ponieważ implementacja DefaultLoadControl może pobierać typy transmisji z funkcji ExoTrackSelection[].
  • Metoda DefaultLoadControl.calculateTargetBufferBytes(Renderer[], ExoTrackSelection[]) została oznaczona jako przestarzała i ostateczna, aby zapobiec jej zastąpieniu. Zamiast niego należy używać nowego interfejsu DefaultLoadControl.calculateTargetBufferBytes(ExoTrackSelection[]).
  • Raportuj zdarzenia MediaSourceEventListener z dodatkowych źródeł w MergingMediaSource. Spowoduje to zgłaszanie zdarzeń loadstart/error/cancelled/completed w przypadku wczytywanych z zewnątrz napisów (dodanych za pomocą funkcji MediaItem.LocalConfiguration.subtitleConfigurations), które mogą pojawiać się jako zduplikowane zdarzenia wczytywania emitowane z funkcji AnalyticsListener.
  • Zapobiegaj całkowitemu zatrzymaniu odtwarzania z powodu błędów w napisach i metadanych. Problemowy utwór jest wyłączany, a odtwarzanie pozostałych utworów jest kontynuowane (#1722).
    • W przypadku nowej obsługi napisów (podczas wyodrębniania) powiązane błędy analizowania (np. nieprawidłowe dane napisów) i ładowania (np. HTTP 404) są emitowane za pomocą wywołań zwrotnych onLoadError.
    • W przypadku starszego sposobu obsługi napisów (podczas renderowania) za pomocą wywołań zwrotnych onLoadError są emitowane tylko powiązane błędy wczytywania, a błędy parsowania są cicho ignorowane (jest to dotychczasowe zachowanie).
  • Naprawiliśmy błąd, w którym elementy playlisty lub okresy w strumieniach DASH z wieloma okresami o czasie trwania niezgodnym z rzeczywistą treścią mogły powodować zamrożenie klatek na końcu elementu (#1698).
  • Dodano funkcję ustawiającą do SntpClient, która umożliwia ustawienie maksymalnego czasu, jaki upłynął od ostatniej aktualizacji, po którym klient jest ponownie inicjowany (#1794).
• Transformer:
  • Dodaj SurfaceAssetLoader, który obsługuje kolejkowanie danych wideo do Transformer za pomocą Surface.
  • ImageAssetLoader zgłasza nieobsługiwane dane wejściowe za pomocą AssetLoader.onError zamiast zgłaszać IllegalStateException.
  • Wymagaj ustawienia czasu trwania obrazu za pomocą parametru MediaItem.Builder.setImageDurationMs podczas eksportowania obrazu.
  • Dodano obsługę eksportowania przerw w sekwencjach obiektów EditedMediaItem.
• Wybór ścieżki:
  • DefaultTrackSelector: preferuj dźwięk oparty na obiektach zamiast dźwięku opartego na kanałach, gdy inne czynniki są równe;
• Ekstraktory:
  • Zezwalaj na identyfikowanie przez opcje Mp4Extractor i FragmentedMp4Extractor próbek H264, które nie są używane jako odniesienie przez kolejne próbki.
  • Dodanie opcji włączania wyszukiwania opartego na indeksie w AmrExtractor.
  • Traktuj pliki MP3 z ponad 128 kB między prawidłowymi ramkami jako obcięte (zamiast nieprawidłowych). Oznacza to, że pliki z danymi innymi niż MP3 na końcu, bez innych metadanych wskazujących długość bajtów MP3, przestają odtwarzać się na końcu danych MP3, zamiast kończyć się błędem ParserException: Searched too many bytes.{contentIsMalformed=true, dataType=1} (#1563).
  • Rozwiązaliśmy problem z obsługą próbki przed reklamą w przypadku pozycji początkowych multimediów innych niż klatki kluczowe podczas przetwarzania list edycji w plikach MP4 (#1659).
  • Ulepszono obliczanie liczby klatek na sekundę przez użycie czasu trwania multimediów z pola mdhd w Mp4Extractor i FragmentedMp4Extractor (#1531).
  • Poprawiono nieprawidłowe skalowanie media_time na listach edycji MP4. Wartość segment_duration była już prawidłowo skalowana przy użyciu skali czasu filmu, a wartość media_time jest teraz prawidłowo skalowana przy użyciu skali czasu ścieżki zgodnie ze standardem formatu MP4 (#1792).
  • Obsługa klatek w nieprawidłowej kolejności w obliczeniach endIndices w przypadku plików MP4 z listą edycji (#1797).
  • Poprawiono analizowanie czasu trwania multimediów w mdhd box w plikach MP4, aby obsługiwać wartości -1 (#1819).
  • Dodano obsługę identyfikowania pola h263 w plikach MP4 dla wideo H.263 (#1821).
  • Dodano obsługę formatu pliku multimedialnego ISO Base Media File Format w przypadku AC-4 Level-4 (#1265).
• DataSource:
  • Aktualizacja HttpEngineDataSource, aby umożliwić korzystanie z niej od wersji S extension 7 zamiast od poziomu 34 interfejsu API (#1262).
  • DataSourceContractTest: Sprawdź, czy funkcja DataSource.getUri() zwraca rozwiązany identyfikator URI (zgodnie z dokumentacją). Jeśli różni się od żądanego adresu URI, testy mogą to wskazywać za pomocą nowej metody DataSourceContractTest.TestResource.Builder.setResolvedUri().
  • DataSourceContractTest: sprawdź, czy funkcje DataSource.getUri() i getResponseHeaders() zwracają wartość „open” po nieudanym wywołaniu funkcji open() (z powodu braku zasobu) i przed kolejnym wywołaniem funkcji close().
    • Zastąpienie DataSourceContractTest.getNotFoundResources() umożliwia podklasom testów dostarczanie wielu zasobów „nie znaleziono” oraz wszelkich oczekiwanych nagłówków. Pozwala to odróżnić błąd HTTP 404 (z nagłówkami) od błędu „nie znaleziono serwera” (bez nagłówków).
• Dźwięk:
  • automatycznie konfigurować metadane głośności CTA-2075 w kodeku, jeśli są one obecne w multimediach;
  • Zapewnij płynne zmniejszanie głośności podczas przewijania.
  • Naprawiono trzaski, które mogą występować podczas przewijania.
  • Naprawiliśmy błąd kumulacji obcinania w algorytmie rozciągania czasu i zmiany wysokości dźwięku Sonic.
  • Naprawiono błąd w SpeedChangingAudioProcessor, który powodował utratę klatek wyjściowych.
• Film:
  • MediaCodecVideoRenderer nie dekoduje próbek, które nie są renderowane ani używane jako odniesienie przez inne próbki.
  • W przypadku interfejsu API w wersji 35 i nowszych MediaCodecAdapter może teraz otrzymywać null Surface w configure i wywoływać nową metodę detachOutputSurface w celu usunięcia wcześniej ustawionego Surface, jeśli kodek to obsługuje (MediaCodecInfo.detachedSurfaceSupported).
  • Podczas przetwarzania onOutputFormatChanged używaj podanych wartości współczynnika proporcji piksela MediaCodecAdapter, jeśli są dostępne (#1371).
  • Dodano obejście problemu z urządzeniem Galaxy Tab S7 FE, który powoduje, że bezpieczne strumienie H264 o częstotliwości 60 kl./s są oznaczane jako nieobsługiwane (#1619).
  • Dodano obejście problemu z kodekami, które po ostatniej próbce nie zwracają sygnału końca strumienia.
• Tekst:
  • Dodaj niestandardowy VoiceSpan i wypełnij go dla zakresów głosowych WebVTT (#1632).
  • Zadbaj o to, aby napisy WebVTT w HLS z bardzo dużymi sygnaturami czasowymi (które przekraczają 64-bitową wartość long, gdy są reprezentowane jako mikrosekundy i pomnożone przez 90,000 podstawę czasu MPEG) były wyświetlane (#1763).
  • Obsługa napisów CEA-608 w treściach Dolby Vision (#1820).
  • Naprawiono zawieszanie się odtwarzania w przypadku strumieni DASH z wieloma okresami, gdy włączone są napisy CEA-608 (#1863).
• Metadane:
  • Przypisz typ C.TRACK_TYPE_METADATA do ścieżek zawierających treści dotyczące lodu lub treści w formacie vnd.dvb.ait.
• Obraz:
  • Dodaj ExternallyLoadedImageDecoder, aby uprościć integrację z zewnętrznymi bibliotekami wczytywania obrazów, takimi jak Glide czy Coil.
• DataSource:
  • Dodano FileDescriptorDataSource, nowy DataSource, który może być używany do odczytywania danych z FileDescriptor (#3757).
• Skutek:
  • Dodano obejście DefaultVideoFrameProcessor w przypadku niewielkiego SurfaceTexture skalowania. SurfaceTexture może obejmować niewielkie skalowanie, które odcina 1-tekselową ramkę wokół krawędzi przyciętego bufora. Teraz jest to obsługiwane w taki sposób, aby dane wyjściowe były bliższe oczekiwanym.
  • Przyspiesz DefaultVideoFrameProcessor.queueInputBitmap(). Dzięki temu eksportowanie obrazów do filmów za pomocą Transformer jest szybsze.
• Rozszerzenie IMA:
  • Naprawiono błąd, który powodował, że wyczyszczenie playlisty mogło spowodować wystąpienie znaku ArrayIndexOutOfBoundsException w ImaServerSideAdInsertionMediaSource.
  • Naprawiono błąd, w którym strumienie DAI wstawiane po stronie serwera bez reklamy przed filmem mogły powodować błąd ArrayIndexOutOfBoundsException podczas odtwarzania po ostatniej reklamie w trakcie filmu (#1741).
• Sesja:
  • Dodaj MediaButtonReceiver.shouldStartForegroundService(Intent), aby umożliwić aplikacjom pomijanie polecenia odtwarzania wznawiającego odtwarzanie przez zastąpienie tej metody. Domyślnie usługa jest zawsze uruchomiona i nie można zatrzymać odtwarzania bez spowodowania awarii usługi przez system z błędem ForegroundServiceDidNotStartInTimeException (#1528).
  • Naprawiliśmy błąd, który powodował, że niestandardowe polecenia wysyłane z MediaBrowser były przekazywane do MediaSessionCompat.Callback zamiast do wariantu MediaBrowserServiceCompat metody po połączeniu z usługą starszego typu. Uniemożliwiało to otrzymanie przez MediaBrowser rzeczywistej wartości zwrotnej wysłanej przez starszą usługę (#1474).
  • Obsługa wyjątku IllegalArgumentException zgłaszanego przez urządzenia niektórych producentów podczas ustawiania odbiornika transmisji dla intencji przycisku multimediów (#1730).
  • Dodaj przyciski poleceń do elementów multimedialnych. Spowoduje to dodanie interfejsu Media3 API do tego, co było znane jako Custom browse actions, z biblioteką starszego typu z MediaBrowserCompat. Pamiętaj, że w przypadku elementów multimedialnych przyciski poleceń Media3 są dostępne zarówno w przypadku MediaBrowser, jak i MediaController. Zobacz Implementowanie niestandardowych działań przeglądania.
  • Naprawiliśmy błąd, który powodował, że kontroler Media3 czasami nie mógł zezwolić aplikacji sesji na uruchomienie usługi działającej na pierwszym planie po wysłaniu żądania play().
  • Ogranicz CommandButton.Builder.setIconUri tak, aby akceptował tylko identyfikatory URI treści.
  • Przekazywanie wskazówek dotyczących połączenia z przeglądarki Media3 do początkowego MediaBrowserCompat podczas łączenia się ze starszym MediaBrowserCompat. Usługa może odbierać wskazówki dotyczące połączenia przekazywane jako wskazówki główne przy pierwszym wywołaniu funkcji onGetRoot().
  • Rozwiązanie problemu polegającego na tym, że serwer MediaBrowser połączony z usługą starszej przeglądarki nie otrzymywał błędu wysłanego przez usługę po zasubskrybowaniu przez przeglądarkę serwera parentid.
  • Poprawiono interoperacyjność, dzięki czemu przeglądarka Media3 połączona ze starszym interfejsem MediaBrowserService nie wysyła 2 razy prośby o dostęp do elementów podrzędnych interfejsu parentId podczas subskrybowania elementu nadrzędnego.
• UI:
  • Wprowadź obejście problemu z rozciągniętym lub przyciętym filmem w funkcji PlayerView-in-Compose-AndroidView, ponieważ występują problemy z przejściami udostępnionymi opartymi na XML. Aplikacje korzystające z PlayerView wewnątrz AndroidView muszą wywoływać PlayerView.setEnableComposeSurfaceSyncWorkaround, aby wyrazić zgodę na udział w programie (#1237, #1594).
  • Dodaj setFullscreenButtonState do PlayerView, aby umożliwić aktualizowanie ikony przycisku pełnego ekranu na żądanie, tj. poza pasmem i nie w reakcji na kliknięcie (#1590, #184).
  • Rozwiązanie problemu polegającego na tym, że opcja „Brak” w wyborze tekstu nie działała, jeśli istniały zdefiniowane przez aplikację preferencje wyboru ścieżki tekstowej.
• Rozszerzenie DASH:
  • Dodano obsługę okresów rozpoczynających się w środku segmentu (#1440).
• Rozszerzenie Smooth Streaming:
  • Naprawiono błąd Bad magic number for Bundle podczas odtwarzania strumieni SmoothStreaming ze ścieżkami tekstowymi (#1779).
• Rozszerzenie RTSP:
  • Naprawiono usuwanie informacji o użytkowniku w przypadku adresów URL zawierających zakodowane znaki @ (#1138).
  • Naprawiono awarię podczas analizowania pakietów RTP z rozszerzeniami nagłówka (#1225).
• Rozszerzenia dekodera (FFmpeg, VP9, AV1 itp.):
  • Dodaj moduł dekodera IAMF, który zapewnia obsługę odtwarzania plików MP4 zawierających ścieżki IAMF za pomocą natywnej biblioteki libiamf do syntezy dźwięku.
    • Odtwarzanie jest włączone w układzie stereo, a także w formacie 5.1 z przestrzennym dźwiękiem i opcjonalnym śledzeniem ruchów głowy, ale odtwarzanie binauralne nie jest obecnie dostępne.
  • Dodano obsługę stron 16 KB w przypadku rozszerzeń dekodera na Androidzie 15 (#1685).
• Rozszerzenie Cast:
  • Zatrzymuje czyszczenie osi czasu po rozłączeniu CastSession, co umożliwia aplikacji wysyłającej wznowienie odtwarzania lokalnego po rozłączeniu.
  • Wypełnij pole DeviceInfo w CastPlayer, gdy podano wartość Context. Umożliwia to połączenie MediaSession z RoutingSession, co jest niezbędne do zintegrowania przełącznika wyjścia (#1056).
• Narzędzia testowe:
  • DataSourceContractTest obejmuje teraz testy weryfikujące:
    • Strumień wejściowy read position został zaktualizowany.
    • Bufor wyjściowy offset jest stosowany prawidłowo.
• Aplikacja w wersji demonstracyjnej
  • Rozwiązanie problemu wycieków pamięci w aplikacji demonstracyjnej z krótkimi filmami (#1839).
• Usuń symbole, które nie są już używane:
  • Usuń wycofane Player.hasPrevious, Player.hasPreviousWindow(). Zamiast niej użyj zasady Player.hasPreviousMediaItem().
  • Usuń wycofaną metodę Player.previous(). Zamiast niej używaj zasady Player.seekToPreviousMediaItem().
  • Usuń wycofaną metodę DrmSessionEventListener.onDrmSessionAcquired.
  • Usuń wycofane konstruktory DefaultEncoderFactory. Zamiast niej używaj zasady DefaultEncoderFactory.Builder.

Wersja 1.5.0-rc02

19 listopada 2024 r.

Używaj stabilnej wersji 1.5.0.

Wersja 1.5.0-rc01

13 listopada 2024 r.

Używaj stabilnej wersji 1.5.0.

Wersja 1.5.0-beta01

30 października 2024 r.

Używaj stabilnej wersji 1.5.0.

Wersja 1.5.0-alpha01

10 września 2024 r.

Używaj stabilnej wersji 1.5.0.

Wersja 1.4.0

Wersja 1.4.1

27 sierpnia 2024 r.

Publikacja androidx.media3:media3-*:1.4.1 Wersja 1.4.1 zawiera te zmiany.

• ExoPlayer:
  • Asynchroniczne obsługiwanie wywołań zwrotnych wstępnego wczytywania w PreloadMediaSource (#1568).
  • Zezwalaj na odtwarzanie niezależnie od czasu buforowania, gdy ładowanie się nie powiedzie (#1571).
• Ekstraktory:
  • MP3: naprawiono błąd Searched too many bytes przez prawidłowe ignorowanie końcowych danych innych niż MP3 na podstawie pola długości w ramce Info (#1480).
• Tekst:
  • TTML: poprawiono obsługę wartości procentowych tts:fontSize, aby zapewnić ich prawidłowe dziedziczenie z węzłów nadrzędnych z wartościami procentowymi tts:fontSize.
  • Naprawiono błąd IndexOutOfBoundsException w LegacySubtitleUtil spowodowany nieprawidłową obsługą przypadku, w którym żądana godzina rozpoczęcia danych wyjściowych jest większa lub równa końcowej godzinie zdarzenia w Subtitle (#1516).
• DRM:
  • Naprawiono błąd android.media.MediaCodec$CryptoException: Operation not supported in this configuration: ERROR_DRM_CANNOT_HANDLE na urządzeniach z API w wersji 31 lub nowszej, na których odtwarzane są treści Widevine L1. Ten błąd jest spowodowany niepełną implementacją metody MediaDrm.requiresSecureDecoder ramową (#1603).
• Skutek:
  • Dodaj metodę release() do GlObjectsProvider.
• Sesja:
  • Zmień dwukrotne kliknięcie KEYCODE_HEADSETHOOK w działanie „przejdź do następnego”, jak opisano w #1493.
  • Traktuj KEYCODE_HEADSETHOOK jako polecenie „play” w MediaButtonReceiver, gdy decydujesz, czy je zignorować, aby uniknąć ForegroundServiceDidNotStartInTimeException (#1581).
• Rozszerzenie RTSP:
  • Pomiń nieprawidłowe opisy multimediów podczas analizowania SDP (#1087).

Wersja 1.4.0

25 lipca 2024 r.

Publikacja androidx.media3:media3-*:1.4.0 Wersja 1.4.0 zawiera te zmiany.

• Biblioteka wspólna:
  • Przekazywanie domniemanych wywołań funkcji seek bez operacji do chronionych metod BasePlayer.seekTo() i SimpleBasePlayer.handleSeek() zamiast ich ignorowania. Jeśli implementujesz te metody w odtwarzaczu niestandardowym, może być konieczne obsłużenie tych dodatkowych wywołań za pomocą mediaItemIndex == C.INDEX_UNSET.
  • Usunięcie zależności kompilacji od ulepszonego odcukrzania kodu Java 8 (#1312).
  • Upewnij się, że czas trwania przekazany do MediaItem.Builder.setImageDurationMs() jest ignorowany w przypadku elementu MediaItem innego niż obraz (zgodnie z dokumentacją).
  • Dodaj Format.customData, aby przechowywać dostarczone przez aplikację niestandardowe informacje o instancjach Format.
• ExoPlayer:
  • Dodaj BasePreloadManager, które koordynują wstępne wczytywanie wielu źródeł na podstawie priorytetów określonych przez ich rankingData. Dostosowywanie jest możliwe przez rozszerzenie tej klasy. Dodaj DefaultPreloadManager, które używa PreloadMediaSource do wstępnego wczytywania próbek multimediów ze źródeł do pamięci i używa liczby całkowitej rankingData, która wskazuje indeks elementu w interfejsie.
  • Dodaj PlayerId do większości metod LoadControl, aby umożliwić implementacjom LoadControl obsługę wielu graczy.
  • Usuń Buffer.isDecodeOnly() i C.BUFFER_FLAG_DECODE_ONLY. Nie musisz ustawiać tej flagi, ponieważ moduły renderujące i dekodery będą pomijać bufory na podstawie sygnatury czasowej. Niestandardowe implementacje Renderer powinny sprawdzać, czy czas buforowania wynosi co najmniej BaseRenderer.getLastResetPositionUs(), aby określić, czy wyświetlić próbkę. Niestandardowe implementacje SimpleDecoder mogą w razie potrzeby sprawdzać isAtLeastOutputStartTimeUs() inne bufory lub oznaczać je symbolem DecoderOutputBuffer.shouldBeSkipped, aby je pominąć.
  • Zezwól na zwracanie wartości null przez TargetPreloadStatusControl.getTargetPreloadStatus(T), aby wskazać, że nie należy wstępnie wczytywać elementu MediaSource z danym elementem rankingData.
  • Dodano remove(MediaSource) do BasePreloadManager.
  • Dodaj reset() do BasePreloadManager, aby zwolnić wszystkie źródła wstrzymania, zachowując instancję menedżera wstępnego wczytywania.
  • Dodaj ExoPlayer.setPriority() (i Builder.setPriority()), aby zdefiniować wartość priorytetu używaną w PriorityTaskManager i w przypadku ważności MediaCodec od interfejsu API 35.
  • Rozwiązaliśmy problem z aktualizacją czasu ostatniego ponownego buforowania, który powodował nieprawidłowy klucz bs (brak bufora) w CMCD (#1124).
  • Dodaj znak PreloadMediaSource.PreloadControl.onLoadedToTheEndOfSource(PreloadMediaSource) , aby wskazać, że źródło zostało wczytane do końca. Umożliwia to implementacjom DefaultPreloadManager i niestandardowym PreloadMediaSource.PreloadControl wstępne wczytanie następnego źródła lub podjęcie innych działań.
  • Naprawiono błąd, który powodował, że pomijanie ciszy na końcu elementów mogło wywoływać wyjątek odtwarzania.
  • Dodaj clear do PreloadMediaSource, aby odrzucić okres wstępnego wczytywania.
  • Dodaj nowy kod błędu PlaybackException.ERROR_CODE_DECODING_RESOURCES_RECLAIMED, który jest używany w przypadku odzyskiwania zasobów kodeka na potrzeby zadań o wyższym priorytecie.
  • Zezwól na wczytywanie reklam przed filmem przed zakończeniem przygotowywania początkowych treści multimedialnych (#1358).AdsMediaSource
  • Naprawiliśmy błąd polegający na tym, że odtwarzanie przenosiło się do STATE_ENDED podczas ponownego przygotowywania transmisji na żywo DASH z wieloma okresami po usunięciu z pliku manifestu pierwotnego okresu.
  • Zmień nazwę onTimelineRefreshed() na onSourcePrepared() i onPrepared() na onTracksSelected() w PreloadMediaSource.PreloadControl. Zmień też nazwy IntDefs w DefaultPreloadManager.Stage.
  • Dodano eksperymentalną obsługę dynamicznego planowania, aby lepiej dopasować pracę do cykli wybudzania procesora i opóźnić wybudzanie do momentu, w którym renderery mogą kontynuować działanie. Możesz włączyć tę funkcję, używając experimentalSetDynamicSchedulingEnabled() podczas konfigurowania instancji ExoPlayera.
  • Dodaj Renderer.getDurationToProgressUs(). Renderer może zaimplementować tę metodę, aby zwrócić do ExoPlayera czas, o który odtwarzanie musi się przesunąć, aby renderowanie mogło się odbywać. Jeśli ExoPlayer jest ustawiony na experimentalSetDynamicSchedulingEnabled(), ExoPlayer wywoła tę metodę podczas obliczania czasu zaplanowania zadania.
  • Dodaj MediaCodecAdapter#OnBufferAvailableListener, aby otrzymywać alerty, gdy bufory wejściowe i wyjściowe są dostępne do użycia przez MediaCodecRenderer. MediaCodecRenderer będzie sygnalizować ExoPlayer po otrzymaniu tych wywołań zwrotnych, a jeśli ExoPlayer jest ustawiony z experimentalSetDynamicSchedulingEnabled(), ExoPlayer zaplanuje pętlę roboczą, aby renderery mogły kontynuować działanie.
  • Zamiast poszczególnych parametrów używaj klasy danych w przypadku metod LoadControl.
  • Dodaj ExoPlayer.isReleased(), aby sprawdzić, czy wywołano funkcję Exoplayer.release().
  • Dodaj ExoPlayer.Builder.setMaxSeekToPreviousPositionMs(), aby skonfigurować maksymalną pozycję, dla której seekToPrevious() szuka poprzedniego elementu (#1425).
  • Naprawiono niektóre niespójności związane z ogniskiem dźwięku, np. brak zgłaszania pełnej lub tymczasowej utraty ogniska, gdy odtwarzacz jest wstrzymany (#1436).
  • Naprawiono potencjalne IndexOutOfBoundsException spowodowane przez ekstraktory zgłaszające dodatkowe ścieżki po początkowym etapie przygotowania (#1476).
  • Effects w ExoPlayer.setVideoEffect() otrzyma sygnatury czasowe z usuniętym przesunięciem renderowania (#1098).
  • Naprawiliśmy potencjalny problem z IllegalArgumentException podczas obsługi błędu odtwarzacza, który wystąpił podczas odczytywania kolejnego elementu na playliście (#1483).
• Transformer:
  • Dodaj znaki audioConversionProcess i videoConversionProcess do ExportResult, aby wskazać, jak powstała odpowiednia ścieżka w pliku wyjściowym.
  • Złagodzenie sprawdzania poziomu H.264 w przypadku optymalizacji przycinania.
  • Dodano obsługę przełączania między wejściowymi plikami SDR i HDR w sekwencji.
  • Dodanie obsługi efektów audio na poziomie kompozycji.
  • Dodaliśmy obsługę transkodowania obrazów ultra HDR na filmy HDR.
  • Rozwiązaliśmy problem, który powodował, że po zresetowaniu i ponownym użyciu DefaultAudioMixer nie podawał prawidłowej liczby bajtów.
  • Obejście błędu dekodera, w którym liczba kanałów audio była ograniczona do stereo podczas obsługi wejścia PCM.
  • Podczas wybierania ścieżek w ExoPlayerAssetLoader zignoruj ograniczenia dotyczące liczby kanałów audio, ponieważ mają one zastosowanie tylko w przypadku odtwarzania.
  • Zastąp interfejs androidx.media3.transformer.Muxer interfejsem androidx.media3.muxer.Muxer i usuń androidx.media3.transformer.Muxer.
  • Naprawiono wczytywanie obrazów HEIC ze schematów identyfikatorów URI treści. (#1373).
  • Dostosuj czas trwania ścieżki audio w AudioGraphInput, aby poprawić synchronizację dźwięku i obrazu.
  • Usuń pole ExportResult.processedInputs. Jeśli używasz tego pola do podawania szczegółów kodeka, użyj zamiast niego pola DefaultDecoderFactory.listener. W przypadku wyjątku kodeka szczegóły kodeka będą dostępne w ExportException.codecInfo.
• Ekstraktory:
  • MPEG-TS: wprowadź zmianę, upewniając się, że ostatnia klatka jest renderowana przez przekazanie ostatniej jednostki dostępu strumienia do kolejki próbek (#7909). Wprowadzono poprawki rozwiązujące problemy, które pojawiły się w strumieniach HLS zawierających tylko klatki I(#1150) i strumieniach HLS w formacie H.262 (#1126).
  • MP3: preferuj rozmiar danych z ramki Info zamiast rozmiaru podanego przez strumień bazowy (np. rozmiar pliku lub nagłówek HTTP Content-Length). Pomaga to wykluczyć z obliczeń wyszukiwania ze stałą szybkością transmisji danych o nieodtwarzalnych zwiastunach (np. okładki albumów), co zwiększa dokładność wyszukiwania (#1376).
  • MP3: używaj liczby klatek i innych danych w klatce Info (jeśli występuje), aby obliczyć średnią szybkość transmisji dla wyszukiwania przy stałej szybkości transmisji, zamiast ekstrapolować z szybkości transmisji klatki po klatce Info, która może być sztucznie mała, np. klatka PCUT (#1376).
  • Poprawiono wyodrębnianie formatu audio PCM w kontenerach AVI.
• Dźwięk:
  • Naprawiono atrybuty kodowania DTS:X Profile 2 w przypadku odtwarzania passthrough (#1299).
  • W przypadku odtwarzania przeniesionego zresetuj pole śledzenia zakończenia strumienia w DefaultAudioSink przed wywołaniem AudioTrack.stop(), aby AudioTrack.StreamEventCallback#onPresentationEnded prawidłowo określał, kiedy wszystkie oczekujące dane zostały odtworzone.
  • Naprawiono błąd w SilenceSkippingAudioProcessor, w którym przejścia między różnymi formatami audio (np. stereo na mono) mogą powodować zgłaszanie wyjątku przez procesor (#1352).
  • Zaimplementuj MediaCodecAudioRenderer.getDurationToProgressUs(), aby odtwarzacz ExoPlayer dynamicznie planował główną pętlę roboczą na czas, w którym komponent MediaCodecAudioRenderer może kontynuować działanie.
• Film:
  • Rozwiązanie problemu polegającego na tym, że Listener.onRenderedFirstFrame() pojawia się zbyt wcześnie podczas przełączania urządzeń w trakcie odtwarzania.
  • Poprawiono logikę rezerwową dekodera Dolby Vision, aby w razie potrzeby używać zgodnego dekodera AV1 (#1389).
  • Rozwiązanie problemu z wyjątkiem kodeka, który może być spowodowany włączeniem renderowania wideo w trakcie odtwarzania.
• Tekst:
  • Rozwiązaliśmy problem polegający na tym, że pomijane były napisy rozpoczynające się przed pozycją wyszukiwania. Ten problem pojawił się dopiero w Media3 w wersji 1.4.0-alpha01.
  • Zmień domyślne zachowanie analizowania napisów, aby odbywało się podczas wyodrębniania, a nie podczas renderowania (różnicę między wyodrębnianiem a renderowaniem znajdziesz na diagramie architektury ExoPlayera).
    • Tę zmianę można zastąpić, wywołując obie funkcje:MediaSource.Factory.experimentalParseSubtitlesDuringExtraction(false) TextRenderer.experimentalSetLegacyDecodingEnabled(true). Informacje o tym, jak połączyć te komponenty z instancją ExoPlayer, znajdziesz w dokumentacji dotyczącej dostosowywania. Te metody (i cała obsługa starszego dekodowania napisów) zostaną usunięte w przyszłej wersji.
    • Aplikacje z niestandardowymi implementacjami SubtitleDecoder muszą je zaktualizować, aby zamiast nich implementować SubtitleParser (a SubtitleParser.Factory zamiast SubtitleDecoderFactory).
  • PGS: poprawiono dekodowanie długości serii, aby rozwiązać problem z 0 jako indeksem koloru zamiast dosłownej wartości koloru (#1367).
  • CEA-708: ignoruj wartość rowLock. Specyfikacja CEA-708-E S-2023 mówi, że wartości rowLock i columnLock powinny być traktowane jako prawdziwe niezależnie od wartości w strumieniu (obsługa columnLock nie jest zaimplementowana, więc w praktyce zawsze przyjmuje się wartość fałsz).
    • Ta informacja była pierwotnie zawarta w informacjach o wersji 1.3.0-alpha01, ale zmiana została przypadkowo cofnięta przed wydaniem wersji 1.3.0-rc01. Problem został już rozwiązany, więc zmiana jest ponownie widoczna.
  • CEA-708: unikaj dodawania zduplikowanych znaków nowego wiersza przez naiwną obsługę polecenia „ustaw lokalizację pióra” w ExoPlayerze (#1315).
  • Naprawiono IllegalArgumentException z LegacySubtitleUtil, gdy próbka napisów WebVTT nie zawierała wskazówek, np. w ramach strumienia DASH (#1516).
• Metadane:
  • Poprawiono mapowanie tagów sortowania MP4 na tagi ID3. Wcześniej tagi MP4 „album sort” (soal), „artist sort” (soar) i „album artist sort” (soaa) były nieprawidłowo mapowane na tagi ID3 TSO2, TSOA i TSOP (#1302).
  • Poprawiono odczyt tagów numerycznych gnre (gatunek) i tmpo (tempo) w plikach MP4 (/iTunes), gdy wartość ma więcej niż 1 bajt.
  • Przekazywanie ramki ID3 TCON do MediaMetadata.genre (#1305).
• Obraz:
  • Dodano obsługę siatek miniatur DASH w formacie innym niż kwadratowy (#1300).
  • Dodanie obsługi formatu AVIF w przypadku interfejsu API w wersji 34 lub nowszej.
  • Zezwól na null jako parametr dla ExoPlayer.setImageOutput(), aby wyczyścić wcześniej ustawiony parametr ImageOutput.
• DataSource:
  • Wdróż obsługę identyfikatorów URI zasobów pierwotnych android.resource://package/id, gdzie package jest inny niż pakiet bieżącej aplikacji. Nie było to wcześniej udokumentowane, ale jest to bardziej wydajny sposób uzyskiwania dostępu do zasobów w innym pakiecie niż za pomocą nazwy.
  • Sprawdzaj, czy url nie ma wartości null w konstruktorach DataSpec. Ten parametr został już oznaczony jako niepusty.
  • Umożliwia ByteArrayDataSource przekształcanie identyfikatora URI w tablicę bajtów podczas open() zamiast kodowania na stałe w momencie tworzenia (#1405).
• DRM:
  • Zezwalaj na ustawianie LoadErrorHandlingPolicy na DefaultDrmSessionManagerProvider (#1271).
• Skutek:
  • Obsługa wielu zmian szybkości w ramach tego samego EditedMediaItem lub Composition w SpeedChangeEffect.
  • Obsługa danych wyjściowych HLG i PQ z danych wejściowych bitmapy ultra HDR.
  • Dodaliśmy obsługę EGL_GL_COLORSPACE_BT2020_HLG_EXT, która poprawia dane wyjściowe HLG w przypadku powierzchni w funkcjach ExoPlayer.setVideoEffect i Transformer.Debug SurfaceView.
  • Zaktualizuj implementację macierzy nakładki, aby była zgodna z dokumentacją, zamieniając wartości x i y zastosowane w setOverlayFrameAnchor(). Jeśli używasz OverlaySettings.Builder.setOverlayFrameAnchor(), zamień wartości x i y, mnożąc je przez -1.
  • Naprawiono błąd, w którym TimestampWrapper ulegał awarii podczas używania z ExoPlayer#setVideoEffects (#821).
  • Zmień domyślną przestrzeń roboczą kolorów SDR z kolorów liniowych na elektryczne wideo SDR BT.709. Podaj też trzecią opcję, aby zachować oryginalną przestrzeń kolorów.
  • Zezwól na określanie nieokreślonej kolejności osi Z w przypadku EditedMediaItemSequences (#1055).
  • Utrzymuj spójny zakres luminancji w różnych treściach HDR (korzysta z zakresu HLG).
  • Dodanie obsługi nakładek Ultra HDR (bitmapowych) na treści HDR.
  • Zezwalaj na używanie efektów SeparableConvolution przed API 26.
  • Usuń nieużywane OverlaySettings.useHdr, ponieważ zakres dynamiczny nakładki i ramki musi być taki sam.
  • Dodaliśmy obsługę HDR w przypadku TextOverlay. Jasność nakładki tekstowej można dostosować za pomocą parametru OverlaySettings.Builder.setHdrLuminanceMultiplier().
• Rozszerzenie IMA:
  • Promowanie interfejsu API, który jest wymagany do odtwarzania w aplikacjach strumieni reklam DAI, do wersji stabilnej.
  • Dodaj replaceAdTagParameters(Map <String, String>) do ImaServerSideAdInsertionMediaSource.AdLoader, co umożliwi zastępowanie parametrów tagu reklamy w czasie działania.
  • Naprawiono błąd polegający na tym, że funkcja VideoAdPlayer.VideoAdPlayerCallback.onError() nie była wywoływana, gdy podczas odtwarzania reklamy wystąpił błąd odtwarzacza (#1334).
  • Zaktualizowano pakiet IMA SDK do wersji 3.33.0, aby naprawić błąd NullPointerException podczas korzystania z data:// adresów URI tagów reklamowych#700.
• Sesja:
  • Zmień domyślną wartość CommandButton.enabled na true i upewnij się, że wartość może pozostać fałszywa w przypadku kontrolerów, nawet jeśli powiązane polecenie jest dostępne.
  • Dodaj stałe wartości ikon dla CommandButton, które mają być używane zamiast niestandardowych zasobów ikon.
  • Dodaj MediaSessionService.isPlaybackOngoing(), aby umożliwić aplikacjom sprawdzanie, czy usługa musi zostać zatrzymana w onTaskRemoved() (#1219).
  • Dodaj MediaSessionService.pauseAllPlayersAndStopSelf(), który wygodnie umożliwia wstrzymanie odtwarzania wszystkich sesji i wywołanie stopSelf() w celu zakończenia cyklu życia MediaSessionService.
  • Zastąp MediaSessionService.onTaskRemoved(Intent), aby zapewnić bezpieczną domyślną implementację, która utrzymuje usługę działającą na pierwszym planie, jeśli odtwarzanie jest w toku, lub zatrzymuje usługę w innych przypadkach.
  • Ukrywanie paska przewijania w powiadomieniu o multimediach w przypadku transmisji na żywo przez nieustawianie czasu trwania w metadanych sesji platformy (#1256).
  • Dopasuj konwersję MediaMetadata do MediaDescriptionCompat, aby używać tej samej preferowanej kolejności i logiki podczas wybierania właściwości metadanych co w przypadku media1.
  • Dodano MediaSession.sendError(), który umożliwia wysyłanie błędów niekrytycznych do kontrolera Media3. Gdy używasz kontrolera powiadomień (patrz MediaSession.getMediaNotificationControllerInfo()), błąd niestandardowy służy do aktualizowania wartości PlaybackState sesji platformy do stanu błędu z podanymi informacjami o błędzie (#543).
  • Dodaj MediaSession.Callback.onPlayerInteractionFinished(), aby informować sesje, gdy zakończy się seria interakcji gracza z określonym kontrolerem.
  • Dodaj SessionError i użyj go w SessionResult i LibraryResult zamiast kodu błędu, aby przekazać więcej informacji o błędzie i sposobie jego rozwiązania (jeśli to możliwe).
  • Opublikuj kod aplikacji testowej kontrolera Media3, której można używać do testowania interakcji z aplikacjami publikującymi sesję multimedialną.
  • Przekazywanie dodatkowych informacji przekazywanych do MediaSession[Builder].setSessionExtras() Media3 do kontrolera PlaybackStateCompat.getExtras() Media1.
  • Mapuj błędy krytyczne i niekrytyczne na sesję platformy i z niej. PlaybackException jest mapowany na stan błędu krytycznego PlaybackStateCompat. Wartość SessionError wysłana do kontrolera powiadomień o multimediach z wartością MediaSession.sendError(ControllerInfo, SessionError) jest mapowana na błąd niekrytyczny w PlaybackStateCompat, co oznacza, że kod błędu i komunikat są ustawione, ale stan sesji platformy pozostaje inny niż STATE_ERROR.
  • Zezwól na ustawianie aktywności sesji dla każdego kontrolera, aby zastąpić globalną aktywność sesji. Aktywność sesji można zdefiniować dla kontrolera w momencie połączenia, tworząc obiekt ConnectionResult z parametrem AcceptedResultBuilder.setSessionActivivty(PendingIntent). Po nawiązaniu połączenia aktywność sesji można zaktualizować za pomocą MediaSession.setSessionActivity(ControllerInfo, PendingIntent).
  • Ulepszyliśmy replikację błędów wywołań funkcji MediaLibrarySession.Callback. Replikację błędów można teraz skonfigurować za pomocą znaku MediaLibrarySession.Builder.setLibraryErrorReplicationMode(), aby wybrać typ błędu lub zrezygnować z replikacji błędów, która jest domyślnie włączona.
• UI:
  • Dodanie obsługi wyświetlania obrazów w PlayerView po połączeniu z ExoPlayer (#1144).
  • Dodanie możliwości dostosowywania różnych ikon w PlayerControlView za pomocą atrybutów XML, aby umożliwić stosowanie różnych elementów rysowalnych w poszczególnych instancjach PlayerView, zamiast globalnych zastąpień (#1200).
  • Obejście błędu platformy powodującego rozciągnięcie lub przycięcie filmu podczas używania elementu SurfaceView w komponowanym elemencie AndroidView na API 34 (#1237).
• Pobrane:
  • Upewnij się, że DownloadHelper nie powoduje wycieku nieopublikowanych instancji Renderer, co może ostatecznie doprowadzić do awarii aplikacji z błędem IllegalStateException: Too many receivers, total of 1000, registered for pid (#1224).
• Rozszerzenie Cronet:
  • Rozwiąż problem SocketTimeoutException w usłudze CronetDataSource. W niektórych wersjach Croneta żądanie przekazywane przez wywołanie zwrotne nie zawsze jest takie samo. Powoduje to, że wywołanie zwrotne nie jest wykonywane, a żądanie przekracza limit czasu (https://issuetracker.google.com/328442628).
• Rozszerzenie HLS:
  • Naprawiliśmy błąd, który powodował, że oczekujące próbki EMSG czekające na przerwę były delegowane w HlsSampleStreamWrapper z nieprawidłowym przesunięciem, co powodowało błąd IndexOutOfBoundsException lub IllegalArgumentException (#1002).
  • Usunięto błąd, który powodował, że playlisty inne niż główne były ciągle przeładowywane w przypadku strumieni LL-HLS (#1240).
  • Rozwiązanie problemu polegającego na tym, że włączenie CMCD w przypadku HLS z segmentami inicjującymi powodowało wystąpienie błędów Source Error i IllegalArgumentException.
  • Usunięto błąd, który powodował, że playlisty odtwarzane w tle nie były odświeżane podczas odtwarzania na żywo (#1240).
  • Naprawiono błąd, w którym włączenie CMCD w przypadku transmisji na żywo HLS powodowało ArrayIndexOutOfBoundsException (#1395).
• Rozszerzenie DASH:
  • Usunięto błąd, w którym ponowne przygotowanie transmisji na żywo z wieloma okresami może powodować błąd IndexOutOfBoundsException (#1329).
  • Dodano obsługę dashif:Laurl adresów URL licencji (#1345).
• Rozszerzenie Cast:
  • Naprawiono błąd, który powodował, że tytuł albumu MediaQueueItem był konwertowany na wykonawcę w elemencie multimedialnym Media3 (#1255).
• Narzędzia testowe:
  • Zaimplementuj funkcje onInit() i onRelease() w FakeRenderer.
  • Zmień metody TestPlayerRunHelper.runUntil()/playUntil(), aby w przypadku błędów niekrytycznych (np. zgłaszanych do AnalyticsListener.onVideoCodecError()) zwracały błąd. Aby wyłączyć to działanie, użyj nowego łańcucha metod TestPlayerRunHelper.run(player).ignoringNonFatalErrors().untilXXX().
• Aplikacja w wersji demonstracyjnej:
  • Użyj DefaultPreloadManager w wersji demonstracyjnej aplikacji w formie krótkiej.
  • Umożliwia ustawianie trybu powtarzania za pomocą argumentów Intent z wiersza poleceń (#1266).
  • Używaj HttpEngineDataSource jako HttpDataSource, jeśli jest to obsługiwane przez urządzenie.
• Usuń symbole, które nie są już używane:
  • Usuń CronetDataSourceFactory. Zamiast niej użyj zasady CronetDataSource.Factory.
  • Usuń niektóre konstruktory DataSpec. Zamiast niej użyj zasady DataSpec.Builder.
  • Usuń formę płatności setContentTypePredicate(Predicate) z usług DefaultHttpDataSource, OkHttpDataSource i CronetDataSource. Zamiast tego użyj odpowiedniej metody na każdej platformie XXXDataSource.Factory.
  • Usuń konstruktory OkHttpDataSource i OkHttpDataSourceFactory. Zamiast niej użyj zasady OkHttpDataSource.Factory.
  • Usuń PlayerMessage.setHandler(Handler). Zamiast niej użyj zasady setLooper(Looper).
  • Usuń pole Timeline.Window.isLive. Zamiast tego użyj metody isLive().
  • Usuń konstruktory DefaultHttpDataSource. Zamiast niej używaj zasady DefaultHttpDataSource.Factory.
  • Usuń DashMediaSource.DEFAULT_LIVE_PRESENTATION_DELAY_MS. Zamiast niej używaj zasady DashMediaSource.DEFAULT_FALLBACK_TARGET_LIVE_OFFSET_MS.
  • Usuń MediaCodecInfo.isSeamlessAdaptationSupported(Format, Format, boolean). Zamiast niej użyj zasady MediaCodecInfo.canReuseCodec(Format, Format).
  • Usuń metodę DrmSessionManager.DUMMY i getDummyDrmSessionManager(). Zamiast niej użyj zasady DrmSessionManager.DRM_UNSUPPORTED.
  • Usuń: AnalyticsListener.onAudioInputFormatChanged(EventTime, Format), AnalyticsListener.onVideoInputFormatChanged(EventTime, Format), AudioRendererEventListener.onAudioInputFormatChanged(Format), VideoRendererEventListener.onVideoInputFormatChanged(Format). Zamiast tego użyj przeciążeń, które przyjmują argument DecoderReuseEvaluation.
  • Usuń stałe RendererSupport.FormatSupport IntDef i FORMAT_HANDLED,FORMAT_EXCEEDS_CAPABILITIES, FORMAT_UNSUPPORTED_DRM,FORMAT_UNSUPPORTED_SUBTYPE, FORMAT_UNSUPPORTED_TYPE. Zamiast tego używaj odpowiednich stałych i adnotacji IntDef w androidx.media3.common.C (np. C.FORMAT_HANDLED).
  • Usuń interfejs Bundleable. Obejmuje to usunięcie wszystkich pól stałych Bundleable.Creator<Foo> CREATOR. Zamiast tego wywołujący powinni używać metod Bundle toBundle() i static Foo fromBundle(Bundle) w przypadku każdego typu.

Wersja 1.4.0-rc01

10 lipca 2024 r.

Używaj stabilnej wersji 1.4.0.

Wersja 1.4.0-beta01

26 czerwca 2024 r.

Używaj stabilnej wersji 1.4.0.

Wersja 1.4.0-alpha02

7 czerwca 2024 r.

Używaj stabilnej wersji 1.4.0.

Wersja 1.4.0-alpha01

17 kwietnia 2024 r.

Używaj stabilnej wersji 1.4.0.

Wersja 1.3.0

Wersja 1.3.1

11 kwietnia 2024 r.

Publikacja androidx.media3:media3-*:1.3.1 Wersja 1.3.1 zawiera te zmiany.

• Biblioteka wspólna:
  • Dodaj Format.labels, aby zezwolić na zlokalizowane lub inne alternatywne etykiety.
• ExoPlayer:
  • Rozwiązaliśmy problem polegający na tym, że PreloadMediaPeriod nie może zachować strumieni, gdy jest ponownie wstępnie wczytywany.
  • Zastosuj odpowiedni atrybut TrackSelectionResult do okresu odtwarzania podczas ponownego wyboru ścieżki.
  • Rozpoczynanie renderowania z włączonym wczesnym renderowaniem dopiero po przesunięciu okresu odtwarzania podczas przechodzenia między elementami multimedialnymi (#1017).
  • Dodanie brakującego typu zwracanego do reguły ProGuard -keepclasseswithmembers dla DefaultVideoFrameProcessor.Factory.Builder.build() (#1187).
• Transformer:
  • Dodano obejście wyjątku zgłaszanego z powodu braku obsługi MediaMuxer ujemnych sygnatur czasowych prezentacji przed interfejsem API w wersji 30.
• Wybór ścieżki:
  • DefaultTrackSelector: preferuj ścieżki wideo z „rozsądną” liczbą klatek na sekundę (>=10 kl./s) od tych z niższą lub nieustawioną liczbą klatek na sekundę. Dzięki temu odtwarzacz wybierze „prawdziwą” ścieżkę wideo w plikach MP4 wyodrębnionych ze zdjęć w ruchu, które mogą zawierać 2 ścieżki HEVC, z których jedna ma wyższą rozdzielczość, ale bardzo małą liczbę klatek (#1051).
• Ekstraktory:
  • Rozwiązaliśmy problem polegający na tym, że podczas odczytywania z plików WAV fragmentów o nieparzystych rozmiarach nie pomijano dopełnienia (#1117).
  • MP3: wypełnij Format.averageBitrate na podstawie ramek metadanych, takich jak XING i VBRI.
  • MPEG-TS: wycofanie zmiany, która miała zapewnić renderowanie ostatniej klatki przez przekazanie ostatniej jednostki dostępu strumienia do kolejki próbek (#7909). Wynika to ze zmiany, która powoduje nowe problemy ze strumieniami HLS zawierającymi tylko klatki I (#1150) i strumieniami HLS H.262 (#1126).
• Dźwięk:
  • Zezwól na przywrócenie renderera przez wyłączenie odciążania, jeśli ścieżka audio nie może się zainicjować w trybie odciążania.
• Film:
  • Dodano obejście problemu z urządzeniami Galaxy Tab S7 FE, Chromecast z Google TV i Lenovo M10 FHD Plus, który powoduje, że strumienie H265 o częstotliwości 60 klatek na sekundę są oznaczane jako nieobsługiwane.
  • Dodano obejście, które zapewnia, że pierwsza klatka jest zawsze renderowana podczas tunelowania, nawet jeśli urządzenie nie robi tego automatycznie zgodnie z wymaganiami interfejsu API (#1169). (#966).
  • Rozwiązano problem z obsługą informacji o kolorach HDR, która powodowała nieprawidłowe działanie kodeka i uniemożliwiała adaptacyjne przełączanie formatów w przypadku ścieżek wideo SDR (#1158).
• Tekst:
  • WebVTT: zapobieganie tworzeniu przez bezpośrednio następujące po sobie sygnały dodatkowych instancji CuesWithTiming z WebvttParser.parse (#1177).
• DRM:
  • Obejście problemu z błędem NoSuchMethodError, który może być zgłaszany przez MediaDrm framework zamiast ResourceBusyException lub NotProvisionedException na niektórych urządzeniach z Androidem 14 (#1145).
• Skutek:
  • Ulepszone mapowanie tonów PQ na SDR dzięki konwersji przestrzeni kolorów.
• Sesja:
  • Rozwiązanie problemu polegającego na tym, że bieżąca pozycja cofa się, gdy kontroler zastępuje bieżący element (#951).
  • Rozwiązaliśmy problem polegający na tym, że MediaMetadata z tylko niepustym extras nie jest przesyłany między kontrolerami multimediów a sesjami (#1176).
• UI:
  • W przypadku, gdy Locale nie może zidentyfikować nazwy wyświetlanej (#988), użyj nazwy języka ścieżki audio.
• Rozszerzenie DASH:
  • Wypełnij wszystkie elementy Label z pliku manifestu w Format.labels (#1054).
• Rozszerzenie RTSP:
  • Pomijanie pustych wartości informacji o sesji (i-tagów) podczas analizowania SDP (#1087).
• Rozszerzenia dekodera (FFmpeg, VP9, AV1, MIDI itp.):
  • Domyślnie wyłącz rozszerzenie MIDI jako lokalną zależność, ponieważ wymaga ono skonfigurowania dodatkowego repozytorium Maven. Użytkownicy, którzy potrzebują tego modułu z lokalnej zależności, mogą go ponownie włączyć.

Wersja 1.3.0

6 marca 2024 roku

Publikacja androidx.media3:media3-*:1.3.0 Wersja 1.3.0 zawiera te zmiany.

• Biblioteka wspólna:
  • Wprowadź obsługę identyfikatorów URI surowych zasobów android.resource://package/[type/]name, w których package różni się od pakietu bieżącej aplikacji. Zawsze było to udokumentowane jako działające, ale do tej pory nie było prawidłowo zaimplementowane.
  • Normalizuj typy MIME ustawione przez kod aplikacji lub odczytane z multimediów, aby były w całości zapisane małymi literami.
  • Określaj reklamy za pomocą pełnego pola MediaItem zamiast pojedynczego pola Uri w polu AdPlaybackState.
  • Zwiększ wartość minSdk do 19 (Android KitKat). Jest to zgodne ze wszystkimi innymi bibliotekami AndroidX i jest wymagane, abyśmy mogli przejść na najnowsze wersje naszych zależności AndroidX.
  • Wypełnij zarówno pole artworkUri, jak i artworkData w elemencie MediaMetadata.Builder.populate(MediaMetadata), jeśli co najmniej jedno z nich nie ma wartości null (#964).
• ExoPlayer:
  • Dodaj PreloadMediaSource i PreloadMediaPeriod, które umożliwiają aplikacjom wstępne wczytywanie źródła treści multimedialnych w określonej pozycji początkowej przed odtwarzaniem. PreloadMediaSource przygotowuje źródło multimediów do otrzymania Timeline, przygotowuje i buforuje okres w danym położeniu początkowym, wybiera ścieżki i wczytuje dane multimedialne dla tego okresu. Aplikacje kontrolują postęp wstępnego wczytywania, implementując PreloadMediaSource.PreloadControl, i ustawiają wstępnie wczytane źródło w odtwarzaczu do odtwarzania.
  • Dodaj ExoPlayer.setImageOutput, które umożliwia aplikacjom ustawianie ImageRenderer.ImageOutput.
  • DefaultRenderersFactory domyślnie udostępnia graczowi ImageRenderer z wartościami null ImageOutput i ImageDecoder.Factory.DEFAULT.
  • Emitowanie zdarzenia Player.Listener.onPositionDiscontinuity, gdy pominięto ciszę (#765).
  • Dodano eksperymentalną obsługę analizowania napisów podczas wyodrębniania. Możesz to zrobić za pomocą MediaSource.Factory.experimentalParseSubtitlesDuringExtraction().
  • Obsługa adaptacyjnych źródeł multimediów za pomocą PreloadMediaSource.
  • Zaimplementuj HttpEngineDataSource, czyli HttpDataSource za pomocą interfejsu HttpEngine API.
  • Zapobiegaj tworzeniu podklas CompositeSequenceableLoader. Ten komponent był wcześniej rozszerzalny, ale nigdy nie został w bibliotece podzielony na podklasy. Dostosowywanie można przeprowadzić, opakowując instancję za pomocą wzorca dekoratora i wdrażając niestandardowy element CompositeSequenceableLoaderFactory.
  • Rozwiązaliśmy problem polegający na tym, że powtórzenie tego samego czasu powodowało wyczyszczenie metadanych tego elementu (#1007).
  • Zmiana nazwy metod experimentalSetSubtitleParserFactory na BundledChunkExtractor.Factory i DefaultHlsExtractorFactory na setSubtitleParserFactory oraz zablokowanie przekazywania null. Użyj nowych metod experimentalParseSubtitlesDuringExtraction(boolean), aby kontrolować zachowanie analizowania.
  • Dodano możliwość dostosowywania znaku SubtitleParser.Factory używanego podczas wyodrębniania. Można to osiągnąć za pomocą MediaSource.Factory.setSubtitleParserFactory().
  • Dodaj prefiks źródła do wszystkich pól Format.id wygenerowanych z MergingMediaSource. Pomaga to określić, które źródło wygenerowało Format (#883).
  • Poprawiono wyrażenie regularne używane do weryfikacji niestandardowych nazw kluczy danych klienta Common Media Client Data (CMCD) poprzez zmodyfikowanie go tak, aby sprawdzało tylko łącznik (#1028).
  • Zapobiegaj podwójnemu kodowaniu parametrów zapytania CMCD (#1075).
• Transformer:
  • Dodano obsługę spłaszczania filmów w zwolnionym tempie w formacie H.265/HEVC SEF.
  • Zwiększenie szybkości transkodowania, zwłaszcza w przypadku zmian typu „usuń film”.
  • Dodaj interfejs API, aby mieć pewność, że plik wyjściowy zaczyna się od klatki wideo. Może to zwiększyć zgodność wyników operacji przycinania z implementacjami odtwarzaczy, które nie wyświetlają pierwszej klatki filmu, dopóki nie zostanie osiągnięta sygnatura czasowa prezentacji (#829).
  • Dodano obsługę optymalizacji operacji przycinania pojedynczych zasobów MP4.
  • Dodaliśmy obsługę, która zapewnia, że klatka wideo ma pierwszą sygnaturę czasową w pliku wyjściowym. Naprawiono pliki wyjściowe zaczynające się od czarnej ramki na odtwarzaczach opartych na iOS (#829).
• Wybór ścieżki:
  • Dodaj DefaultTrackSelector.selectImageTrack, aby włączyć wybieranie ścieżki obrazu.
  • Dodaj TrackSelectionParameters.isPrioritizeImageOverVideoEnabled, aby określić, czy wybrać ścieżkę obrazu, jeśli dostępne są zarówno ścieżka obrazu, jak i ścieżka wideo. Wartość domyślna to false, co oznacza, że priorytetem jest wybór ścieżki wideo.
• Ekstraktory:
  • Dodano do ekstraktora MP4 dodatkowe parsowanie AV1C, aby pobierać wartości ColorInfo.colorSpace, ColorInfo.colorTransfer i ColorInfo.colorRange (#692).
  • MP3: używaj wyszukiwania ze stałą szybkością transmisji (CBR) w przypadku plików z nagłówkiem Info (odpowiednik nagłówka Xing w przypadku CBR). Wcześniej używaliśmy tabeli seek z nagłówka Info, ale powoduje to mniej precyzyjne wyszukiwanie niż w przypadku, gdy ją ignorujemy i zakładamy, że plik jest CBR.
  • MPEG2-TS: dodano obsługę DTS, DTS-LBR i DTS:X Profile2 (#275).
  • Wyodrębnianie typów audio z deskryptorów TS i mapowanie ich na flagi ról, co pozwala użytkownikom podejmować bardziej świadome decyzje dotyczące wyboru ścieżki audio (#973).
• Dźwięk:
  • Ulepszony algorytm pomijania ciszy z płynnym zwiększaniem głośności; zachowana minimalna cisza i bardziej naturalne czasy trwania ciszy (#7423).
  • Zgłaszanie pominiętego wyciszenia w bardziej deterministyczny sposób (#1035).
• Film:
  • Zmień konstruktor MediaCodecVideoRenderer, który przyjmuje argument VideoFrameProcessor.Factory, i zastąp go konstruktorem, który przyjmuje argument VideoSinkProvider. Aplikacje, które chcą wstawić niestandardowy element VideoFrameProcessor.Factory, mogą utworzyć instancję elementu CompositingVideoSinkProvider, który używa niestandardowego elementu VideoFrameProcessor.Factory, i przekazać dostawcę ujścia wideo do elementu MediaCodecVideoRenderer.
• Tekst:
  • Naprawiono serializację wskazówek bitmapowych, aby rozwiązać błąd Tried to marshall a Parcel that contained Binder objects podczas korzystania z DefaultExtractorsFactory.setTextTrackTranscodingEnabled (#836).
  • CEA-708: ignoruj wartość rowLock. Specyfikacja CEA-708-E S-2023 mówi, że wartości rowLock i columnLock powinny być traktowane jako prawdziwe niezależnie od wartości w strumieniu (obsługa columnLock nie jest zaimplementowana, więc w praktyce zawsze przyjmuje się wartość fałsz).
• Obraz:
  • Dodano obsługę miniatur DASH. Obrazy w siatce są przycinane, a poszczególne miniatury są udostępniane ImageOutput w pobliżu czasu ich wyświetlania.
• DRM:
  • Odtwarzaj od razu „czyste” nieszyfrowane próbki w treściach z DRM, nawet jeśli klucze do późniejszych zaszyfrowanych próbek nie są jeszcze gotowe. Może to prowadzić do przerw w odtwarzaniu, jeśli klucze nie będą jeszcze gotowe, gdy pozycja odtwarzania osiągnie zaszyfrowane próbki (wcześniej odtwarzanie w tym momencie w ogóle by się nie rozpoczęło). To zachowanie można wyłączyć za pomocą parametru MediaItem.DrmConfiguration.Builder.setPlayClearContentWithoutKey lub DefaultDrmSessionManager.Builder.setPlayClearSamplesWithoutKeys.
• Rozszerzenie IMA:
  • Rozwiązanie problemu polegającego na tym, że nie można odtworzyć reklam DASH i HLS bez odpowiedniego rozszerzenia pliku.
• Sesja:
  • Wyłącz wykrywanie dwukrotnego kliknięcia w aplikacjach na telewizory (#962).
  • Rozwiązaliśmy problem, który powodował, że MediaItem.RequestMetadata zawierający tylko niepuste dodatki nie był przesyłany między kontrolerami multimediów a sesjami.
  • Dodaj do klasy MediaLibrarySession.Builder konstruktor, który przyjmuje tylko argument Context zamiast argumentu MediaLibraryService.
• Rozszerzenie HLS:
  • Zmniejsz widoczność HlsMediaPeriod do poziomu prywatnego pakietu. Ten typ nie powinien być bezpośrednio zależny od elementów spoza pakietu HLS.
  • Rozwiązanie problemu z wydajniejszym wyszukiwaniem początku segmentu (#1031).
• Rozszerzenia dekodera (FFmpeg, VP9, AV1, MIDI itp.):
  • Dekoder MIDI: ignoruj komunikaty zdarzeń SysEx (#710).
• Narzędzia testowe:
  • Nie wstrzymuj odtwarzania w TestPlayerRunHelper.playUntilPosition. Test utrzymuje odtwarzanie w stanie odtwarzania, ale wstrzymuje postęp do momentu, gdy będzie można dodać asercje i dalsze działania.
• Aplikacja w wersji demonstracyjnej:
  • Dodaj moduł demonstracyjny krótkich filmów, aby zademonstrować użycie atrybutu PreloadMediaSource w przypadku krótkich filmów.

Wersja 1.3.0-rc01

22 lutego 2024 r.

Używaj stabilnej wersji 1.3.0.

Wersja 1.3.0-beta01

7 lutego 2024 r.

Użyj stabilnej wersji 1.3.0.

Wersja 1.3.0-alpha01

15 stycznia 2024 r.

Używaj stabilnej wersji 1.3.0.

Wersja 1.2.0

Wersja 1.2.1

9 stycznia 2024 r.

• ExoPlayer:
  • Rozwiązaliśmy problem, który powodował, że ręczne przewijanie poza zakresem LiveConfiguration.min/maxOffset stale dostosowywało przesunięcie z powrotem do min/maxOffset.
  • Naprawiono problem z nieprawidłowym układem kanałów OPUS i VORBIS w przypadku 3, 5, 6, 7 i 8 kanałów (#8396).
  • Rozwiązaliśmy problem polegający na tym, że po przewinięciu transmisji na żywo do początku wybór ścieżki powodował nieprawidłowe rozpoczęcie transmisji w domyślnej pozycji (#9347).
  • Rozwiązaliśmy problem, w którym nowe instancje CmcdData.Factory otrzymywały ujemne wartości parametru bufferedDurationUs ze źródeł fragmentów, co powodowało błąd IllegalArgumentException (#888).
• Transformer:
  • Rozwiązaliśmy problem, który powodował, że koder zgłaszał błąd podczas konfiguracji z powodu ustawienia wysokiej szybkości działania.
• Ekstraktory:
  • Oznacz dodatkowe (nieodtwarzalne) ścieżki HEVC w zdjęciach w ruchu JPEG jako ROLE_FLAG_ALTERNATE, aby zapobiec ich automatycznemu wybieraniu do odtwarzania ze względu na wyższą rozdzielczość.
  • Poprawiono nieprawidłowe wykrywanie klatek kluczowych w strumieniach TS H264 (#864).
  • Poprawiono szacowanie czasu trwania strumieni TS dłuższych niż 47721 sekund (#855).
• Dźwięk:
  • Poprawiono obsługę EOS w przypadku wywoływania SilenceSkippingAudioProcessor wiele razy (#712).
• Film:
  • Dodano obejście problemu z urządzeniami Galaxy Tab S7 FE, Chromecast z Google TV i Lenovo M10 FHD Plus, który powoduje, że strumienie AVC o częstotliwości 60 kl./s są oznaczane jako nieobsługiwane (#693).
• Metadane:
  • Naprawiono błąd, w którym pole MediaMetadata było wypełniane tylko na podstawie komentarzy Vorbis z kluczami pisanymi wielkimi literami (#876).
  • Poprawka OutOfMemoryError podczas analizowania bardzo dużych ramek ID3, co oznacza, że odtwarzanie może być kontynuowane bez informacji o tagu, zamiast całkowicie się nie powieść.
• DRM:
  • Rozszerzono obejście problemu z fałszywym adresem URL licencji ClearKey https://default.url na interfejs API w wersji 33 lub nowszej (wcześniej obejście dotyczyło tylko interfejsu API w wersji 33) (#837).
  • Naprawiono ERROR_DRM_SESSION_NOT_OPENED podczas przełączania z zaszyfrowanych na niezabezpieczone treści bez powierzchni dołączonej do odtwarzacza. Błąd wystąpił z powodu nieprawidłowego użycia bezpiecznego dekodera do odtwarzania treści w formie niezaszyfrowanej.
• Sesja:
  • Umieść klucze i wartości niestandardowe w MediaMetadataCompat to MediaMetadata.extras i MediaMetadata.extras to MediaMetadataCompat (#756, #802).
  • Naprawiono rozgłaszanie notifyChildrenChanged w przypadku starszych kontrolerów (#644).
  • Naprawiliśmy błąd, który powodował, że ustawienie ujemnego czasu dla wyłączonego timera setWhen powiadomienia powodowało awarię na niektórych urządzeniach (#903).
  • Naprawiono błąd IllegalStateException, który występował, gdy kontroler powiadomień o multimediach nie zakończył łączenia, a użytkownik poprosił o pierwszą aktualizację powiadomienia (#917).
• UI:
  • Rozwiązanie problemu polegającego na tym, że przyciski przewijania do przodu i do tyłu nie były widoczne, gdy były używane z Material Design w BottomSheetDialogFragment (#511).
  • Rozwiązaliśmy problem z nieprawidłowym wyrównaniem liczb na przycisku przewijania do przodu w PlayerControlView (#547).
• Rozszerzenie DASH:
  • Parsowanie „f800” jako liczby kanałów 5 w przypadku Dolby w pliku manifestu DASH (#688).
• Rozszerzenia dekodera (FFmpeg, VP9, AV1, MIDI itp.):
  • MIDI: rozwiązano problem z przeskakiwaniem zdarzeń zmiany programu podczas przewijania do przodu (#704).
  • Migracja do FFmpeg 6.0 i aktualizacja obsługiwanego NDK do wersji r26b(#707,#867).
• Rozszerzenie Cast:
  • Poprawiono tworzenie Timeline, aby aplikacja nie ulegała awarii, gdy ładowanie multimediów na urządzeniu do przesyłania nie powiedzie się (#708).

Wersja 1.2.0

15 listopada 2023 r.

• Biblioteka wspólna:
  • Dodaj parametr @Nullable Throwable do metod w interfejsie Log.Logger. Parametr message w tych metodach nie zawiera już żadnych informacji o parametrze Throwable przekazywanym do metod Log.{d,i,w,e}(), więc w razie potrzeby implementacje będą musiały ręcznie dołączać te informacje (być może za pomocą parametru Logger.appendThrowableString(String, Throwable)).
  • Rozwiązanie problemu ze zgodnością z Kotlinem, który powodował, że parametry typu ogólnego dopuszczające wartość null i typy elementów tablicy dopuszczające wartość null nie były wykrywane jako dopuszczające wartość null. Przykładami są parametry metod TrackSelectorResult i SimpleDecoder (#6792).
  • Zmień domyślne działanie interfejsu i powiadomień w Util.shouldShowPlayButton, aby wyświetlać przycisk „Odtwórz”, gdy odtwarzanie jest tymczasowo wstrzymane (np. z powodu chwilowej utraty fokusu dźwięku). Poprzednie działanie można zachować, używając PlayerView.setShowPlayButtonIfPlaybackIsSuppressed(false) lub MediaSession.Builder.setShowPlayButtonIfPlaybackIsSuppressed(false) (#11213).
  • Uaktualnij androidx.annotation:annotation-experimental do 1.3.1, aby rozwiązać problem opisany na stronie https://issuetracker.google.com/251172715.
  • Przenieś ExoPlayer.setAudioAttributes do interfejsu Player.
• ExoPlayer:
  • Rozwiązaliśmy problem z przewijaniem strumieni AC4 spowodowany nieprawidłowym rozpoznawaniem próbek przeznaczonych tylko do dekodowania (#11000).
  • Dodaj wyłączanie odtwarzania na nieodpowiednich urządzeniach wyjściowych audio (np. wbudowanym głośniku na urządzeniach z Wear OS), gdy ta funkcja jest włączona za pomocą ExoPlayer.Builder.setSuppressPlaybackOnUnsuitableOutput. Przyczyna wstrzymania odtwarzania zostanie zaktualizowana do wartości Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT, jeśli odtwarzanie zostanie podjęte, gdy nie są dostępne odpowiednie wyjścia audio, lub jeśli wszystkie odpowiednie wyjścia zostaną odłączone podczas odtwarzania. Przyczyna wyciszenia zostanie usunięta po podłączeniu odpowiedniego wyjścia.
  • Dodaj znaki MediaSource.canUpdateMediaItem i MediaSource.updateMediaItem, aby zaakceptować aktualizacje MediaItem po utworzeniu za pomocą Player.replaceMediaItem(s).
  • Zezwalaj na aktualizacje MediaItem dla wszystkich klas MediaSource udostępnianych przez bibliotekę za pomocą Player.replaceMediaItem(s) (#33, #9978).
  • Zmień nazwę MimeTypes.TEXT_EXOPLAYER_CUES na MimeTypes.APPLICATION_MEDIA3_CUES.
  • Dodaj PngExtractor, które wysyła i odczytuje cały plik PNG w TrackOutput jako jeden przykład.
  • Ulepsz metodę SequenceableLoader.continueLoading(long) w interfejsie SequenceableLoader, aby SequenceableLoader.continueLoading(LoadingInfo loadingInfo). LoadingInfo zawiera dodatkowe parametry, w tym playbackSpeed i lastRebufferRealtimeMs, oprócz dotychczasowego parametru playbackPositionUs.
  • Ulepsz metodę ChunkSource.getNextChunk(long, long, List, ChunkHolder) w interfejsie ChunkSource, aby ChunkSource.getNextChunk(LoadingInfo, long, List, ChunkHolder).
  • Dodaliśmy do rejestrowania danych klienta Common Media Client Data (CMCD) dodatkowe pola: buffer starvation (bs), deadline (dl), playback rate (pr) i startup (su) (#8699).
  • Dodaj głębię bitową luminancji i chrominancji do ColorInfo(#491).
  • Dodano do rejestrowania danych klienta Common Media Client Data (CMCD) dodatkowe pola: następne żądanie obiektu (nor) i następne żądanie zakresu (nrr) (#8699).
  • Dodaj funkcję przesyłania danych Common Media Client Data (CMCD) za pomocą parametrów zapytania (#553).
  • Rozwiąż problem ConcurrentModificationException w sekcji ExperimentalBandwidthMeter (#612).
  • Dodaj parametr MediaPeriodId do CompositeMediaSource.getMediaTimeForChildMediaTime.
  • Obsługa ClippingMediaSource (i innych źródeł z okresem/okresem czasu przesunięcia) w ConcatenatingMediaSource2 (#11226).
  • Zmień BaseRenderer.onStreamChanged(), aby otrzymywać też argument MediaPeriodId.
• Transformer:
  • Analizowanie danych o rotacji EXIF w przypadku danych wejściowych w postaci obrazów.
  • Usuń typ adnotacji TransformationRequest.HdrMode i powiązane z nim stałe. Zamiast tego użyj zasady Composition.HdrMode i powiązanych z nią stałych.
  • Uprość OverlaySettings, aby rozwiązać problemy z obracaniem.
  • Zmieniono parametry frameRate i durationUs elementu SampleConsumer.queueInputBitmap na TimestampIterator.
• Wybór ścieżki:
  • Dodaj DefaultTrackSelector.Parameters.allowAudioNonSeamlessAdaptiveness, aby wyraźnie zezwolić na adaptację niepełną lub jej zabronić. Domyślne działanie pozostaje bez zmian i wynosi true.
• Ekstraktory:
  • MPEG-TS: upewnij się, że ostatnia klatka jest renderowana przez przekazanie ostatniej jednostki dostępu strumienia do kolejki próbek (#7909).
  • Popraw literówkę podczas określania rotationDegrees. Zmieniono projectionPosePitch na projectionPoseRoll (#461).
  • Usuń założenie, że instancje Extractor można bezpośrednio sprawdzać za pomocą instanceof. Jeśli chcesz uzyskać dostęp w czasie działania do szczegółów implementacji Extractor, musisz najpierw wywołać Extractor.getUnderlyingInstance.
  • Dodaj BmpExtractor.
  • Dodaj WebpExtractor.
  • Dodaj HeifExtractor.
  • Dodaliśmy obsługę QuickTime Classic w Mp4Extractor.
• Dźwięk:
  • Dodaliśmy obsługę 24/32-bitowego formatu PCM w formacie big-endian w MP4 i Matroska oraz analizowanie kodowania PCM dla lpcm w MP4.
  • Dodano obsługę wyodrębniania dźwięku Vorbis z pliku MP4.
  • Dodaj AudioSink.getFormatOffloadSupport(Format), które pobiera poziom obsługi odciążania, jaki odbiornik może zapewnić w przypadku formatu, za pomocą DefaultAudioOffloadSupportProvider. Zwraca nowy AudioOffloadSupport, który zawiera isFormatSupported, isGaplessSupported i isSpeedChangeSupported.
  • Dodaj AudioSink.setOffloadMode(), za pomocą którego konfiguracja odciążania na urządzeniu wyjściowym audio jest konfigurowana. Wartość domyślna to AudioSink.OFFLOAD_MODE_DISABLED.
  • Przenoszenie można włączyć w setAudioOffloadPreference w TrackSelectionParameters. Jeśli ustawiona preferencja to włączenie, urządzenie obsługuje odciążanie w przypadku danego formatu, a wybór ścieżki to pojedyncza ścieżka audio, odciążanie audio zostanie włączone.
  • Jeśli wartość audioOffloadModePreference to AUDIO_OFFLOAD_MODE_PREFERENCE_REQUIRED, DefaultTrackSelector wybierze tylko ścieżkę audio i tylko wtedy, gdy jej format jest obsługiwany w przypadku odciążania. Jeśli żadna ścieżka audio nie jest obsługiwana w przypadku odciążania, nie zostanie wybrana żadna ścieżka.
  • Wyłączanie obsługi bez przerw w przypadku odciążania, gdy poziom interfejsu API jest niższy niż 33, z powodu problemu z pozycją odtwarzania po przejściu utworu.
  • Usuń parametr enableOffload z sygnatury metody DefaultRenderersFactory.buildAudioSink.
  • Usuń metodę DefaultAudioSink.Builder.setOffloadMode.
  • Usuń wartość intdef:DefaultAudioSink.OffloadMode.OFFLOAD_MODE_ENABLED_GAPLESS_DISABLED
  • Dodanie obsługi metadanych bez przerw w przypadku formatu Opus podczas odtwarzania z przeniesieniem.
  • Zezwól na przywrócenie renderera przez wyłączenie przenoszenia, jeśli pierwsza próba zapisu się nie powiodła (#627).
  • Domyślnie włącz harmonogram odciążania w przypadku odtwarzania odciążonego tylko dźwięku.
  • Usuń ExoPlayer.experimentalSetOffloadSchedulingEnabled i AudioOffloadListener.onExperimentalOffloadSchedulingEnabledChanged.
  • Zmieniono nazwę onExperimentalSleepingForOffloadChanged na onSleepingForOffloadChanged, a onExperimentalOffloadedPlayback na onOffloadedPlayback.
  • Przenieś interfejsy i definicje związane z trybem odciążania dźwięku TrackSelectionParameters do wewnętrznej klasy AudioOffloadPreferences.
  • Dodaj wywołania zwrotne onAudioTrackInitialized i onAudioTrackReleased do AnalyticsListener, AudioRendererEventListener i AudioSink.Listener.
  • Rozwiązanie problemu z niedomiarem bufora audio DTS Express (#650).
  • Naprawiono błąd, w którym sprawdzanie możliwości E-AC3-JOC powodowało wyświetlenie komunikatu IllegalArgumentException(#677).
• Film:
  • Zezwalaj usłudze MediaCodecVideoRenderer na korzystanie z niestandardowego VideoFrameProcessor.Factory.
  • Rozwiązanie problemu polegającego na tym, że pierwsza klatka nie mogła być renderowana, jeśli strumień audio zaczynał się od ujemnych sygnatur czasowych (#291).
• Tekst:
  • Usuń ExoplayerCuesDecoder. Ścieżki tekstowe z sampleMimeType = application/x-media3-cues są teraz obsługiwane bezpośrednio przez TextRenderer bez konieczności używania instancji SubtitleDecoder.
• Metadane:
  • MetadataDecoder.decode nie będzie już wywoływana w przypadku próbek „tylko do dekodowania”, ponieważ implementacja i tak musi zwracać wartość null.
• Skutek:
  • Dodaj VideoFrameProcessor.queueInputBitmap(Bitmap, Iterator<Long>) wejście mapy bitowej kolejki według sygnatury czasowej.
  • Zmień VideoFrameProcessor.registerInputStream() na nieblokujące. Aplikacje muszą implementować funkcję VideoFrameProcessor.Listener#onInputStreamRegistered().
  • Zmieniono parametry frameRate i durationUs elementu VideoFrameProcessor.queueInputBitmap na TimestampIterator.
• Rozszerzenie IMA:
  • Rozwiązanie problemu polegającego na tym, że transmisja na żywo DASH z wieloma okresami, która nie jest pierwszym elementem na playliście, może zgłaszać wyjątek (#571).
  • Zwolnij StreamManager przed wywołaniem AdsLoader.destroy()
  • Zaktualizuj pakiet IMA SDK do wersji 3.31.0.
• Sesja:
  • Ustaw zachowanie usługi pierwszego planu powiadomień na FOREGROUND_SERVICE_IMMEDIATE w DefaultMediaNotificationProvider (#167).
  • Używaj tylko android.media.session.MediaSession.setMediaButtonBroadcastReceiver() interfejsu API w wersji 31 lub nowszej, aby uniknąć problemów z przestarzałym interfejsem API na urządzeniach Samsung (#167).
  • Użyj kontrolera powiadomień o multimediach jako serwera proxy, aby ustawić dostępne polecenia i niestandardowy układ używany do wypełniania powiadomienia i sesji platformy.
  • Konwertuj zdarzenia przycisków multimedialnych odbierane przez MediaSessionService.onStartCommand() w Media3 zamiast kierować je do sesji platformy i z powrotem do Media3. Dzięki temu kontroler połączeń jest zawsze kontrolerem powiadomień o multimediach, a aplikacje mogą łatwo rozpoznawać połączenia przychodzące z powiadomienia w taki sam sposób na wszystkich obsługiwanych poziomach interfejsu API.
  • Rozwiązanie problemu polegającego na tym, że MediaController.getCurrentPosition() nie przechodzi do przodu, gdy jest połączony ze starszym MediaSessionCompat.
  • Dodaj MediaLibrarySession.getSubscribedControllers(mediaId) dla wygody.
  • Zastąp MediaLibrarySession.Callback.onSubscribe(), aby potwierdzić dostępność identyfikatora elementu nadrzędnego, do którego subskrybuje kontroler. Jeśli się to uda, subskrypcja zostanie zaakceptowana i notifyChildrenChanged() zostanie natychmiast wywołana, aby poinformować przeglądarkę (#561).
  • Dodaj moduł demonstracyjny sesji dla systemu operacyjnego Automotive i włącz demonstrację sesji w Androidzie Auto.
  • Nie ustawiaj kolejki sesji platformy, gdy wartość COMMAND_GET_TIMELINE nie jest dostępna dla kontrolera powiadomień o multimediach. Gdy Android Auto jest kontrolerem klienta odczytującym dane z sesji frameworka, przycisk queue w interfejsie Androida Auto nie jest wyświetlany (#339).
  • Domyślnie używaj DataSourceBitmapLoader zamiast SimpleBitmapLoader (#271, #327).
  • Dodano MediaSession.Callback.onMediaButtonEvent(Intent), który umożliwia aplikacjom zastępowanie domyślnej obsługi zdarzeń przycisków multimedialnych.
• UI:
  • Dodaj implementację Player.Listener na urządzenia z Wear OS, która obsługuje wyciszanie odtwarzania z powodu Player.PLAYBACK_SUPPRESSION_REASON_UNSUITABLE_AUDIO_OUTPUT przez wyświetlanie okna systemowego, które umożliwia użytkownikowi podłączenie odpowiedniego wyjścia audio (np. słuchawek Bluetooth). Odtwarzanie zostanie automatycznie wznowione, jeśli w konfigurowalnym czasie (domyślnie 5 minut) zostanie podłączone odpowiednie urządzenie.
• Pobrane:
  • Zadeklaruj typ usługi na pierwszym planie „synchronizacja danych” w przypadku DownloadService, aby zapewnić zgodność z Androidem 14. Podczas korzystania z tej usługi aplikacja musi też dodać dataSync jako foregroundServiceType w pliku manifestu oraz dodać uprawnienie FOREGROUND_SERVICE_DATA_SYNC (#11239).
• Rozszerzenie HLS:
  • Odświeżanie listy odtwarzania HLS na żywo w interwale obliczanym na podstawie czasu rozpoczęcia ostatniego wczytywania, a nie czasu zakończenia ostatniego wczytywania (#663).
• Rozszerzenie DASH:
  • Zezwalaj na wiele identyfikatorów DASH w adresie URL szablonu segmentu.
  • Dodano eksperymentalną obsługę analizowania napisów podczas wyodrębniania. Ta funkcja lepiej obsługuje scalanie nakładających się napisów, w tym rozwiązuje problem migotania podczas przechodzenia między segmentami napisów. Możesz włączyć tę funkcję za pomocą DashMediaSource.Factory.experimentalParseSubtitlesDuringExtraction() (#288).
• Rozszerzenie RTSP:
  • Usunięto błąd wyścigu, który w niektórych sytuacjach mógł powodować IndexOutOfBoundsException podczas powrotu do TCP lub zawieszanie się odtwarzania.
  • Sprawdzanie stanu podczas konfiguracji RTSP przy zwracaniu stanu ładowania RtspMediaPeriod (#577).
  • Ignorowanie niestandardowych metod żądań RTSP w nagłówku publicznym odpowiedzi na żądanie OPTIONS (#613).
  • Użyj wartości czasu oczekiwania na odpowiedź na żądanie konfiguracji RTSP w interwale czasowym wysyłania żądań opcji RTSP typu keep-alive (#662).
• Rozszerzenia dekodera (FFmpeg, VP9, AV1, MIDI itp.):
  • Wydanie modułu dekodera MIDI, który zapewnia obsługę odtwarzania standardowych plików MIDI za pomocą biblioteki Jsyn do syntezy dźwięku.
  • Dodaj DecoderOutputBuffer.shouldBeSkipped, aby bezpośrednio oznaczyć bufory wyjściowe, które nie muszą być prezentowane. Jest to preferowane rozwiązanie w porównaniu z C.BUFFER_FLAG_DECODE_ONLY, które zostanie wycofane.
  • Dodaj Decoder.setOutputStartTimeUs i SimpleDecoder.isAtLeastOutputStartTimeUs, aby umożliwić dekoderom odrzucanie próbek tylko do dekodowania przed czasem rozpoczęcia. Jest to preferowane rozwiązanie w porównaniu z Buffer.isDecodeOnly, które zostanie wycofane.
  • Naprawiono błąd publikowania artefaktu dekodera MIDI w repozytorium Maven. Artefakt został zmieniony na media3-exoplayer-midi (#734).
• Rozszerzenie Leanback:
  • Naprawiono błąd, w którym wyłączenie powierzchni może powodować błąd ArithmeticException w kodzie Leanback (#617).
• Narzędzia testowe:
  • Zapewnij zgodność TestExoPlayerBuilder i FakeClock z testami interfejsu Espresso i testami interfejsu Compose. Rozwiązaliśmy problem, w którym odtwarzanie postępuje w sposób niedeterministyczny podczas interakcji z widokami Espresso lub Compose.
• Usuń symbole, które nie są już używane:
  • Usuń TransformationRequest.Builder.setEnableRequestSdrToneMapping(boolean) i TransformationRequest.Builder.experimental_setEnableHdrEditing(boolean). Użyj zasady Composition.Builder.setHdrMode(int) i przekaż do niej wartość Composition, a następnie użyj zasady Transformer.start(Composition, String).
  • Usuń wycofaną metodę DownloadNotificationHelper.buildProgressNotification. Zamiast niej użyj metody, która nie została wycofana i przyjmuje parametr notMetRequirements.

Wersja 1.2.0-rc01

1 listopada 2023 roku

Używaj stabilnej wersji 1.2.0.

Wersja 1.2.0-beta01

19 października 2023 r.

Używaj stabilnej wersji 1.2.0.

Wersja 1.2.0-alpha02

29 września 2023 r.

Używaj stabilnej wersji 1.2.0.

Wersja 1.2.0-alpha01

17 sierpnia 2023 r.

Używaj stabilnej wersji 1.2.0.

Wersja 1.1.0

Wersja 1.1.1

16 sierpnia 2023 r.

• Biblioteka wspólna:
  • Usuń przypadkowo dodaną zależność multidex ze wszystkich modułów (#499).
• ExoPlayer:
  • Rozwiązaliśmy problem w PlaybackStatsListener, który powodował, że po wyczyszczeniu playlisty tworzone były nieprawidłowe PlaybackStats.
  • Dodawanie dodatkowych pól do rejestrowania danych klienta multimediów (CMCD): format strumieniowania (sf), typ strumienia (st), wersja (v), najwyższa szybkość transmisji (tb), czas trwania obiektu (d), zmierzona przepustowość (mtp) i typ obiektu (ot) (#8699).
• Dźwięk:
  • Usunięto błąd, w którym Player.getState() nigdy nie przechodziło w STATE_ENDED podczas odtwarzania bardzo krótkich plików (#538).
• Przekierowanie dźwięku:
  • Dodaj na początku strumienia bitów strony nagłówka identyfikatora Ogg i strony nagłówka komentarza, aby umożliwić odtwarzanie Opus w trybie offload zgodnie z dokumentem RFC 7845.
• Film:
  • H.265/HEVC: poprawiono analizowanie informacji o krótkoterminowych i długoterminowych obrazach referencyjnych w SPS.
• Tekst:
  • CEA-608: zmiana logiki obcinania wskazówek, aby uwzględniać tylko widoczny tekst. Wcześniej wcięcia i przesunięcia tabulacji były uwzględniane przy ograniczaniu długości napisu do 32 znaków (co było technicznie poprawne zgodnie ze specyfikacją) (#11019).
• Rozszerzenie IMA:
  • Zaktualizuj pakiet IMA SDK do wersji 3.30.3.
• Sesja:
  • Dodaj niestandardowy układ do stanu kontrolera i udostępnij funkcję pobierającą, która umożliwi do niego dostęp. Gdy zmieni się układ niestandardowy, wywoływana jest funkcja MediaController.Listener.onCustomLayoutChanged. Aplikacje, które chcą wysyłać różne niestandardowe układy do różnych kontrolerów Media3, mogą to zrobić w MediaSession.Callback.onConnect, używając AcceptedResultBuilder, aby mieć pewność, że niestandardowy układ będzie dostępny dla kontrolera po zakończeniu połączenia.
  • Naprawiliśmy przypadki, w których MediaLibraryServiceLegacyStub wysyłał błąd do Result, który nie obsługiwał tej funkcji, co powodowało błąd UnsupportedOperationException (#78).
  • Poprawiono sposób, w jaki PlayerWrapper tworzy VolumeProviderCompat, poprzez określanie volumeControlType za pomocą starszych poleceń (COMMAND_ADJUST_DEVICE_VOLUME i COMMAND_SET_DEVICE_VOLUME) oraz nowych poleceń (COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS i COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS) (#554).

Wersja 1.1.0

5 lipca 2023 r.

• Biblioteka wspólna:
  • Dodaj powód wyciszenia nieodpowiedniej ścieżki audio i odtwarzaj, gdy będzie gotowa zmień powód wyciszenia na zbyt długi. (#15).
  • Dodawanie poleceń do odtwarzacza:
    • COMMAND_GET_METADATA
    • COMMAND_SET_PLAYLIST_METADATA
    • COMMAND_SET_DEVICE_VOLUME_WITH_FLAGS
    • COMMAND_ADJUST_DEVICE_VOLUME_WITH_FLAGS
  • Dodaj do klasy Player przeciążone metody, które pozwalają użytkownikom określać flagi głośności:
    • void setDeviceVolume(int, int)
    • void increaseDeviceVolume(int)
    • void decreaseDeviceVolume(int)
    • void setDeviceMuted(boolean, int)
  • Dodano Builder dla DeviceInfo i wycofano dotychczasowy konstruktor.
  • Dodaj DeviceInfo.routingControllerId, aby określić identyfikator kontrolera routingu w przypadku odtwarzania zdalnego.
  • Dodaj Player.replaceMediaItem(s) jako skrót do dodawania i usuwania elementów w tym samym miejscu (#8046).
• ExoPlayer:
  • Zezwalaj ExoPlayerowi na sterowanie metodami głośności urządzenia tylko wtedy, gdy użytkownik wyraźnie się na to zgodzi. Użyj ExoPlayer.Builder.setDeviceVolumeControlEnabled, aby uzyskać dostęp do:
    • getDeviceVolume()
    • isDeviceMuted()
    • setDeviceVolume(int) i setDeviceVolume(int, int)
    • increaseDeviceVolume(int) i increaseDeviceVolume(int, int)
    • decreaseDeviceVolume(int) i decreaseDeviceVolume(int, int)
  • Dodaj FilteringMediaSource, który umożliwia filtrowanie dostępnych typów ścieżek z MediaSource.
  • Dodanie obsługi danych klienta multimediów (CMCD) w wychodzących żądaniach formatów strumieniowania adaptacyjnego DASH, HLS i SmoothStreaming. Wprowadziliśmy te pola: br, bl, cid, rtp i sid (#8699). Struktura interfejsu API i metody interfejsu API:
    • Rejestrowanie CMCD jest domyślnie wyłączone. Aby je włączyć, użyj MediaSource.Factory.setCmcdConfigurationFactory(CmcdConfiguration.Factory cmcdConfigurationFactory).
    • Domyślnie wszystkie klucze są włączone. Zastąp tę wartość, aby odfiltrować klucze, które mają być rejestrowane.CmcdConfiguration.RequestConfig.isKeyAllowed(String key)
    • Zastąp CmcdConfiguration.RequestConfig.getCustomData(), aby włączyć logowanie kluczy niestandardowych.
  • Dodano dodatkowe działanie do pliku manifestu głównej wersji demonstracyjnej, aby ułatwić uruchamianie aplikacji demonstracyjnej z niestandardowym plikiem *.exolist.json (#439).
  • Dodaj ExoPlayer.setVideoEffects() za korzystanie z Effect podczas odtwarzania wideo.
  • Zaktualizuj SampleQueue, aby przechowywać sourceId jako long zamiast int. Spowoduje to zmianę sygnatur metod publicznych SampleQueue.sourceId i SampleQueue.peekSourceId.
  • Dodaj do metod LoadControl i onTracksSelected parametry, które umożliwiają powiązanie tych metod z odpowiednim MediaPeriod.shouldStartPlayback
  • Zmień sygnaturę funkcji ServerSideAdInsertionMediaSource.setAdPlaybackStates(Map<Object, AdPlaybackState>), dodając parametr osi czasu, który zawiera okresy z identyfikatorami UID używanymi jako klucze na mapie. Jest to wymagane, aby uniknąć problemów z jednoczesnym dostępem w przypadku transmisji na żywo z wieloma okresami.
  • Wycofaj: EventDispatcher.withParameters(int windowIndex, @Nullable MediaPeriodId mediaPeriodId, long mediaTimeOffsetMs) i BaseMediaSource.createEventDispatcher(..., long mediaTimeOffsetMs). Zamiast tego można wywołać warianty metod bez symbolu mediaTimeOffsetUs. Pamiętaj, że nawet w przypadku wycofanych wariantów przesunięcie nie jest już dodawane do wartości startTimeUs i endTimeUs obiektów MediaLoadData wysyłanych przez moduł wysyłający.
  • Zmień nazwę ExoTrackSelection.blacklist na excludeTrack i isBlacklisted na isTrackExcluded.
  • Naprawiono niespójne działanie funkcji ExoPlayer.setMediaItem(s) i addMediaItem(s) w przypadku wywołania ich na pustej playliście.
• Transformer:
  • Usuń Transformer.Builder.setMediaSourceFactory(MediaSource.Factory). Zamiast niej używaj zasad ExoPlayerAssetLoader.Factory(MediaSource.Factory) i Transformer.Builder.setAssetLoaderFactory(AssetLoader.Factory).
  • Usuń Transformer.startTransformation(MediaItem, ParcelFileDescriptor).
  • Usunęliśmy błąd polegający na tym, że transformacja mogła się zawiesić (co prowadziło do przekroczenia limitu czasu multipleksera), jeśli koniec strumienia wideo został zasygnalizowany w momencie, gdy ramka wejściowa oczekiwała na przetworzenie.
  • W celu rozszerzenia obsługi używaj kodeków zapytań za pomocą narzędzia MediaCodecList zamiast narzędzi findDecoder/EncoderForFormat.
  • Usuń konfigurację klatek B w DefaultEncoderFactory, ponieważ nie działa ona na niektórych urządzeniach.
• Wybór ścieżki:
  • DodajDefaultTrackSelector.Parameters.allowInvalidateSelectionsForRendererCapabilitiesChange, która jest domyślnie wyłączona. Po włączeniu opcji DefaultTrackSelector wywoła ona nowy wybór ścieżki, gdy zmienią się możliwości renderowania.
• Ekstraktory:
  • Ogg: naprawiono błąd podczas wyszukiwania w plikach o długim czasie trwania (#391).
  • FMP4: rozwiązano problem, w którym TimestampAdjuster inicjuje nieprawidłowe przesunięcie sygnatury czasowej z czasem próbki metadanych z atomu emsg (#356).
• Dźwięk:
  • Naprawiono błąd, który powodował, że niektóre odtwarzania kończyły się niepowodzeniem, gdy włączone było tunelowanie i aktywne były np. funkcje przycinania bez przerw (#10847).AudioProcessors
  • Enkapsulacja ramek Opus w pakietach Ogg podczas bezpośredniego odtwarzania (odciążanie).
  • Ekstrapolacja bieżącej pozycji podczas uśpienia z planowaniem odciążenia.
  • Dodaj Renderer.release() i AudioSink.release(), aby zwolnić zasoby po zakończeniu cyklu życia odtwarzacza.
  • Nasłuchiwanie zmian w funkcjach audio w DefaultAudioSink. Dodaj wymagany parametr context w konstruktorze DefaultAudioSink, za pomocą którego DefaultAudioSink zarejestruje się jako odbiorca AudioCapabilitiesReceiver i zaktualizuje swoją właściwość audioCapabilities, gdy otrzyma informację o zmianie możliwości.
  • Przekazywanie zmian w funkcjach audio za pomocą nowego zdarzenia onAudioCapabilitiesChanged w interfejsie AudioSink.Listener i nowego interfejsu RendererCapabilities.Listener, który wywołuje zdarzenia onRendererCapabilitiesChanged.
  • Dodaj ChannelMixingAudioProcessor, aby zastosować skalowanie lub miksowanie do kanałów audio.
  • Dodaj nową wartość całkowitą DISCARD_REASON_AUDIO_BYPASS_POSSIBLE do DecoderDiscardReasons, aby odrzucić dekoder audio, gdy po zmianie możliwości audio możliwy jest tryb obejścia.
  • Dodano obsługę bezpośredniego odtwarzania DTS Express i DTS:X (#335).
• Film:
  • Spraw, aby MediaCodecVideoRenderer zgłaszał VideoSize o szerokości i wysokości 0, gdy moduł renderujący jest wyłączony. Player.Listener.onVideoSizeChanged jest wywoływana odpowiednio, gdy zmieni się Player.getVideoSize(). W wyniku tej zmiany rozmiar wideo ExoPlayera z parametrem MediaCodecVideoRenderer ma szerokość i wysokość 0, gdy Player.getCurrentTracks nie obsługuje wideo lub rozmiar obsługiwanej ścieżki wideo nie został jeszcze określony.
• DRM:
  • Zmniejsz widoczność kilku metod wewnętrznych w DefaultDrmSession, które nie powinny być wywoływane spoza pakietu DRM:
    • void onMediaDrmEvent(int)
    • void provision()
    • void onProvisionCompleted()
    • onProvisionError(Exception, boolean)
• Muxer:
  • Dodano nową bibliotekę multipleksera, której można używać do tworzenia pliku kontenera MP4.
• Rozszerzenie IMA:
  • Włącz transmisje na żywo DASH z wieloma przedziałami czasu na potrzeby dynamicznego wstawiania reklam. Pamiętaj, że obecna implementacja nie obsługuje jeszcze przewijania transmisji na żywo (#10912).
  • Naprawiono błąd, w którym w transmisjach na żywo wstawiana jest nowa grupa reklam, ponieważ obliczona pozycja treści w kolejnych osiach czasu nieznacznie się różni.
• Sesja:
  • Dodaj metodę pomocniczą MediaSession.getControllerForCurrentRequest, aby uzyskać informacje o kontrolerze, który obecnie wywołuje metodę Player.
  • Dodanie androidx.media3.session.MediaButtonReceiver, aby umożliwić aplikacjom wznawianie odtwarzania za pomocą zdarzeń przycisków multimedialnych wysyłanych np. przez słuchawki Bluetooth (#167).
  • Dodaj domyślną implementację do MediaSession.Callback.onAddMediaItems, aby umożliwić przekazywanie żądanych MediaItems do Player, jeśli mają LocalConfiguration (np. URI) (#282).
  • Dodanie przycisków poleceń „przewiń do poprzedniego” i „przewiń do następnego” w kompaktowym widoku powiadomienia o multimediach domyślnie w przypadku Androida 12 i starszych wersji (#410).
  • Dodaj domyślną implementację do MediaSession.Callback.onAddMediaItems, aby umożliwić przekazywanie żądanych MediaItems do Player, jeśli mają LocalConfiguration (np. URI) (#282).
  • Dodanie przycisków poleceń „przewiń do poprzedniego” i „przewiń do następnego” w kompaktowym widoku powiadomienia o multimediach domyślnie w przypadku Androida 12 i starszych wersji (#410).
• UI:
  • Dodaj metody narzędziowe shouldShowPlayButton i handlePlayPauseButtonAction, aby napisać niestandardowe elementy interfejsu z przyciskiem odtwarzania/wstrzymywania.
• Rozszerzenie RTSP:
  • W przypadku MPEG4-LATM użyj domyślnej wartości profile-level-id, jeśli nie ma jej w wiadomości SDP DescribeResponse (#302).
  • Używaj podstawowego identyfikatora URI do rozpoznawania ścieżki względnej z sesji RTSP, jeśli jest on obecny w nagłówku odpowiedzi DESCRIBE (#11160).
• Rozszerzenie DASH:
  • Usuń przesunięcie czasu multimediów z MediaLoadData.startTimeMs i MediaLoadData.endTimeMs w przypadku strumieni DASH z wieloma okresami.
  • Usunęliśmy błąd, który powodował, że ponowne przygotowanie źródła multimediów DASH na żywo z wieloma okresami powodowało wystąpienie błędu IndexOutOfBoundsException (#10838).
• Rozszerzenie HLS:
  • Dodaj HlsMediaSource.Factory.setTimestampAdjusterInitializationTimeoutMs(long) aby ustawić limit czasu, przez jaki wątek wczytywania ma czekać na zainicjowanie elementu TimestampAdjuster. Jeśli inicjowanie nie zakończy się przed upływem limitu czasu, zostanie zgłoszony wyjątek PlaybackException, aby uniknąć niekończącego się wstrzymania odtwarzania. Domyślnie limit czasu jest ustawiony na zero (#323).
• Narzędzia testowe:
  • Sprawdź, czy w DataSourceContractTest wielkość liter w schemacie URI nie ma znaczenia.
• Usuń symbole, które nie są już używane:
  • Usuń konstruktory DefaultAudioSink i zamiast nich użyj DefaultAudioSink.Builder.
  • Usuń polecenie HlsMasterPlaylist i zamiast niego użyj polecenia HlsMultivariantPlaylist.
  • Usuń Player.stop(boolean). Zamiast niej użyj zasad Player.stop() i Player.clearMediaItems() (jeśli reset ma wartość true).
  • Usuń 2 wycofane konstruktory SimpleCache. Zamiast nich użyj niewycofanego konstruktora, który przyjmuje wartość DatabaseProvider, aby uzyskać lepszą wydajność.
  • Usuń konstruktor DefaultBandwidthMeter i zamiast niego użyj DefaultBandwidthMeter.Builder.
  • Usuń konstruktory DefaultDrmSessionManager i użyj zamiast nich DefaultDrmSessionManager.Builder.
  • Usuń 2 wycofane konstruktory HttpDataSource.InvalidResponseCodeException. Użyj niewycofanego konstruktora, który akceptuje dodatkowe pola(cause, responseBody), aby ulepszyć rejestrowanie błędów.
  • Usuń zasady DownloadHelper.forProgressive, DownloadHelper.forHls, DownloadHelper.forDash i DownloadHelper.forSmoothStreaming, a zamiast nich używaj zasad DownloadHelper.forMediaItem.
  • Usuń wycofany konstruktor DownloadService i użyj konstruktora, który nie został wycofany i zawiera opcję podania parametru channelDescriptionResourceId.
  • Usuń wycofane stałe ciągi znaków dla zestawów znaków (ASCII_NAME, UTF8_NAME, ISO88591_NAME, UTF16_NAME i UTF16LE_NAME). Zamiast nich używaj zestawów znaków Kotlin z pakietu kotlin.text, java.nio.charset.StandardCharsets lub com.google.common.base.Charsets.
  • Usuń wycofany konstruktor WorkManagerScheduler i użyj konstruktora, który nie został wycofany i zawiera opcję podania parametru Context.
  • Usuń wycofane metody createVideoSampleFormat, createAudioSampleFormat, createContainerFormat i createSampleFormat, które były używane do tworzenia instancji klasy Format. Zamiast tego użyj Format.Builder do tworzenia instancji Format.
  • Usuń wycofane metody copyWithMaxInputSize, copyWithSubsampleOffsetUs, copyWithLabel, copyWithManifestFormatInfo, copyWithGaplessInfo, copyWithFrameRate, copyWithDrmInitData, copyWithMetadata, copyWithBitrate i copyWithVideoSize. Zamiast nich używaj metod Format.buildUpon() i metod ustawiających.
  • Usuń wycofany tag ExoPlayer.retry() i zamiast niego użyj tagu prepare().
  • Usuń wycofany konstruktor DefaultTrackSelector bez argumentów i zamiast niego użyj konstruktora DefaultTrackSelector(Context).
  • Usuń wycofany konstruktor OfflineLicenseHelper i użyj konstruktora OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher).
  • Usuń wycofany konstruktor DownloadManager i użyj konstruktora, który przyjmuje argument Executor.
  • Usuń wycofane konstruktory Cue i zamiast nich używaj konstruktorów Cue.Builder.
  • Usuń wycofany konstruktor OfflineLicenseHelper i użyj konstruktora OfflineLicenseHelper(DefaultDrmSessionManager, DrmSessionEventListener.EventDispatcher).
  • Usuń 4 wycofane metody AnalyticsListener:
    • onDecoderEnabled, użyj zamiast niej onAudioEnabled lub onVideoEnabled.
    • onDecoderInitialized, użyj onAudioDecoderInitialized lub onVideoDecoderInitialized.
    • onDecoderInputFormatChanged, użyj zamiast niej onAudioInputFormatChanged lub onVideoInputFormatChanged.
    • onDecoderDisabled, użyj zamiast niej onAudioDisabled lub onVideoDisabled.
  • Usuń wycofane polecenia Player.Listener.onSeekProcessed i AnalyticsListener.onSeekProcessed, a zamiast nich użyj polecenia onPositionDiscontinuity z parametrem DISCONTINUITY_REASON_SEEK.
  • Usuń polecenie ExoPlayer.setHandleWakeLock(boolean) i zamiast niego użyj polecenia setWakeMode(int).
  • Usuń wycofany element DefaultLoadControl.Builder.createDefaultLoadControl() i zamiast niego użyj elementu build().
  • Usuń wycofany tag MediaItem.PlaybackProperties i zamiast niego użyj tagu MediaItem.LocalConfiguration. Wycofane pole MediaItem.playbackProperties ma teraz typ MediaItem.LocalConfiguration.

Wersja 1.1.0-rc01

21 czerwca 2023 r.

Używaj stabilnej wersji 1.1.0.

Wersja 1.1.0-beta01

7 czerwca 2023 r.

Używaj stabilnej wersji 1.1.0.

Wersja 1.1.0-alpha01

10 maja 2023 r.

Używaj stabilnej wersji 1.1.0.

Wersja 1.0.0

Wersja 1.0.2

18 maja 2023 r.

Publikacja androidx.media3:media3-*:1.0.2 Wersja 1.0.2 zawiera te zatwierdzenia.

Ta wersja odpowiada wersji ExoPlayera 2.18.7.

W tej wersji wprowadziliśmy następujące zmiany w porównaniu z wersją 1.0.1:

• Biblioteka podstawowa:
  • Dodaj Buffer.isLastSample(), aby wskazać, czy Buffer zawiera flagę C.BUFFER_FLAG_LAST_SAMPLE.
  • Rozwiązaliśmy problem, który powodował, że ostatnia klatka mogła nie być renderowana, jeśli ostatnia próbka z klatkami została usunięta z kolejki bez odczytania próbki „koniec strumienia”. (#11079).
• Ekstraktory:
  • Naprawiono analizowanie SPS w H.265 w plikach MPEG-TS przez ponowne użycie logiki analizowania, która jest już używana przez ekstraktory RTSP i MP4 (#303).
• Tekst:
  • SSA: dodano obsługę plików UTF-16, jeśli zaczynają się od znacznika kolejności bajtów (#319).
• Sesja:
  • Rozwiązano problem polegający na tym, że MediaController nie aktualizował dostępnych poleceń po połączeniu ze starszym MediaSessionCompat, który aktualizował swoje działania.
  • Naprawiono błąd, który uniemożliwiał zwracanie wartości null przez MediaLibraryService w przypadku wywołania z interfejsu systemu do Callback.onGetLibraryRoot z parametrem params.isRecent == true w interfejsie API 30 (#355).
  • Naprawiono wyciek pamięci w przypadku MediaSessionService lub MediaLibraryService (#346).
  • Naprawiliśmy błąd, w którym połączona aktualizacja Timeline i pozycji w MediaSession może powodować zgłaszanie błędu MediaController przez IllegalStateException.

Wersja 1.0.1

18 kwietnia 2023 r.

Publikacja androidx.media3:media3-*:1.0.1 Wersja 1.0.1 zawiera te zatwierdzenia.

Ta wersja odpowiada wersji ExoPlayera 2.18.6.

• Biblioteka podstawowa:
  • Resetowanie zastąpienia docelowej transmisji na żywo podczas przewijania do pozycji domyślnej (#11051).
  • Naprawiono błąd, który powodował zawieszanie się odtwarzania z powodu pustych strumieni próbek w multimediach.
• Sesja:
  • Naprawiliśmy błąd polegający na tym, że wiele identycznych elementów kolejki opublikowanych przez starszą wersjęMediaSessionCompat powodowało wyjątek w MediaController(#290).
  • Dodano brakujące przekazywanie MediaSession.broadcastCustomCommand do starszego MediaControllerCompat.Callback.onSessionEvent (#293).
  • Naprawiliśmy błąd, który powodował, że wywołanie funkcji MediaSession.setPlayer nie aktualizowało dostępnych poleceń.
  • Rozwiązaliśmy problem polegający na tym, że instancje TrackSelectionOverride wysłane z MediaController są ignorowane, jeśli odwołują się do grupy z Format.metadata (#296).
  • Rozwiązanie problemu, w którym Player.COMMAND_GET_CURRENT_MEDIA_ITEM musi być dostępne, aby uzyskać dostęp do metadanych za pomocą starszego interfejsu MediaSessionCompat.
  • Rozwiązaliśmy problem, który powodował, że instancje MediaSession w wątku w tle powodowały awarie podczas używania w MediaSessionService (#318).
  • Rozwiązanie problemu polegającego na tym, że odbiornik przycisku multimediów był deklarowany przez bibliotekę bez intencji aplikacji (#314).
• DASH:
  • Naprawiono obsługę pustych osi czasu segmentów (#11014).
• RTSP:
  • Ponów próbę z protokołem TCP, jeśli konfiguracja RTSP z protokołem UDP nie powiedzie się i zostanie zwrócony błąd RTSP 461 UnsupportedTransport (#11069).

Wersja 1.0.0

22 marca 2023 r.

Publikacja androidx.media3:media3-*:1.0.0 Wersja 1.0.0 zawiera te zatwierdzenia.

Ta wersja odpowiada wersji ExoPlayera 2.18.5.

Od wersji 1.0.0-rc02 nie wprowadziliśmy żadnych zmian.

Wersja 1.0.0-rc02

2 marca 2023 r.

Publikacja androidx.media3:media3-*:1.0.0-rc02 Wersja 1.0.0-rc02 zawiera te zatwierdzenia.

Ta wersja odpowiada wersji ExoPlayera 2.18.4.

• Biblioteka podstawowa:
  • Naprawiono wykrywanie typu sieci w przypadku API 33 (#10970).
  • Rozwiąż problem NullPointerException podczas dzwonienia pod numer ExoPlayer.isTunnelingEnabled (#10977).
• Pobrane:
  • Umożliwienie konfigurowania maksymalnej różnicy między czasem rozpoczęcia 2 segmentów do scalenia w SegmentDownloader i klasach podrzędnych (#248).
• Dźwięk:
  • Naprawiono problem z odtwarzaniem plików MP3 bez przerw na urządzeniach Samsung (#8594).
  • Rozwiązanie problemu polegającego na tym, że szybkość odtwarzania ustawiona natychmiast po wyłączeniu dźwięku może zostać zastąpiona przez poprzednią zmianę szybkości (#10882).
• Film:
  • Mapuj format HEVC HDR10 na HEVCProfileMain10HDR10 zamiast na HEVCProfileMain10.
  • Dodano obejście problemu z urządzeniem Chromecast z Google TV i Lenovo M10 FHD Plus, który powoduje, że strumienie AVC o częstotliwości 60 kl./s są oznaczane jako nieobsługiwane (#10898).
  • Rozwiązano problemy z wydajnością zwalniania klatek podczas odtwarzania multimediów z częstotliwością klatek znacznie wyższą niż częstotliwość odświeżania ekranu.
• Przesyłanie:
  • Rozwiązaliśmy problem z przejściowym STATE_IDLE podczas przechodzenia między elementami multimedialnymi (#245).
• RTSP:
  • Wyłapywanie wyjątku IllegalArgumentException zgłaszanego podczas analizowania nieprawidłowych wiadomości odpowiedzi RTSP Describe (#10971).
• Sesja:
  • Usunęliśmy błąd, który powodował, że przycisk odtwarzania/wstrzymywania w powiadomieniu nie aktualizował się zgodnie ze stanem odtwarzacza (#192).
• Rozszerzenie IMA:
  • Naprawiono błąd, który uniemożliwiał rozpoczęcie strumieni DAI bez reklam, ponieważ nie otrzymywano pierwszego (a w przypadku braku reklam jedynego) zdarzenia LOADED.

Wersja 1.0.0-rc01

16 lutego 2023 r.

Publikacja androidx.media3:media3-*:1.0.0-rc01 Wersja 1.0.0-rc01 zawiera te zatwierdzenia.

Ta wersja odpowiada wersji ExoPlayera 2.18.3.

• Biblioteka podstawowa:
  • Dostosuj logikę kolejności dekoderów renderera, aby zachować preferencje MediaCodecSelector, nawet jeśli dekoder zgłosi, że może nie być w stanie odtworzyć multimediów w sposób wydajny. Na przykład w przypadku domyślnego selektora dekoder sprzętowy z tylko funkcjonalną obsługą będzie preferowany od dekodera programowego, który w pełni obsługuje format (#10604).
  • Dodaj ExoPlayer.Builder.setPlaybackLooper, który ustawia istniejący wątek odtwarzania dla nowej instancji ExoPlayera.
  • Zezwalaj na czyszczenie pomocników menedżera pobierania (#10776).
  • Dodaj parametr do BasePlayer.seekTo, aby wskazać polecenie użyte do przewijania.
  • Używanie motywu podczas wczytywania elementów rysowalnych w przypadku interfejsu API w wersji 21 lub nowszej (#220).
  • Dodano ConcatenatingMediaSource2, które umożliwia łączenie wielu elementów multimedialnych w jednym oknie (#247).
• Ekstraktory:
  • Zwróć ParserException zamiast NullPointerException, jeśli podczas analizowania atomów trak w tabeli próbek (stbl) brakuje wymaganego opisu próbki (stsd).
  • Prawidłowe pomijanie próbek podczas bezpośredniego przewijania do klatki synchronizacji w fMP4 (#10941).
• Dźwięk:
  • Użyj przepływności skompresowanego formatu audio, aby obliczyć minimalny rozmiar bufora dla AudioTrack w przypadku bezpośredniego odtwarzania (passthrough).
• Tekst:
  • Naprawiono TextRenderer przekazywanie nieprawidłowego (ujemnego) indeksu do Subtitle.getEventTime, jeśli plik z napisami nie zawiera wskazówek.
  • SubRip: dodaliśmy obsługę plików UTF-16, jeśli zaczynają się od znacznika kolejności bajtów.
• Metadane:
  • Analizuj wiele wartości rozdzielonych znakiem null z ramek ID3, zgodnie z ID3 v2.4.
  • Dodaj znak MediaMetadata.mediaType, aby oznaczyć typ treści lub typ folderu opisywanego przez metadane.
  • Dodaj MediaMetadata.isBrowsable jako zamiennik dla MediaMetadata.folderType. W kolejnej wersji wycofamy ten typ folderu.
• DASH:
  • Dodano pełne parsowanie zestawów adaptacyjnych obrazów, w tym liczbę kafelków (#3752).
• UI:
  • Napraw błąd związany z funkcją, która została wycofana PlayerView.setControllerVisibilityListener(PlayerControlView.VisibilityListener) aby mieć pewność, że zmiany widoczności są przekazywane do zarejestrowanego odbiorcy (#229).
  • Poprawiono kolejność elementów sterujących odtwarzaczem w PlayerView podczas korzystania z układu od prawej do lewej (RTL) (#227).
• Sesja:
  • Dodaj abstrakcyjny element SimpleBasePlayer, aby zaimplementować interfejs Player w przypadku odtwarzaczy niestandardowych.
  • Dodanie metody pomocniczej do konwertowania tokena sesji platformy na Media3 (#171).SessionToken
  • Użyj onMediaMetadataChanged, aby wywołać aktualizacje sesji multimediów na platformie (#219).
  • Dodaj sesję multimedialną jako argument funkcji getMediaButtons() of the DefaultMediaNotificationProvider i używaj list niezmiennych dla przejrzystości (#216).
  • Dodaj onSetMediaItemsfunkcję zwrotną, która umożliwi modyfikowanie lub ustawianie listyMediaItem, indeksu początkowego i pozycji według sesji przed ustawieniem ich w odtwarzaczu (#156).
  • Unikanie wykrywania dwukrotnego kliknięcia w przypadku zdarzeń przycisku multimediów innych niż Bluetooth (#233).
  • Zwiększono odporność QueueTimeline w przypadku podejrzanego stanu sesji starszego typu (#241).
• Metadane:
  • Analizuj wiele wartości rozdzielonych znakiem null z ramek ID3, zgodnie z ID3 v2.4.
  • Dodaj znak MediaMetadata.mediaType, aby oznaczyć typ treści lub typ folderu opisywanego przez metadane.
  • Dodaj MediaMetadata.isBrowsable jako zamiennik dla MediaMetadata.folderType. W kolejnej wersji wycofamy ten typ folderu.
• Rozszerzenie Cast:
  • Zaktualizowano wersję pakietu Cast SDK do 21.2.0.
• Rozszerzenie IMA:
  • Usuń odbiornik odtwarzacza ImaServerSideAdInsertionMediaSource w wątku aplikacji, aby uniknąć problemów z wątkami.
  • Dodaj właściwość focusSkipButtonWhenAvailable do elementu ImaServerSideAdInsertionMediaSource.AdsLoader.Builder, aby poprosić o skupienie się na przycisku pominięcia na urządzeniach TV, i ustaw domyślnie wartość „true”.
  • Dodaj metodę focusSkipButton() do elementu ImaServerSideAdInsertionMediaSource.AdsLoader, aby programowo wysyłać żądania dotyczące zaznaczenia przycisku pomijania.
  • Zaktualizuj pakiet IMA SDK do wersji 3.29.0.
• Aplikacja w wersji demonstracyjnej:
  • Prośba o uprawnienia do powiadomień o pobranych plikach w czasie działania aplikacji (#10884).

Wersja 1.0.0-beta03

22 listopada 2022 r.

Publikacja androidx.media3:media3-*:1.0.0-beta03 Wersja 1.0.0-beta03 zawiera te zatwierdzenia.

Ta wersja odpowiada wersji ExoPlayera 2.18.2.

• Biblioteka podstawowa:
  • Dodano ExoPlayer.isTunnelingEnabled, aby sprawdzić, czy tunelowanie jest włączone w przypadku obecnie wybranych ścieżek (#2518).
  • Dodano WrappingMediaSource, aby uprościć opakowywanie pojedynczego MediaSource (#7279).
  • Odrzucanie bufora wstecznego, zanim odtwarzanie się zatrzyma z powodu niewystarczającej ilości dostępnej pamięci.
  • Zamknij blok śledzenia „doSomeWork”, gdy jest włączone przenoszenie obliczeń.
  • Rozwiązano problem ze śledzeniem sesji w przypadku szybkiego przewijania w PlaybackStatsListener(#180).
  • Wysyłanie brakującego wywołania zwrotnego onMediaItemTransition podczas wywoływania seekToNext lub seekToPrevious na playliście z 1 elementem (#10667).
  • Dodaj Player.getSurfaceSize, który zwraca rozmiar powierzchni, na której jest renderowany film.
  • Naprawiono błąd, który powodował, że usunięcie słuchaczy podczas zwalniania odtwarzacza mogło wywołać wyjątek IllegalStateException (#10758).
• Kompilacja:
  • Wymuszanie minimalnej wersji compileSdkVersion, aby uniknąć błędów kompilacji (#10684).
  • Unikaj publikowania bloku, gdy jest on uwzględniony w innej kompilacji Gradle.
• Wybór ścieżki:
  • Jeśli wyświetlacz nie obsługuje Dolby Vision, preferuj inne ścieżki. (#8944).
• Pobrane:
  • Rozwiązano problem z potencjalną nieskończoną pętlą w ProgressiveDownloader spowodowaną jednoczesnym pobieraniem i odtwarzaniem z tym samym PriorityTaskManager (#10570).
  • Natychmiastowe wyświetlanie powiadomienia o pobieraniu (#183).
  • Ograniczono liczbę równoległych usunięć pobierania do 1, aby uniknąć nadmiernego tworzenia wątków (#10458).
• Film:
  • Wypróbuj alternatywny dekoder Dolby Vision, jeśli wyświetlacz go nie obsługuje. (#9794).
• Dźwięk:
  • Używaj SingleThreadExecutor do zwalniania instancji AudioTrack, aby uniknąć błędów OutOfMemory podczas zwalniania wielu odtwarzaczy w tym samym czasie (#10057).
  • Dodaje AudioOffloadListener.onExperimentalOffloadedPlayback dla stanu odciążenia AudioTrack. (#134).
  • Ustaw AudioTrackBufferSizeProvider jako interfejs publiczny.
  • Dodaj ExoPlayer.setPreferredAudioDevice, aby ustawić preferowane urządzenie wyjściowe audio (#135).
  • Zmień nazwę androidx.media3.exoplayer.audio.AudioProcessor na androidx.media3.common.audio.AudioProcessor.
  • Mapowanie 8-kanałowego i 12-kanałowego dźwięku na maski kanałów 7.1 i 7.1.4 odpowiednio we wszystkich wersjach Androida (#10701).
• Metadane:
  • MetadataRenderer można teraz skonfigurować tak, aby renderował metadane, gdy tylko staną się dostępne. Utwórz instancję z parametrem MetadataRenderer(MetadataOutput, Looper, MetadataDecoderFactory, boolean), aby określić, czy moduł renderujący ma generować metadane wcześniej czy synchronicznie z pozycją odtwarzacza.
• DRM:
  • Obejście błędu w implementacji ClearKey na Androidzie 13, który zwraca niepusty, ale nieprawidłowy adres URL licencji.
  • Usunęliśmy błąd setMediaDrmSession failed: session not opened, który występował podczas przełączania między schematami DRM na liście odtwarzania (np. z Widevine na ClearKey).
• Tekst:
  • CEA-608: sprawdź, czy pole 2 zawiera prawidłowe polecenia przełączania usługi (#10666).
• DASH:
  • Analizowanie EventStream.presentationTimeOffset z plików manifestu (#10460).
• UI:
  • Użyj bieżących zastąpień odtwarzacza jako ustawień wstępnych w TrackSelectionDialogBuilder (#10429).
• Sesja:
  • Sprawdź, czy polecenia są zawsze wykonywane we właściwej kolejności, nawet jeśli niektóre z nich wymagają asynchronicznego rozwiązania (#85).
  • Dodaj DefaultMediaNotificationProvider.Builder, aby utworzyć instancje DefaultMediaNotificationProvider. Twórca może skonfigurować identyfikator powiadomienia, identyfikator kanału powiadomień i nazwę kanału powiadomień używane przez dostawcę. Dodaj też metodę DefaultMediaNotificationProvider.setSmallIcon(int), aby ustawić małą ikonę powiadomień. (#104).
  • Zapewnia, że polecenia wysłane przed MediaController.release() nie zostaną pominięte (#99).
  • SimpleBitmapLoader może wczytywać mapy bitowe z file:// identyfikatorów URI (#108).
  • Naprawiono asercję, która uniemożliwiała MediaController przewijanie reklamy w okresie (#122).
  • Po zakończeniu odtwarzania MediaSessionService jest zatrzymywany na pierwszym planie i wyświetlane jest powiadomienie o możliwości ponownego odtworzenia ostatniego odtwarzanego elementu multimedialnego (#112).
  • Nie uruchamiaj usługi działającej na pierwszym planie za pomocą oczekującego zamiaru wstrzymania (#167).
  • Ręczne ukrywanie „odznaki” powiązanej z powiadomieniem utworzonym przez DefaultNotificationProvider w przypadku interfejsów API 26 i 27 (odznaka jest automatycznie ukrywana w przypadku interfejsów API 28 i nowszych) (#131).
  • Naprawiliśmy błąd, który powodował, że drugie połączenie bindera ze starszej wersji MediaSession z Media3 MediaController powodowało wyjątki IllegalStateException (#49).
• RTSP:
  • Dodano obsługę podzielonych pakietów H263 (#119).
  • Dodano obsługę formatu MP4A-LATM (#162).
• IMA:
  • Dodano limit czasu wczytywania informacji o reklamie, aby obsługiwać przypadki, w których pakiet IMA SDK zawiesza się podczas wczytywania reklamy (#10510).
  • Zapobieganie pomijaniu reklam w trakcie filmu podczas przewijania do końca treści (#10685).
  • Prawidłowe obliczanie czasu trwania okna w przypadku transmisji na żywo z reklamami wstawianymi po stronie serwera, np. IMA DAI (#10764).
• Rozszerzenie FFmpeg:
  • Dodano nowe wymagane flagi do łączenia bibliotek FFmpeg z NDK w wersji 23.1.7779620 i nowszych (#9933).
• Rozszerzenie AV1:
  • Zaktualizowano wersję CMake, aby uniknąć niezgodności z najnowszymi wersjami Androida Studio (#9933).
• Rozszerzenie Cast:
  • Wdróż getDeviceInfo(), aby móc identyfikować CastPlayer podczas sterowania odtwarzaniem za pomocą MediaController (#142).
• Transformer:
  • Dodanie timera nadzorującego multipleksera, który wykrywa, kiedy generowanie próbki wyjściowej trwa zbyt długo.
• Usuń symbole, które nie są już używane:
  • Usuń Transformer.Builder.setOutputMimeType(String). Ta funkcja została usunięta. Gdy używany jest domyślny multiplekser, typ MIME zawsze będzie MP4.

Wersja 1.0.0-beta02

21 lipca 2022 r.

Publikacja androidx.media3:media3-*:1.0.0-beta02 Wersja 1.0.0-beta02 zawiera te zatwierdzenia.

Ta wersja odpowiada wersji ExoPlayera 2.18.1.

• Biblioteka podstawowa:
  • Sprawdź, czy zmiana ShuffleOrder na ExoPlayer.setShuffleOrder powoduje wywołanie funkcji Player.Listener#onTimelineChanged z parametrem reason=Player.TIMELINE_CHANGE_REASON_PLAYLIST_CHANGED (#9889).
  • W przypadku mediów progresywnych uwzględniaj tylko wybrane ścieżki w pozycji buforowanej (#10361).
  • Zezwalanie na niestandardowy rejestrator dla wszystkich danych wyjściowych logów ExoPlayera (#9752).
  • Poprawiono implementację setDataSourceFactory w DefaultMediaSourceFactory, która w niektórych przypadkach nie działała (#116).
• Ekstraktory:
  • Naprawiono analizowanie krótkoterminowych zestawów obrazów referencyjnych H265 (#10316).
  • Naprawiono analizowanie szybkości transmisji z esds pól (#10381).
• DASH:
  • Parsowanie adresu URL licencji ClearKey z plików manifestu (#10246).
• UI:
  • Sprawdź, czy TalkBack odczytuje aktualnie aktywną opcję szybkości w menu elementów sterujących odtwarzaniem (#10298).
• RTSP:
  • Dodano obsługę fragmentowanych pakietów VP8 (#110).
• Rozszerzenie Leanback:
  • Sprawdzanie zmian w playWhenReady w LeanbackAdapter (10420).
• Przesyłanie:
  • Użyj parametru MediaItem przekazanego do metod playlisty jako Window.mediaItem w CastTimeline (#25, #8212).
  • Obsługa Player.getMetadata() i Listener.onMediaMetadataChanged() za pomocą CastPlayer (#25).

Wersja 1.0.0-beta01

16 czerwca 2022 r.

Publikacja androidx.media3:media3-*:1.0.0-beta01 Wersja 1.0.0-beta01 zawiera te zatwierdzenia.

Odpowiada to wersji ExoPlayera 2.18.0.

• Biblioteka podstawowa:
  • Włącz obsługę diagnostyki platformy Android za pomocą MediaMetricsManager. ExoPlayer będzie przekazywać do platformy zdarzenia odtwarzania i dane o wydajności, co pomoże dostarczać informacje o wydajności systemu i debugowaniu na urządzeniu. Dane te mogą być też gromadzone przez Google, jeśli użytkownik urządzenia włączy udostępnianie danych o użyciu i diagnostyce. Aplikacje mogą zrezygnować z przekazywania danych do diagnostyki platformy ExoPlayer za pomocą parametru ExoPlayer.Builder.setUsePlatformDiagnostics(false).
  • Naprawiliśmy błąd, który powodował zbyt częste resetowanie ścieżek podczas korzystania z MergingMediaSource, np. podczas wczytywania napisów z pliku i zmiany wybranych napisów w trakcie odtwarzania (#10248).
  • Zaprzestanie wykrywania typu sieci 5G-NSA w przypadku interfejsów API w wersjach 29 i 30. Odtwarzanie będzie odbywać się w sieci 4G.
  • Nie zezwalaj na przekazywanie parametru null do usług MediaSource.Factory.setDrmSessionManagerProvider i MediaSource.Factory.setLoadErrorHandlingPolicy. W razie potrzeby można jawnie przekazać instancje DefaultDrmSessionManagerProvider i DefaultLoadErrorHandlingPolicy.
  • Dodaj symbol MediaItem.RequestMetadata, aby oznaczyć metadane potrzebne do odtwarzania multimediów, gdy dokładny symbol LocalConfiguration nie jest znany. Usuń też MediaMetadata.mediaUrl, ponieważ jest to teraz uwzględnione w RequestMetadata.
  • Dodaj Player.Command.COMMAND_SET_MEDIA_ITEM, aby umożliwić graczom ustawienie pojedynczego elementu.
• Wybór ścieżki:
  • Spłaszcz klasę TrackSelectionOverrides do TrackSelectionParameters i przenieś klasę TrackSelectionOverride na najwyższy poziom.
  • Zmień nazwę TracksInfo na Tracks, a TracksInfo.TrackGroupInfo na Tracks.Group. Player.getCurrentTracksInfo i Player.Listener.onTracksInfoChanged zostały też zmienione na Player.getCurrentTracks i Player.Listener.onTracksChanged. Obejmuje to „przywrócenie” nazwy metody Player.Listener.onTracksChanged, ale z innymi typami parametrów.
  • Zmień DefaultTrackSelector.buildUponParameters i DefaultTrackSelector.Parameters.buildUpon, aby zwracać DefaultTrackSelector.Parameters.Builder zamiast wycofanego DefaultTrackSelector.ParametersBuilder.
  • DodajDefaultTrackSelector.Parameters.constrainAudioChannelCountToDeviceCapabilities, która jest domyślnie włączona. Gdy ta opcja jest włączona, DefaultTrackSelector będzie preferować ścieżki audio, których liczba kanałów nie przekracza możliwości wyjściowych urządzenia. Na urządzeniach przenośnych DefaultTrackSelector będzie preferować formaty stereo/mono zamiast formatów dźwięku wielokanałowego, chyba że format wielokanałowy może być przestrzenny (Android 12L lub nowszy) lub jest formatem dźwięku przestrzennego Dolby. Dodatkowo na urządzeniach obsługujących przestrzenne odtwarzanie dźwięku DefaultTrackSelectorbędzie monitorować zmiany w właściwościach przestrzennego odtwarzania dźwięku i w razie potrzeby wybierać nowy utwór. Urządzenia z television trybem interfejsu są wyłączone z tych ograniczeń, a preferowany będzie format z największą liczbą kanałów. Aby włączyć tę funkcję, instancja DefaultTrackSelector musi być utworzona za pomocą Context.
• Film:
  • Zmień nazwę DummySurface na PlaceholderSurface.
  • Dodanie obsługi formatu AV1 do elementu MediaCodecVideoRenderer.getCodecMaxInputSize.
• Dźwięk:
  • Użyj dekodera audio LG AC3 do wyświetlania reklam z niestandardowym typem MIME.
  • Zmień typ zwracany funkcji AudioAttributes.getAudioAttributesV21() z android.media.AudioAttributes na nową klasę opakowującą AudioAttributesV21, aby zapobiec powolnej weryfikacji ART w przypadku interfejsu API < 21.
  • Wysyłaj zapytania do platformy (API 29+) lub zakładaj liczbę kanałów kodowania dźwięku w przypadku przekazywania dźwięku, gdy liczba kanałów audio formatu jest nieustawiona, co ma miejsce w przypadku przygotowania bez fragmentów HLS (10204).
  • Skonfiguruj AudioTrack z maską kanałuAudioFormat.CHANNEL_OUT_7POINT1POINT4, jeśli dekoder generuje 12-kanałowy dźwięk PCM (#10322).
• DRM
  • Zadbaj o to, aby sesja DRM była zawsze prawidłowo aktualizowana podczas przewijania bezpośrednio po zmianie formatu (10274).
• Tekst:
  • Zmień Player.getCurrentCues(), aby zwracać CueGroup zamiast List<Cue>.
  • SSA: obsługa ustawienia stylu OutlineColour, gdy BorderStyle == 3 (np. OutlineColour ustawia tło wskazówki) (#8435).
  • CEA-708: analizuje dane w wielu blokach usług i ignoruje bloki, które nie są powiązane z obecnie wybranym numerem usługi.
  • Usuń RawCcExtractor, który był używany tylko do obsługi wewnętrznego formatu napisów Google.
• Ekstraktory:
  • Dodano obsługę formatu AVI (#2092).
  • Matroska: analizowanie DiscardPadding w przypadku ścieżek Opus.
  • MP4: analizowanie szybkości transmisji z esds pudełek.
  • Ogg: zezwalaj na zduplikowane nagłówki identyfikatora Opus i komentarza (#10038).
• UI:
  • Naprawiono dostarczanie zdarzeń do OnClickListener ustawionych na PlayerView w przypadku, gdy useController=false (#9605). Naprawiono też dostarczanie zdarzeń do OnLongClickListener we wszystkich konfiguracjach widoku.
  • Naprawiliśmy problem z nieprawidłowym traktowaniem sekwencji zdarzeń dotykowych, które wychodzą poza granice PlayerView przed ACTION_UP, jako kliknięcia (#9861).
  • Rozwiązaliśmy problem z ułatwieniami dostępu PlayerView, który powodował, że kliknięcie mogło przełączać odtwarzanie zamiast ukrywać elementy sterujące (#8627).
  • Zmodyfikuj TrackSelectionView i TrackSelectionDialogBuilder, aby działały w interfejsie Player, a nie ExoPlayer. Dzięki temu widoki mogą być używane z innymi implementacjami Player, a zależność modułu interfejsu od modułu ExoPlayer zostaje usunięta. Jest to zmiana powodująca niezgodność wsteczną.
  • Nie wyświetlaj wymuszonych ścieżek tekstowych w selektorze ścieżek PlayerView i zachowaj wybraną odpowiednią wymuszoną ścieżkę tekstową, jeśli wybrano „Brak” (#9432).
• DASH:
  • Analizowanie liczby kanałów z elementów DTS AudioChannelConfiguration. Przywraca to przekazywanie dźwięku w przypadku strumieni DTS (#10159).
  • Nie zezwalaj na przekazywanie parametru null do usługi DashMediaSource.Factory.setCompositeSequenceableLoaderFactory. W razie potrzeby można jawnie przekazywać instancje DefaultCompositeSequenceableLoaderFactory.
• HLS:
  • Wróć do przygotowywania fragmentów, jeśli atrybut CODECS playlisty nie zawiera kodeka audio (#10065).
  • Nie zezwalaj na przekazywanie parametru null do usług HlsMediaSource.Factory.setCompositeSequenceableLoaderFactory, HlsMediaSource.Factory.setPlaylistParserFactory i HlsMediaSource.Factory.setPlaylistTrackerFactory. Instancje DefaultCompositeSequenceableLoaderFactory, DefaultHlsPlaylistParserFactory lub odwołanie do DefaultHlsPlaylistTracker.FACTORY można przekazywać jawnie, jeśli jest to wymagane.
• Smooth Streaming:
  • Nie zezwalaj na przekazywanie parametru null do usługi SsMediaSource.Factory.setCompositeSequenceableLoaderFactory. W razie potrzeby można jawnie przekazywać instancje DefaultCompositeSequenceableLoaderFactory.
• RTSP:
  • Dodano czytnik RTP dla H263 (#63).
  • Dodaj czytnik RTP dla MPEG4 (#35).
  • Dodano czytnik RTP dla HEVC (#36).
  • Dodaj czytnik RTP dla AMR. Obecnie obsługiwane są tylko strumienie AMR jednokanałowe, nieprzeplatane. Złożony ładunek AMR RTP nie jest obsługiwany. (#46)
  • Dodano czytnik RTP dla VP8 (#47).
  • Dodaj czytnik RTP dla formatu WAV (#56).
  • Popraw nagłówek uwierzytelniania podstawowego RTSP. (#9544).
  • Zaprzestanie sprawdzania obowiązkowych pól SDP, ponieważ ExoPlayer ich nie potrzebuje (#10049).
  • Rzucanie sprawdzonym wyjątkiem podczas analizowania czasu RTSP (#10165).
  • Dodano czytnik RTP dla VP9 (#47).
  • Dodano czytnik RTP dla OPUS (#53).
• Źródła danych:
  • Zmień nazwę DummyDataSource na PlaceholderDataSource.
  • Obejście obsługi przerwań OkHttp.
• Sesja:
  • Zastąp MediaSession.MediaItemFiller ciągiem MediaSession.Callback.onAddMediaItems, aby zezwolić na asynchroniczne rozwiązywanie żądań.
  • Obsługa metod setMediaItems(s), gdy MediaController łączy się ze starszą sesją multimedialną.
  • Usuń MediaController.setMediaUri i MediaSession.Callback.onSetMediaUri. Tę samą funkcję można uzyskać za pomocą funkcji MediaController.setMediaItem i MediaSession.Callback.onAddMediaItems.
  • Przekierowywanie połączeń z usługi starszego typu MediaController w celu odtwarzania multimediów na urządzeniu MediaSession.Callback.onAddMediaItems zamiast na urządzeniu onSetMediaUri.
  • Dodaj MediaNotification.Provider i DefaultMediaNotificationProvider, aby dostosować powiadomienie.
  • Dodano BitmapLoader i SimpleBitmapLoader do pobierania obrazów z grafiką.
  • Dodaj MediaSession.setCustomLayout(), aby zapewnić zgodność wsteczną ze starszą sesją.
  • Dodaj MediaSession.setSessionExtras(), aby zapewnić równoważność funkcji ze starszą sesją.
  • Zmień nazwę MediaSession.MediaSessionCallback na MediaSession.Callback, MediaLibrarySession.MediaLibrarySessionCallback na MediaLibrarySession.Callback i MediaSession.Builder.setSessionCallback na setCallback.
  • Naprawiono błąd NPE w MediaControllerImplLegacy(#59).
  • Aktualizowanie informacji o pozycji sesji na osi czasu change(#51).
  • Naprawiono błąd NPE w MediaControllerImplBase po zwolnieniu kontrolera (#74).
• Odtwarzanie reklam / IMA:
  • Zmniejsz częstotliwość odpytywania reklam ze 100 ms do 200 ms, aby dostosować ją do zaleceń organizacji Media Rating Council (MRC).
• Rozszerzenie FFmpeg:
  • Zaktualizuj wersję CMake do 3.21.0+, aby uniknąć błędu CMake powodującego niepowodzenie synchronizacji Gradle w Android Studio (#9933).
• Usuń symbole, które nie są już używane:
  • Usuń Player.Listener.onTracksChanged(TrackGroupArray, TrackSelectionArray). Zamiast niej użyj zasady Player.Listener.onTracksChanged(Tracks).
  • Usuń Player.getCurrentTrackGroups i Player.getCurrentTrackSelections. Zamiast niej użyj zasady Player.getCurrentTracks. Możesz też nadal korzystać z usług ExoPlayer.getCurrentTrackGroups i ExoPlayer.getCurrentTrackSelections, ale te metody są już przestarzałe.
  • Usuń stałe DownloadHelper DEFAULT_TRACK_SELECTOR_PARAMETERS_WITHOUT_VIEWPORT i DEFAULT_TRACK_SELECTOR_PARAMETERS. W miarę możliwości używaj zasady getDefaultTrackSelectorParameters(Context), a w pozostałych przypadkach zasady DEFAULT_TRACK_SELECTOR_PARAMETERS_WITHOUT_CONTEXT.
  • Usuń konstruktora DefaultTrackSelector(ExoTrackSelection.Factory). Zamiast niej użyj zasady DefaultTrackSelector(Context, ExoTrackSelection.Factory).
  • Usuń Transformer.Builder.setContext. Zamiast tego należy przekazać wartość Context do konstruktora Transformer.Builder.

Wersja 1.0.0-alpha03

14 marca 2022 r.

Publikacja androidx.media3:media3-*:1.0.0-alpha03 Wersja 1.0.0-alpha03 zawiera te zatwierdzenia.

Odpowiada to wersji ExoPlayera 2.17.1.

• Dźwięk:
  • Naprawiono błąd sprawdzania możliwości audio dla Dolby Atmos (E-AC3-JOC) w HLS.
• Ekstraktory:
  • FMP4: naprawiono problem polegający na tym, że metadane próbki emsg mogły być wyświetlane w niewłaściwej kolejności w przypadku strumieni zawierających atomy emsg w wersjach 0 i 1 (#9996).
• Tekst:
  • Naprawiono interakcję między polami SingleSampleMediaSource.Factory.setTrackId i MediaItem.SubtitleConfiguration.Builder.setId, aby nadać priorytet polu SubtitleConfiguration i w razie jego braku używać wartości Factory (#10016).
• Odtwarzanie reklam:
  • Naprawianie niedoborów dźwięku między okresami reklamowymi w transmisjach na żywo HLS z SSAI.

Wersja 1.0.0-alpha02

2 marca 2022 r.

Publikacja androidx.media3:media3-*:1.0.0-alpha02 Wersja 1.0.0-alpha02 zawiera te zatwierdzenia.

Odpowiada to wersji ExoPlayera 2.17.0.

• Podstawowa biblioteka:
  • Dodaj chronioną metodę DefaultRenderersFactory.getCodecAdapterFactory(), aby podklasy DefaultRenderersFactory, które zastępują buildVideoRenderers() lub buildAudioRenderers(), mogły uzyskać dostęp do fabryki adapterów kodeków i przekazywać ją do tworzonych przez siebie instancji MediaCodecRenderer.
  • Przekaż pola nagłówka ICY name i genre do MediaMetadata.station i MediaMetadata.genre odpowiednio, aby dotarły do aplikacji przez Player.Listener.onMediaMetadataChanged() (#9677).
  • Usuń klucze o wartości null z kolekcji DefaultHttpDataSource#getResponseHeaders.
  • W przypadku niepowodzenia tworzenia instancji MediaCodec poczekaj i spróbuj ponownie. Rozwiązuje to problem, który występuje na niektórych urządzeniach podczas przełączania powierzchni z bezpiecznego kodeka na inny kodek (#8696).
  • Dodaj MediaCodecAdapter.getMetrics(), aby umożliwić użytkownikom uzyskiwanie danych o metrykach z MediaCodec. (#9766).
  • Naprawiono rozwiązywanie zależności Maven (#8353).
  • Wyłącz automatyczne dostosowywanie szybkości w przypadku transmisji na żywo, które nie mają funkcji niskiego opóźnienia ani ustawienia szybkości wybranego przez użytkownika (#9329).
  • Zmień nazwę DecoderCounters#inputBufferCount na queuedInputBufferCount.
  • Ustaw SimpleExoPlayer.renderers jako prywatne. Do modułów renderujących można uzyskać dostęp za pomocą ExoPlayer.getRenderer.
  • Zaktualizowano niektóre stałe wartości AnalyticsListener.EventFlags, aby były zgodne z wartościami w Player.EventFlags.
  • Podziel AnalyticsCollector na interfejs i domyślną implementację, aby R8 mógł go usunąć, jeśli aplikacja go nie potrzebuje.
• Wybór ścieżki:
  • Obsługa preferowanych flag ról wideo przy wyborze ścieżki (#9402).
  • Zaktualizowano logikę wyboru ścieżki wideo, aby podczas wybierania wielu ścieżek wideo do adaptacji uwzględniała preferowane typy MIME i flagi ról (#9519).
  • Zaktualizowano logikę wyboru ścieżek wideo i audio, aby wybierać tylko formaty do adaptacyjnego wyboru, które mają ten sam poziom obsługi dekodera i sprzętu (#9565).
  • Zaktualizowano logikę wyboru ścieżki wideo, aby preferować bardziej wydajne kodeki, jeśli dekodery podstawowe z akceleracją sprzętową obsługują wiele kodeków (#4835).
  • preferować ustawienia treści audio (np. „domyślną” ścieżkę audio lub ścieżkę pasującą do języka ustawionego w systemie) od technicznych ograniczeń wyboru ścieżki (np. preferowanego typu MIME lub maksymalnej liczby kanałów);
  • Rozwiązaliśmy problem z wyborem ścieżki, który powodował, że zastąpienie jednej grupy ścieżek nie wyłączało innych grup ścieżek tego samego typu (#9675).
  • Rozwiązaliśmy problem z wyborem ścieżki, który powodował, że mieszanka niepustych i pustych zastąpień ścieżki nie była prawidłowo stosowana (#9649).
  • Zabraniaj duplikowania TrackGroup w TrackGroupArray. TrackGroups można zawsze odróżnić, ustawiając id w konstruktorze TrackGroup. Rozwiązuje to problem z awarią podczas wznawiania odtwarzania po przejściu aplikacji do trybu tła z aktywnym zastąpieniem ścieżki (#9718).
  • Zmiana logiki w AdaptiveTrackSelection, aby umożliwić zwiększenie jakości przy wystarczającej przepustowości sieci, nawet jeśli odtwarzanie jest bardzo blisko krawędzi transmisji na żywo (#9784).
• Film:
  • Poprawiono logikę rezerwowego dekodera Dolby Vision, aby w razie potrzeby używać zgodnego dekodera H264/H265.
• Dźwięk:
  • Poprawiono logikę powrotu dekodera w przypadku Dolby Atmos (E-AC3-JOC), aby w razie potrzeby używać zgodnego dekodera E-AC3.
  • Zmień interfejsy API AudioCapabilities, aby wymagały jawnego przekazywania wartości AudioCapabilities.DEFAULT_AUDIO_CAPABILITIES zamiast null.
  • Umożliwia dostosowanie obliczania rozmiaru bufora AudioTrack przez wstrzyknięcie AudioTrackBufferSizeProvider do DefaultAudioSink. (#8891).
  • Ponów próbę utworzenia AudioTrack, jeśli żądany rozmiar bufora był większy niż 1 MB. (#9712).
• Ekstraktory:
  • WAV: dodano obsługę strumieni RF64 (#9543).
  • Naprawiono nieprawidłową analizę jednostek NAL SPS H.265 (#9719).
  • Analizowanie komentarzy Vorbis (w tym METADATA_BLOCK_PICTURE) w plikach Ogg Opus i Ogg Vorbis.
• Tekst:
  • Dodaj pole MediaItem.SubtitleConfiguration.id, które jest propagowane do pola Format.id ścieżki napisów utworzonej na podstawie konfiguracji (#9673).
  • Dodano podstawową obsługę napisów WebVTT w kontenerach Matroska (#9886).
  • Uniemożliwiać Cea708Decoder odczytywanie większej ilości danych niż zadeklarowany rozmiar bloku usługi.
• DRM:
  • Usuń urządzenie playbackLooper z konta DrmSessionManager.(pre)acquireSession. Jeśli aplikacja używa elementu DrmSessionManager w niestandardowym elemencie MediaSource, zamiast tego należy przekazać element playbackLooper do elementu DrmSessionManager.setPlayer.
• Odtwarzanie reklam / IMA:
  • Dodano obsługę dynamicznego wstawiania reklam (DAI) w pakiecie IMA SDK (#8213).
  • Dodaj metodę do AdPlaybackState, aby umożliwić resetowanie grupy reklam, tak aby można było ją ponownie odtworzyć (#9615).
  • Wymuszanie szybkości odtwarzania 1,0 podczas odtwarzania reklam (#9018).
  • Rozwiązaliśmy problem polegający na tym, że grupa reklam, której nie udało się załadować, powodowała natychmiastowe zresetowanie odtwarzania (#9929).
• UI:
  • Naprawiliśmy kolor liczb na przyciskach StyledPlayerView przewijania do tyłu i do przodu podczas korzystania z niektórych motywów (#9765).
  • Prawidłowe tłumaczenie ciągów znaków dotyczących szybkości odtwarzania (#9811).
• DASH:
  • Dodaj do Representation przeanalizowane właściwości podstawowe i dodatkowe (#9579).
  • Obsługa roli ścieżki forced-subtitle (#9727).
  • Przestań interpretować rolę ścieżki main jako C.SELECTION_FLAG_DEFAULT.
  • Poprawiono logikę wykluczania podstawowego adresu URL w przypadku plików manifestu, które nie deklarują przestrzeni nazw DVB (#9856).
  • Obsługa względnych adresów URL MPD.Location (#9939).
• HLS:
  • Prawidłowo wypełnij pole Format.label w przypadku strumieni HLS zawierających tylko dźwięk (#9608).
  • Domyślnie używaj przygotowywania bez podziału na części, aby skrócić czas uruchamiania. Jeśli Twoje wersje zawierają zmuksowane ścieżki napisów, które nie są zadeklarowane w playliście nadrzędnej, dodaj je do tej playlisty, aby były dostępne do odtwarzania, lub wyłącz przygotowywanie bez podziału na części za pomocą parametru HlsMediaSource.Factory.setAllowChunklessPreparation(false).
  • Obsługa precyzyjnego przewijania do klatki kluczowej w HLS (#2882).
• RTSP:
  • Udostępnij interfejs API klienta, aby zastąpić SocketFactory używany w przypadku dowolnego połączenia z serwerem (#9606).
  • Preferuj metodę uwierzytelniania DIGEST zamiast BASIC, jeśli obie są obecne (#9800).
  • Obsługa sytuacji, w której czas ścieżki RTSP jest niedostępny (#9775).
  • Ignoruj nieprawidłowe wartości nagłówka RTP-Info (#9619).
• Transformer:
  • Zwiększ minimalną wymaganą wersję interfejsu API do 21.
  • TransformationException służy teraz do opisywania błędów, które występują podczas przekształcenia.
  • Dodaj TransformationRequest, aby określić opcje przekształcania.
  • Zezwalaj na rejestrację wielu słuchaczy.
  • Naprawiono problem z zawieszaniem się transformatora, gdy dane wyjściowe kodeka są odczytywane częściowo.
  • Naprawianie potencjalnego błędu NPE w Transformer.getProgress podczas zwalniania multipleksera throws.
  • Dodaj aplikację demonstracyjną do stosowania przekształceń.
• Rozszerzenie MediaSession:
  • Domyślnie MediaSessionConnector czyści teraz playlistę po zatrzymaniu. Aplikacje, które chcą zachować playlistę, mogą wywołać funkcję setClearMediaItemsOnStop(false) w przypadku oprogramowania sprzęgającego.
• Rozszerzenie Cast:
  • Naprawiono błąd, który uniemożliwiał prawidłowe wywoływanie funkcji CastPlayer przez funkcję onIsPlayingChanged (#9792).
  • Obsługa metadanych audio, w tym grafiki, z DefaultMediaItemConverter(#9663).
• Rozszerzenie FFmpeg:
  • Ustaw zależność build_ffmpeg.sh od narzędzi binarnych LLVM zamiast GNU (#9933).
• Zgodność z Androidem 12:
  • Zaktualizuj rozszerzenie Cast, aby zależało od com.google.android.gms:play-services-cast-framework:20.1.0. Starsze wersje play-services-cast-framework nie są zgodne z aplikacjami przeznaczonymi na Androida 12 i będą się zamykać z błędem IllegalArgumentException podczas tworzenia PendingIntent (#9528).
• Usuń symbole, które nie są już używane:
  • Usuń Player.EventListener. Zamiast niej użyj zasady Player.Listener.
  • Usuń MediaSourceFactory#setDrmSessionManager, MediaSourceFactory#setDrmHttpDataSourceFactory i MediaSourceFactory#setDrmUserAgent. Zamiast niej używaj zasady MediaSourceFactory#setDrmSessionManagerProvider.
  • Usuń MediaSourceFactory#setStreamKeys. Zamiast niej używaj zasady MediaItem.Builder#setStreamKeys.
  • Usuń MediaSourceFactory#createMediaSource(Uri). Zamiast niej używaj zasady MediaSourceFactory#createMediaSource(MediaItem).
  • Usuń urządzenie setTag z konta DashMediaSource, HlsMediaSource i SsMediaSource. Zamiast niej użyj zasady MediaItem.Builder#setTag.
  • Usuń DashMediaSource#setLivePresentationDelayMs(long, boolean). Użyj symboli MediaItem.Builder#setLiveConfiguration i MediaItem.LiveConfiguration.Builder#setTargetOffsetMs, aby zastąpić plik manifestu, lub symbolu DashMediaSource#setFallbackTargetLiveOffsetMs, aby podać wartość domyślną.
  • Usuń (Simple)ExoPlayer.setThrowsWhenUsingWrongThread. Rezygnacja z egzekwowania zasad dotyczących wątków nie jest już możliwa.
  • Usuń ActionFile i ActionFileUpgradeUtil. Aby używać funkcji ActionFileUpgradeUtil do scalania starszych plików działań w DefaultDownloadIndex, używaj ExoPlayera w wersji 2.16.1 lub starszej.
  • Usuń ProgressiveMediaSource#setExtractorsFactory. Zamiast tego użyj konstruktora ProgressiveMediaSource.Factory(DataSource.Factory, ExtractorsFactory).
  • Usuń ProgressiveMediaSource.Factory#setTag i ProgressiveMediaSource.Factory#setCustomCacheKey. Zamiast niej używaj kolumn MediaItem.Builder#setTag i MediaItem.Builder#setCustomCacheKey.
  • Usuń konstruktory DefaultRenderersFactory(Context, @ExtensionRendererMode int) i DefaultRenderersFactory(Context, @ExtensionRendererMode int, long). Zamiast niego użyj konstruktora DefaultRenderersFactory(Context), DefaultRenderersFactory#setExtensionRendererMode i DefaultRenderersFactory#setAllowedVideoJoiningTimeMs.
  • Usuń wszystkie publiczne konstruktory CronetDataSource. Zamiast niej używaj zasady CronetDataSource.Factory.
• Zmień IntDefs na @Target(TYPE_USE). Może to spowodować przerwanie kompilacji użyć w języku Kotlin, co można naprawić, przenosząc adnotację do adnotowania typu (Int).
  • @AacAudioObjectType
  • @Ac3Util.SyncFrameInfo.StreamType
  • @AdLoadException.Type
  • @AdtsExtractor.Flags
  • @AmrExtractor.Flags
  • @AspectRatioFrameLayout.ResizeMode
  • @AudioFocusManager.PlayerCommand
  • @AudioSink.SinkFormatSupport
  • @BinarySearchSeeker.TimestampSearchResult.Type
  • @BufferReplacementMode
  • @C.BufferFlags
  • @C.ColorRange
  • @C.ColorSpace
  • @C.ColorTransfer
  • @C.CryptoMode
  • @C.Encoding
  • @C.PcmEncoding
  • @C.Projection
  • @C.SelectionReason
  • @C.StereoMode
  • @C.VideoOutputMode
  • @CacheDataSource.Flags
  • @CaptionStyleCompat.EdgeType
  • @DataSpec.Flags
  • @DataSpec.HttpMethods
  • @DecoderDiscardReasons
  • @DecoderReuseResult
  • @DefaultAudioSink.OutputMode
  • @DefaultDrmSessionManager.Mode
  • @DefaultTrackSelector.SelectionEligibility
  • @DefaultTsPayloadReaderFactory.Flags
  • @EGLSurfaceTexture.SecureMode
  • @EbmlProcessor.ElementType
  • @ExoMediaDrm.KeyRequest.RequestType
  • @ExtensionRendererMode
  • @Extractor.ReadResult
  • @FileTypes.Type
  • @FlacExtractor.Flags (w com.google.android.exoplayer2.ext.flac pakiecie)
  • @FlacExtractor.Flags (w com.google.android.exoplayer2.extractor.flac)
  • @FragmentedMp4Extractor.Flags
  • @HlsMediaPlaylist.PlaylistType
  • @HttpDataSourceException.Type
  • @IllegalClippingException.Reason
  • @IllegalMergeException.Reason
  • @LoadErrorHandlingPolicy.FallbackType
  • @MatroskaExtractor.Flags
  • @Mp3Extractor.Flags
  • @Mp4Extractor.Flags
  • @NotificationUtil.Importance
  • @PlaybackException.FieldNumber
  • @PlayerNotificationManager.Priority
  • @PlayerNotificationManager.Visibility
  • @PlayerView.ShowBuffering
  • @Renderer.State
  • @RendererCapabilities.AdaptiveSupport
  • @RendererCapabilities.Capabilities
  • @RendererCapabilities.DecoderSupport
  • @RendererCapabilities.FormatSupport
  • @RendererCapabilities.HardwareAccelerationSupport
  • @RendererCapabilities.TunnelingSupport
  • @SampleStream.ReadDataResult
  • @SampleStream.ReadFlags
  • @StyledPlayerView.ShowBuffering
  • @SubtitleView.ViewType
  • @TextAnnotation.Position
  • @TextEmphasisSpan.MarkFill
  • @TextEmphasisSpan.MarkShape
  • @Track.Transformation
  • @TrackOutput.SampleDataPart
  • @Transformer.ProgressState
  • @TsExtractor.Mode
  • @TsPayloadReader.Flags
  • @WebvttCssStyle.FontSizeUnit

Wersja 1.0.0-alpha01

27 października 2021 roku

Publikacja androidx.media3:media3-*:1.0.0-alpha01 Wersja 1.0.0-alpha01 zawiera te zatwierdzenia.

Nowe funkcje

Media3 to nowe miejsce dla bibliotek obsługi multimediów, w tym ExoPlayera. Pierwsza wersja alfa zawiera wczesne, funkcjonalne implementacje bibliotek do wdrażania przypadków użycia multimediów, w tym:

• ExoPlayer, odtwarzacz multimediów na poziomie aplikacji na Androida, który można łatwo dostosowywać i rozszerzać.
• Funkcje sesji multimedialnej do udostępniania odtwarzania i sterowania nim. Ten nowy moduł sesji korzysta z tego samego interfejsu Player co ExoPlayer.
• Komponenty interfejsu do tworzenia interfejsów odtwarzania multimediów.
• Moduły opakowujące funkcje w innych bibliotekach do użytku z ExoPlayer, np. wstawianie reklam za pomocą pakietu IMA SDK.

Więcej informacji znajdziesz w projekcie Media3 na GitHubie.

ExoPlayer był wcześniej hostowany w osobnym projekcie GitHub ExoPlayer. W Media3 nazwa pakietu to androidx.media3.exoplayer. Planujemy jeszcze przez jakiś czas utrzymywać i udostępniać projekt ExoPlayer w GitHubie, aby dać aplikacjom czas na przejście na Media3. Biblioteka Media3 ma zamienniki wszystkich modułów ExoPlayera z wyjątkiem starszych rozszerzeń media2 i mediasession, które zostały zastąpione nowym modułem media3-session. Zapewnia to bezpośrednią integrację między odtwarzaczami a sesjami multimedialnymi bez konieczności używania klasy adaptera lub łącznika.