Bei der Definition der Formate, die ExoPlayer unterstützt, ist zu beachten, dass „Medienformate“ auf mehreren Ebenen definiert sind. Von der untersten Ebene zur am höchsten sind, sind diese:
- Das Format der einzelnen Medienbeispiele (z. B. ein Frame eines Videos oder ein Frame) Audio). Dies sind Beispielformate. Beachten Sie, dass eine typische Videodatei Medien in mindestens zwei Beispielformaten enthalten; eine für Video (z. B. H.264) und eine für Audio (z. B. AAC).
- Das Format des Containers, der die Medienbeispiele und die zugehörigen Metadaten. Dies sind Containerformate. Eine Mediendatei hat einen einzelnen Container (z. B. MP4), was üblicherweise durch die Dateiendung angegeben wird. Hinweis dass bei einigen reinen Audioformaten (z. B. MP3) die Sample- und Containerformate identisch sein.
- Adaptive Streamingtechnologien wie DASH, SmoothStreaming und HLS. Diese sind keine Medienformate an sich. Es muss jedoch definiert werden, Supportstufe von ExoPlayer.
In den folgenden Abschnitten wird die Unterstützung von ExoPlayer für jedes Level definiert, von der höchsten bis zur niedrigste. In den letzten beiden Abschnitten wird die Unterstützung für eigenständige Untertitelformate beschrieben. und HDR-Videowiedergabe.
Adaptives Streaming
DASH
ExoPlayer unterstützt DASH mit mehreren Containerformaten. Media-Streams müssen
Das heißt, Video, Audio und Text müssen getrennt voneinander definiert werden.
AdaptationSet-Elemente im DASH-Manifest (CEA-608 ist eine Ausnahme, da
wie in der Tabelle unten beschrieben). Die enthaltenen Audio- und Video-Beispielformate müssen
auch unterstützt werden (siehe
Beispielformate.
| Funktion | Unterstützt | Kommentare |
|---|---|---|
| Container | ||
| FMP4 | JA | Nur demuxierte Streams |
| WebM | JA | Nur demuxierte Streams |
| Matroska | JA | Nur demuxierte Streams |
| MPEG-TS | NEIN | Keine Unterstützung geplant |
| Untertitel | ||
| TTML | JA | RAW oder in FMP4 gemäß ISO/IEC 14496-30 eingebettet |
| WebVTT | JA | RAW oder in FMP4 gemäß ISO/IEC 14496-30 eingebettet |
| CEA-608 | JA | In FMP4 eingebettet, wenn sie mithilfe von SCTE-Bedienungshilfen-Deskriptoren signalisiert wird |
| CEA-708 | JA | In FMP4 eingebettet, wenn sie mithilfe von SCTE-Bedienungshilfen-Deskriptoren signalisiert wird |
| Metadaten | ||
| EMSG-Metadaten | JA | In FMP4 eingebettet |
| Inhaltsschutz | ||
| Widevine | JA | „cenc“ Schema: API 19+; „cbcs“ Schema: API 25+ |
| PlayReady SL2000 | JA | Android TV, „cenc“ Nur Schema |
| Löschschlüssel | JA | API 21 oder höher, „cenc“ Nur Schema |
| Live-Wiedergabe | ||
| Regelmäßige Live-Wiedergabe | JA | |
| CMAF-Livewiedergabe mit extrem niedriger Latenz | JA | |
| Common Media Client Data (CMCD) | JA | Integrationsleitfaden |
SmoothStreaming
ExoPlayer unterstützt SmoothStreaming mit dem FMP4-Containerformat. Medien-Streams müssen getrennt sein, d. h. Video, Audio und Text müssen getrennt voneinander definiert werden. StreamIndex-Elemente im SmoothStreaming-Manifest Die enthaltenen Audio- und Video-Beispielformate müssen ebenfalls unterstützt werden (siehe Beispielformate.
| Funktion | Unterstützt | Kommentare |
|---|---|---|
| Container | ||
| FMP4 | JA | Nur demuxierte Streams |
| Untertitel | ||
| TTML | JA | In FMP4 eingebettet |
| Inhaltsschutz | ||
| PlayReady SL2000 | JA | Nur Android TV |
| Live-Wiedergabe | ||
| Regelmäßige Live-Wiedergabe | JA | |
| Common Media Client Data (CMCD) | JA | Integrationsleitfaden |
HLS
ExoPlayer unterstützt HLS mit mehreren Containerformaten. Die enthaltenen Audio- und Video-Beispielformate müssen ebenfalls unterstützt werden (siehe Beispielformate. Mi. Ersteller von HLS-Content ausdrücklich ermutigen, HLS-Streams hoher Qualität zu generieren wie beschrieben hier.
| Funktion | Unterstützt | Kommentare |
|---|---|---|
| Container | ||
| MPEG-TS | JA | |
| FMP4/CMAF | JA | |
| ADTS (AAC) | JA | |
| MP3 | JA | |
| Untertitel | ||
| CEA-608 | JA | |
| CEA-708 | JA | |
| WebVTT | JA | |
| Metadaten | ||
| ID3 | JA | |
| SCTE-35 | NEIN | |
| Inhaltsschutz | ||
| AES-128 | JA | |
| AES-128-Beispiel | NEIN | |
| Widevine | JA | API 19 oder höher (Schema „cenc“) und API 25 oder höher (Schema „cbcs“) |
| PlayReady SL2000 | JA | Nur Android TV |
| Serversteuerung | ||
| Delta-Aktualisierungen | JA | |
| Neuladen der Playlist wird blockiert | JA | |
| Laden von Vorabladehinweisen blockieren | JA | Außer für Bytebereiche mit undefinierter Länge |
| Live-Wiedergabe | ||
| Regelmäßige Live-Wiedergabe | JA | |
| HLS mit niedriger Latenz (Apple) | JA | |
| HLS mit niedriger Latenz (Community) | NEIN | |
| Common Media Client Data (CMCD) | JA | Integrationsleitfaden |
Progressive Containerformate
Streams in den folgenden Containerformaten können direkt von ExoPlayer wiedergegeben werden. Die enthaltenen Audio- und Video-Beispielformate müssen ebenfalls unterstützt werden (siehe Beispielformate. Informationen zur Unterstützung von Image-Containern und -Formaten finden Sie unter Bilder:
| Container format | Unterstützt | Kommentare |
|---|---|---|
| MP4 | JA | |
| M4A | JA | |
| FMP4 | JA | |
| WebM | JA | |
| Matroska | JA | |
| MP3 | JA | Einige Streams können nur über die konstante Bitratesuche gefunden werden** |
| OGG | JA | Enthält Vorbis, Opus und FLAC |
| WAV (WAV) | JA | |
| MPEG-TS | JA | |
| MPEG-PS | JA | |
| FLV | JA | Nicht suchbar* |
| ADTS (AAC) | JA | Suche nur mit konstanter Bitrate-Suche möglich** |
| FLAC | JA | Sie können die FLAC-Bibliothek oder den FLAC-Extraktor in der ExoPlayer-Bibliothek verwenden.*** |
| Logo: AMR | JA | Suche nur mit konstanter Bitrate-Suche möglich** |
* Die Suche wird nicht unterstützt, da der Container keine Metadaten bereitstellt (z. B. ein Beispielindex), damit ein Mediaplayer eine Suche auf effiziente Weise ausführen kann. Wenn eine Suche erforderlich ist, sollten Sie ein geeigneteres Containerformat verwenden.
** Diese Extraktoren haben FLAG_ENABLE_CONSTANT_BITRATE_SEEKING-Flags für
eine ungefähre Suche mit einer konstanten Bitratenannahme möglich. Dieses
ist standardmäßig nicht aktiviert. Das geht am einfachsten
für alle Extraktoren,
die diese unterstützen, besteht darin,
DefaultExtractorsFactory.setConstantBitrateSeekingEnabled, wie beschrieben
finden Sie hier.
*** Der Extraktor der FLAC-Bibliothek gibt Audio-Rohdaten aus, die verarbeitet werden können.
des Frameworks auf allen API-Ebenen. Der FLAC-Extraktor der ExoPlayer-Bibliothek gibt aus
FLAC-Audioframes und ist daher auf einen FLAC-Decoder (z. B. MediaCodec) angewiesen.
der FLAC verarbeitet (erforderlich ab API-Level 27), oder der
FFmpeg-Bibliothek mit aktiviertem FLAC). DefaultExtractorsFactory verwendet die Methode
Erweiterungsextraktor, wenn die Anwendung mit der FLAC-Bibliothek erstellt wurde.
Andernfalls wird der ExoPlayer-Extraktor der ExoPlayer-Bibliothek verwendet.
RTSP
ExoPlayer unterstützt sowohl Live- als auch On-Demand-RTSP. Unterstützte Beispielformate und sind unten aufgeführt.
Unterstützte Beispielformate
- H264 (die SDP-Medienbeschreibung muss SPS/PPS-Daten in fmtp enthalten) für die Decoder-Initialisierung.
- AAC (mit ADTS-Bitstream).
- AC3
Unterstützte Netzwerktypen
- RTP über UDP-Unicast (Multicast wird nicht unterstützt).
- Verschränktes RTSP, RTP über RTSP mit TCP.
Beispielformate
Standardmäßig verwendet ExoPlayer die Plattformdecoder von Android. Daher werden die unterstützten Die Beispielformate hängen von der zugrunde liegenden Plattform ab, nicht von ExoPlayer. Weitere Informationen finden Sie im Artikel Unterstützte Medienformate für Dokumentation zu Beispielformaten, die von Android-Geräten unterstützt werden. Beachten Sie, dass können auf einzelnen Geräten weitere Formate unterstützt werden.
Neben den Plattformdecoder der Android-Plattform kann ExoPlayer auch Software-Decoder-Erweiterungen. Diese müssen manuell erstellt und in die sie nutzen möchten. Wir bieten derzeit einen Softwaredecoder an. Bibliotheken für AV1 VP9 FLAC Opus und FFmpeg
FFmpeg-Bibliothek
Die FFmpeg-Bibliothek unterstützt verschiedene Audiobeispielformate decodiert. Sie können auswählen, Decoder für den Bau der Bibliothek, wie in der README.md der Bibliothek. Die Die folgende Tabelle zeigt eine Zuordnung vom Audiobeispielformat zum entsprechenden Name des FFmpeg-Decoders.
| Beispielformat | Decoder-Name(n) |
|---|---|
| Vorbis | Vorbis |
| Opus | Opus |
| FLAC | FLAC |
| AAC | Alac |
| PCM-μ-Gesetz | pcm_mulaw |
| PCM A-Gesetz | pcm_alaw |
| MP1, MP2, MP3 | MP3 |
| AMR-NB | Amrnb |
| AMR-WB | Amrwb |
| AAC | AAC |
| AC-3- | AC3 |
| E-AC-3 (E-AC-3) | EAC3 |
| DTS, DTS-HD | DCA |
| TrueHD | mlp truehd |
Bilder
ExoPlayer unterstützt die folgenden Bildformate. Weitere Informationen finden Sie unter Bibliotheken zum Laden von Bildern . Dort erfahren Sie, wie Sie externe Bibliotheken integrieren, die ein mit unterschiedlichen Formaten.
| Bildformat | Unterstützt | Hinweise |
|---|---|---|
| BMP | JA | |
| GIF | NEIN | Keine Unterstützung für Extraktoren |
| JPEG | JA | |
| JPEG-Foto mit Bewegtbild | JA | Standbilder und Videos werden unterstützt |
| JPEG Ultra HDR | JA | Vor Android 14 oder höher wird auf SDR zurückgesetzt nicht HDR-Displays |
| PNG | JA | |
| WebP | JA | |
| HEIF/HEIC | JA | |
| HEIC-Foto mit Bewegtbild | Teilweise | Nur Standbilder werden unterstützt* |
| AVIF (Baseline) | JA | Nur mit Android 14 und höher decodiert |
* Der Videoteil von HEIC-Bewegungsfotos kann mit MetadataRetriever und als eigenständige Datei wiedergegeben.
Eigenständige Untertitelformate
ExoPlayer unterstützt eigenständige Untertiteldateien in verschiedenen Formaten. Untertitel Dateien können, wie auf der Seite mit den Medieninhalten beschrieben, per Sideload übertragen werden.
| Container format | Unterstützt | MIME-Typ |
|---|---|---|
| WebVTT | JA | MIME-Typen.TEXT_VTT |
| TTML / SMPTE-TT | JA | MIME-Typen.APPLICATION_TTML |
| SubRip | JA | MIME-Typen.APPLICATION_SUBRIP |
| SubStationAlpha (SSA/ASS) | JA | MIME-Typen.TEXT_SSA |
HDR-Videowiedergabe
ExoPlayer extrahiert HDR-Videos (High Dynamic Range) aus verschiedenen Container wie Dolby Vision in MP4 und HDR10+ in Matroska/WebM. Decodierung HDR-Inhalte und die Anzeige von HDR-Inhalten . Weitere Informationen finden Sie unter HDR-Videowiedergabe um mehr über die Überprüfung der HDR-Decodierung/-Anzeigefunktionen und die Einschränkungen HDR-Unterstützung in allen Android-Versionen.
Bei der Wiedergabe eines HDR-Streams, der die Unterstützung eines bestimmten Codec-Profils erfordert,
Mit der Standardauswahl von „MediaCodec“ von ExoPlayer wird ein Decoder ausgewählt, der diese Funktion unterstützt
(falls verfügbar), auch wenn ein anderer Decoder für denselben MIME-Typ
unterstützt, steht dieses Profil weiter oben in der Liste der Codec. Das kann dazu führen,
zur Auswahl eines Software-Decodierers in Fällen, in denen der Stream die
Hardware-Decodierer für denselben MIME-Typ.