HDR功能接入

更新时间：2025-08-22

接入准备

接入HDR功能，需要使用播放器SDK高级版，并申请高级版License。

功能介绍

在高级版SDK中，提供了HDR视频的解码和渲染能力，能够让HDR视频在高低端机型上都得到正确的色彩呈现。其中解码能力由播放内核原生支持，渲染能力由HDRKit组件和VideoProcessor组件提供，请确保该组件已集成到你的APP中。

SDK当前支持的HDR标准有：HDR10、HLG、HDR Vivid。

Demo体验

快速开始

初始化设备HDR能力信息和HDRKit组件

                Java
                
            

                // 查询设备HDR能力信息
HdrInfo.initHDRDeviceInfo(mAppContext);
mHdrKit = new HdrKit();
// 需要传入您申请的高级版证书LicenseID，ID可以在百度智能云控制台(https://console.bce.baidu.com/bvc/#/bvc/player-license/list)查看
mHdrKit.init(mAppContext, "your-license-id");
            

设置输出surface和输入surface，典型场景是在onSurfaceCreated回调中进行设置

                Java
                
                // 设置目标surface，HDR处理后的内容将渲染到此surface上
mHdrKit.prepareWithTargetSurface(mSurfaceholder.getSurface());
// 获取输入surface, 将原始画面渲染到此surface上
mMediaPlayer.setSurface(mHdrKit.getInputSurface());

渲染参数设置

                Java
                
            

                // 设置输入画面宽高
mHdrKit.setInputSize(mSurfaceWidth, mSurfaceHeight);
// 设置渲染输出宽高
mHdrKit.setOutputSize(mSurfaceWidth, mSurfaceHeight);
// 设置输入视频的HDR标准，默认为HDR10
mHdrKit.setInputVideoContentType(HdrKit.ContentType.VIVID);
// 设置是否自动调节屏幕亮度，默认开启。
mHdrKit.setEnableBrightAdjust(true);
            

HDR元数据设置

                Java
                
            

                播放器提供了HDR10/HLG静态元数据和HDR Vivid动态元数据的回调
// 静态元数据回调
public boolean onHdrStaticMetadata(IMediaPlayer mp, int metadataType, byte[] metadata) 
// 动态元数据回调
public boolean onVividMetadata(IMediaPlayer mp, byte[] metadata)
在这两个回调中，可以相应地将元数据设置给HDRKit组件
// 设置静态元数据
mHdrKit.setHdrStaticMetadata(metadataType, metadata);
// 设置动态元数据
mHdrKit.setVividMetadata(metadata);
            

开始渲染，典型场景是随播放器的start调用

                Java
                
                // 开始渲染到目标surface
mHdrKit.startRenderFromSurface();

释放，典型场景是随播放器的release调用

                Java
                
                // 销毁，如果要重新使用，则需要重新init
mHdrKit.release();

高级用法

HDRKit组件除了可以用surface作为输入输出之外，还可以用纹理id作为输入输出，使用纹理ID时需使用如下的接口

                Java
                
            

                // 设置输入纹理id, 该id对应的是未处理的视频，HDR处理后的内容将渲染到指定的输出纹理id或屏幕上
mHdrKit.prepareWithInputTexId(texid);
// 设置输出纹理id，如果不调用，则直接渲染到屏幕
mHdrKit.setOutputTexId(outputTexId)
// 开始基于输入纹理id的渲染，调用一次，渲染一帧。典型场景是在GLSurfaceView的onDrawFrame中调用
mHdrKit.drawFrameFromTexId()
            

在播放器SDK Demo中的BDCloudVideoView类对上述流程有详细的展示，可以参考。

接口说明

HDRKit类

枚举成员	描述
ContentType.HDR10	HDR10标准视频
ContentType.HLG	HLG标准视频
ContentType.VIVID	HDR Vivid标准视频
ContentType.SDR	SDR视频

接口名	描述
void init(Context context, String appID)	初始化，鉴权失败时会抛出异常
void release()	销毁。如果要重新使用，则需要重新调用init
int getState()	获取HDRKit当前状态
void setInputVideoContentType(ContentType contentType)	输入视频的hdr类型，默认为HDR10
void setInputSize(int inputWidth, int inputHeight)	输入画面宽高。必须在prepareWithTargetSurface或prepareWithInputTexId之后调用，否则抛出异常。
void setOutputSize(int outputWidth, int outputHeight)	渲染输出宽高。必须在prepareWithTargetSurface或prepareWithInputTexId之后调用，否则抛出异常。
void setHdrStaticMetadata(int metadataType, byte[] metadata)	传入HDR静态元数据。 metadataType 为SEI_MASTERING_DISPLAY_COLOUR_VOLUME(137)或SEI_CONTENT_LIGHT_LEVEL(144)
void setVividMetadata(byte[] metadata)	传入HDR Vivid动态元数据
void setEnableBrightAdjust(boolean enable)	是否开启自动亮度调节
boolean getEnableBrightAdjust()	查询是否开启了自动亮度调节
void prepareWithTargetSurface(Surface surface)	设置目标surface，HDR处理后的内容将渲染到此surface上。必须在init之后调用，否则抛出异常。
Surface getInputSurface()	获取输入surface, 将原始画面渲染到此surface上。必须在prepareWithTargetSurface之后调用，否则抛出异常。
void startRenderFromSurface()	开始渲染到目标surface。必须在prepareWithTargetSurface之后调用，否则抛出异常。
void prepareWithInputTexId(int texid)	设置输入纹理id, 该id对应的是未处理的视频，HDR处理后的内容将渲染到指定的输出纹理id或屏幕上。必须在init之后调用，否则抛出异常。
void setOutputTexId(int outputTexId)	设置输出纹理id，如果不调用，则直接渲染到屏幕。必须在prepareWithInputTexId之后调用，否则抛出异常。
void drawFrameFromTexId()	开始基于输入纹理id的渲染，调用一次，渲染一帧。必须在prepareWithInputTexId之后调用，否则抛出异常。

全景声功能接入

超低延时直播功能接入

智能视频SDK VideoCreatingSDK