使用 Transformer 时，请务必考虑 HDR 和 SDR 内容之间的兼容性。HDR 显示屏可呈现色彩细节、颜色和对比度更丰富的内容，从而为用户带来更好的视觉体验。不过，由于 HDR 和 SDR 之间的色域存在差异，因此将这两种类型的内容组合在一起可能会导致兼容性问题。
在构建 Composition 时，您可以选择为 HDR 视频输入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 及更高版本，在支持 HDR 拍摄的设备上支持 API 33 及更高版本。如果不支持，Transformer 会抛出 ExportException。 |
| 使用 OpenGL 进行色调映射 | 支持 API 29 及更高版本，并且通常在各种设备上都得到更广泛的支持。生成更一致的结果。 | 与使用 HDR_MODE_TONE_MAP_HDR_TO_SDR_USING_MEDIACODEC 时的输出相比，可能会产生细微差异。 |
| 将 HDR 解释为 SDR | 最受支持的选项。 | 内容可能会显得色彩暗淡，并且可能显示不正确。 |
当前限制
以下内容不支持用于多素材资源乐曲：
- SDR 到 HDR 色调映射
- 以 HDR 资产开头的 SDR 和 HDR 内容序列