▷ 示例格式

在定义 ExoPlayer 支持的格式时，请务必注意，“媒体格式”是在多个级别定义的。从最低级别到最高级别，这些方法如下所示：

各个媒体样本（例如视频帧或音频帧）的格式。这些是格式示例。请注意，典型的视频文件至少包含两种采样格式的媒体；一种用于视频（例如 H.264），另一种用于音频（例如 AAC）。

用于存放媒体样本和关联元数据的容器的格式。这些是容器格式。媒体文件具有单一的容器格式（例如 MP4），通常通过文件扩展名来指示。请注意，对于某些纯音频格式（例如 MP3），样本格式和容器格式可能相同。

DASH、SmoothStreaming 和 HLS 等自适应流式传输技术。这些不是媒体格式，但仍需定义 ExoPlayer 提供的支持级别。

以下部分从最高到最低级别定义了 ExoPlayer 的支持。最后两部分介绍了对独立字幕格式和 HDR 视频播放的支持。

自适应流式传输

DASH

ExoPlayer 支持多种容器格式的 DASH。媒体流必须经过解复用，这意味着视频、音频和文本必须在 DASH 清单中的不同 AdaptationSet 元素中定义（CEA-608 是例外情况，如下表中所述）。所含音频和视频样本格式也必须受支持（有关详情，请参阅样本格式部分）。

功能

支持

评论

容器

FMP4

是

仅限解复用的流

WebM

是

仅限解复用的流

Matroska

是

仅限解复用的流

MPEG-TS

否

未计划任何支持

字幕

TTML

是

原始格式，或根据 ISO/IEC 14496-30 嵌入在 FMP4 中

WebVTT

是

原始格式，或根据 ISO/IEC 14496-30 嵌入在 FMP4 中

CEA-608

是

使用 SCTE 无障碍描述符发出信号时嵌入到 FMP4 中

CEA-708

是

使用 SCTE 无障碍描述符发出信号时嵌入到 FMP4 中

元数据

EMSG 元数据

是

嵌入在 FMP4 中

内容保护

Widevine

是

“cenc”方案：API 19 及更高版本；“cbcs”方案：API 25 及更高版本

PlayReady SL2000

是

Android TV，仅限“cenc”方案

ClearKey

是

API 21 及更高级别，仅限“cenc”方案

广告插播

多时段播放

是

服务器引导的广告插播

(xlinks)

否

IMA 服务器端广告和客户端广告

是

广告插播指南

直播

常规直播播放

是

超低延迟 CMAF 直播

是

通用媒体客户端数据

(CMCD)

是

CMCD 集成指南

SmoothStreaming

ExoPlayer 支持采用 FMP4 容器格式的 SmoothStreaming。媒体流必须进行解复用，这意味着视频、音频和文本必须在 SmoothStreaming 清单中以不同的 StreamIndex 元素进行定义。所含音频和视频样本格式也必须受支持（如需了解详情，请参阅样本格式部分）。

功能

支持

评论

容器

FMP4

是

仅限解复用的流

字幕

TTML

是

嵌入在 FMP4 中

内容保护

PlayReady SL2000

是

仅分发至 Android TV

直播

常规直播播放

是

通用媒体客户端数据 (CMCD)

是

集成指南

HLS

ExoPlayer 支持采用多种容器格式的 HLS。所含音频和视频样本格式也必须受支持（有关详情，请参阅样本格式部分）。我们强烈建议 HLS 内容制作方生成高画质的 HLS 流，如这篇博文中所述。

功能

支持

评论

容器

MPEG-TS

是

FMP4/CMAF

是

ADTS (AAC)

是

MP3

是

字幕

CEA-608

是

CEA-708

是

WebVTT

是

元数据

ID3

是

SCTE-35

否

内容保护

AES-128

是

Sample AES-128

否

Widevine

是

API 19 及更高版本（“cenc”方案）和 25 及更高版本（“cbcs”方案）

PlayReady SL2000

是

仅分发至 Android TV

服务器控制

增量更新

是

阻止播放列表重新加载

是

阻止加载预加载提示

是

长度未定义的字节范围除外

广告插播

服务器引导的广告插播（插页式广告）

部分支持

仅限包含 X-ASSET-URI 的 VOD。

直播和X-ASSET-LIST将在稍后添加。

IMA 服务器端广告和客户端广告

是

广告插播指南

直播

常规直播播放

是

低延迟 HLS (Apple)

是

低延迟 HLS（社区）

否

通用媒体客户端数据

CMCD

是

CMCD 集成指南

渐进式容器格式

ExoPlayer 可以直接播放以下容器格式的媒体流。

所含音频和视频样本格式也必须受支持（有关详情，请参阅样本格式部分）。如需了解图片容器和格式支持，请参阅图片。

容器格式

支持

评论

MP4

是

M4A

是

FMP4

是

WebM

是

Matroska

是

MP3

是

部分视频流只能使用恒定比特率搜索进行搜索**

Ogg

是

包含 Vorbis、Opus 和 FLAC

WAV

是

MPEG-TS

是

MPEG-PS

是

FLV

是

不可搜索*

ADTS (AAC)

是

只能使用恒定比特率搜索**

FLAC

是

使用 FLAC 库或 ExoPlayer 库中的 FLAC 提取器***

AMR

是

只能使用恒定比特率搜索**

* 不支持搜索，因为容器未提供元数据（例如，样本索引），无法让媒体播放器以高效的方式执行搜索。如果需要搜索，我们建议使用更合适的容器格式。

** 这些提取器具有 FLAG_ENABLE_CONSTANT_BITRATE_SEEKING 标志，用于启用基于恒定比特率假设的近似搜索。此功能默认处于未启用状态。如需为所有支持此功能的提取器启用此功能，最简单的方法是使用 DefaultExtractorsFactory.setConstantBitrateSeekingEnabled，如此处所述。

*** FLAC 库提取器输出原始音频，该音频可由框架在所有 API 级别上处理。ExoPlayer 库 FLAC 提取器会输出 FLAC 音频帧，因此需要使用 FLAC 解码器（例如，处理 FLAC 的 MediaCodec 解码器 [从 API 级别 27 开始需要]，或启用了 FLAC 的 FFmpeg 库）。如果应用是使用 FLAC 库构建的，则 DefaultExtractorsFactory 会使用扩展提取器。否则，它会使用 ExoPlayer 库提取器。

RTSP

ExoPlayer 同时支持直播和点播 RTSP。支持的采样格式和网络类型如下所列。

支持的样本格式

H264（SDP 媒体说明必须在 fmtp 属性中包含 SPS/PPS 数据，以进行解码器初始化）。

AAC（采用 ADTS 位流）。

AC3.

注意： 请针对此问题发表评论，以请求支持其他样本格式。

支持的网络类型

通过 UDP 单播的 RTP（不支持多播）。

交错式 RTSP，使用 TCP 通过 RTSP 传输 RTP。

示例格式

默认情况下，ExoPlayer 使用 Android 的平台解码器。因此，支持的样本格式取决于底层平台，而不是 ExoPlayer。如需查看有关 Android 设备支持的样本格式的文档，请参阅支持的媒体格式。请注意，除了列出的格式之外，个别设备可能还支持其他格式。

除了 Android 的平台解码器之外，ExoPlayer 还可以使用软件解码器扩展程序。这些必须手动构建，并包含在希望使用它们的项目中。我们目前为 AV1、VP9、FLAC、Opus、FFmpeg、MIDI、IAMF 和 MPEG-H 提供软件解码器库。

FFmpeg 库

FFmpeg 库支持解码各种不同的音频样本格式。您可以选择在构建库时包含哪些解码器，如库的 README.md 中所述。下表提供了音频样本格式与相应 FFmpeg 解码器名称之间的映射。

示例格式

解码器名称

Vorbis

vorbis

Opus

opus

FLAC

flac

ALAC

alac

PCM μ-law

pcm_mulaw

PCM A-law

pcm_alaw

MP1、MP2、MP3

MP3

AMR-NB

amrnb

AMR-WB

amrwb

AAC

aac

AC-3

ac3

E-AC-3

eac3

DTS、DTS-HD

DCA

TrueHD

mlp truehd

图片

ExoPlayer 支持以下图片格式。如需了解如何与可能支持不同格式集成的外部库集成，请参阅图片加载库。

映像格式

支持

备注

BMP

是

GIF

否

不支持提取器

JPEG

是

JPEG 动态照片

是

支持静态图片和视频

JPEG Ultra HDR

是

在 Android 14 之前或在非 HDR 显示屏上回退到 SDR

PNG

是

WebP

是

HEIF/HEIC

是

HEIC 动态照片

是

AVIF（基准）

是

仅在 Android 14 及更高版本上解码

独立字幕格式

ExoPlayer 支持各种格式的独立字幕文件。字幕文件可以按照媒体文件页面中的说明进行旁加载。

容器格式

支持

MIME 类型

WebVTT

是

MimeTypes.TEXT_VTT

TTML / SMPTE-TT

是

MimeTypes.APPLICATION_TTML

SubRip

是

MimeTypes.APPLICATION_SUBRIP

SubStationAlpha (SSA/ASS)

是

MimeTypes.TEXT_SSA

HDR 视频播放

ExoPlayer 可处理各种容器中的高动态范围 (HDR) 视频提取，包括 MP4 中的 Dolby Vision 和 Matroska/WebM 中的 HDR10+。解码和显示 HDR 内容取决于 Android 平台和设备的支持。如需了解如何检查 HDR 解码/显示功能以及 HDR 支持在不同 Android 版本中的限制，请参阅 HDR 视频播放。

播放需要支持特定编解码器配置文件的 HDR 流时，即使编解码器列表中相同 MIME 类型但不支持该配置文件的另一个解码器显示在更上方，ExoPlayer 的默认 MediaCodec 选择器也会选择支持该配置文件的解码器（如果有）。这样一来，在流超出同一 MIME 类型硬件解码器的能力范围时，可能会选择软件解码器。