目录

native_avcodec_base.h

概述

声明用于音视频封装、解封装、编解码基础功能的Native API。

引用文件： <multimedia/player_framework/native_avcodec_base.h>

库： libnative_media_codecbase.so

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 9

相关模块： CodecBase

相关示例： AVCodec

汇总

[h2]结构体

名称 typedef关键字 描述
OH_AVCodecAsyncCallback OH_AVCodecAsyncCallback OH_AVCodec中所有异步回调函数指针的集合。将该结构体的实例注册到OH_AVCodec实例中，并处理回调上报的信息，以保证OH_AVCodec的正常运行。(API11废弃)
OH_AVCodecCallback OH_AVCodecCallback OH_AVCodec中所有异步回调函数指针的集合。将该结构体的实例注册到OH_AVCodec实例中，并处理回调上报的信息，以保证OH_AVCodec的正常运行。
OH_AVDataSource OH_AVDataSource 用户自定义数据源。
OH_AVDataSourceExt OH_AVDataSourceExt 用户自定义数据源，回调支持通过userData传递用户自定义数据。
NativeWindow OHNativeWindow 为图形接口定义native层对象。
OH_AVCodec OH_AVCodec 为音视频编解码接口定义native层对象。

[h2]枚举

名称 typedef关键字 描述
OH_MediaType OH_MediaType 媒体类型。
OH_AACProfile OH_AACProfile AAC档次。
OH_AVCProfile OH_AVCProfile AVC档次。
OH_HEVCProfile OH_HEVCProfile HEVC档次。
OH_VVCProfile OH_VVCProfile VVC档次。
OH_MPEG2Profile OH_MPEG2Profile MPEG2档次。
OH_MPEG4Profile OH_MPEG4Profile MPEG4档次。
OH_H263Profile OH_H263Profile H.263档次。
OH_VC1Profile OH_VC1Profile VC-1档次。
OH_AV1Profile OH_AV1Profile AV1档次。
OH_VP9Profile OH_VP9Profile VP9档次。
OH_WVC1Profile OH_WVC1Profile WVC1档次。
OH_WMV3Profile OH_WMV3Profile WMV3档次。
OH_AVOutputFormat OH_AVOutputFormat 封装器支持的输出文件格式。
OH_AVSeekMode OH_AVSeekMode 跳转模式。
OH_ScalingMode OH_ScalingMode 缩放模式，只在Surface模式下使用。(API14废弃)
OH_BitsPerSample OH_BitsPerSample 每个编码样本的音频位数。
OH_ColorPrimary OH_ColorPrimary 色域。编解码都支持。
OH_TransferCharacteristic OH_TransferCharacteristic 转移特性。编解码都支持。
OH_MatrixCoefficient OH_MatrixCoefficient 矩阵系数。编解码都支持。
OH_AVCLevel OH_AVCLevel AVC级别。
OH_HEVCLevel OH_HEVCLevel HEVC级别。
OH_VVCLevel OH_VVCLevel VVC级别。
OH_MPEG2Level OH_MPEG2Level MPEG2级别。
OH_MPEG4Level OH_MPEG4Level MPEG4级别。
OH_H263Level OH_H263Level H.263级别。
OH_VC1Level OH_VC1Level VC-1级别。
OH_AV1Level OH_AV1Level AV1级别。
OH_VP9Level OH_VP9Level VP9级别。
OH_WVC1Level OH_WVC1Level WVC1级别。
OH_WMV3Level OH_WMV3Level WMV3级别。
OH_TemporalGopReferenceMode OH_TemporalGopReferenceMode 时域图片组参考模式。
OH_BitrateMode OH_BitrateMode 编码器的比特率模式。
OH_FrameRetentionMode OH_FrameRetentionMode 视频解码帧保留模式。
OH_AudioEncoderPTSMode OH_AudioEncoderPTSMode 音频编码器PTS模式。

[h2]函数

名称 typedef关键字 描述
typedef void (*OH_AVCodecOnError)(OH_AVCodec *codec, int32_t errorCode, void *userData) OH_AVCodecOnError 当OH_AVCodec实例运行出错时，会调用来上报具体的错误信息的函数指针。
typedef void (*OH_AVCodecOnStreamChanged)(OH_AVCodec *codec, OH_AVFormat *format, void *userData) OH_AVCodecOnStreamChanged

当视频解码输入码流分辨率或者视频编码输出码流的分辨率发生变化时，调用此函数指针报告新的流描述信息。

从API version 15开始，支持音频解码时，码流采样率、声道数或者音频采样格式发生变化时，将调用此函数指针报告新的流描述信息，支持检测此变化的解码格式有：Audio Vivid，AAC，FLAC，MP3，VORBIS。

需要注意的是，OH_AVFormat指针的生命周期只有在函数指针被调用时才有效，调用结束后禁止继续访问。
typedef void (*OH_AVCodecOnNeedInputData)(OH_AVCodec *codec, uint32_t index, OH_AVMemory *data, void *userData) OH_AVCodecOnNeedInputData 当OH_AVCodec在运行过程中需要新的输入数据时，将调用此函数指针，并携带可用的缓冲区来填充新的输入数据。(API11废弃)
typedef void (*OH_AVCodecOnNewOutputData)(OH_AVCodec *codec, uint32_t index, OH_AVMemory *data, OH_AVCodecBufferAttr *attr, void *userData) OH_AVCodecOnNewOutputData 当OH_AVCodec运行过程中生成新的输出数据时，将调用此函数指针，并携带包含新输出数据的缓冲区。需要注意的是，OH_AVCodecBufferAttr指针的生命周期仅在调用函数指针时有效，这将禁止调用结束后继续访问。(API11废弃)
typedef void (*OH_AVCodecOnNeedInputBuffer)(OH_AVCodec *codec, uint32_t index, OH_AVBuffer *buffer, void *userData) OH_AVCodecOnNeedInputBuffer 当OH_AVCodec在运行过程中需要新的输入数据时，将调用此函数指针，并携带可用的缓冲区来填充新的输入数据。
typedef void (*OH_AVCodecOnNewOutputBuffer)(OH_AVCodec *codec, uint32_t index, OH_AVBuffer *buffer, void *userData) OH_AVCodecOnNewOutputBuffer 当OH_AVCodec运行过程中生成新的输出数据时，将调用此函数指针，并携带包含新输出数据的缓冲区。
typedef int32_t (*OH_AVDataSourceReadAt)(OH_AVBuffer *data, int32_t length, int64_t pos) OH_AVDataSourceReadAt 函数指针定义，用于提供获取用户自定义媒体数据的能力。
typedef int32_t (*OH_AVDataSourceReadAtExt)(OH_AVBuffer *data, int32_t length, int64_t pos, void *userData) OH_AVDataSourceReadAtExt 函数指针定义，用于提供获取用户自定义媒体数据的能力。

[h2]变量

名称 描述
const char * OH_AVCODEC_MIMETYPE_VIDEO_AVC

AVC(H.264)视频编解码器的MIME类型。

起始版本： 9

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_AUDIO_AAC

AAC音频编解码器的MIME类型。

起始版本： 9

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_AUDIO_FLAC

FLAC音频编解码器的MIME类型。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_AUDIO_VORBIS

VORBIS音频解码器的MIME类型。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_AUDIO_MPEG

MP3音频编解码器的MIME类型。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_VIDEO_HEVC

HEVC(H.265)视频编解码器的MIME类型。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_VIDEO_MPEG4

MPEG4视频编码的MIME类型，仅用于封装MPEG4视频码流使用。

起始版本： 10

废弃版本： 11

替代接口： OH_AVCODEC_MIMETYPE_VIDEO_MPEG4_PART2

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_VIDEO_MPEG4_PART2

视频MPEG4 Part2编解码器的MIME类型。

起始版本： 17

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_VIDEO_MPEG2

视频MPEG2编解码器的MIME类型。

起始版本： 17

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_VIDEO_H263

H.263视频编解码器的MIME类型。

起始版本： 17

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_VIDEO_VC1

VC-1视频编解码器的MIME类型。

起始版本： 22

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_VIDEO_AV1

AV1视频编解码器的MIME类型。

起始版本： 23
const char * OH_AVCODEC_MIMETYPE_VIDEO_VP9

VP9视频编解码器的MIME类型。

起始版本： 23
const char * OH_AVCODEC_MIMETYPE_VIDEO_VP8

VP8视频编解码器的MIME类型。

起始版本： 23
const char * OH_AVCODEC_MIMETYPE_VIDEO_RV30

RV30视频编解码器的MIME类型。

起始版本： 23
const char * OH_AVCODEC_MIMETYPE_VIDEO_RV40

RV40视频编解码器的MIME类型。

起始版本： 23
const char * OH_AVCODEC_MIMETYPE_VIDEO_WVC1

WVC1视频编解码器的MIME类型。

起始版本： 23
const char * OH_AVCODEC_MIMETYPE_VIDEO_DVVIDEO

DVVIDEO（Digital Video）视频编解码器的MIME类型。支持DV NTSC、DV PAL与DVCPRO HD。

起始版本： 23
const char * OH_AVCODEC_MIMETYPE_VIDEO_RAWVIDEO

RAWVIDEO视频编解码器的MIME类型。

起始版本： 23
const char * OH_AVCODEC_MIMETYPE_VIDEO_MPEG1

MPEG1视频编解码器的MIME类型。

起始版本： 23
const char * OH_AVCODEC_MIMETYPE_VIDEO_CINEPAK

Cinepak视频编解码器的MIME类型。

起始版本： 24
const char * OH_AVCODEC_MIMETYPE_VIDEO_MSVIDEO1

MSVIDEO1（Microsoft Video 1）视频编解码器的MIME类型。

起始版本： 22

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_VIDEO_WMV3

WMV3视频编解码器的MIME类型。

起始版本： 22

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_VIDEO_MJPEG

MJPEG（Motion JPEG）视频编解码器的MIME类型。

起始版本： 22

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_IMAGE_JPG

JPG图片编码的MIME类型，仅用于封装JPG封面时使用。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_IMAGE_PNG

PNG图片编码的MIME类型，仅用于封装PNG封面时使用。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_IMAGE_BMP

BMP图片编码的MIME类型，仅用于封装BMP封面时使用。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_AUDIO_VIVID

Audio Vivid音频解码器的MIME类型。

起始版本： 11

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_AUDIO_AMR_NB

AMR_NB音频编解码器的MIME类型。

起始版本： 11

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_AUDIO_AMR_WB

AMR_WB音频编解码器的MIME类型。

起始版本： 11

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_AUDIO_OPUS

OPUS音频编解码器的MIME类型。

起始版本： 11

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_AUDIO_G711MU

G711MU音频编解码器的MIME类型。

起始版本： 11

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_AUDIO_ALAC

ALAC（Apple Lossless Audio Codec）音频解码器的MIME类型。

起始版本： 22
const char * OH_AVCODEC_MIMETYPE_AUDIO_AC3

AC3（Dolby Audio Coding 3）音频解码器的MIME类型。

起始版本： 22
const char * OH_AVCODEC_MIMETYPE_AUDIO_EAC3

EAC3（Enhanced AC-3）音频解码器的MIME类型。

起始版本： 22
const char * OH_AVCODEC_MIMETYPE_AUDIO_WMAV1

WMA（Windows Media Audio）V1音频解码器的MIME类型。

起始版本： 22
const char * OH_AVCODEC_MIMETYPE_AUDIO_WMAV2

WMA（Windows Media Audio）V2音频解码器的MIME类型。

起始版本： 22
const char * OH_AVCODEC_MIMETYPE_AUDIO_WMAPRO

WMA（Windows Media Audio）Pro音频解码器的MIME类型。

起始版本： 22
const char * OH_MD_KEY_BLOCK_ALIGN

划分音频数据块大小的键，单位为字节，值类型为int32_t。该键仅用于WMA（V1、V2、PRO）解码器。

允许的MIME类型包括OH_AVCODEC_MIMETYPE_AUDIO_WMAV1，OH_AVCODEC_MIMETYPE_AUDIO_WMAV2和OH_AVCODEC_MIMETYPE_AUDIO_WMAPRO。

起始版本： 22
const char * OH_AVCODEC_MIMETYPE_AUDIO_GSM

GSM（Global System for Mobile Communications）音频解码器的MIME类型。

起始版本： 22
const char * OH_AVCODEC_MIMETYPE_AUDIO_GSM_MS

GSM MS（Microsoft variant）音频解码器的MIME类型。

起始版本： 22
const char * OH_AVCODEC_MIMETYPE_AUDIO_TWINVQ

TWINVQ（Transform-domain Weighted Interleave Vector Quantization）音频解码器的MIME类型。

起始版本： 23
const char * OH_AVCODEC_MIMETYPE_AUDIO_ILBC

ILBC（Internet Low Bitrate Codec） 音频解码器的MIME类型。

起始版本： 23
const char * OH_AVCODEC_MIMETYPE_AUDIO_TRUEHD

TRUEHD（True High Definition）音频解码器的MIME类型。

起始版本： 23
const char * OH_AVCODEC_MIMETYPE_VIDEO_VVC

VVC(H.266)视频编解码器的MIME类型。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_AUDIO_APE

APE音频解码器的MIME类型。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_SUBTITLE_SRT

SRT字幕解封装器的MIME类型。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_SUBTITLE_WEBVTT

WEBVTT字幕解封装器的MIME类型。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_AUDIO_RAW

RAW音频码流的MIME类型。

起始版本： 18

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_AUDIO_G711A

G711A音频解码器的MIME类型。

起始版本： 20

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_AUDIO_COOK

COOK（RealAudio Cook）音频解码器的MIME类型。

起始版本： 23

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_AUDIO_DTS

DTS（Digital Theater Systems）音频解码器的MIME类型。

起始版本： 23

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_AVCODEC_MIMETYPE_AUDIO_DVAUDIO

DVAUDIO（Digital Video Audio）音频解码器的MIME类型。

起始版本： 23

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_ED_KEY_TIME_STAMP

表示surfacebuffer时间戳的键，值类型为int64_t。

起始版本： 9

废弃版本： 14

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_ED_KEY_EOS

表示surfacebuffer流结束符的键，值类型为int32_t。

起始版本： 9

废弃版本： 14

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_TRACK_TYPE

轨道媒体类型的键，值类型为int32_t，请参见OH_MediaType。

起始版本： 9

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_CODEC_MIME

编解码器MIME类型的键，值类型为char *。

起始版本： 9

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_DURATION

媒体文件持续时间的键，单位为微秒，值类型为int64_t。

起始版本： 9

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_BITRATE

比特率的键，单位为bps，值类型为int64_t。可以通过能力查询接口OH_AVCapability_GetEncoderBitrateRange接口来获取取值范围。

起始版本： 9

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_MAX_INPUT_SIZE

设置解码输入码流大小最大值的键，值类型为int32_t。

起始版本： 9

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_WIDTH

视频宽度的键，值类型为int32_t。

对于视频编码，该键用于设置目标编码分辨率。对于视频解码，该键是解码器预分配内部缓冲区的分辨率提示。实际解码输出尺寸由OH_MD_KEY_VIDEO_PIC_WIDTH提供。

虽然该键主要用于控制内存分配，但可参考OH_AVCapability_GetVideoWidthRange获取推荐值范围，该接口定义了编解码器支持的解码宽度范围。

起始版本： 9

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_HEIGHT

视频高度键，值类型为int32_t。

对于视频编码，该键用于设置目标编码分辨率。对于视频解码，该键是解码器预分配内部缓冲区的分辨率提示。实际解码输出尺寸由OH_MD_KEY_VIDEO_PIC_HEIGHT提供。

虽然该键主要用于控制内存分配，但可参考OH_AVCapability_GetVideoHeightRange获取推荐值范围，该接口定义了编解码器支持的解码高度范围。

起始版本： 9

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_PIXEL_FORMAT

视频像素格式的键，值类型为int32_t，请参见OH_AVPixelFormat。

起始版本： 9

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_AUDIO_SAMPLE_FORMAT

音频原始格式的键，值类型为int32_t，请参见OH_BitsPerSample。

起始版本： 9

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_FRAME_RATE

视频帧率的键，值类型为double。该值必须大于 0。可以通过能力查询接口OH_AVCapability_GetVideoFrameRateRange来获取取值范围。

起始版本： 9

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE

视频编码码率模式，值类型为int32_t，请参见OH_BitrateMode。

起始版本： 9

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_PROFILE

编码档次，值类型为int32_t，请参见OH_AVCProfile、OH_HEVCProfile、OH_AACProfile。可以通过能力查询接口OH_AVCapability_GetSupportedProfiles来获取支持的档次。

起始版本： 9

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_AUD_CHANNEL_COUNT

音频通道计数键，值类型为int32_t。

起始版本： 9

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_AUD_SAMPLE_RATE

音频采样率键，值类型为int32_t。

起始版本： 9

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_I_FRAME_INTERVAL

关键帧间隔的键，值类型为int32_t，单位为ms。该键是可选的且只用于视频编码。

负值表示只有第一帧是关键帧，0表示所有帧都是关键帧，正值表示每(frameRate * 设置值)/1000帧一个关键帧。默认值为1000。

起始版本： 9

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_ROTATION

surface旋转角度的键，旋转方向为顺时针。值类型为int32_t，值为{0, 90, 180, 270}，默认值为0。

该键只在视频解码Surface模式下使用。

设置视频解码surface模式旋转时，推荐使用OH_MD_KEY_VIDEO_TRANSFORM_TYPE键。

起始版本： 9

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_TRANSFORM_TYPE

视频翻转角度的键，值类型为int32_t，请参见OH_NativeBuffer_TransformType。

此键用于设置视频解码surface模式的翻转角度。若未指定，默认值为0 (NATIVEBUFFER_ROTATE_NONE)。

此键与OH_MD_KEY_ROTATION互斥。若两者同时设置，以OH_MD_KEY_VIDEO_TRANSFORM_TYPE为准，推荐使用OH_MD_KEY_VIDEO_TRANSFORM_TYPE键。

注意：OH_NativeBuffer_TransformType中指定的角度表示逆时针旋转，这与OH_MD_KEY_ROTATION定义的旋转方向相反。

对应关系如下:

- NATIVEBUFFER_ROTATE_NONE等同于OH_MD_KEY_ROTATION = 0。

- NATIVEBUFFER_ROTATE_90等同于OH_MD_KEY_ROTATION = 270。

- NATIVEBUFFER_ROTATE_180等同于OH_MD_KEY_ROTATION = 180。

- NATIVEBUFFER_ROTATE_270等同于OH_MD_KEY_ROTATION = 90。

起始版本： 22
const char * OH_MD_KEY_RANGE_FLAG

视频YUV值域标志的键，值类型为int32_t，1表示full range，0表示limited range，默认值为0。配置非0值将按照配置1处理，表示full range。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_COLOR_PRIMARIES

视频色域的键，值类型为int32_t，默认值为COLOR_PRIMARY_UNSPECIFIED。请参见OH_ColorPrimary，遵循H.273标准Table2。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_TRANSFER_CHARACTERISTICS

视频传递函数的键，值类型为int32_t，默认值为TRANSFER_CHARACTERISTIC_UNSPECIFIED。请参见OH_TransferCharacteristic，遵循H.273标准Table3。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_MATRIX_COEFFICIENTS

视频矩阵系数的键，值类型为int32_t，默认值为MATRIX_COEFFICIENT_UNSPECIFIED。请参见OH_MatrixCoefficient，遵循H.273标准Table4。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_REQUEST_I_FRAME

请求立即编码I帧的键。值类型为int32_t。在调用OH_VideoEncoder_SetParameter阶段使用，或随帧立即生效。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_QUALITY

所需编码质量的键。值类型为int32_t，默认值为50。在H.264、H.265编码场景值范围可以通过能力查询接口OH_AVCapability_GetEncoderQualityRange来获取取值范围，此键仅适用于配置在恒定质量模式下的编码器。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_CODEC_CONFIG

编解码器特定数据的键，视频中表示传递SPS/PPS，音频中表示传递extraData，值类型为uint8_t*。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_TITLE

媒体文件标题的键，值类型为char *。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_ARTIST

媒体文件艺术家的键，值类型为char *。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_ALBUM

专辑的媒体文件的键，值类型为char *。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_ALBUM_ARTIST

专辑艺术家的键，值类型为char *。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_DATE

媒体文件日期的键，值类型为char *，例如2024年。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_COMMENT

媒体文件注释的键，值类型为char *。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_ENABLE_MOOV_FRONT

媒体文件moov元数据是否前置标志，值类型为int32_t, 1表示前置， 0表示不前置, 默认为0。

起始版本： 20

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_GENRE

媒体文件流派的键，值类型为char *。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_COPYRIGHT

媒体文件版权的键，值类型为char *。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_LANGUAGE

媒体文件语言的键，值类型为char *。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_DESCRIPTION

媒体文件描述的键，值类型为char *。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_LYRICS

媒体文件歌词的键，值类型为char *。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_TRACK_COUNT

媒体文件轨道数量的键，值类型为int32_t。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_CHANNEL_LAYOUT

所需编码通道布局的键。值类型为int64_t，此键仅适用于编码器。请参见OH_AudioChannelLayout。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_BITS_PER_CODED_SAMPLE

每个编码样本位数的键，值类型为int32_t。

API version 20前，FLAC编码必须设置此参数，设置为1即可；未设置此参数配置FLAC编码器时，调用OH_AudioCodec_Configure会返回错误码AV_ERR_INVALID_VAL。该值无实际作用，不会影响编码结果。

从API version 20开始，无需设置此参数。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_AAC_IS_ADTS

aac格式的键，aac格式分为ADTS格式和LATM格式。值类型为int32_t，0表示LATM格式，1表示ADTS格式。aac解码器支持。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_SBR

aac sbr模式的键，值类型为int32_t，aac编码器支持。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_COMPLIANCE_LEVEL

flac兼容性等级的键，值类型为int32_t，仅在音频编码使用。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_IDENTIFICATION_HEADER

vorbis标识头的键，值类型为uint8_t*，仅vorbis解码器支持。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_SETUP_HEADER

vorbis设置头的键，值类型为uint8_t*，仅vorbis解码器支持。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_SCALING_MODE

视频缩放模式，值类型为int32_t，请参见OH_ScalingMode。

建议直接调用OH_NativeWindow_NativeWindowSetScalingModeV2接口进行设置。该键是可选的且只用于视频解码Surface模式。

起始版本： 10

废弃版本： 14

替代接口： OH_NativeWindow_NativeWindowSetScalingModeV2

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_MAX_INPUT_BUFFER_COUNT

最大输入缓冲区个数的键，值类型为int32_t。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_MAX_OUTPUT_BUFFER_COUNT

最大输出缓冲区个数的键，值类型int32_t。

起始版本： 10

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_AUDIO_COMPRESSION_LEVEL

音频编解码压缩水平的键，只在音频编码使用，值类型为int32_t。

起始版本： 11

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_IS_HDR_VIVID

媒体文件中的视频轨是否为HDR Vivid的键，支持封装和解封装，值类型为int32_t。

1表示是HDR Vivid视频轨，0表示不是HDR Vivid视频轨。

起始版本： 11

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_AUDIO_OBJECT_NUMBER

音频对象数目的键。值类型为int32_t，该键是可选的且仅用于Audio Vivid编解码器。

起始版本： 11

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_AUDIO_VIVID_METADATA

Audio Vivid元数据的键，值类型为uint8_t*，该键是可选的且仅用于Audio Vivid编解码器。

起始版本： 11

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_FEATURE_PROPERTY_KEY_VIDEO_ENCODER_MAX_LTR_FRAME_COUNT

在视频编码中获取长期参考帧的最大个数的键，值类型为int32_t。

可以通过OH_AVCapability_GetFeatureProperties接口和枚举值OH_AVCapabilityFeature中的VIDEO_ENCODER_LONG_TERM_REFERENCE来查询这个最大值。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_ENCODER_ENABLE_TEMPORAL_SCALABILITY

使能分层编码的键，值类型为int32_t，1表示使能，0表示不使能，默认值为0。配置非0值将按照配置1处理，表示使能。

使用前可以通过OH_AVCapability_IsFeatureSupported接口和枚举值OH_AVCapabilityFeature中的VIDEO_ENCODER_TEMPORAL_SCALABILITY来查询当前视频编码器是否支持分层编码。

详情请参见：时域可分层视频编码。

该键是可选的且只用于视频编码，在Configure阶段使用。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_ENCODER_TEMPORAL_GOP_SIZE

描述图片组基本层图片的间隔大小的键，值类型为int32_t，只在使能分层编码时生效。

该键是可选的且只用于视频编码，在Configure阶段使用。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_ENCODER_TEMPORAL_GOP_REFERENCE_MODE

描述图片组内参考模式的键，值类型为int32_t，请参见OH_TemporalGopReferenceMode，只在使能分层编码时生效。

该键是可选的且只用于视频编码，在Configure阶段使用。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_ENCODER_TEMPORAL_LAYER_ID

描述图像组（GOP）内的时域层号ID键，数据类型为int32_t。

时域层号为0时，表示基础层，1及以上时表示增强层，最大时域层号与OH_MD_KEY_VIDEO_ENCODER_TEMPORAL_GOP_REFERENCE_MODE参数和OH_MD_KEY_VIDEO_ENCODER_TEMPORAL_GOP_SIZE参数相关。

该键目前仅用于查询编码器输出的AVBuffer中携带的时域层号。

使用流程如下：

1. 通过OH_AVCodecOnNewOutputBuffer接口或OH_VideoEncoder_GetOutputBuffer获取缓冲区实例（AVBuffer）。

2. 通过OH_AVBuffer_GetParameter获取除基础属性外的其他参数实例（OH_AVFormat）。

3. 通过OH_AVFormat_GetIntValue接口和本键获取对应帧的时域层号。

起始版本： 26.0.0
const char * OH_MD_KEY_VIDEO_ENCODER_LTR_FRAME_COUNT

描述长期参考帧个数的键，值类型为int32_t，必须在支持的值范围内使用。

使用前可以通过OH_AVCapability_GetFeatureProperties接口和枚举值OH_AVCapabilityFeature中的VIDEO_ENCODER_LONG_TERM_REFERENCE来查询支持的LTR数目。

该键是可选的且只用于视频编码，在Configure阶段使用。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_ENCODER_PER_FRAME_MARK_LTR

标记当前帧为长期参考帧的键，值类型为int32_t，1表示被标记，0表示未被标记，默认值为0。配置非0值将按照配置1处理，表示被标记。

只在长期参考帧个数被配置后生效。

该键是可选的且只用于视频编码输入轮转中，配置后立即生效。

详情请参见：时域可分层视频编码。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_ENCODER_PER_FRAME_USE_LTR

描述当前帧参考的长期参考帧POC号的键，值类型为int32_t。

该键是可选的且只用于视频编码输入轮转中，配置后立即生效。

详情请参见：时域可分层视频编码。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_PER_FRAME_IS_LTR

当前OH_AVBuffer中输出的码流对应的帧是否为长期参考帧的键，值类型为int32_t，1表示是LTR，0表示不是LTR，默认值为0。配置非0值将按照配置1处理，表示是LTR。

该键是可选的且只用于视频编码输出轮转中。

表示帧的属性。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_PER_FRAME_POC

描述帧的POC的键，值类型为int32_t。

该键是可选的且只用于视频编码输出轮转中。

表示帧的属性。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_CROP_TOP

描述裁剪矩形顶部坐标(y)值的键，值类型为int32_t。

包含裁剪框顶部的行，行索引从0开始。

该键只用于视频解码。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_CROP_BOTTOM

描述裁剪矩形底部坐标(y)值的键，值类型为int32_t。

包含裁剪框底部的行，行索引从0开始。

该键只用于视频解码。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_CROP_LEFT

描述裁剪矩形左坐标(x)值的键，值类型为int32_t。

包含裁剪框最左边的列，列索引从0开始。

该键只用于视频解码。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_CROP_RIGHT

描述裁剪矩形右坐标(x)值的键，值类型为int32_t。

包含裁剪框最右边的列，列索引从0开始。

该键只用于视频解码。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_STRIDE

描述视频帧宽跨距的键，值类型为int32_t。

宽跨距表示内存中相邻两行数据起始位置之间的字节距离。由于硬件对齐要求，stride通常大于或等于图像有效宽度。当stride等于width，表示无水平填充。应始终通过OH_VideoEncoder_GetInputDescription（编码）、OH_VideoDecoder_GetOutputDescription（解码）或OH_AVCodecOnStreamChanged回调中的OH_AVFormat参数获取实际跨距值，而非假设固定值。

使用示例详见视频编码Buffer模式的步骤8或者视频解码Buffer模式的步骤11。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_SLICE_HEIGHT

描述视频帧高跨距的键，值类型为int32_t。

高跨距表示内存中为单个平面分配的总行数。由于硬件对齐要求，sliceHeight通常大于或等于图像有效高度。U平面的起始地址相对于Y平面原点的偏移量为（sliceHeight * stride）。应始终通过OH_VideoEncoder_GetInputDescription（编码）、OH_VideoDecoder_GetOutputDescription（解码）或 OH_AVCodecOnStreamChanged回调中的OH_AVFormat参数获取实际高跨距值，而非假设固定值。

使用示例详见视频编码Buffer模式的步骤8或视频解码Buffer模式的步骤11。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_PIC_WIDTH

描述解码后视频帧实际有效宽度的键名。值类型为int32_t。该键为只读，仅用于视频解码。

调用OH_VideoDecoder_GetOutputDescription时，或通过OH_AVCodecOnStreamChanged回调检测到解码输出流变化时，可从返回的OH_AVFormat实例中获取该值。该值表示图像有效宽度，与Configure阶段设置的OH_MD_KEY_WIDTH不同，后者是用于预分配缓冲区的配置提示。当需要获取显示或保存图像的实际宽度时，读取该值。

图像排布和使用示例详见视频编码Buffer模式的步骤8或视频解码Buffer模式的步骤11。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_PIC_HEIGHT

描述解码后视频帧实际有效高度的键名。值类型为int32_t。该键为只读，仅用于视频解码。

调用OH_VideoDecoder_GetOutputDescription时，或通过OH_AVCodecOnStreamChanged回调检测到解码输出码流变化时，可从返回的OH_AVFormat实例中获取该值。该值表示图像有效高度，与Configure阶段设置的OH_MD_KEY_HEIGHT不同，后者是用于预分配缓冲区的配置提示。当需要获取显示或保存图像的实际高度时，读取该值。

图像排布和使用示例详见视频编码Buffer模式的步骤8或视频解码Buffer模式的步骤11。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_ENABLE_LOW_LATENCY

使能低时延视频解码的键，值类型为int32_t，1表示使能，0表示不使能，默认值为0。配置非0值将按照配置1处理，表示使能。

该键是可选的，在Configure阶段使用。

如果使能，则视频解码器持有的输入和输出数据不会超过解码器标准所要求的数量。

可以通过能力查询接口OH_AVCapability_IsFeatureSupported来查询特定解码器是否支持低时延。若解码器支持，使能此接口时，视频解码器将按照解码序输出帧。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_ENCODER_QP_MAX

描述视频编码器允许的最大量化参数的键，值类型为int32_t。

在Configure/SetParameter阶段使用，或随帧立即生效。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_ENCODER_QP_MIN

描述视频编码器允许的最小量化参数的键，值类型为int32_t。

在Configure/SetParameter阶段使用，或随帧立即生效。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_ENCODER_QP_AVERAGE

描述视频帧平均量化参数的键，值类型为int32_t。

表示当前帧编码块的平均qp值，随OH_AVBuffer输出。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_ENCODER_MSE

描述视频帧平方误差的键，值类型为double。

表示当前帧编码块的MSE统计值，随OH_AVBuffer输出。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_DECODING_TIMESTAMP

AVBuffer中携带的音视频或字幕的sample对应的解码时间戳的键，以微秒为单位，值类型为int64_t。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_BUFFER_DURATION

AVBuffer中携带的音视频或字幕的sample对应的持续时间的键，以微秒为单位，值类型为int64_t。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_SAR

样本长宽比的键，值类型为double。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_START_TIME

媒体文件中第一帧起始位置开始时间的键，以微秒为单位，值类型为int64_t。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_TRACK_START_TIME

轨道开始时间的键，以微秒为单位，值类型为int64_t。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_DECODER_OUTPUT_COLOR_SPACE

设置视频解码器输出色彩空间的键，值类型为int32_t。

支持的值为OH_COLORSPACE_BT709_LIMIT，请参见OH_NativeBuffer_ColorSpace。

在视频解码调用OH_VideoDecoder_Configure接口时使用此接口。

在启动OH_VideoDecoder_Start接口前，必须要先调用OH_VideoDecoder_Prepare接口。

如果支持色彩空间转换功能并配置了此键，则视频解码器会自动将HDR Vivid视频转码为指定的色彩空间。

如果不支持色彩空间转换功能，则接口OH_VideoDecoder_Configure返回错误码OH_AVErrCode中的AV_ERR_VIDEO_UNSUPPORTED_COLOR_SPACE_CONVERSION。如果输入视频不是HDR Vivid视频，则会通过回调函数OH_AVCodecOnError报告错误OH_AVErrCode中的AV_ERR_VIDEO_UNSUPPORTED_COLOR_SPACE_CONVERSION。

起始版本： 12

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_DECODER_OUTPUT_ENABLE_VRR

解码器是否打开视频可变帧率功能的键，值类型为int32_t。

1代表使能视频可变帧率功能，0代表不使能。

起始版本： 15

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_CREATION_TIME

媒体文件创建时间的元数据，值类型为char *。使用ISO 8601标准的时间格式且为UTC时间，时间格式参考："2024-12-28T00:00:00.000000Z"。

起始版本： 14

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_ENCODER_REPEAT_PREVIOUS_FRAME_AFTER

如果在上一帧提交给编码器之后没有新的帧可用，则会以毫秒为单位重复提交最后一帧，值类型为int32_t。

该键只用于视频编码Surface模式，在Configure阶段使用。

配置的值：

- 小于等于0：Configure阶段会被拦截，返回ERROR AV_ERR_INVALID_VAL。

- 大于0：如果在上一帧提交给编码器之后没有新的帧可用，则会以毫秒为单位重复提交最后一帧。

起始版本： 18

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_ENCODER_REPEAT_PREVIOUS_MAX_COUNT

描述编码器在没有新的帧可用的情况下，可以对之前的帧进行重复编码的最大次数，值类型为int32_t。

该键仅在OH_MD_KEY_VIDEO_ENCODER_REPEAT_PREVIOUS_FRAME_AFTER可用时生效，在Configure阶段使用。

配置的值：

- 等于0：Configure阶段会被拦截，返回ERROR AV_ERR_INVALID_VAL。

- 小于0：在没有新的帧提交给编码器的这段时间内，编码器会一直重复编上一帧，直到达到系统上限。

- 大于0：在没有新的帧提交给编码器的这段时间内，最多可以重复编码的帧数。

起始版本： 18

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_ENCODER_ENABLE_B_FRAME

使能B帧编码的键，值类型为int32_t（0或1）：1表示使能，0表示不使能。该键是可选项，仅用于视频编码器，默认值为0。

如果使能，视频编码器将使用B帧，解码顺序与显示顺序会不同。

对于不支持的平台，配置该键不会生效。

可通过OH_AVCapability_IsFeatureSupported接口和枚举值OH_AVCapabilityFeature.VIDEO_ENCODER_B_FRAME查询平台能力。

该键仅在configure阶段使用。

起始版本： 20

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_ENCODER_MAX_B_FRAMES

描述视频编码器支持的最大连续B帧数的键，值类型为int32_t。注意：该键目前仅用于查询编码器能力。

使用规范如下：

1. 通过OH_AVCapability_IsFeatureSupported接口和枚举值OH_AVCapabilityFeature.VIDEO_ENCODER_B_FRAME查询特性支持情况。

2. 通过OH_AVCapability_GetFeatureProperties接口和枚举值OH_AVCapabilityFeature.VIDEO_ENCODER_B_FRAME获取OH_AVFormat指针。

3. 通过OH_AVFormat_GetIntValue接口和本键获取最大B帧数。

起始版本： 20

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_ENCODER_ROI_PARAMS

用于设置感兴趣区域（ROI）参数的键。值类型为字符串，格式为"Top1,Left1-Bottom1,Right1[=Params1];Top2,Left2-Bottom2,Right2[=Params2];"。每个"Top,Left-Bottom,Right"代表一个ROI的坐标信息。"[=Params]"是可选的。"[=Params]"的格式随版本变化：

- 在API版本26.0.0之前：仅支持单个代表量化参数偏移量的int32_t值（例如，"=Offset"）。

- 从API版本26.0.0开始：额外支持并推荐使用键值对（Key-Value）格式。参数使用逗号分隔的键值对（例如，"=dqp:-6,slb:1"）。

支持的键包括：

- "dqp"：量化参数偏移量。

- "slb"：语义标签。

该值必须与OH_VideoMetadataRoiSemanticLabel对应。如果完全省略"=Params"，例如 "Top1,Left1-Bottom1,Right1;Top2,Left2-Bottom2,Right2=dqp:-6;"，编码器将使用默认参数对第一个ROI进行ROI编码，并使用指定的参数对第二个ROI进行编码。请注意，可同时应用的ROI数量不得超过6个，且总面积不得超过图像面积的1/5。这是一个仅适用于视频编码器的可选键，在运行过程中按帧设置并生效。在Surface模式下，它用于OH_VideoEncoder_OnNeedInputParameter。在Buffer模式下，通过OH_AVBuffer_SetParameter进行配置。

起始版本： 20

说明： 从API版本26.0.0开始，推荐使用OH_VideoMetadata_AppendRoiString来安全地转化和追加ROI配置，而不是手动拼接字符串。
const char * OH_MD_KEY_SQR_FACTOR

指定SQR码控模式的质量参数，仅支持H265（HEVC）。取值范围为[0, 51]（同编码量化参数QP），值越小，编码输出码率越大，质量越好。

在Configure/SetParameter阶段使用。

起始版本： 20

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_MAX_BITRATE

指定SQR码控模式的最大码率，仅支持H265（HEVC）。使用OH_AVCapability_GetEncoderBitrateRange方法获取取值范围（同OH_MD_KEY_BITRATE），单位bps，值类型为int64_t。

在Configure/SetParameter阶段使用。

起始版本： 20

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_ENCODER_ENABLE_PTS_BASED_RATECONTROL

使能基于显示时间戳(PTS)的码控模式的键，值类型为int32_t，1表示使能，0表示不使能，默认值为0。配置非0值将按照配置1处理，表示使能。

该键值是可选的且只用于视频编码。

如果使能，则必须在每个视频帧中携带PTS信息，并发送到编码器。Surface模式下，通过OH_NativeWindow_NativeWindowHandleOpt接口设置PTS，时间单位为纳秒(ns)；Buffer模式下，通过OH_AVBuffer_SetBufferAttr接口设置PTS，时间单位为微秒(us)。

在Configure阶段使用。

起始版本： 20

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_REFERENCE_TRACK_IDS

媒体文件轨道间参考、被参考关系，值类型为int32_t*。

起始版本： 20

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_TRACK_REFERENCE_TYPE

媒体文件辅助轨类型，值类型为char *。

起始版本： 20

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_TRACK_DESCRIPTION

媒体文件辅助轨描述信息，值类型为char *。

起始版本： 20

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_ENABLE_SYNC_MODE

使能音视频编解码同步模式的键，值类型为int32_t，1表示使能，0表示不使能，默认值为0。配置非0值将按照配置1处理，表示使能。该键是可选的。

如果使能，需要注意：

1. 编解码器不可设置回调函数。

2. 必须使用缓冲区查询接口替代回调。

3. 只能在Configure阶段使用。

起始版本： 20

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_DECODER_BLANK_FRAME_ON_SHUTDOWN

用于指定视频解码器关闭时是否输出空白帧的键，值类型为int32_t，1表示使能，0表示不使能，默认值为0。配置非0值将按照配置1处理，表示使能。该键是可选的且仅用于视频解码Surface模式。

使能后，调用OH_VideoDecoder_Stop接口或者OH_VideoDecoder_Destroy接口时，视频解码器将输出空白帧（通常为黑色）。该机制可避免因解码器突然终止导致的显示残留。

起始版本： 20

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_VIDEO_NATIVE_BUFFER_FORMAT

用于查询视频编解码中native buffer像素格式的键，值类型为int32_t。

具体取值请参见OH_NativeBuffer_Format中定义的像素格式。该键主要用于以下两种场景：

1. 视频解码：调用OH_VideoDecoder_GetOutputDescription接口或OH_AVCodecOnStreamChanged，从返回的OH_AVFormat对象中获取当前输出格式。

2. 视频编码：调用OH_VideoEncoder_GetInputDescription接口，从返回的OH_AVFormat对象中获取当前输入格式。

起始版本： 22

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_BUFFER_SKIP_SAMPLES_INFO

OH_AVBuffer中携带的键，用于跳过音频解码输出的数据。以采样点为单位，值类型为uint8_t*，当使用mp3、vorbis、opus解码器解码时，可设置该键。

仅音频的起始、末尾帧携带该键，该键是可选的。使用方法一：解封装时获取该信息并设置到解码输入的OH_AVBuffer。

1. 从OH_AVCodecCallback的回调函数OH_AVCodecOnNeedInputBuffer里获取解码用的OH_AVBuffer。

2. 调用OH_AVDemuxer_ReadSampleBuffer接口读取音频数据，该接口会自行设置OH_MD_KEY_BUFFER_SKIP_SAMPLES_INFO。

3. 调用OH_AudioCodec_PushInputBuffer输入OH_AVBuffer进行解码。

使用方法二：构造该键需要的数据并设置到解码输入的OH_AVBuffer。

开发者需要先创建一个10字节uint8_t[]类型的数组，具体结构如下：

1. 数组0~3，这4个字节表示从当前帧第一个采样点开始往后跳过的采样点数，以小端序存储uint32_t值。

2. 数组4~7，这4个字节表示从当前帧最后一个采样点开始往前跳过的采样点数（不大于1帧采样点数），以小端序存储uint32_t值。

3. 数组8~9，这2个字节填0即可。

起始版本： 23

系统能力： SystemCapability.Multimedia.Media.CodecBase
const char * OH_MD_KEY_ENABLE_BUFFER_SKIP_SAMPLES

在音频解码器中使能OH_MD_KEY_BUFFER_SKIP_SAMPLES_INFO的键，值类型为int32_t。1表示使能，0表示不使能，默认值为0。配置非1值将按照配置0处理，表示不使能。

该键是可选的。仅用于音频解码器。

起始版本： 24
const char * OH_MD_KEY_LATITUDE

纬度的键，值类型为float，范围为[-90.0, 90.0]。表示地理位置信息中的纬度。

起始版本： 24
const char * OH_MD_KEY_LONGITUDE

经度的键，值类型为float，范围为[-180.0, 180.0]。表示地理位置信息中的经度。

起始版本： 24
const char * OH_MD_KEY_ALTITUDE

海拔的键，值类型为float，该键是可选的。表示地理位置信息中的海拔。

起始版本： 24
const char * OH_MD_KEY_VIDEO_ENCODER_NUMBER_OF_PENDING_FRAMES

视频编码器待处理帧数量的键值，值类型为int32_t。该键是只读的，用于查询当前待编码帧的数量。可通过OH_VideoEncoder_GetInputDescription接口获取。

起始版本： 26.0.0
const char * OH_MD_KEY_VIDEO_DECODER_OUTPUT_IN_DECODING_ORDER

解码器输出模式的键值。值类型为int32_t，取值为0或1。1表示解码器按解码顺序输出帧；0表示解码器按显示顺序输出帧，默认值为0。该键是可选的，仅用于视频解码，且仅可在Configure阶段使用。设置该键前，可通过OH_AVCapability_IsFeatureSupported接口和枚举值OH_AVCapabilityFeature.VIDEO_DECODER_OUTPUT_IN_DECODING_ORDER查询是否支持该特性。如果视频解码不支持该特性，通过OH_VideoDecoder_Configure接口设置该键将返回AV_ERR_INVALID_VAL。

起始版本： 26.0.0
const char * OH_MD_KEY_VIDEO_ENCODER_MAX_FRAME_DELAY_COUNT

视频编码器在输出压缩帧前允许缓存的最大帧数的键值。值类型为int32_t，取值范围为[1，5]。该键是可选的，仅用于视频编码，且仅可在Configure阶段使用。取值在[1，5]区间内时可正常生效；若超出该范围（小于1或大于5），调用OH_VideoEncoder_Configure接口会返回AV_ERR_INVALID_VAL。

起始版本： 26.0.0
const char * OH_MD_KEY_VIDEO_ENCODER_REPEAT_HEADER_BEFORE_SYNC_FRAMES

码流同步帧前置参数集的键值。值类型为int32_t，取值为0或1，1表示使能，0表示不使能，默认值为0。该键是可选的，仅用于视频编码，且仅可在Configure阶段使用。开启后，编码器会在每个同步帧前插入前置参数集数据（例如H.264/H.265格式对应的SPS、PPS）。

起始版本： 26.0.0
const char * OH_MD_KEY_AUDIO_VIVID_SIGNAL_FORMAT

设置Audio Vivid输入信号格式的键，值类型为int32_t，该键仅用于Audio Vivid编码器。

具体取值请参见OH_AudioVividSignalFormat。

起始版本： 26.0.0
const char * OH_MD_KEY_AUDIO_SOUNDBED_LAYOUT

设置音频声床的通道布局的键，值类型为int64_t，该键是可选的且仅用于Audio Vivid编码器。

具体取值请参见OH_AudioChannelLayout。

起始版本： 26.0.0
const char * OH_MD_KEY_AUDIO_SOUNDBED_BITRATE

设置音频声床编码比特率的键，值类型为int64_t，该键是可选的且仅用于Audio Vivid编码器。

实际编码比特率可能会根据编码器的能力调整。

起始版本： 26.0.0
const char * OH_MD_KEY_AUDIO_OBJECT_BITRATE

设置音频对象编码比特率的键，值类型为int64_t，该键是可选的且仅用于Audio Vivid编码器。

实际编码比特率可能会根据编码器的能力调整。

起始版本： 26.0.0
const char * OH_MD_KEY_AUDIO_MAX_INPUT_BUFFER_SIZE

设置或查询音频编码器最大输入缓冲区大小的键。单位为字节（Byte），值类型为int32_t。该键用于配置或获取音频编码器输入缓冲区的最大值。实际缓冲区大小受编码器实现限制，设置超过编码器最大支持的值时不会生效。该配置为可选项，如果不设置，编码器将使用默认的缓冲区大小。

起始版本： 26.0.0
const char * OH_MD_KEY_AUDIO_ENCODER_PTS_MODE

配置音频编码器PTS（Presentation Time Stamp，显示时间戳）输出模式的键。设置PTS输出行为模式，值类型为int32_t，请参见OH_AudioEncoderPTSMode。该键为可选项，如果不设置，默认值为OH_AUDIO_ENCODER_PTS_MODE_DEFAULT。

起始版本： 26.0.0
const char * OH_MD_KEY_AUDIO_ENCODER_ENABLE_SAMPLE_FORMAT_CONVERT

使能音频编码器采样格式转换的键。值类型为int32_t，取值为0或1，1表示使能，0表示不使能，默认值为0。音频编码器仅支持有限的采样格式。使能此配置后，如果使用了不支持的采样格式，音频编码器会将采样格式转换为支持的格式后进行编码。转换前支持的采样格式如下：SAMPLE_U8、SAMPLE_S16LE、SAMPLE_S24LE、SAMPLE_S32LE、SAMPLE_F32LE。

起始版本： 26.0.0
const char * OH_MD_KEY_VIDEO_ENCODER_PREPROC_DOWNSAMPLING_WIDTH

视频编码前处理降采样目标宽度的键，值类型为int32_t。该键是可选的，降采样功能默认关闭。该键与OH_MD_KEY_VIDEO_ENCODER_PREPROC_DOWNSAMPLING_HEIGHT必须同时配置，当都设置为0时则关闭降采样功能，可以通过OH_AVCapability_IsVideoSizeSupported查询支持的降采样宽高范围。降采样参数与裁剪参数互斥，降采样功能与裁剪功能不可同时启用。

该键仅用于支持前处理的视频编码器或一入二出编码场景，可在Configure阶段配置或通过SetParameter运行时动态调整。

起始版本： 26.0.0
const char * OH_MD_KEY_VIDEO_ENCODER_PREPROC_DOWNSAMPLING_HEIGHT

视频编码前处理降采样目标高度的键，值类型为int32_t。该键是可选的，降采样功能默认关闭。该键与OH_MD_KEY_VIDEO_ENCODER_PREPROC_DOWNSAMPLING_WIDTH必须同时配置，当都设置为0时则关闭降采样功能，可以通过OH_AVCapability_IsVideoSizeSupported查询支持的降采样宽高范围。降采样参数与裁剪参数互斥，降采样功能与裁剪功能不可同时启用。

该键仅用于支持前处理的视频编码器或一入二出编码场景，可在Configure阶段配置或通过SetParameter运行时动态调整。

起始版本： 26.0.0
const char * OH_MD_KEY_VIDEO_ENCODER_PREPROC_CROP_LEFT

视频编码前处理裁剪区域左边坐标（x）的键，值类型为int32_t。该键是可选的，裁剪功能默认关闭。OH_MD_KEY_VIDEO_ENCODER_PREPROC_CROP_LEFT/TOP/RIGHT/BOTTOM 4个参数必须同时配置，当全部设置为0时则关闭裁剪功能，默认坐标原点为输入视频帧左上角(0, 0)，坐标取值不可超过输入视频帧宽高，且需满足(0, 0) <= (LEFT, TOP) < (RIGHT, BOTTOM) < (输入视频帧宽度，输入视频帧高度)。降采样参数与裁剪参数互斥，降采样功能与裁剪功能不可同时启用。

该键仅用于支持前处理的视频编码器或一入二出编码场景，可在Configure阶段配置或通过SetParameter运行时动态调整。

起始版本： 26.0.0
const char * OH_MD_KEY_VIDEO_ENCODER_PREPROC_CROP_TOP

视频编码前处理裁剪区域顶部坐标（y）的键，值类型为int32_t。该键是可选的，裁剪功能默认关闭。OH_MD_KEY_VIDEO_ENCODER_PREPROC_CROP_LEFT/TOP/RIGHT/BOTTOM 4个参数必须同时配置，当全部设置为0时则关闭裁剪功能，默认坐标原点为输入视频帧左上角(0, 0)，坐标取值不可超过输入视频帧宽高，且需满足(0, 0) <= (LEFT, TOP) < (RIGHT, BOTTOM) < (输入视频帧宽度，输入视频帧高度)。降采样参数与裁剪参数互斥，降采样功能与裁剪功能不可同时启用。

该键仅用于支持前处理的视频编码器或一入二出编码场景，可在Configure阶段配置或通过SetParameter运行时动态调整。

起始版本： 26.0.0
const char * OH_MD_KEY_VIDEO_ENCODER_PREPROC_CROP_RIGHT

视频编码前处理裁剪区域右边坐标（x）的键，值类型为int32_t。该键是可选的，裁剪功能默认关闭。OH_MD_KEY_VIDEO_ENCODER_PREPROC_CROP_LEFT/TOP/RIGHT/BOTTOM 4个参数必须同时配置，当全部设置为0时则关闭裁剪功能，默认坐标原点为输入视频帧左上角(0, 0)，坐标取值不可超过输入视频帧宽高，且需满足(0, 0) <= (LEFT, TOP) < (RIGHT, BOTTOM) < (输入视频帧宽度，输入视频帧高度)。降采样参数与裁剪参数互斥，降采样功能与裁剪功能不可同时启用。

该键仅用于支持前处理的视频编码器或一入二出编码场景，可在Configure阶段配置或通过SetParameter运行时动态调整。

起始版本： 26.0.0
const char * OH_MD_KEY_VIDEO_ENCODER_PREPROC_CROP_BOTTOM

视频编码前处理裁剪区域底部坐标（y）的键，值类型为int32_t。该键是可选的，裁剪功能默认关闭。OH_MD_KEY_VIDEO_ENCODER_PREPROC_CROP_LEFT/TOP/RIGHT/BOTTOM 4个参数必须同时配置，当全部设置为0时则关闭裁剪功能，默认坐标原点为输入视频帧左上角(0, 0)，坐标取值不可超过输入视频帧宽高，且需满足(0, 0) <= (LEFT, TOP) < (RIGHT, BOTTOM) < (输入视频帧宽度，输入视频帧高度)。降采样参数与裁剪参数互斥，降采样功能与裁剪功能不可同时启用。

该键仅用于支持前处理的视频编码器或一入二出编码场景，可在Configure阶段配置或通过SetParameter运行时动态调整。

起始版本： 26.0.0
const char * OH_MD_KEY_VIDEO_ENCODER_PREPROC_DROP_TO_FRAME_RATE

视频编码前处理丢帧目标帧率的键，值类型为double，数值精度保留2位小数。该键是可选的，丢帧功能默认关闭。当设置0.00时则关闭丢帧功能，配置值时自动四舍五入保留两位小数。可独立使用，也可与降采样或裁剪组合使用。

该键仅用于支持前处理的视频编码器或一入二出编码场景，可在Configure阶段配置或通过SetParameter运行时动态调整。

起始版本： 26.0.0
const char * OH_MD_KEY_VIDEO_DECODER_FRAME_RETENTION_MODE

设置视频解码帧保留模式的键。取值类型为int32_t。该值表示在OH_FrameRetentionMode中定义的帧保留模式。每种模式的详细说明及其行为请参考枚举定义OH_FrameRetentionMode。

可以通过OH_VideoDecoder_Configure和OH_VideoDecoder_SetParameter接口进行配置。

起始版本： 26.0.0
const char * OH_MD_KEY_VIDEO_DECODER_FRAME_RETENTION_RATIO

设置视频解码帧保留比例的键。取值类型为double。当OH_MD_KEY_VIDEO_DECODER_FRAME_RETENTION_MODE设置为OH_FRAME_RETENTION_MODE_UNIFORM时，或者未配置保留模式（隐式默认采用均匀逻辑）时，该参数生效。

仅当保留模式显式设置为OH_FRAME_RETENTION_MODE_ADAPTIVE或OH_FRAME_RETENTION_MODE_FULL时，此配置才会被忽略。

有效范围是[0.01, 1.0]（其中1.0表示保留所有帧，0.01为最小限制），任何超出此范围的值都将被视为无效并被忽略。

可以通过OH_VideoDecoder_Configure和OH_VideoDecoder_SetParameter接口进行配置。每种模式的详细说明及其行为请参考枚举定义OH_FrameRetentionMode。

起始版本： 26.0.0
const char * OH_MD_KEY_VIDEO_DECODER_SPEED

配置视频解码器播放倍速的键。取值类型为double。该键用于指定视频的目标播放倍速。主要推荐与OH_FRAME_RETENTION_MODE_ADAPTIVE模式结合使用，以辅助感知自适应算法准确评估丢帧对视觉感知的影响。

取值必须严格大于0.0，推荐的标准值包括0.5、0.75、1.0（正常速度）、1.25、1.5、2.0 和 3.0，任何小于或等于0.0的值都会被视为无效。

可以通过OH_VideoDecoder_Configure和OH_VideoDecoder_SetParameter接口进行配置。每种模式的详细说明及其行为请参考枚举定义OH_FrameRetentionMode。

起始版本： 26.0.0
const char * OH_MD_KEY_AUDIO_MAX_INPUT_BUFFER_SIZE

设置或查询音频编解码器最大输入缓冲区大小的键，值类型为int32_t，单位为字节。

该键用于配置或获取音频编解码器的最大输入缓冲区大小，实际缓冲区大小受编解码器实现限制，超出上限的值不生效。

该键是可选的。不设置时编解码器使用默认缓冲区大小。

起始版本： 26.0.0
const char * OH_MD_KEY_AUDIO_ENCODER_PTS_MODE

配置音频编码器输出PTS模式的键，值类型为int32_t，取值参见OH_AudioEncoderPTSMode。

该键是可选的，不设置时默认为OH_AUDIO_ENCODER_PTS_MODE_DEFAULT。

起始版本： 26.0.0
const char * OH_MD_KEY_AUDIO_ENCODER_ENABLE_SAMPLE_FORMAT_CONVERT

使能音频编码器采样格式转换的键，值类型为int32_t，1表示使能，0表示不使能，默认值为0。

音频编码器仅支持有限的采样格式，使能后，如果使用不支持的采样格式，编码器会将采样格式转换为支持的格式进行编码。

使能后支持的输入采样格式为：SAMPLE_U8、SAMPLE_S16LE、SAMPLE_S24LE、SAMPLE_S32LE、SAMPLE_F32LE，请参见OH_BitsPerSample。

该键是可选的，仅在音频编码Configure阶段使用。

起始版本： 26.0.0

枚举类型说明

[h2]OH_MediaType

enum OH_MediaType

描述

媒体类型。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 9

枚举项 描述
MEDIA_TYPE_AUD = 0 音频轨。
MEDIA_TYPE_VID = 1 视频轨。
MEDIA_TYPE_SUBTITLE = 2

字幕轨。

起始版本： 12
MEDIA_TYPE_TIMED_METADATA = 5

timed metadata轨。

起始版本： 20
MEDIA_TYPE_AUXILIARY = 6

辅助轨。

起始版本： 20

[h2]OH_AACProfile

enum OH_AACProfile

描述

AAC档次。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 9

枚举项 描述
AAC_PROFILE_LC = 0 AAC编码档次为Low Complexity级别。
AAC_PROFILE_HE = 3

AAC编码档次为High Efficiency级别。包含音频对象类型：AAC LC和SBR。

起始版本： 14
AAC_PROFILE_HE_V2 = 4

AAC编码档次为High Efficiency v2级别。包含音频对象类型：AAC LC、SBR和PS。

起始版本： 14

[h2]OH_AVCProfile

enum OH_AVCProfile

描述

AVC档次。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 9

枚举项 描述
AVC_PROFILE_BASELINE = 0 AVC编码档次为基本档次。
AVC_PROFILE_HIGH = 4 AVC编码档次为高档次。
AVC_PROFILE_MAIN = 8 AVC编码档次为主档次。

[h2]OH_HEVCProfile

enum OH_HEVCProfile

描述

HEVC档次。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 10

枚举项 描述
HEVC_PROFILE_MAIN = 0 HEVC编码档次为主档次。
HEVC_PROFILE_MAIN_10 = 1 HEVC编码档次为10bit主档次。
HEVC_PROFILE_MAIN_STILL = 2 HEVC编码档次为静止图像主档次。
HEVC_PROFILE_MAIN_10_HDR10 = 3

HEVC编码档次为HDR10主档次。

废弃版本： 14
HEVC_PROFILE_MAIN_10_HDR10_PLUS = 4

HEVC编码档次为HDR10+主档次。

废弃版本： 14

[h2]OH_VVCProfile

enum OH_VVCProfile

描述

VVC档次。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 15

枚举项 描述
VVC_PROFILE_MAIN_10 = 1 VVC编码档次为10bit主档次。
VVC_PROFILE_MAIN_12 = 2 VVC编码档次为12bit主档次。
VVC_PROFILE_MAIN_12_INTRA = 10 VVC编码档次为12bit帧内主档次。
VVC_PROFILE_MULTI_MAIN_10 = 17 VVC编码档次为多层编码10bit主档次。
VVC_PROFILE_MAIN_10_444 = 33 VVC编码档次为10bit全采样主档次。
VVC_PROFILE_MAIN_12_444 = 34 VVC编码档次为12bit全采样主档次。
VVC_PROFILE_MAIN_16_444 = 36 VVC编码档次为16bit全采样主档次。
VVC_PROFILE_MAIN_12_444_INTRA = 42 VVC编码档次为12bit全采样帧内主档次。
VVC_PROFILE_MAIN_16_444_INTRA = 44 VVC编码档次为16bit全采样帧内主档次。
VVC_PROFILE_MULTI_MAIN_10_444 = 49 VVC编码档次为多层编码10bit全采样主档次。
VVC_PROFILE_MAIN_10_STILL = 65 VVC编码档次为10bit静止图像主档次。
VVC_PROFILE_MAIN_12_STILL = 66 VVC编码档次为12bit静止图像主档次。
VVC_PROFILE_MAIN_10_444_STILL = 97 VVC编码档次为10bit全采样静止图像主档次。
VVC_PROFILE_MAIN_12_444_STILL = 98 VVC编码档次为12bit全采样静止图像主档次。
VVC_PROFILE_MAIN_16_444_STILL = 100 VVC编码档次为16bit全采样静止图像主档次。

[h2]OH_MPEG2Profile

enum OH_MPEG2Profile

描述

MPEG2档次。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 17

枚举项 描述
MPEG2_PROFILE_SIMPLE = 0 简单档次。
MPEG2_PROFILE_MAIN = 1 主档次。
MPEG2_PROFILE_SNR_SCALABLE = 2 信噪比可分级档次。
MPEG2_PROFILE_SPATIALLY_SCALABLE = 3 空间可分级档次。
MPEG2_PROFILE_HIGH = 4 高级档次。
MPEG2_PROFILE_422 = 5 4:2:2档次。

[h2]OH_MPEG4Profile

enum OH_MPEG4Profile

描述

MPEG4档次。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 17

枚举项 描述
MPEG4_PROFILE_SIMPLE = 0 简单档次。
MPEG4_PROFILE_SIMPLE_SCALABLE = 1 简单可分级档次。
MPEG4_PROFILE_CORE = 2 核心档次。
MPEG4_PROFILE_MAIN = 3 主档次。
MPEG4_PROFILE_N_BIT = 4 N位档次。
MPEG4_PROFILE_HYBRID = 5 混合档次。
MPEG4_PROFILE_BASIC_ANIMATED_TEXTURE = 6 基本动画纹理档次。
MPEG4_PROFILE_SCALABLE_TEXTURE = 7 可分级纹理档次。
MPEG4_PROFILE_SIMPLE_FA = 8 简单FA档次。
MPEG4_PROFILE_ADVANCED_REAL_TIME_SIMPLE = 9 高级实时简单档次。
MPEG4_PROFILE_CORE_SCALABLE = 10 核心可分级档次。
MPEG4_PROFILE_ADVANCED_CODING_EFFICIENCY = 11 高级编码效率档次。
MPEG4_PROFILE_ADVANCED_CORE = 12 高级核心档次。
MPEG4_PROFILE_ADVANCED_SCALABLE_TEXTURE = 13 高级可分级纹理档次。
MPEG4_PROFILE_ADVANCED_SIMPLE = 17 高级简单档次。

[h2]OH_H263Profile

enum OH_H263Profile

描述

H.263档次。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 17

枚举项 描述
H263_PROFILE_BASELINE = 0 基线档次。
H263_PROFILE_VERSION_1_BACKWARD_COMPATIBILITY = 2 版本1向后兼容档次。

[h2]OH_VC1Profile

enum OH_VC1Profile

描述

VC-1档次。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 22

枚举项 描述
VC1_PROFILE_SIMPLE = 0 简单档次。
VC1_PROFILE_MAIN = 1 主档次。
VC1_PROFILE_ADVANCED = 2 高级档次。

[h2]OH_AV1Profile

enum OH_AV1Profile

描述

AV1档次。

起始版本： 23

枚举项 描述
AV1_PROFILE_MAIN = 0 主档次。
AV1_PROFILE_HIGH = 1 高级档次。
AV1_PROFILE_PROFESSIONAL = 2 专业档次。

[h2]OH_VP9Profile

enum OH_VP9Profile

描述

VP9档次。

起始版本： 23

枚举项 描述
VP9_PROFILE_0 = 0 0档次。
VP9_PROFILE_1 = 1 1档次。
VP9_PROFILE_2 = 2 2档次。
VP9_PROFILE_3 = 3 3档次。

[h2]OH_WVC1Profile

enum OH_WVC1Profile

描述

WVC1档次。

起始版本： 23

枚举项 描述
WVC1_PROFILE_ADVANCED = 0 高级档次。

[h2]OH_WMV3Profile

enum OH_WMV3Profile

描述

WMV3档次。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 22

枚举项 描述
WMV3_PROFILE_SIMPLE = 0 简单档次。
WMV3_PROFILE_MAIN = 1 主档次。

[h2]OH_AVOutputFormat

enum OH_AVOutputFormat

描述

封装器支持的输出文件格式。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 10

枚举项 描述
AV_OUTPUT_FORMAT_DEFAULT = 0 输出文件格式默认值，默认为MP4格式。
AV_OUTPUT_FORMAT_MPEG_4 = 2 输出文件格式为MP4格式。
AV_OUTPUT_FORMAT_M4A = 6 输出文件格式为M4A格式。
AV_OUTPUT_FORMAT_AMR = 8

输出文件格式为AMR格式。

起始版本： 12
AV_OUTPUT_FORMAT_MP3 = 9

输出文件格式为MP3格式。

起始版本： 12
AV_OUTPUT_FORMAT_WAV = 10

输出文件格式为WAV格式。

起始版本： 12
AV_OUTPUT_FORMAT_AAC = 11

输出文件格式为AAC格式。

起始版本： 18
AV_OUTPUT_FORMAT_FLAC = 12

输出文件格式为FLAC格式。

起始版本： 20
AV_OUTPUT_FORMAT_OGG = 13

输出文件格式为OGG格式。

起始版本： 23
AV_OUTPUT_FORMAT_FLV = 14

输出文件格式为FLV格式。

起始版本： 26.0.0

[h2]OH_AVSeekMode

enum OH_AVSeekMode

描述

跳转模式。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 10

枚举项 描述
SEEK_MODE_NEXT_SYNC = 0 指定时间位置的下一I帧。若时间点后没有I帧，该模式可能跳转失败。
SEEK_MODE_PREVIOUS_SYNC 指定时间位置的上一I帧。
SEEK_MODE_CLOSEST_SYNC 指定时间位置的最近I帧。

[h2]OH_ScalingMode

enum OH_ScalingMode

描述

缩放模式，只在Surface模式下使用。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 10

废弃版本： 14

替代接口： OHScalingModeV2

枚举项 描述
SCALING_MODE_SCALE_TO_WINDOW = 1

根据窗口尺寸自适应调整图像大小。

替代接口： OHScalingModeV2.OH_SCALING_MODE_SCALE_TO_WINDOW_V2
SCALING_MODE_SCALE_CROP = 2

根据窗口尺寸裁剪图像大小。

替代接口： OHScalingModeV2.OH_SCALING_MODE_SCALE_CROP_V2

[h2]OH_BitsPerSample

enum OH_BitsPerSample

描述

每个编码样本的音频位数。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 10

枚举项 描述
SAMPLE_U8 = 0 8位无符号整数采样。
SAMPLE_S16LE = 1 16位有符号整数采样。
SAMPLE_S24LE = 2 24位有符号整数采样。
SAMPLE_S32LE = 3 32位有符号整数采样。
SAMPLE_F32LE = 4 32位浮点采样。
SAMPLE_U8P = 5 8位无符号整数平面采样。
SAMPLE_S16P = 6 16位有符号整数平面采样。
SAMPLE_S24P = 7 24位有符号整数平面采样。
SAMPLE_S32P = 8 32位有符号整数平面采样。
SAMPLE_F32P = 9 32位浮点平面采样。
INVALID_WIDTH = -1 无效采样格式。

[h2]OH_ColorPrimary

enum OH_ColorPrimary

描述

色域。编解码都支持。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 10

枚举项 描述
COLOR_PRIMARY_BT709 = 1 BT709色域。
COLOR_PRIMARY_UNSPECIFIED = 2 未指定色域。
COLOR_PRIMARY_BT470_M = 4 BT470_M色域。
COLOR_PRIMARY_BT601_625 = 5 BT601_625色域。
COLOR_PRIMARY_BT601_525 = 6 BT601_525色域。
COLOR_PRIMARY_SMPTE_ST240 = 7 SMPTE_ST240色域。
COLOR_PRIMARY_GENERIC_FILM = 8 GENERIC_FILM色域。
COLOR_PRIMARY_BT2020 = 9 BT2020色域。
COLOR_PRIMARY_SMPTE_ST428 = 10 SMPTE_ST428色域。
COLOR_PRIMARY_P3DCI = 11 P3DCI色域。
COLOR_PRIMARY_P3D65 = 12 P3D65色域。

[h2]OH_TransferCharacteristic

enum OH_TransferCharacteristic

描述

转移特性。编解码都支持。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 10

枚举项 描述
TRANSFER_CHARACTERISTIC_BT709 = 1 BT709传递函数。
TRANSFER_CHARACTERISTIC_UNSPECIFIED = 2 未指定传递函数。
TRANSFER_CHARACTERISTIC_GAMMA_2_2 = 4 GAMMA_2_2传递函数。
TRANSFER_CHARACTERISTIC_GAMMA_2_8 = 5 GAMMA_2_8传递函数。
TRANSFER_CHARACTERISTIC_BT601 = 6 BT601传递函数。
TRANSFER_CHARACTERISTIC_SMPTE_ST240 = 7 SMPTE_ST240传递函数。
TRANSFER_CHARACTERISTIC_LINEAR = 8 LINEAR传递函数。
TRANSFER_CHARACTERISTIC_LOG = 9 LOG传递函数。
TRANSFER_CHARACTERISTIC_LOG_SQRT = 10 LOG_SQRT传递函数。
TRANSFER_CHARACTERISTIC_IEC_61966_2_4 = 11 IEC_61966_2_4传递函数。
TRANSFER_CHARACTERISTIC_BT1361 = 12 BT1361传递函数。
TRANSFER_CHARACTERISTIC_IEC_61966_2_1 = 13 IEC_61966_2_1传递函数。
TRANSFER_CHARACTERISTIC_BT2020_10BIT = 14 BT2020_10BIT传递函数。
TRANSFER_CHARACTERISTIC_BT2020_12BIT = 15 BT2020_12BIT传递函数。
TRANSFER_CHARACTERISTIC_PQ = 16 PQ传递函数。
TRANSFER_CHARACTERISTIC_SMPTE_ST428 = 17 SMPTE_ST428传递函数。
TRANSFER_CHARACTERISTIC_HLG = 18 HLG传递函数。

[h2]OH_MatrixCoefficient

enum OH_MatrixCoefficient

描述

矩阵系数。编解码都支持。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 10

枚举项 描述
MATRIX_COEFFICIENT_IDENTITY = 0 单位矩阵。
MATRIX_COEFFICIENT_BT709 = 1 BT709转换矩阵。
MATRIX_COEFFICIENT_UNSPECIFIED = 2 未指定转换矩阵。
MATRIX_COEFFICIENT_FCC = 4 FCC转换矩阵。
MATRIX_COEFFICIENT_BT601_625 = 5 BT601_625转换矩阵。
MATRIX_COEFFICIENT_BT601_525 = 6 BT601_525转换矩阵。
MATRIX_COEFFICIENT_SMPTE_ST240 = 7 SMPTE_ST240转换矩阵。
MATRIX_COEFFICIENT_YCGCO = 8 YCGCO转换矩阵。
MATRIX_COEFFICIENT_BT2020_NCL = 9 BT2020_NCL转换矩阵。
MATRIX_COEFFICIENT_BT2020_CL = 10 BT2020_CL转换矩阵。
MATRIX_COEFFICIENT_SMPTE_ST2085 = 11 SMPTE_ST2085转换矩阵。
MATRIX_COEFFICIENT_CHROMATICITY_NCL = 12 CHROMATICITY_NCL转换矩阵。
MATRIX_COEFFICIENT_CHROMATICITY_CL = 13 CHROMATICITY_CL转换矩阵。
MATRIX_COEFFICIENT_ICTCP = 14 ICTCP转换矩阵。

[h2]OH_AVCLevel

enum OH_AVCLevel

描述

AVC级别。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 12

枚举项 描述
AVC_LEVEL_1 = 0 级别1
AVC_LEVEL_1b = 1 级别1b
AVC_LEVEL_11 = 2 级别1.1
AVC_LEVEL_12 = 3 级别1.2
AVC_LEVEL_13 = 4 级别1.3
AVC_LEVEL_2 = 5 级别2
AVC_LEVEL_21 = 6 级别2.1
AVC_LEVEL_22 = 7 级别2.2
AVC_LEVEL_3 = 8 级别3
AVC_LEVEL_31 = 9 级别3.1
AVC_LEVEL_32 = 10 级别3.2
AVC_LEVEL_4 = 11 级别4
AVC_LEVEL_41 = 12 级别4.1
AVC_LEVEL_42 = 13 级别4.2
AVC_LEVEL_5 = 14 级别5
AVC_LEVEL_51 = 15 级别5.1
AVC_LEVEL_52 = 16 级别5.2
AVC_LEVEL_6 = 17 级别6
AVC_LEVEL_61 = 18 级别6.1
AVC_LEVEL_62 = 19 级别6.2

[h2]OH_HEVCLevel

enum OH_HEVCLevel

描述

HEVC级别。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 12

枚举项 描述
HEVC_LEVEL_1 = 0 级别1
HEVC_LEVEL_2 = 1 级别2
HEVC_LEVEL_21 = 2 级别2.1
HEVC_LEVEL_3 = 3 级别3
HEVC_LEVEL_31 = 4 级别3.1
HEVC_LEVEL_4 = 5 级别4
HEVC_LEVEL_41 = 6 级别4.1
HEVC_LEVEL_5 = 7 级别5
HEVC_LEVEL_51 = 8 级别5.1
HEVC_LEVEL_52 = 9 级别5.2
HEVC_LEVEL_6 = 10 级别6
HEVC_LEVEL_61 = 11 级别6.1
HEVC_LEVEL_62 = 12 级别6.2

[h2]OH_VVCLevel

enum OH_VVCLevel

描述

VVC级别。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 15

枚举项 描述
VVC_LEVEL_1 = 16 级别1.0
VVC_LEVEL_2 = 32 级别2.0
VVC_LEVEL_21 = 35 级别2.1
VVC_LEVEL_3 = 48 级别3.0
VVC_LEVEL_31 = 51 级别3.1
VVC_LEVEL_4 = 64 级别4.0
VVC_LEVEL_41 = 67 级别4.1
VVC_LEVEL_5 = 80 级别5.0
VVC_LEVEL_51 = 83 级别5.1
VVC_LEVEL_52 = 86 级别5.2
VVC_LEVEL_6 = 96 级别6.0
VVC_LEVEL_61 = 99 级别6.1
VVC_LEVEL_62 = 102 级别6.2
VVC_LEVEL_63 = 105 级别6.3
VVC_LEVEL_155 = 255 级别15.5

[h2]OH_MPEG2Level

enum OH_MPEG2Level

描述

MPEG2级别。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 17

枚举项 描述
MPEG2_LEVEL_LOW = 0 低级别。
MPEG2_LEVEL_MAIN = 1 主级别。
MPEG2_LEVEL_HIGH_1440 = 2 高1440级别。
MPEG2_LEVEL_HIGH = 3 高级别。

[h2]OH_MPEG4Level

enum OH_MPEG4Level

描述

MPEG4级别。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 17

枚举项 描述
MPEG4_LEVEL_0 = 0 级别0
MPEG4_LEVEL_0B = 1 级别0B。
MPEG4_LEVEL_1 = 2 级别1。
MPEG4_LEVEL_2 = 3 级别2。
MPEG4_LEVEL_3 = 4 级别3。
MPEG4_LEVEL_3B = 5 级别3B。
MPEG4_LEVEL_4 = 6 级别4。
MPEG4_LEVEL_4A = 7 级别4A。
MPEG4_LEVEL_5 = 8 级别5。
MPEG4_LEVEL_6 = 9 级别6。

[h2]OH_H263Level

enum OH_H263Level

描述

H.263级别。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 17

枚举项 描述
H263_LEVEL_10 = 0 级别10。
H263_LEVEL_20 = 1 级别20。
H263_LEVEL_30 = 2 级别30。
H263_LEVEL_40 = 3 级别40。
H263_LEVEL_45 = 4 级别45。
H263_LEVEL_50 = 5 级别50。
H263_LEVEL_60 = 6 级别60。
H263_LEVEL_70 = 7 级别70。

[h2]OH_VC1Level

enum OH_VC1Level

描述

VC-1级别。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 22

枚举项 描述
VC1_LEVEL_L0 = 0 级别L0。
VC1_LEVEL_L1 = 1 级别L1。
VC1_LEVEL_L2 = 2 级别L2。
VC1_LEVEL_L3 = 3 级别L3。
VC1_LEVEL_L4 = 4 级别L4。
VC1_LEVEL_LOW = 5 低级别。
VC1_LEVEL_MEDIUM = 6 中级别。
VC1_LEVEL_HIGH = 7 高级别。

[h2]OH_AV1Level

enum OH_AV1Level

描述

AV1级别。

起始版本： 23

枚举项 描述
AV1_LEVEL_20 = 0 2.0级别。
AV1_LEVEL_21 = 1 2.1级别。
AV1_LEVEL_22 = 2 2.2级别。
AV1_LEVEL_23 = 3 2.3级别。
AV1_LEVEL_30 = 4 3.0级别。
AV1_LEVEL_31 = 5 3.1级别。
AV1_LEVEL_32 = 6 3.2级别。
AV1_LEVEL_33 = 7 3.3级别。
AV1_LEVEL_40 = 8 4.0级别。
AV1_LEVEL_41 = 9 4.1级别。
AV1_LEVEL_42 = 10 4.2级别。
AV1_LEVEL_43 = 11 4.3级别。
AV1_LEVEL_50 = 12 5.0级别。
AV1_LEVEL_51 = 13 5.1级别。
AV1_LEVEL_52 = 14 5.2级别。
AV1_LEVEL_53 = 15 5.3级别。
AV1_LEVEL_60 = 16 6.0级别。
AV1_LEVEL_61 = 17 6.1级别。
AV1_LEVEL_62 = 18 6.2级别。
AV1_LEVEL_63 = 19 6.3级别。
AV1_LEVEL_70 = 20 7.0级别。
AV1_LEVEL_71 = 21 7.1级别。
AV1_LEVEL_72 = 22 7.2级别。
AV1_LEVEL_73 = 23 7.3级别。

[h2]OH_VP9Level

enum OH_VP9Level

描述

VP9级别。

起始版本： 23

枚举项 描述
VP9_LEVEL_1 = 0 1级别。
VP9_LEVEL_11 = 1 1.1级别。
VP9_LEVEL_2 = 2 2级别。
VP9_LEVEL_21 = 3 2.1级别。
VP9_LEVEL_3 = 4 3级别。
VP9_LEVEL_31 = 5 3.1级别。
VP9_LEVEL_4 = 6 4级别。
VP9_LEVEL_41 = 7 4.1级别。
VP9_LEVEL_5 = 8 5级别。
VP9_LEVEL_51 = 9 5.1级别。
VP9_LEVEL_52 = 10 5.2级别。
VP9_LEVEL_6 = 11 6级别。
VP9_LEVEL_61 = 12 6.1级别。
VP9_LEVEL_62 = 13 6.2级别。

[h2]OH_WVC1Level

enum OH_WVC1Level

描述

WVC1级别。

起始版本： 23

枚举项 描述
WVC1_LEVEL_L0 = 0 L0级别。
WVC1_LEVEL_L1 = 1 L1级别。
WVC1_LEVEL_L2 = 2 L2级别。
WVC1_LEVEL_L3 = 3 L3级别。
WVC1_LEVEL_L4 = 4 L4级别。

[h2]OH_WMV3Level

enum OH_WMV3Level

描述

WMV3级别。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 22

枚举项 描述
WMV3_LEVEL_LOW = 0 低级别。
WMV3_LEVEL_MEDIUM = 1 中级别。
WMV3_LEVEL_HIGH = 2 高级别。

[h2]OH_TemporalGopReferenceMode

enum OH_TemporalGopReferenceMode

描述

时域图片组参考模式。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 12

枚举项 描述
ADJACENT_REFERENCE = 0 参考最近的短期参考帧。
JUMP_REFERENCE = 1 参考最近的长期参考帧。
UNIFORMLY_SCALED_REFERENCE = 2 均匀分层参考结构，在丢弃最高层级视频帧后，视频帧均匀分布。其中时域图片组个数必须为2的幂。

[h2]OH_BitrateMode

enum OH_BitrateMode

描述

编码器的比特率模式。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 10

枚举项 描述
BITRATE_MODE_CBR = 0 恒定比特率模式。
BITRATE_MODE_VBR = 1 可变比特率模式。
BITRATE_MODE_CQ = 2 恒定质量模式。
BITRATE_MODE_SQR = 3

质量稳定模式，仅支持H265（HEVC）。

起始版本： 20
BITRATE_MODE_CBR_HIGH_QUALITY = 4

高质量恒定比特率模式，仅支持H265（HEVC）。

起始版本： 26.0.0

[h2]OH_FrameRetentionMode

enum OH_FrameRetentionMode

描述

视频解码帧保留模式。

起始版本： 26.0.0

枚举项 描述
OH_FRAME_RETENTION_MODE_FULL = 0

全量保留模式。

解码器工作在透明直通状态，100%保留所有输入帧，实质上禁用了抽帧功能。所有底层的视觉感知算法将被完全跳过，实现零算法开销。

起始版本： 26.0.0
OH_FRAME_RETENTION_MODE_ADAPTIVE = 1

感知自适应保留模式。

解码器动态分析视频特征，优先丢弃对视觉感知影响最小的帧，在最小化播放体验损失的同时保持视觉平滑度。为了获得最佳的算法准确性，强烈建议通过OH_MD_KEY_VIDEO_DECODER_SPEED变量显式配置当前的播放倍速。

起始版本： 26.0.0
OH_FRAME_RETENTION_MODE_UNIFORM = 2

平滑定比保留模式。

根据用户配置的保留比例（通过OH_MD_KEY_VIDEO_DECODER_FRAME_RETENTION_RATIO变量配置）均匀地保留视频帧。如果没有显式配置保留比例，解码器默认将输出限制在最高30fps。

起始版本： 26.0.0

[h2]OH_AudioEncoderPTSMode

enum OH_AudioEncoderPTSMode

描述

音频编码器PTS模式。

起始版本： 26.0.0

枚举项 描述
OH_AUDIO_ENCODER_PTS_MODE_DEFAULT = 0

音频编码器默认PTS模式，不同编码器可能有不同表现。

起始版本： 26.0.0
OH_AUDIO_ENCODER_PTS_MODE_ZERO_START = 1

以0为起点的PTS模式。

起始版本： 26.0.0
OH_AUDIO_ENCODER_PTS_MODE_FIRST_INPUT_START = 2

以首个输入帧的PTS值为起点的PTS模式。

起始版本： 26.0.0

函数说明

[h2]OH_AVCodecOnError()

typedef void (*OH_AVCodecOnError)(OH_AVCodec *codec, int32_t errorCode, void *userData)

描述

当OH_AVCodec实例运行出错时，会调用来上报具体的错误信息的函数指针。

使用场景 错误码
音频编解码 AV_ERR_DRM_DECRYPT_FAILED：DRM解密失败。
视频编解码

AV_ERR_NO_MEMORY：系统资源不足。

AV_ERR_UNKNOWN：未知错误，请通过具体日志分析。

AV_ERR_SERVICE_DIED：服务状态已消亡。
视频解码 AV_ERR_VIDEO_UNSUPPORTED_COLOR_SPACE_CONVERSION：当前输入不支持色彩空间转换功能。
视频编码

AV_ERR_INPUT_DATA_ERROR：

1. 运行过程中surfacebuffer宽、高超出OH_VideoEncoder_Configure接口配置的宽、高。

2. 配置信息与输入数据比特不一致，如：编码输入数据为8bit而配置为10bit，或编码输入数据为10bit而配置为8bit。

3. 配置了不支持的pixelformat。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 9

参数：

参数项 描述
OH_AVCodec *codec OH_AVCodec实例。
int32_t errorCode 特定错误代码。
void *userData 开发者执行回调所依赖的数据。

[h2]OH_AVCodecOnStreamChanged()

typedef void (*OH_AVCodecOnStreamChanged)(OH_AVCodec *codec, OH_AVFormat *format, void *userData)

描述

当视频解码输入码流分辨率或者视频编码输出码流的分辨率发生变化时，调用此函数指针报告新的流描述信息。

从API version 15开始，支持音频解码时，码流采样率、声道数或者音频采样格式发生变化时，将调用此函数指针报告新的流描述信息，支持检测此变化的解码格式有：Audio Vivid，AAC，FLAC，MP3，VORBIS。

需要注意的是，OH_AVFormat指针的生命周期只有在函数指针被调用时才有效，调用结束后禁止继续访问。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 9

参数：

参数项 描述
OH_AVCodec *codec OH_AVCodec实例。
OH_AVFormat *format 新输出流描述信息。
void *userData 开发者执行回调所依赖的数据。

[h2]OH_AVCodecOnNeedInputData()

typedef void (*OH_AVCodecOnNeedInputData)(OH_AVCodec *codec, uint32_t index, OH_AVMemory *data, void *userData)

描述

当OH_AVCodec在运行过程中需要新的输入数据时，将调用此函数指针，并携带可用的缓冲区来填充新的输入数据。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 9

废弃版本： 11

替代接口： OH_AVCodecOnNeedInputBuffer

参数：

参数项 描述
OH_AVCodec *codec OH_AVCodec实例。
uint32_t index 与新可用的输入缓冲区相对应的索引。
OH_AVMemory *data 新的可用输入缓冲区。
void *userData 开发者执行回调所依赖的数据。

[h2]OH_AVCodecOnNewOutputData()

typedef void (*OH_AVCodecOnNewOutputData)(OH_AVCodec *codec, uint32_t index, OH_AVMemory *data, OH_AVCodecBufferAttr *attr, void *userData)

描述

当OH_AVCodec运行过程中生成新的输出数据时，将调用此函数指针，并携带包含新输出数据的缓冲区。需要注意的是，OH_AVCodecBufferAttr指针的生命周期仅在调用函数指针时有效，这将禁止调用结束后继续访问。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 9

废弃版本： 11

替代接口： OH_AVCodecOnNewOutputBuffer

参数：

参数项 描述
OH_AVCodec *codec OH_AVCodec实例。
uint32_t index 与新输出缓冲区对应的索引。
OH_AVMemory *data 包含新输出数据的缓冲区。
OH_AVCodecBufferAttr *attr 新输出缓冲区的说明。
void *userData 开发者执行回调所依赖的数据。

[h2]OH_AVCodecOnNeedInputBuffer()

typedef void (*OH_AVCodecOnNeedInputBuffer)(OH_AVCodec *codec, uint32_t index, OH_AVBuffer *buffer, void *userData)

描述

当OH_AVCodec在运行过程中需要新的输入数据时，将调用此函数指针，并携带可用的缓冲区来填充新的输入数据。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 11

参数：

参数项 描述
OH_AVCodec *codec OH_AVCodec实例。
uint32_t index 与新可用的输入缓冲区相对应的索引。
OH_AVBuffer *buffer 新的可用输入缓冲区。
void *userData 开发者执行回调所依赖的数据。

[h2]OH_AVCodecOnNewOutputBuffer()

typedef void (*OH_AVCodecOnNewOutputBuffer)(OH_AVCodec *codec, uint32_t index, OH_AVBuffer *buffer, void *userData)

描述

当OH_AVCodec运行过程中生成新的输出数据时，将调用此函数指针，并携带包含新输出数据的缓冲区。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 11

参数：

参数项 描述
OH_AVCodec *codec OH_AVCodec实例。
uint32_t index 与新输出缓冲区对应的索引。
OH_AVBuffer *buffer 包含新输出数据的缓冲区。
void *userData 开发者执行回调所依赖的数据。

[h2]OH_AVDataSourceReadAt()

typedef int32_t (*OH_AVDataSourceReadAt)(OH_AVBuffer *data, int32_t length, int64_t pos)

描述

函数指针定义，用于提供获取用户自定义媒体数据的能力。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 12

参数：

参数项 描述
OH_AVBuffer *data 要填充的缓冲区。
int32_t length 要读取的数据长度，单位为字节。
int64_t pos 从偏移量位置读取，单位为字节。

返回：

类型 说明
int32_t 读取到缓冲区的数据的实际长度。

[h2]OH_AVDataSourceReadAtExt()

typedef int32_t (*OH_AVDataSourceReadAtExt)(OH_AVBuffer *data, int32_t length, int64_t pos, void *userData)

描述

函数指针定义，用于提供获取用户自定义媒体数据的能力。

系统能力： SystemCapability.Multimedia.Media.CodecBase

起始版本： 20

参数：

参数项 描述
OH_AVBuffer *data 要填充的缓冲区。
int32_t length 要读取的数据长度，单位为字节。
int64_t pos 从偏移量位置读取，单位为字节。
void *userData 用户自定义数据。

返回：

类型 说明
int32_t 读取到缓冲区的数据的实际长度。