高动态范围 (HDR) 视频是高品质视频解码领域的又一项前沿技术产物，能够提供卓越的场景再现品质。它可以通过显著扩大亮度分量的动态范围（从当前的 100 cd/m2 到 1000 cd/m2）以及使用更宽的色彩空间 (BT 2020) 来达到这种效果。如今，在电视领域中，HDR 是发展 4K 超高清显示技术的一项核心元素。

Android 10 支持以下 HDR 视频。

从 Android 9 及更高版本开始，无论是否使用隧道模式，MediaCodec 都会报告 HDR 元数据。您可以在非隧道模式下同时获取解码数据和静态/动态元数据。对于使用静态元数据的 HDR10 和 VP9Profile2，可使用密钥 KEY_HDR_STATIC_INFO 以输出格式进行报告。对于使用动态元数据的 HDR10+，可使用密钥 KEY_HDR10_PLUS_INFO 以输出格式进行报告（针对各个输出框架，可能会有所不同）。如需了解详情，请参阅多媒体隧道。

自 Android 7.0 起，对 HDR 技术的初步支持包括创建适当的常量以便发现和设置 HDR 视频通道。这意味着需要定义编解码器类型和显示模式，以及指定以何种方式将 HDR 数据传递至 MediaCodec 并将其提供给 HDR 解码器。

本文档的目的在于帮助应用开发者提供对 HDR 流播放技术的支持，并帮助原始设备制造商 (OEM) 和 SoC 供应商启用 HDR 功能。

自 Android 7.0 及更高版本起，支持以下 HDR 技术。

在 Android 7.0 中，仅定义了隧道模式下的 HDR 播放，但设备可以新增相应的支持，以便使用不透明的视频缓冲区在 SurfaceView 上播放 HDR 视频。也就是说：

若要使用 HDR 播放功能，必须有具备 HDR 功能的解码器，并连接到具备 HDR 功能的屏幕。有时，某些技术需要用到特定的提取器。

应用应使用全新 Display.getHdrCapabilities API 来查询特定屏幕支持的 HDR 技术。这基本上就是 CTA-861.3 中定义的 EDID 静态元数据块中的信息：

常量：

公开方法：

应用应使用现有的 CodecCapabilities.profileLevels API 来验证是否支持新的具有 HDR 功能的配置文件：

MediaFormat mime 常量：

MediaCodecInfo.CodecProfileLevel 配置文件常量：

杜比视界视频层和元数据必须通过视频应用逐帧连接到单个缓冲区。此过程可通过具有杜比视界功能的 MediaExtractor 自动完成。

MediaCodecInfo.CodecProfileLevel 配置文件常量：

MediaCodecInfo.CodecProfileLevel 配置文件常量：

如果某个平台支持具备 HDR 功能的解码器，则该平台还应该支持具备 HDR 功能的提取器。

只有隧道解码器才能确保播放 HDR 内容。通过非隧道解码器播放可能会导致 HDR 信息丢失，且内容会被压缩为 SDR 色域。

Android 7.0 支持实现各项 HDR 技术的以下容器：

该平台不支持探索（文件的）轨道是否需要 HDR 支持。应用可以解析编解码器专用数据，以确定轨道是否需要特定的 HDR 配置文件。

各项 HDR 技术的组件要求如下表所示：

注意：

应用确认支持 HDR 播放功能后，可以通过几乎与播放非 HDR 内容相同的方式播放 HDR 内容，但需注意以下情况：

SoC 供应商和原始设备制造商 (OEM) 必须采取进一步措施，才能让某款设备支持 HDR 平台。

以下是原始设备制造商 (OEM) 和 SoC 供应商需知悉的平台（应用层/本地层）中的一些重要更改。

具有 HDR 功能的平台必须支持将 HDR 内容与非 HDR 内容合成在一起。从 7.0 版开始，Android 不再对实际的合成特性和操作进行定义，但完成相应流程一般应遵循以下步骤：

HDR Display Discovery 功能只能通过 HWC2 受支持。设备实施者必须选择性地启用随 Android 7.0 一起发布的 HWC2 适配器，以确保此功能正常发挥作用。因此，平台必须添加对 HWC2 的支持，或扩展 AOSP 框架以允许通过某种方式提供此信息。HWC2 首次采用一种全新的 API，可以向框架和应用传播 HDR 静态数据。

平台必须添加具有 HDR 功能的隧道解码器，并播发其 HDR 支持。通常，具有 HDR 功能的解码器必须：

要支持杜比视界，平台必须添加具有杜比视界功能的 HDR OMX 解码器。基于杜比视界的特性，这通常是由一个或多个 AVC 和/或 HEVC 解码器以及合成器封装的解码器。此类解码器必须：

在配置解码器时，实际的杜比配置文件不会被传送到编解码器。只有在解码器启动后，配置文件才能通过编解码器专用数据完成传送。一个平台可选择支持多个杜比视界解码器：一个用于 AVC 配置文件，另一个用于 HEVC 配置文件，以便能够在配置时间内初始化底层编解码器。如果单个杜比视界解码器同时支持两种类型的配置文件，那么它还必须支持以自适应方式在这两种类型之间进行动态切换。

如果一个平台不仅支持一般的 HDR 解码器，而且还提供具有杜比视界功能的解码器，那么它必须：

要支持 HDR10，平台必须添加一个支持 HDR10 的 OMX 解码器。上述解码器通常是采用隧道技术且支持解析和处理 HDMI 相关元数据的 HEVC 解码器。此类解码器（除了支持一般的 HDR 解码器之外）必须：

要支持 VP9 HDR，平台必须添加一个支持 VP9 Profile2 的 HDR OMX 解码器。上述解码器通常是采用隧道技术且支持处理 HDMI 相关元数据的 VP9 解码器。此类解码器（除了支持一般的 HDR 解码器之外）必须：

支持杜比视界解码器的平台必须支持用于提取杜比视频内容的杜比提取器（也称 Dolby Extractor）。

如果需要支持 HDR10 或 VP9 HLG，对于提取器并没有额外的要求。但是要支持 MP4 中的 VP9 PQ，平台必须额外提供 MP4 提取器。HDR 静态元数据必须传播到 VP9 PQ 比特流中，以便将此元数据传递到 VP9 PQ 解码器，并通过正常的 MediaExtractor => MediaCodec 通道传递到屏幕。

平台必须为 Stagefright 添加杜比视界格式支持：

图 1. HDR10 通道

HDR10 比特流会打包到 MP4 容器中。应用会使用常规的 MP4 提取器来提取帧数据，并将其发送到解码器。

图 2. 杜比视界通道

将杜比比特流打包到由杜比实验室定义的 MP4 容器中。在理论上，应用可以使用常规 MP4 提取器独立提取基本层、增强层和元数据层；不过，这不适合当前的 Android MediaExtractor/MediaCodec 模式。

图 3. VP9-PQ 通道

VP9 比特流将按照 WebM 团队定义的方式打包到 WebM 容器中。在将帧发送到解码器之前，应用需要使用 WebM 提取器将 HDR 元数据从比特流中提取出来。