HarmonyOS API:头文件
版本:v3.1 Beta
native_avcodec_videoencoder.h
更新时间: 2023-02-17 09:19
概述
声明用于视频编码的Native API。
起始版本:
9
相关模块:
汇总
类型定义
名称 | 描述 |
typedef enum OH_VideoEncodeBitrateMode 视频编码的比特率模式。 |
枚举
名称 | 描述 |
OH_VideoEncodeBitrateMode { CBR = 0, VBR = 1, CQ = 2 } | 视频编码的比特率模式。 |
函数
名称 | 描述 |
OH_VideoEncoder_CreateByMime (const char *mime) | 通过mime类型创建一个视频编码器实例,大多数情况下推荐使用该接口。 |
OH_VideoEncoder_CreateByName (const char *name) | 通过视频编码器名称创建一个视频编码器实例,使用这个接口的前提是必须清楚编码器准确的名称。 |
OH_VideoEncoder_Destroy (OH_AVCodec *codec) | 清空编码器内部资源,并销毁编码器实例。 |
OH_VideoEncoder_SetCallback (OH_AVCodec *codec, OH_AVCodecAsyncCallback callback, void *userData) | 设置异步回调函数,使得你的应用能够响应视频编码器产生的事件,该接口被调用必须是在Prepare被调用前。 |
OH_VideoEncoder_Configure (OH_AVCodec *codec, OH_AVFormat *format) | 配置视频编码器,典型地,需要配置被编码视频轨道的描述信息,该接口被调用必须是在Prepare被调用前。 |
OH_VideoEncoder_Prepare (OH_AVCodec *codec) | 准备编码器内部资源,调用该接口前必须先调用Configure接口。 |
OH_VideoEncoder_Start (OH_AVCodec *codec) | 启动编码器,该接口必须在已经Prepare成功后调用。 在启动成功后,编码器将开始报告OH_AVCodecOnNeedInputData事件。 |
OH_VideoEncoder_Stop (OH_AVCodec *codec) | 停止编码器。在停止后可通过Start重新进入Started状态。 |
OH_VideoEncoder_Flush (OH_AVCodec *codec) | 清空编码器内部缓存的输入输出数据。在该接口被调用后,所有先前通过异步回调报告的Buffer的索引都将 失效,确保不要再访问这些索引对应的Buffers。 |
OH_VideoEncoder_Reset (OH_AVCodec *codec) | 重置编码器。如需继续编码工作,需要重新调用Configure接口以配置该编码器实例。 |
OH_VideoEncoder_GetOutputDescription (OH_AVCodec *codec) | 获取该编码器输出数据的描述信息,需要注意的是,返回值所指向的OH_AVFormat实例的生命周期 将会再下一次调用该接口时或者该OH_AVCodec实例被销毁时失效。 |
OH_VideoEncoder_SetParameter (OH_AVCodec *codec, OH_AVFormat *format) | 向编码器设置动态参数,注意:该接口仅能在编码器被启动后调用,同时错误的参数设置,可能会导致编码失败。 |
OH_VideoEncoder_GetSurface (OH_AVCodec *codec, OHNativeWindow **window) | 从视频编码器获取输入Surface, 该接口被调用必须是在Prepare被调用前。 |
OH_VideoEncoder_FreeOutputData (OH_AVCodec *codec, uint32_t index) | 将处理结束的输出Buffer交还给编码器。 |
OH_VideoEncoder_NotifyEndOfStream (OH_AVCodec *codec) | 通知视频编码器输入码流已结束。Surface模式推荐使用该接口通知编码器码流结束。 |
native_averrors.h
更新时间: 2023-02-17 09:19
概述
声明了媒体播放框架的错误码。
起始版本:
9
相关模块:
Core
汇总
类型定义
名称 | 描述 |
音视频错误码。 |
枚举
名称 | 描述 |
OH_AVErrCode { AV_ERR_OK = 0, AV_ERR_NO_MEMORY = 1, AV_ERR_OPERATE_NOT_PERMIT = 2, AV_ERR_INVALID_VAL = 3, AV_ERR_IO = 4, AV_ERR_TIMEOUT = 5, AV_ERR_UNKNOWN = 6, AV_ERR_SERVICE_DIED = 7, AV_ERR_INVALID_STATE = 8, AV_ERR_UNSUPPORT = 9, AV_ERR_EXTEND_START = 100 } |
native_avformat.h
更新时间: 2023-02-17 09:19
概述
声明了格式相关的函数和枚举。
起始版本:
9
相关模块:
Core
汇总
类型定义
名称 | 描述 |
AVPixel 格式的枚举。 |
枚举
名称 | 描述 |
AV_PIXEL_FORMAT_YUVI420 = 1, AV_PIXEL_FORMAT_NV12 = 2, AV_PIXEL_FORMAT_NV21 = 3, AV_PIXEL_FORMAT_SurfACE_FORMAT = 4, AV_PIXEL_FORMAT_RGBA = 5 } | AVPixel 格式的枚举。 |
函数
名称 | 描述 |
OH_AVFormat_Create (void) | 创建一个OH_AVFormat句柄指针,用以读写数据。 |
OH_AVFormat_Destroy (struct OH_AVFormat *format) | 销毁指定OH_AVFormat句柄资源。 |
OH_AVFormat_Copy (struct OH_AVFormat *to, struct OH_AVFormat *from) | 拷贝OH_AVFormat句柄资源. |
OH_AVFormat_SetIntValue (struct OH_AVFormat *format, const char *key, int32_t value) | 向OH_AVFormat写入Int数据. |
OH_AVFormat_SetLongValue (struct OH_AVFormat *format, const char *key, int64_t value) | 向OH_AVFormat写入Long数据。 |
OH_AVFormat_SetFloatValue (struct OH_AVFormat *format, const char *key, float value) | 向OH_AVFormat写入Float数据。 |
OH_AVFormat_SetDoubleValue (struct OH_AVFormat *format, const char *key, double value) | 向OH_AVFormat写入Double数据。 |
OH_AVFormat_SetStringValue (struct OH_AVFormat *format, const char *key, const char *value) | 向OH_AVFormat写入String数据。 |
OH_AVFormat_SetBuffer (struct OH_AVFormat *format, const char *key, const uint8_t *addr, size_t size) | 向OH_AVFormat写入一块指定长度的数据。 |
OH_AVFormat_GetIntValue (struct OH_AVFormat *format, const char *key, int32_t *out) | 从OH_AVFormat读取Int数据。 |
OH_AVFormat_GetLongValue (struct OH_AVFormat *format, const char *key, int64_t *out) | 从OH_AVFormat读取Long数据。 |
OH_AVFormat_GetFloatValue (struct OH_AVFormat *format, const char *key, float *out) | 从OH_AVFormat读取Float数据。 |
OH_AVFormat_GetDoubleValue (struct OH_AVFormat *format, const char *key, double *out) | 从OH_AVFormat读取Double数据。 |
OH_AVFormat_GetStringValue (struct OH_AVFormat *format, const char *key, const char **out) | 从OH_AVFormat读取Double数据。 |
OH_AVFormat_GetBuffer (struct OH_AVFormat *format, const char *key, uint8_t **addr, size_t *size) | 从OH_AVFormat读取一块指定长度的数据。 |
OH_AVFormat_DumpInfo (struct OH_AVFormat *format) | 以字符串的形式输出OH_AVFormat所包含的信息。 |
native_avmemory.h
更新时间: 2023-02-17 09:19
概述
声明了AVMemory的函数接口。
起始版本:
9
相关模块:
Core
汇总
函数
名称 | 描述 |
OH_AVMemory_GetAddr (struct OH_AVMemory *mem) | 获取入参的内存虚拟地址。 |
OH_AVMemory_GetSize (struct OH_AVMemory *mem) | 获取入参的内存长度。 |