色调映射 - 支持 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 内容序列