Obsługiwane formaty

Podczas definiowania formatów obsługiwanych przez ExoPlayer trzeba pamiętać, „formaty multimediów” są definiowane na wielu poziomach. Od najniższego do najwyższe wartości:

  • Format poszczególnych próbek multimediów (np. ramka filmu lub klatki). dźwięku). To przykładowe formaty. Pamiętaj, że typowy plik wideo zawierać multimedia w co najmniej dwóch przykładowych formatach; jeden dla wideo (np. H.264) oraz jeden dla dźwięku (np. AAC).
  • Format kontenera zawierającego próbki multimediów i powiązane metadanych. Są to formaty kontenerów. Plik multimedialny ma 1 kontener (np. MP4), który jest często określany przez rozszerzenie pliku. Notatka że w przypadku niektórych formatów tylko audio (np. MP3) formaty próbek i kontenerów może być taka sama.
  • Adaptacyjne technologie strumieniowania, takie jak DASH, SmoothStreaming i HLS. Te nie są formatami multimedialnymi, ale i tak trzeba określić, poziomu wsparcia zapewnianego przez ExoPlayer.

W poniższych sekcjach opisano obsługę odtwarzacza ExoPlayer na każdym poziomie, od najwyższego do najniższego najniższą. W dwóch ostatnich sekcjach opisano obsługę samodzielnych formatów napisów. i odtwarzania filmów HDR.

Adaptacyjne strumieniowanie

DASH

ExoPlayer obsługuje DASH z wieloma formatami kontenerów. Strumienie multimediów muszą być: demuksowany, co oznacza, że wideo, dźwięk i tekst muszą być zdefiniowane osobno. elementów AdaptationSet w manifeście DASH (CEA-608 jest wyjątkiem opisane w tabeli poniżej). Zawarte w nim przykładowe formaty dźwięku i wideo muszą również być obsługiwane (zobacz przykładowe formaty).

Funkcja Obsługiwane Komentarze
Kontenery
protokół FMP4 TAK Tylko strumienie zdemonstrowane
WebM TAK Tylko strumienie zdemonstrowane
Matroska TAK Tylko strumienie zdemonstrowane
MPEG-TS NIE Pomoc nie jest planowana
Napisy
TTML, TAK Nieprzetworzone lub umieszczone w FMP4 zgodnie z normą ISO/IEC 14496-30
WebVTT TAK Nieprzetworzone lub umieszczone w FMP4 zgodnie z normą ISO/IEC 14496-30
CEA-608 TAK Umieszczony w FMP4 po sygnalizowaniu za pomocą deskryptorów ułatwień dostępu SCTE
CEA-708 TAK Umieszczony w FMP4 po sygnalizowaniu za pomocą deskryptorów ułatwień dostępu SCTE
Metadane
Metadane EMSG TAK Umieszczone w FMP4
Ochrona treści
Widevine TAK „cenc” schemat: API 19+; „cbcs” schemat: API w wersji 25+
PlayReady SL2000 TAK Android TV, „cenc” tylko schemat
Wyczyść klucz TAK API 21+, „cenc” tylko schemat
Odtwarzanie na żywo
Standardowe odtwarzanie na żywo TAK
Odtwarzanie na żywo w CMAF z bardzo małym opóźnieniem TAK
Common Media Client Data (CMCD). TAK Przewodnik po integracji

Płynne odtwarzanie

ExoPlayer obsługuje funkcję SmoothStreaming w formacie kontenera FMP4. Strumienie multimediów musi być zdemonstrowany, co oznacza, że film, dźwięk i tekst muszą być zdefiniowane osobno. elementy StreamIndex w pliku manifestu SmoothStreaming. Zawarte w nim materiały audio Muszą być też obsługiwane przykładowe formaty wideo (zobacz przykładowe formaty).

Funkcja Obsługiwane Komentarze
Kontenery
protokół FMP4 TAK Tylko strumienie zdemonstrowane
Napisy
TTML, TAK Umieszczone w FMP4
Ochrona treści
PlayReady SL2000 TAK Tylko Android TV
Odtwarzanie na żywo
Standardowe odtwarzanie na żywo TAK
Common Media Client Data (CMCD). TAK Przewodnik po integracji

HLS

ExoPlayer obsługuje HLS z wieloma formatami kontenerów. Zawarte w nim materiały audio Muszą być też obsługiwane przykładowe formaty wideo (zobacz przykładowe formaty). Śr zdecydowanie zachęcamy producentów treści HLS do generowania wysokiej jakości strumieni HLS, zgodnie z opisem tutaj.

Funkcja Obsługiwane Komentarze
Kontenery
MPEG-TS TAK
FMP4/CMAF TAK
ADTS (AAC) TAK
MP3 TAK
Napisy
CEA-608 TAK
CEA-708 TAK
WebVTT TAK
Metadane
Identyfikator 3 TAK
SCTE-35 NIE
Ochrona treści
AES-128, TAK
Przykład AES-128 NIE
Widevine TAK API 19+ (schemat „cenc”) i 25+ (schemat „cbcs”)
PlayReady SL2000 TAK Tylko Android TV
Kontrola serwera
Aktualizacje delta TAK
Blokuję ponowne ładowanie playlisty TAK
Blokuję ładowanie wskazówek dotyczących wstępnego wczytywania TAK Z wyjątkiem zakresów bajtów o nieokreślonej długości
Odtwarzanie na żywo
Standardowe odtwarzanie na żywo TAK
HLS z krótkim czasem oczekiwania (Apple) TAK
HLS z krótkim czasem oczekiwania (społeczność) NIE
Common Media Client Data (CMCD). TAK Przewodnik po integracji

Formaty kontenerów progresywnych

ExoPlayer może odtwarzać strumienie w poniższych formatach kontenera. Muszą być też obsługiwane dołączone do tego formaty dźwiękowe i wideo (patrz Przykładowe formaty). Informacje o kontenerach obrazów i obsłudze formatu znajdziesz tutaj Grafika.

Format kontenera Obsługiwane Komentarze
MP4 TAK
M4A TAK
protokół FMP4 TAK
WebM TAK
Matroska TAK
MP3 TAK Niektóre strumienie można przewijać tylko z użyciem przewijania o stałej szybkości transmisji bitów**
Ogg TAK Zawiera Vorbis, Opus i FLAC
WAV TAK
MPEG-TS TAK
MPEG-PS TAK
FLV TAK Nie można przewijać*
ADTS (AAC) TAK Dostępna tylko do przewijania przy stałej szybkości transmisji bitów**
FLAC TAK Przy użyciu biblioteki FLAC lub wyodrębniania FLAC w bibliotece ExoPlayer***
AMR TAK Dostępna tylko do przewijania przy stałej szybkości transmisji bitów**

* Przeszukiwanie nie jest obsługiwane, ponieważ kontener nie zawiera metadanych (na przykład przykładowy indeks), który umożliwia odtwarzaczowi multimediów skuteczne wyszukiwanie. Jeśli wymagane jest wyszukiwanie, zalecamy użycie bardziej odpowiedniego formatu kontenera.

** Te moduły wyodrębniania danych mają FLAG_ENABLE_CONSTANT_BITRATE_SEEKING flagi dla umożliwiające przybliżone przewijanie z założeniem o stałej szybkości transmisji bitów. Ten funkcja nie jest domyślnie włączona. Najprostszy sposób, aby to włączyć dla wszystkich modułów wyodrębniania, które go obsługują, jest użycie DefaultExtractorsFactory.setConstantBitrateSeekingEnabled, zgodnie z opisem tutaj.

*** Wyodrębnianie biblioteki FLAC generuje nieprzetworzony dźwięk, który może być obsługiwany na wszystkich poziomach interfejsu API. Dane wyjściowe biblioteki ExoPlayer wyodrębniania FLAC ramki audio FLAC i wymaga dekodera FLAC (np. MediaCodec dekoder obsługujący format FLAC (wymagany od interfejsu API poziomu 27) lub bibliotekę FFmpeg z włączonym FLAC). W elemencie DefaultExtractorsFactory używany jest protokół wyodrębniania rozszerzeń, jeśli aplikacja została skompilowana za pomocą biblioteki FLAC. W przeciwnym razie używany jest ekstraktor biblioteki ExoPlayer.

RTSP

ExoPlayer obsługuje zarówno protokół RTSP na żywo, jak i na żądanie. Obsługiwane formaty próbek wymienionych poniżej.

Obsługiwane formaty próbek

  • H264 (opis mediów SDP musi zawierać dane SPS/PPS w fmtp) do inicjowania dekodera).
  • AAC (ze strumieniem bitowym ADTS).
  • AC3.
.

Obsługiwane typy sieci

  • Transmisja pojedyncza RTP przez UDP (multicast nie jest obsługiwany).
  • Przeplatany RTSP, RTP przez RTSP przy użyciu TCP.

Przykładowe formaty

Domyślnie ExoPlayer używa dekoderów platformy Androida. Dlatego też przykładowe formaty zależą od platformy, a nie od ExoPlayer. Przeczytaj artykuł Obsługiwane formaty multimediów: dokumentacji dotyczącej przykładowych formatów obsługiwanych przez urządzenia z Androidem. Pamiętaj, że poszczególne urządzenia mogą obsługiwać dodatkowe formaty niż wymienione.

Oprócz dekoderów platformy Androida ExoPlayer może też wykorzystywać z rozszerzeń do dekodera oprogramowania. Należy je utworzyć ręcznie i uwzględnić w projektach, które chcą z nich korzystać. Obecnie udostępniamy dekoder oprogramowania biblioteki dla AV1 VP9 FLAC Opus oraz FFmpeg.

Biblioteka FFmpeg

Biblioteka FFmpeg obsługuje dekodowanie różnych formatów próbek dźwięku. Możesz wybrać, które mają być uwzględnione podczas tworzenia biblioteki, zgodnie z opisem w sekcji do pliku README.md biblioteki. ta tabela zawiera mapowanie z formatu próbki audio na odpowiedni Nazwa dekodera FFmpeg.

Przykładowy format Nazwy dekodera
Vorbis Vorbis
Opus Opus
FLAC Flac
lista ALAC Alac
PCM (μ-prawo) pcm_mulaw
Prawo PCM pcm_alaw
MP1, MP2, MP3 mp3
AMR-NB Amrnb
AMR-WB Amrwb
AAC AAC
AC-3 AC3
E-AC-3 Eac3,
DTS, DTS-HD DC
TrueHD MLP truehd

Obrazy

ExoPlayer obsługuje następujące formaty obrazów. Zobacz Wczytywanie bibliotek obrazów integracji z bibliotekami zewnętrznymi, które mogą zapewnić obsługę różnych formatów.

Format pliku graficznego Obsługiwane Uwagi
BMP TAK
GIF NIE Brak obsługi wyodrębniania
JPEG TAK
Zdjęcie ruchome JPEG TAK Obsługa nieruchomych obrazów i filmów
JPEG ultra HDR TAK Wraca do SDR przed Androidem 14 lub nowszym wyświetlacze bez HDR
PNG TAK
WebP TAK
HEIF/HEIC TAK
Zdjęcie ruchome HEIC Częściowo Obsługiwane są tylko obrazy nieruchome*
AVIF (wartość bazowa) TAK Odkodowane tylko na Androidzie 14 i nowszych

* Fragment wideo ze zdjęć ruchomych HEIC można uzyskać za pomocą Metadatapickupr, i odtwarzane jako samodzielny plik.

Samodzielne formaty napisów

ExoPlayer obsługuje niezależne pliki napisów w różnych formatach. Napisy takie pliki mogą być ładowane z innego urządzenia zgodnie z opisem na stronie elementów multimedialnych.

Format kontenera Obsługiwane Typ MIME
WebVTT TAK Typy MIME.TEXT_VTT
TTML / SMPTE-TT TAK Typy MIME.APPLICATION_TTML
SubRip TAK Typy MIME.APPLICATION_SUBRIP
Podstacja alfa (SSA/ASS) TAK Typy MIME.TEXT_SSA

Odtwarzanie filmów HDR

ExoPlayer obsługuje wyodrębnianie filmów o wysokim zakresie dynamiki (HDR) w różnych w tym Dolby Vision w formacie MP4 i HD10+ w formacie Matroska/WebM. Dekodowanie a wyświetlanie treści HDR zależy od obsługi platformy urządzenia. Zobacz Odtwarzanie filmów HDR aby dowiedzieć się więcej o sprawdzaniu możliwości dekodowania/wyświetlania HDR i ograniczeń Obsługa HDR na różnych wersjach Androida.

Podczas odtwarzania strumienia HDR, który wymaga obsługi konkretnego profilu kodeka, Domyślny selektor MediaCodec ExoPlayer wybierze dekoder, który obsługuje ten profilu (jeśli jest dostępny), nawet jeśli inny dekoder dla tego samego typu MIME nie obsługuje tego profilu, pojawia się wyżej na liście kodeków. Może to spowodować przy wyborze dekodera programowego w przypadkach, gdy strumień przekracza możliwości dekodera sprzętowego dla tego samego typu MIME.