色调映射 - 支持 HDR 和 SDR 内容

使用 Transformer 时，请务必考虑 HDR 和 SDR 内容之间的差距。HDR 显示的色彩细节更丰富， 颜色和对比度，为用户提供更好的视觉体验。但是，由于 HDR 和 SDR 之间的颜色范围差异，将这两种类型的 可能会导致兼容性问题。

在构建 Composition, 您可以选择setHdrMode 。默认情况下，Transformer 会将此值设置为 HDR_MODE_KEEP_HDR, 这可确保输出保持为 HDR 格式。如果设备未 支持 HDR 格式，Transformer 会自动尝试使用 HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_OPEN_GL。

在某些情况下，您可能会将 HDR 和 SDR 素材资源结合使用。例如，您 可能会在 HDR 视频和图片上叠加 SDR 叠加层， HDR 和 SDR 视频在这种情况下，您可以采取以下做法：

优点 缺点
使用 MediaCodec 的色调映射 最佳视觉质量输出（如果设备和 API 组合支持的话）。 仅适用于特定设备上的 API 31 及更高版本，以及设备的 API 33 及更高版本 并支持 HDR 拍摄如果不受支持，Transformer 会抛出 ExportException。
使用 OpenGL 设置色调地图 支持 API 29 及以上级别，跨设备的支持范围通常更广泛。产生更一致的结果。 与使用输出时相比，可能会产生轻微的差异 HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_MEDIACODEC。
将 HDR 解释为 SDR 支持最广泛的选项。 内容可能会呈现褪色效果，并且可能无法正常显示。

当前限制

多资产乐曲不支持以下内容：

  • SDR 到 HDR 色调映射
  • 以 HDR 资产开头的 SDR 和 HDR 内容序列