HDR（High Dynamic Range，高动态范围）视频，相比普通 SDR（Standard Dynamic Range）视频拥有更高的色深、更广的动态范围和更强的色彩表现力，使得画面更真实、更有层次，很直观的提升视频画质，从而有效提升人们的观影感受。本文为您介绍使用播放器 SDK 时如何播放 HDR 视频。

前提条件

使用 HDR 视频播放功能前，请确保满足以下条件：

• 设备支持：Android 系统版本 ≥ 9.0
• 播放设置：
  • 使用 SurfaceView 作为视频渲染视图
  • 启用硬解（硬件解码）
• 视频源要求：
  • 视频编码格式：H.265（HEVC）
  • HDR 标准：HDR10 或 HLG

判断设备是否支持 HDR 播放

播放前，先通过 isDeviceSupportHevcHDR 判断设备是否支持 HDR 播放，示例代码如下：

boolean support = TTVideoEngine.isDeviceSupportHevcHDR(context);

播放 HDR 视频

若设备支持 HDR 视频且已知源为 HDR，则可直接设置播放视频。

DirectUrl 模式

若您以 DirectUrl 模式播放 HDR 视频，参考设置播放源将 HDR 视频资源的 URL 设置给播放器即可。

Vid 模式

若您以 Vid 模式播放 HDR 视频，您需要参考以下步骤：

1. 准备 HDR 视频源：通过视频点播媒体处理服务转出 HDR 视频，详细操作请见画质增强（旧版）。
2. 客户端请求 HDR 视频源：客户端从服务端获取 HDR 视频源时，服务端需在签发临时播放 Token 中指定 HDRDefinition 参数，从视频点播服务获取对应清晰度的 HDR 源。

   说明

   各语言 SDK 签发临时播放 Token 文档：

   • Java SDK - 签发临时播放 Token
   • Python SDK - 签发临时播放 Token
   • PHP SDK - 签发临时播放 Token
   • Go SDK - 签发临时播放 Token
   • Node.js SDK - 签发临时播放 Token
3. 客户端设置播放源：参考设置播放源设置 Vid 播放源。
4. 管理与切换清晰度：

   • 在 onFetchedVideoInfo 回调中获取支持的清晰度列表：

     ttVideoEngine.setVideoInfoListener(new VideoInfoListener() {
         @Override
         public boolean onFetchedVideoInfo(VideoModel videoModel) {
             // 获取视频数据成功回调
             Log.v("VideoPlay", "onFetchedVideoInfo " + videoModel);
             if (videoModel == null) return false;
             
             // 获取当前 VideoModel 的清晰度数组，可用于清晰度列表展示
             Resolution[] resolutions = ttVideoEngine.supportedResolutionTypes();
               
             return false;
         }
     });
     

   • 调用 configResolution 切换 HDR 档位：

     说明

     详见 HDR 档位枚举。

     ttVideoEngine.configResolution(High_HDR);
     

   • 通过 isHDRResolution 判断某清晰度是否为 HDR：

     /**
      判断是否是 HDR 档位清晰度
      
      @param resolution 清晰度
      */
     private boolean isHDRResolution(Resolution resolution) {
         return resolution.toString(TYPE_VIDEO).contains("HDR");
     }
     

判断播放源是否为 HDR

若不确定播放源是否为 HDR，可在 onPrepared 中对播放源是否为 HDR 进行判断。若为 HDR 则采用 HDR 播放模式，若不是则采用 SDR 播放模式。

// 在 prepare 成功时调用，判断播放源是否为 HDR
public void onPrepared(TTVideoEngine engine) {
    // 1 : 是；0 否。
    int isHDRSource = ttVideoEngine.getIntOption(PLAYER_OPTION_IS_HDR_SOURCE); 
}

播放 HDR 源时选择展示 HDR 或 SDR 效果

展示 HDR 效果

// 设置 HDR 播放源
ttVideoEngine.setStrategySource(source);

ttVideoEngine.setIntOption(PLAYER_OPTION_SKIP_FIND_STREAM_INFO, 0); //检测头信息
ttVideoEngine.setIntOption(PLAYER_OPTION_ENABLE_HDR_AUTOMATIC_IDENTIFICATION, 1); // HDR 自动检测
ttVideoEngine.setIntOption(PLAYER_OPTION_PREFER_BIT_DEPTH, 10);// 设置 10bit 位深
ttVideoEngine.setIntOption(PLAYER_OPTION_ENABLE_SET_HDRINFO_TO_TEXTURERENDER, 0 ); // 不设置 HDR 信息给 textureRender
ttVideoEngine.setIntOption(PLAYER_OPTION_ENABLE_HARDWARE_DECODE, 1); //使用硬解码
ttVideoEngine.setIntOption(PLAYER_OPTION_ENABLE_FALLBACK_SW_DEC, 0);// 禁止回退到软解

// 必须使用 surfaceView 进行渲染，才能展示 HDR 效果
ttVideoEngine.setSurfaceHolder(mVideoView.getHolder());
// 播放，此时是 HDR 展示效果
ttVideoEngine.play();

展示 SDR 效果

// 设置 HDR 播放源
ttVideoEngine.setStrategySource(source);

ttVideoEngine.setIntOption(PLAYER_OPTION_SKIP_FIND_STREAM_INFO, 0); //检测头信息
ttVideoEngine.setIntOption(PLAYER_OPTION_ENABLE_HDR_AUTOMATIC_IDENTIFICATION, 1);// HDR 自动检测
ttVideoEngine.setIntOption(PLAYER_OPTION_PREFER_BIT_DEPTH, 10);//设置 10bit 位深
ttVideoEngine.setIntOption(PLAYER_OPTION_ENABLE_SET_HDRINFO_TO_TEXTURERENDER, 0); //不设置 HDR 信息给 textureRender
ttVideoEngine.setIntOption(PLAYER_OPTION_ENABLE_HARDWARE_DECODE, 1); //使用硬解码
ttVideoEngine.setIntOption(PLAYER_OPTION_ENABLE_FALLBACK_SW_DEC, 0); // 禁止回退到软解
ttVideoEngine.setIntOption(PLAYER_OPTION_USE_TEXTURE_RENDER, 1); // 打开TEXTURERENDER

// 使用 surfaceView 进行渲染
ttVideoEngine.setSurfaceHolder(mVideoView.getHolder());
// 播放，此时是 SDR 展示效果
ttVideoEngine.play();

播放过程中切换 HDR 和 SDR 展示效果

// 设置 HDR 播放源
ttVideoEngine.setStrategySource(source);

ttVideoEngine.setIntOption(PLAYER_OPTION_SKIP_FIND_STREAM_INFO, 0); //检测头信息
ttVideoEngine.setIntOption(PLAYER_OPTION_ENABLE_HDR_AUTOMATIC_IDENTIFICATION, 1); // HDR 自动检测
ttVideoEngine.setIntOption(PLAYER_OPTION_PREFER_BIT_DEPTH, 10); // 设置10bit 位深
ttVideoEngine.setIntOption(PLAYER_OPTION_ENABLE_SET_HDRINFO_TO_TEXTURERENDER, 0); // 不设置 HDR 信息给 textureRender
ttVideoEngine.setIntOption(PLAYER_OPTION_ENABLE_HARDWARE_DECODE, 1); //使用硬解码
ttVideoEngine.setIntOption(PLAYER_OPTION_ENABLE_FALLBACK_SW_DEC, 0);// 禁止回退到软解
// 注意，如果设备不支持 HDR，需要打开软解回退，以保证能正常播放
// ttVideoEngine.setIntOption(PLAYER_OPTION_ENABLE_FALLBACK_SW_DEC, 1);

// 使用 surfaceView 进行渲染, 需要保证 SurfaceView 的宽高比跟视频的一致，否则可能出现画面拉伸问题
ttVideoEngine.setSurfaceHolder(mVideoView.getHolder());
// 播放
ttvideoEngine.play();

// 从 HDR 效果展示切换到 SDR 效果展示
ttVideoEngine.setIntOption(PLAYER_OPTION_USE_TEXTURE_RENDER, 1);
// 从 SDR 展示切换到 HDR 效果播放
//ttVideoEngine.setSurfaceHolder(null);
//ttVideoEngine.setIntOption(PLAYER_OPTION_USE_TEXTURE_RENDER, 0);
//ttVideoEngine.setSurfaceHolder(mSurfaceView.getHolder());

判断当前播放是否是 HDR 展示

// 在首帧渲染之后调用，判断当次播放是否为 HDR 展示
public void onFirstAVSyncFrame(TTVideoEngine engine) {
    // 1 : 是; 0 否。
    int isHDRPlay = ttVideoEngine.getIntOption(PLAYER_OPTION_IS_PLAY_HDR_MODE); 
}

参考信息

HDR 档位枚举