HarmonyOS API：CodecBase

版本：v3.1 Beta

CodecBase

更新时间: 2023-02-17 09:19

概述

CodecBase模块提供运行音视频编解码通用的结构体、字符常量、枚举。

@syscap SystemCapability.Multimedia.Media.CodecBase

起始版本：

9

汇总

文件

结构体

类型定义

枚举

变量

类型定义说明

OH_AACProfile

typedef enum OH_AACProfile

描述:

AAC Profile枚举。

@syscap SystemCapability.Multimedia.Media.CodecBase

OH_AVCodecAsyncCallback

typedef struct OH_AVCodecAsyncCallback

描述:

AVCodec所有的异步回调函数指针集合。注册一个该结构体实例给OH_AVCodec实例，并处理通过该回调报告 的信息，以确保AVCodec正常运转。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数:

OH_AVCodecBufferAttr

typedef struct OH_AVCodecBufferAttr

描述:

定义OH_AVCodec的Buffer描述信息。

@syscap SystemCapability.Multimedia.Media.CodecBase

OH_AVCodecBufferFlags

typedef enum OH_AVCodecBufferFlags

描述:

枚举OH_AVCodec的Buffer标记的类别。

@syscap SystemCapability.Multimedia.Media.CodecBase

OH_AVCodecOnError

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

描述:

当OH_AVCodec实例运行发生错误时，该函数指针会被调用以报告具体错误信息。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数:

OH_AVCodecOnNeedInputData

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

描述:

当AVCodec运行过程中需要新的输入数据时，该函数指针会被调用，并携带一块可用的Buffer以供填入新的输入数据。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数:

OH_AVCodecOnNewOutputData

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

描述:

当AVCodec运行过程中产生了新的输出数据时，该函数指针会被调用，并携带一块包含新输出数据的Buffer， 需要注意的是，OH_AVCodecBufferAttr指针的生命周期仅维持在该函数指针被调用时有效，禁止调用结束后继续访问。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数:

OH_AVCodecOnStreamChanged

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

描述:

当输出流发生变化时，该函数指针会被调用以报告新的流描述信息。 需要注意的时，OH_AVFormat指针的生命周期仅维持在该函数指针被调用时上有效，禁止在调用结束后继续访问。

@syscap SystemCapability.Multimedia.Media.CodecBase

参数:

OH_AVCProfile

typedef enum OH_AVCProfile

描述:

AVC Profile枚举。

@syscap SystemCapability.Multimedia.Media.CodecBase

OH_MediaType

typedef enum OH_MediaType

描述:

媒体类型。

@syscap SystemCapability.Multimedia.Media.CodecBase

枚举类型说明

OH_AACProfile

enum OH_AACProfile

描述:

AAC Profile枚举。

@syscap SystemCapability.Multimedia.Media.CodecBase

OH_AVCodecBufferFlags

enum OH_AVCodecBufferFlags

描述:

枚举OH_AVCodec的Buffer标记的类别。

@syscap SystemCapability.Multimedia.Media.CodecBase

OH_AVCProfile

enum OH_AVCProfile

描述:

AVC Profile枚举。

@syscap SystemCapability.Multimedia.Media.CodecBase

OH_MediaType

enum OH_MediaType

描述:

媒体类型。

@syscap SystemCapability.Multimedia.Media.CodecBase

变量说明

flags

uint32_t OH_AVCodecBufferAttr::flags

描述:

该Buffer具有的标记，也是多个​​OH_AVCodecBufferFlags​​的组合

offset

int32_t OH_AVCodecBufferAttr::offset

描述:

有效数据在该Buffer内的起始偏移量

OH_AVCODEC_MIMETYPE_AUDIO_AAC

const char* OH_AVCODEC_MIMETYPE_AUDIO_AAC

描述:

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

@syscap SystemCapability.Multimedia.Media.CodecBase

OH_AVCODEC_MIMETYPE_VIDEO_AVC

const char* OH_AVCODEC_MIMETYPE_VIDEO_AVC

描述:

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

@syscap SystemCapability.Multimedia.Media.CodecBase

OH_ED_KEY_EOS

const char* OH_ED_KEY_EOS

描述:

surface附属数据中结束流的字符描述符，值类型为bool

OH_ED_KEY_TIME_STAMP

const char* OH_ED_KEY_TIME_STAMP

描述:

surface附属数据中时间戳的字符描述符，值类型为int64

OH_MD_KEY_AUD_CHANNEL_COUNT

const char* OH_MD_KEY_AUD_CHANNEL_COUNT

描述:

音频声道数的字符描述符，值类型为uint32_t

OH_MD_KEY_AUD_SAMPLE_RATE

const char* OH_MD_KEY_AUD_SAMPLE_RATE

描述:

音频采样率的字符描述符，值类型为uint32_t

OH_MD_KEY_AUDIO_SAMPLE_FORMAT

const char* OH_MD_KEY_AUDIO_SAMPLE_FORMAT

描述:

音频采样格式的字符描述符，值类型为uint32_t

OH_MD_KEY_BITRATE

const char* OH_MD_KEY_BITRATE

描述:

比特率的字符描述符，值类型为uint32_t

OH_MD_KEY_CODEC_MIME

const char* OH_MD_KEY_CODEC_MIME

描述:

mime类型的字符描述符，值类型为string

OH_MD_KEY_DURATION

const char* OH_MD_KEY_DURATION

描述:

duration的字符描述符，值类型为int64_t

OH_MD_KEY_FRAME_RATE

const char* OH_MD_KEY_FRAME_RATE

描述:

视频帧率的字符描述符，值类型为double

OH_MD_KEY_HEIGHT

const char* OH_MD_KEY_HEIGHT

描述:

视频高度的字符描述符，值类型为uint32_t

OH_MD_KEY_I_FRAME_INTERVAL

const char* OH_MD_KEY_I_FRAME_INTERVAL

描述:

I帧间隔时长的字符描述符，值类型为int32_t，单位是毫秒

OH_MD_KEY_MAX_INPUT_SIZE

const char* OH_MD_KEY_MAX_INPUT_SIZE

描述:

最大输入尺寸的字符描述符，值类型为uint32_t

OH_MD_KEY_PIXEL_FORMAT

const char* OH_MD_KEY_PIXEL_FORMAT

描述:

视频像素格式的字符描述符，值类型为int32_t，具体见​​OH_AVPixelFormat​​

OH_MD_KEY_PROFILE

const char* OH_MD_KEY_PROFILE

描述:

音视频编码能力的字符描述符，值类型为int32_t，具体见​​OH_AVCProfile​​​或​​OH_AACProfile​​

OH_MD_KEY_ROTATION

const char* OH_MD_KEY_ROTATION

描述:

surface旋转角度的字符描述符，值类型为int32_t，限于{0, 90, 180, 270}，默认值为0

OH_MD_KEY_TRACK_TYPE

const char* OH_MD_KEY_TRACK_TYPE

描述:

为媒体播放框架提供统一的字符描述符。

@syscap SystemCapability.Multimedia.Media.CodecBase

OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE

const char* OH_MD_KEY_VIDEO_ENCODE_BITRATE_MODE

描述:

视频编码比特率模式的字符描述符，值类型为int32_t，具体见​​OH_VideoEncodeBitrateMode​​

OH_MD_KEY_WIDTH

const char* OH_MD_KEY_WIDTH

描述:

视频宽度的字符描述符，值类型为uint32_t

pts

int64_t OH_AVCodecBufferAttr::pts

描述:

以微秒为单位表示的该Buffer的Presentation时间戳

size

int32_t OH_AVCodecBufferAttr::size

描述:

以字节为单位表示的该Buffer内所包含数据的大小

文章转载自：​​https://developer.harmonyos.com/cn/docs/documentation/doc-references-V3/_codec_base-0000001497530213-V3?catalogVersion=V3#ZH-CN_TOPIC_0000001497530213__概述​​