1# native_avcodec_base.h 2 3 4## 概述 5 6声明运行音视频编解码通用的结构体、字符常量、枚举。 7 8**起始版本：** 9 109 11 12**相关模块:** 13 14[CodecBase](_codec_base.md) 15 16 17## 汇总 18 19 20### 结构体 21 22| 名称 | 描述 | 23| -------- | -------- | 24| [OH_AVCodecBufferAttr](_o_h___a_v_codec_buffer_attr.md) | 定义OH_AVCodec的缓冲区描述信息。 | 25| [OH_AVCodecAsyncCallback](_o_h___a_v_codec_async_callback.md) | OH_AVCodec中所有异步回调函数指针的集合。 | 26 27 28### 类型定义 29 30| 名称 | 描述 | 31| -------- | -------- | 32| [OH_AVCodecBufferFlags](_codec_base.md#oh_avcodecbufferflags) | 枚举OH_AVCodec缓冲区标记的类别。 | 33| [OH_AVOutputFormat](_codec_base.md#oh_avoutputformat) | 枚举封装器的输出文件格式。 | 34| [OH_AVCodecBufferAttr](_codec_base.md#oh_avcodecbufferattr) | 定义OH_AVCodec的缓冲区描述信息。 | 35| (\*[OH_AVCodecOnError](_codec_base.md#oh_avcodeconerror)) (OH_AVCodec \*codec, int32_t errorCode, void \*userData) | 当OH_AVCodec实例运行出错时，会调用来上报具体的错误信息的函数指针。 | 36| (\*[OH_AVCodecOnStreamChanged](_codec_base.md#oh_avcodeconstreamchanged)) (OH_AVCodec \*codec, OH_AVFormat \*format, void \*userData) | 当输出流发生变化时，将调用此函数指针报告新的流描述信息。 | 37| (\*[OH_AVCodecOnNeedInputData](_codec_base.md#oh_avcodeconneedinputdata)) (OH_AVCodec \*codec, uint32_t index, OH_AVMemory \*data, void \*userData) | 当OH_AVCodec在运行过程中需要新的输入数据时，将调用此函数指针，并携带可用的缓冲区来填充新的输入数据。 | 38| (\*[OH_AVCodecOnNewOutputData](_codec_base.md#oh_avcodeconnewoutputdata)) (OH_AVCodec \*codec, uint32_t index, OH_AVMemory \*data, [OH_AVCodecBufferAttr](_o_h___a_v_codec_buffer_attr.md) \*attr, void \*userData) | 当OH_AVCodec运行过程中生成新的输出数据时，将调用此函数指针，并携带包含新输出数据的缓冲区。 | 39| [OH_AVCodecAsyncCallback](_codec_base.md#oh_avcodecasynccallback) | OH_AVCodec中所有异步回调函数指针的集合。 | 40| [OH_MediaType](_codec_base.md#oh_mediatype) | 媒体类型。 | 41| [OH_AVCProfile](_codec_base.md#oh_avcprofile) | AVC Profile枚举。 | 42| [OH_HEVCProfile](_codec_base.md#oh_hevcprofile) | HEVC Profile枚举。 | 43| [OH_AACProfile](_codec_base.md#oh_aacprofile) | AAC Profile枚举。 | 44| [OH_AVSeekMode](_codec_base.md#oh_avseekmode) | 跳转模式。 | 45| [OH_ColorPrimary](_codec_base.md#oh_colorprimary) | 原色。 | 46| [OH_TransferCharacteristic](_codec_base.md#oh_transfercharacteristic) | 转移特性。 | 47| [OH_MatrixCoefficient](_codec_base.md#oh_matrixcoefficient) | 矩阵系数。 | 48| [OH_BitsPerSample](_codec_base.md#oh_bitspersample) | 枚举每个编码样本的音频位数。 | 49 50 51### 枚举 52 53| 名称 | 描述 | 54| -------- | -------- | 55| [OH_AVCodecBufferFlags](_codec_base.md#oh_avcodecbufferflags) {<br/> **AVCODEC_BUFFER_FLAGS_NONE** = 0,<br/> **AVCODEC_BUFFER_FLAGS_EOS** = 1 << 0,<br/> **AVCODEC_BUFFER_FLAGS_SYNC_FRAME** = 1 << 1,<br/> **AVCODEC_BUFFER_FLAGS_INCOMPLETE_FRAME** = 1 << 2,<br/> **AVCODEC_BUFFER_FLAGS_CODEC_DATA** = 1 << 3<br/>} | 枚举OH_AVCodec缓冲区标记的类别。 | 56| [OH_AVOutputFormat](_codec_base.md#oh_avoutputformat) {<br/> **AV_OUTPUT_FORMAT_DEFAULT** = 0,<br/> **AV_OUTPUT_FORMAT_MPEG_4** = 2,<br/> **AV_OUTPUT_FORMAT_M4A** = 6<br/>} | 枚举封装器的输出文件格式。 | 57| [OH_MediaType](_codec_base.md#oh_mediatype) {<br/> **MEDIA_TYPE_AUD** = 0,<br/> **MEDIA_TYPE_VID** = 1<br/>} | 媒体类型。 | 58| [OH_AVCProfile](_codec_base.md#oh_avcprofile) {<br/> **AVC_PROFILE_BASELINE** = 0,<br/> **AVC_PROFILE_HIGH** = 4,<br/> **AVC_PROFILE_MAIN** = 8<br/>} | AVC Profile枚举。 | 59| [OH_HEVCProfile](_codec_base.md#oh_hevcprofile) {<br/> **HEVC_PROFILE_MAIN** = 0,<br/> **HEVC_PROFILE_MAIN_10** = 1,<br/> **HEVC_PROFILE_MAIN_STILL** = 2,<br/> **HEVC_PROFILE_MAIN_10_HDR10** = 3,<br/> **HEVC_PROFILE_MAIN_10_HDR10_PLUS** = 4<br/>} | HEVC Profile枚举。 | 60| [OH_AACProfile](_codec_base.md#oh_aacprofile) {<br/> **AAC_PROFILE_LC** = 0<br/>} | AAC Profile枚举。 | 61| [OH_AVSeekMode](_codec_base.md#oh_avseekmode) {<br/> **SEEK_MODE_NEXT_SYNC** = 0,<br/> **SEEK_MODE_PREVIOUS_SYNC**,<br/> **SEEK_MODE_CLOSEST_SYNC**<br/>} | 跳转模式。 | 62| [OH_ColorPrimary](_codec_base.md#oh_colorprimary) {<br/> **COLOR_PRIMARY_BT709** = 1,<br/> **COLOR_PRIMARY_UNSPECIFIED** = 2,<br/> **COLOR_PRIMARY_BT470_M** = 4,<br/> **COLOR_PRIMARY_BT601_625** = 5,<br/> **COLOR_PRIMARY_BT601_525** = 6,<br/> **COLOR_PRIMARY_SMPTE_ST240** = 7,<br/> **COLOR_PRIMARY_GENERIC_FILM** = 8,<br/> **COLOR_PRIMARY_BT2020** = 9,<br/> **COLOR_PRIMARY_SMPTE_ST428** = 10,<br/> **COLOR_PRIMARY_P3DCI** = 11,<br/> **COLOR_PRIMARY_P3D65** = 12<br/>} | 原色。 | 63| [OH_TransferCharacteristic](_codec_base.md#oh_transfercharacteristic) {<br/> **TRANSFER_CHARACTERISTIC_BT709** = 1,<br/> **TRANSFER_CHARACTERISTIC_UNSPECIFIED** = 2,<br/> **TRANSFER_CHARACTERISTIC_GAMMA_2_2** = 4,<br/> **TRANSFER_CHARACTERISTIC_GAMMA_2_8** = 5,<br/> **TRANSFER_CHARACTERISTIC_BT601** = 6,<br/> **TRANSFER_CHARACTERISTIC_SMPTE_ST240** = 7,<br/> **TRANSFER_CHARACTERISTIC_LINEAR** = 8,<br/> **TRANSFER_CHARACTERISTIC_LOG** = 9,<br/> **TRANSFER_CHARACTERISTIC_LOG_SQRT** = 10,<br/> **TRANSFER_CHARACTERISTIC_IEC_61966_2_4** = 11,<br/> **TRANSFER_CHARACTERISTIC_BT1361** = 12,<br/> **TRANSFER_CHARACTERISTIC_IEC_61966_2_1** = 13,<br/> **TRANSFER_CHARACTERISTIC_BT2020_10BIT** = 14,<br/> **TRANSFER_CHARACTERISTIC_BT2020_12BIT** = 15,<br/> **TRANSFER_CHARACTERISTIC_PQ** = 16,<br/> **TRANSFER_CHARACTERISTIC_SMPTE_ST428** = 17,<br/> **TRANSFER_CHARACTERISTIC_HLG** = 18<br/>} | 转移特性。 | 64| [OH_MatrixCoefficient](_codec_base.md#oh_matrixcoefficient) {<br/> **MATRIX_COEFFICIENT_IDENTITY** = 0,<br/> **MATRIX_COEFFICIENT_BT709** = 1,<br/> **MATRIX_COEFFICIENT_UNSPECIFIED** = 2,<br/> **MATRIX_COEFFICIENT_FCC** = 4,<br/> **MATRIX_COEFFICIENT_BT601_625** = 5,<br/> **MATRIX_COEFFICIENT_BT601_525** = 6,<br/> **MATRIX_COEFFICIENT_SMPTE_ST240** = 7,<br/> **MATRIX_COEFFICIENT_YCGCO** = 8,<br/> **MATRIX_COEFFICIENT_BT2020_NCL** = 9,<br/> **MATRIX_COEFFICIENT_BT2020_CL** = 10,<br/> **MATRIX_COEFFICIENT_SMPTE_ST2085** = 11,<br/> **MATRIX_COEFFICIENT_CHROMATICITY_NCL** = 12,<br/> **MATRIX_COEFFICIENT_CHROMATICITY_CL** = 13,<br/> **MATRIX_COEFFICIENT_ICTCP** = 14<br/>} | 矩阵系数。 | 65| [OH_BitsPerSample](_codec_base.md#oh_bitspersample) {<br/> **SAMPLE_U8** = 0,<br/> **SAMPLE_S16LE** = 1,<br/> **SAMPLE_S24LE** = 2,<br/> **SAMPLE_S32LE** = 3,<br/> **SAMPLE_F32LE** = 4,i<br/> **SAMPLE_U8P** = 5,<br/> **SAMPLE_S16P** = 6,<br/> **SAMPLE_S24P** = 7,<br/> **SAMPLE_S32P** = 8,<br/> **SAMPLE_F32P** = 9,<br/> **INVALID_WIDTH** = -1<br/>} | 枚举每个编码样本的音频位数。 | 66 67 68### 变量 69 70| 名称 | 描述 | 71| -------- | -------- | 72| [OH_AVCodecBufferAttr::pts](_o_h___a_v_codec_buffer_attr.md#pts) | 此缓冲区的显示时间戳（以微秒为单位） | 73| [OH_AVCodecBufferAttr::size](_o_h___a_v_codec_buffer_attr.md#size) | 缓冲区中包含的数据的大小（以字节为单位） | 74| [OH_AVCodecBufferAttr::offset](_o_h___a_v_codec_buffer_attr.md#offset) | 此缓冲区中有效数据的起始偏移量 | 75| [OH_AVCodecBufferAttr::flags](_o_h___a_v_codec_buffer_attr.md#flags) | 此缓冲区具有的标志，也是多个[OH_AVCodecBufferFlags](_codec_base.md#oh_avcodecbufferflags)的组合。 | 76| [OH_AVCodecAsyncCallback::onError](_o_h___a_v_codec_async_callback.md#onerror) | 监控编解码器操作错误，请参见[OH_AVCodecOnError](_codec_base.md#oh_avcodeconerror) | 77| [OH_AVCodecAsyncCallback::onStreamChanged](_o_h___a_v_codec_async_callback.md#onstreamchanged) | 监控编解码器流变化，请参见[OH_AVCodecOnStreamChanged](_codec_base.md#oh_avcodeconstreamchanged) | 78| [OH_AVCodecAsyncCallback::onNeedInputData](_o_h___a_v_codec_async_callback.md#onneedinputdata) | 监控编解码器需要输入数据，请参见[OH_AVCodecOnNeedInputData](_codec_base.md#oh_avcodeconneedinputdata) | 79| [OH_AVCodecAsyncCallback::onNeedOutputData](_o_h___a_v_codec_async_callback.md#onneedinputdata) | 监控编解码器已生成输出数据，请参见[OH_AVCodecOnNewOutputData](_codec_base.md#oh_avcodeconnewoutputdata) | 80| \*[OH_AVCODEC_MIMETYPE_VIDEO_AVC](_codec_base.md#oh_avcodec_mimetype_video_avc) | AVC视频编解码器的MIME类型。 | 81| \*[OH_AVCODEC_MIMETYPE_AUDIO_AAC](_codec_base.md#oh_avcodec_mimetype_audio_aac) | AAC音频编解码器的MIME类型。 | 82| \*[OH_AVCODEC_MIMETYPE_VIDEO_MPEG4](_codec_base.md#oh_avcodec_mimetype_video_mpeg4) | MPEG4视频编解码器的MIME类型。 | 83| \*[OH_AVCODEC_MIMETYPE_VIDEO_HEVC](_codec_base.md#oh_avcodec_mimetype_video_hevc) | HEVC视频编解码器的MIME类型。 | 84| \*[OH_AVCODEC_MIMETYPE_AUDIO_MPEG](_codec_base.md#oh_avcodec_mimetype_audio_mpeg) | MPEG音频编解码器的MIME类型。 | 85| \*[OH_AVCODEC_MIMETYPE_IMAGE_JPG](_codec_base.md#oh_avcodec_mimetype_image_jpg) | JPG图片编解码器的MIME类型。 | 86| \*[OH_AVCODEC_MIMETYPE_IMAGE_PNG](_codec_base.md#oh_avcodec_mimetype_image_png) | PNG图片编解码器的MIME类型。 | 87| \*[OH_AVCODEC_MIMETYPE_IMAGE_BMP](_codec_base.md#oh_avcodec_mimetype_image_bmp) | BMP图片编解码器的MIME类型。 | 88| \*[OH_AVCODEC_MIMETYPE_AUDIO_FLAC](_codec_base.md#oh_avcodec_mimetype_audio_flac) | FLAC音频编解码器的MIME类型。 | 89| \*[OH_AVCODEC_MIMETYPE_AUDIO_VORBIS](_codec_base.md#oh_avcodec_mimetype_audio_vorbis) | VORBIS音频编解码器的MIME类型。 | 90| \*[OH_ED_KEY_TIME_STAMP](_codec_base.md#oh_ed_key_time_stamp) | 表面的额外数据中时间戳的键，值类型为int64 | 91| \*[OH_ED_KEY_EOS](_codec_base.md#oh_ed_key_eos) | 表面的额外数据中流结束符的键，值类型为bool | 92| \*[OH_MD_KEY_TRACK_TYPE](_codec_base.md#oh_md_key_track_type) | 提供统一容器，用于存储媒体描述。 | 93| \*[OH_MD_KEY_CODEC_MIME](_codec_base.md#oh_md_key_codec_mime) | 编解码器mime类型的键，值类型为字符串。 | 94| \*[OH_MD_KEY_DURATION](_codec_base.md#oh_md_key_duration) | 持续时间键，值类型为int64_t。 | 95| \*[OH_MD_KEY_BITRATE](_codec_base.md#oh_md_key_bitrate) | 比特率的键，值类型为uint32_t。 | 96| \*[OH_MD_KEY_MAX_INPUT_SIZE](_codec_base.md#oh_md_key_max_input_size) | 最大输入大小的键，值类型为uint32_t | 97| \*[OH_MD_KEY_WIDTH](_codec_base.md#oh_md_key_width) | 视频宽度的键，值类型为uint32_t | 98| \*[OH_MD_KEY_HEIGHT](_codec_base.md#oh_md_key_height) | 视频高度键，值类型为uint32_t | 99| \*[OH_MD_KEY_PIXEL_FORMAT](_codec_base.md#oh_md_key_pixel_format) | 视频像素格式的键，值类型为int32_t，具体见[OH_AVPixelFormat](_core.md#oh_avpixelformat) | 100| \*[OH_MD_KEY_RANGE_FLAG](_codec_base.md#oh_md_key_range_flag) | 视频YUV取值范围标志的键，值类型为bool | 101| \*[OH_MD_KEY_COLOR_PRIMARIES](_codec_base.md#oh_md_key_color_primaries) | 视频颜色原色键, 值类型为int32_t | 102| \*[OH_MD_KEY_TRANSFER_CHARACTERISTICS](_codec_base.md#oh_md_key_transfer_characteristics) | 视频转移特性的键，值类型为int32_t | 103| \*[OH_MD_KEY_MATRIX_COEFFICIENTS](_codec_base.md#oh_md_key_matrix_coefficients) | 视频矩阵系数的键，值类型为int32_t | 104| \*[OH_MD_KEY_AUDIO_SAMPLE_FORMAT](_codec_base.md#oh_md_key_audio_sample_format) | 音频原始格式的键，值类型为uint32_t | 105| \*[OH_MD_KEY_FRAME_RATE](_codec_base.md#oh_md_key_frame_rate) | 视频帧率的键，值类型为双精度浮点。 | 106| \*[OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE](_codec_base.md#oh_md_key_video_encode_bitrate_mode) | 视频编码码率模式，值类型为int32_t，具体见[OH_VideoEncodeBitrateMode](_video_encoder.md#oh_videoencodebitratemode) | 107| \*[OH_MD_KEY_PROFILE](_codec_base.md#oh_md_key_profile) | 编码模板，值类型为数字，具体见[OH_AVCProfile](_codec_base.md#oh_avcprofile)，[OH_AACProfile](_codec_base.md#oh_aacprofile)或[CodecBase](_codec_base.md#oh_hevcprofile)。 | 108| \*[OH_MD_KEY_AUD_CHANNEL_COUNT](_codec_base.md#oh_md_key_aud_channel_count) | 音频通道计数键，值类型为uint32_t | 109| \*[OH_MD_KEY_AUD_SAMPLE_RATE](_codec_base.md#oh_md_key_aud_sample_rate) | 音频采样率键，值类型为uint32_t | 110| \*[OH_MD_KEY_I_FRAME_INTERVAL](_codec_base.md#oh_md_key_i_frame_interval) | 关键帧间隔的键，值类型为int32_t，单位为毫秒。 | 111| \*[OH_MD_KEY_ROTATION](_codec_base.md#oh_md_key_rotation) | 表面旋转角度的键。值类型为int32_t：应为{0, 90, 180, 270}，默认值为0。 | 112| \*[OH_MD_KEY_CODEC_CONFIG](_codec_base.md#oh_md_key_codec_config) | 编解码器特定数据的键，值类型为uint8_t\*。 | 113| \*[OH_MD_KEY_REQUEST_I_FRAME](_codec_base.md#oh_md_key_request_i_frame) | 请求立即编码I帧的键。值类型为布尔值 | 114| \*[OH_MD_KEY_QUALITY](_codec_base.md#oh_md_key_quality) | 所需编码质量的键。值类型为uint32_t，此键仅适用于配置在恒定质量模式下的编码器 | 115| \*[OH_MD_KEY_CHANNEL_LAYOUT](_codec_base.md#oh_md_key_channel_layout) | 所需编码通道布局的键。值类型为int64_t，此键仅适用于编码器。 | 116| \*[OH_MD_KEY_BITS_PER_CODED_SAMPLE](_codec_base.md#oh_md_key_bits_per_coded_sample) | 每个编码样本位数的键，值类型为uint32_t，支持flac编码器。 | 117| \*[OH_MD_KEY_AAC_IS_ADTS](_codec_base.md#oh_md_key_aac_is_adts) | aac格式的键，值类型为uint32_t,aac解码器支持。 | 118| \*[OH_MD_KEY_SBR](_codec_base.md#oh_md_key_sbr) | aac sbr模式的键，值类型为uint32_t,aac编码器支持。 | 119| \*[OH_MD_KEY_COMPLIANCE_LEVEL](_codec_base.md#oh_md_key_compliance_level) | flac合规性级别的键，值类型为int32_t。 | 120| \*[OH_MD_KEY_IDENTIFICATION_HEADER](_codec_base.md#oh_md_key_identification_header) | vorbis标识头的键，值类型为uint8_t\*，仅vorbis解码器支持。 | 121| \*[OH_MD_KEY_SETUP_HEADER](_codec_base.md#oh_md_key_setup_header) | vorbis设置头的键，值类型为uint8_t\*，仅vorbis解码器支持。 | 122| \*[OH_MD_KEY_TITLE](_codec_base.md#oh_md_key_title) | 源格式标题的键，值类型为字符串 | 123| \*[OH_MD_KEY_ARTIST](_codec_base.md#oh_md_key_artist) | 艺术家的源格式Key，值类型为字符串 | 124| \*[OH_MD_KEY_ALBUM](_codec_base.md#oh_md_key_album) | 相册的源格式键，值类型为字符串 | 125| \*[OH_MD_KEY_ALBUM_ARTIST](_codec_base.md#oh_md_key_album_artist) | 源格式专辑_artist的键，值类型为字符串 | 126| \*[OH_MD_KEY_DATE](_codec_base.md#oh_md_key_date) | 源格式日期的键，值类型为字符串 | 127| \*[OH_MD_KEY_COMMENT](_codec_base.md#oh_md_key_comment) | 源格式注释的键，值类型为字符串 | 128| \*[OH_MD_KEY_GENRE](_codec_base.md#oh_md_key_genre) | 源格式类型的键，值类型为字符串 | 129| \*[OH_MD_KEY_COPYRIGHT](_codec_base.md#oh_md_key_copyright) | 源格式版权的键，值类型为字符串 | 130| \*[OH_MD_KEY_LANGUAGE](_codec_base.md#oh_md_key_language) | 源格式语言的键，值类型为字符串 | 131| \*[OH_MD_KEY_DESCRIPTION](_codec_base.md#oh_md_key_description) | 源格式描述的键，值类型为字符串 | 132| \*[OH_MD_KEY_LYRICS](_codec_base.md#oh_md_key_lyrics) | 源格式歌词的键，值类型为字符串 | 133| \*[OH_MD_KEY_TRACK_COUNT](_codec_base.md#oh_md_key_track_count) | 源格式轨道计数的键，值类型为uint32_t | 134| \*[OH_MD_MAX_INPUT_BUFFER_COUNT](_codec_base.md#oh_md_max_input_buffer_count) | 输入buffer的最大个数，值类型为int32_t | 135| \*[OH_MD_MAX_OUTPUT_BUFFER_COUNT](_codec_base.md#oh_md_max_output_buffer_count) | 输出buffer的最大个数，值类型为int32_t |