harmony 鸿蒙Core

  • 2022-12-22
  • 浏览 (1788)

Core

概述

Core模块提供用于播放框架的基础骨干能力，包含内存、错误码、格式载体等相关函数。

\@syscap SystemCapability.Multimedia.Media.Core

起始版本：

9

汇总

文件

名称 描述
native_averrors.h 声明了媒体播放框架的错误码。
引用文件：
库：libnative_media_core.so
native_avformat.h 声明了格式相关的函数和枚举。
引用文件：
库：libnative_media_core.so
native_avmemory.h 声明了AVMemory的函数接口。
引用文件：
库：libnative_media_core.so

类型定义

名称 描述
OH_AVErrCode 音视频错误码。
OH_AVPixelFormat AVPixel 格式的枚举类。

枚举

名称 描述
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
}		 音视频错误码。
OH_AVPixelFormat {
    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_CreateAudioFormat (const char *mimeType, int32_t sampleRate, int32_t channelCount) 创建音频OH_AVFormat句柄指针，用于读写数据。
*OH_AVFormat_CreateVideoFormat (const char *mimeType, int32_t width, int32_t height) 创建视频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) 将int数据写入OH_AVFormat。
OH_AVFormat_SetLongValue (struct OH_AVFormat *format, const char *key, int64_t value) 将long数据写入OH_AVFormat。
OH_AVFormat_SetFloatValue (struct OH_AVFormat *format, const char *key, float value) 将float数据写入OH_AVFormat。
OH_AVFormat_SetDoubleValue (struct OH_AVFormat *format, const char *key, double value) 将double数据写入OH_AVFormat。
OH_AVFormat_SetStringValue (struct OH_AVFormat *format, const char *key, const char *value) 将string数据写入OH_AVFormat。
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读取string数据。
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中包含的字符串。
*OH_AVMemory_Create (int32_t size) 创建OH_AVMemory实例的指针。
*OH_AVMemory_GetAddr (struct OH_AVMemory *mem) 获取入参的内存虚拟地址。
OH_AVMemory_GetSize (struct OH_AVMemory *mem) 获取入参的内存长度。
OH_AVMemory_Destroy (struct OH_AVMemory *mem) 释放OH_AVMemory实例指针的资源。

类型定义说明

OH_AVErrCode

typedef enum OH_AVErrCode OH_AVErrCode

描述：

音视频错误码。

\@syscap SystemCapability.Multimedia.Media.Core

起始版本：

9

OH_AVPixelFormat

typedef enum OH_AVPixelFormat OH_AVPixelFormat

描述：

视频像素格式的枚举类。

\@syscap SystemCapability.Multimedia.Media.Core

起始版本：

9

枚举类型说明

OH_AVErrCode

enum OH_AVErrCode

描述：

音视频错误码。

\@syscap SystemCapability.Multimedia.Media.Core

起始版本：

9

枚举值 描述
AV_ERR_OK 操作成功
AV_ERR_NO_MEMORY 无内存
AV_ERR_OPERATE_NOT_PERMIT 操作不允许
AV_ERR_INVALID_VAL 无效值
AV_ERR_IO IO错误
AV_ERR_TIMEOUT 超时错误
AV_ERR_UNKNOWN 未知错误
AV_ERR_SERVICE_DIED 服务死亡
AV_ERR_INVALID_STATE 当前状态不支持此操作
AV_ERR_UNSUPPORT 未支持的接口
AV_ERR_EXTEND_START 扩展错误码初始值

OH_AVPixelFormat

enum OH_AVPixelFormat

描述：

视频像素格式的枚举类。

\@syscap SystemCapability.Multimedia.Media.Core

起始版本：

9

枚举值 描述
AV_PIXEL_FORMAT_YUVI420 yuv 420 planar
AV_PIXEL_FORMAT_NV12 NV12. yuv 420 semiplanar
AV_PIXEL_FORMAT_NV21 NV21. yvu 420 semiplanar
AV_PIXEL_FORMAT_SURFACE_FORMAT surface格式
AV_PIXEL_FORMAT_RGBA RGBA8888

函数说明

OH_AVFormat_Copy()

bool OH_AVFormat_Copy (struct OH_AVFormat *to, struct OH_AVFormat *from)

描述：

复制OH_AVFormat句柄。

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
to OH_AVFormat句柄，用于接收数据
from 指向复制数据的OH_AVFormat句柄的指针

返回：

返回值为true表示成功，为false表示失败

起始版本：

9

OH_AVFormat_Create()

struct OH_AVFormat* OH_AVFormat_Create (void)

描述：

创建OH_AVFormat句柄，用于读取数据。

\@syscap SystemCapability.Multimedia.Media.Core

返回：

返回指向OH_AVFormat实例的指针

起始版本：

9

OH_AVFormat_CreateAudioFormat()

struct OH_AVFormat* OH_AVFormat_CreateAudioFormat (const char *mimeType, int32_t sampleRate, int32_t channelCount)

描述：

创建音频OH_AVFormat句柄指针，用于读写数据。

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
mimeType MIME类型描述字符串，请参阅AVCODEC_MIMETYPE
sampleRate 采样率，单位Hz。
channelCount 声道个数，如1为单声道，2为双声道。

返回：

返回指向OH_AVFormat实例的指针。

起始版本：

10

OH_AVFormat_CreateVideoFormat()

struct OH_AVFormat* OH_AVFormat_CreateVideoFormat (const char *mimeType, int32_t width, int32_t height)

描述：

创建视频OH_AVFormat句柄指针，用于读写数据。

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
mimeType MIME类型描述字符串，请参阅AVCODEC_MIMETYPE
width 宽度，单位为px。
height 高度，单位为px。

返回：

返回指向OH_AVFormat实例的指针。

起始版本：

10

OH_AVFormat_Destroy()

void OH_AVFormat_Destroy (struct OH_AVFormat *format)

描述：

销毁OH_AVFormat句柄。

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
format 指向OH_AVFormat实例的指针。

起始版本：

9

OH_AVFormat_DumpInfo()

const char* OH_AVFormat_DumpInfo (struct OH_AVFormat *format)

描述：

输出OH_AVFormat中包含的字符串。

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
format 指向OH_AVFormat实例的指针

返回：

返回一个由key和data组成的字符串。

起始版本：

9

OH_AVFormat_GetBuffer()

bool OH_AVFormat_GetBuffer (struct OH_AVFormat *format, const char *key, uint8_t **addr, size_t *size)

描述：

从OH_AVFormat中读取指定长度的数据块。

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
format 指向OH_AVFormat实例的指针。
key 读写数据的键。
addr 生命周期与format相同，与format一同销毁。 如果调用者需要长时间保持它，必须进行内存拷贝。
size 读写数据的长度。

返回：

返回值为true表示成功，为false表示失败。

起始版本：

9

OH_AVFormat_GetDoubleValue()

bool OH_AVFormat_GetDoubleValue (struct OH_AVFormat *format, const char *key, double *out)

描述：

从OH_AVFormat读取double数据。

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
format 指向OH_AVFormat实例的指针
key 读取数据的键
out 读取数据的值

返回：

返回值为true表示成功，为false表示失败

起始版本：

9

OH_AVFormat_GetFloatValue()

bool OH_AVFormat_GetFloatValue (struct OH_AVFormat *format, const char *key, float *out)

描述：

从OH_AVFormat读取Float数据。

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
format 指向OH_AVFormat实例的指针
key 读取数据的键
out 读取数据的值

返回：

返回值为true表示成功，为false表示失败

起始版本：

9

OH_AVFormat_GetIntValue()

bool OH_AVFormat_GetIntValue (struct OH_AVFormat *format, const char *key, int32_t *out)

描述：

从OH_AVFormat读取int数据。

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
format 指向OH_AVFormat实例的指针
key 读取数据的键
out 读取数据的值

返回：

返回值为true表示成功，为false表示失败

OH_AVFormat_GetLongValue()

bool OH_AVFormat_GetLongValue (struct OH_AVFormat *format, const char *key, int64_t *out)

描述：

从OH_AVFormat读取long数据。

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
format 指向OH_AVFormat实例的指针
key 读取数据的键
out 读取数据的值

返回：

返回值为true表示成功，为false表示失败

起始版本：

9

OH_AVFormat_GetStringValue()

bool OH_AVFormat_GetStringValue (struct OH_AVFormat *format, const char *key, const char **out)

描述：

从OH_AVFormat读取string数据。

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
format 指向OH_AVFormat实例的指针
key 读取数据的键
out 读取string指针，out数据的生命周期与format内string对应。 如果调用者需要长时间保持它，必须内存拷贝

返回：

返回值为true表示成功，为false表示失败

起始版本：

9

OH_AVFormat_SetBuffer()

bool OH_AVFormat_SetBuffer (struct OH_AVFormat *format, const char *key, const uint8_t *addr, size_t size)

描述：

将指定长度的数据块写入OH_AVFormat。

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
format 指向OH_AVFormat实例的指针
key 写入数据的键
addr 写入数据的地址
size 写入数据的长度

返回：

返回值为true表示成功，为false表示失败

起始版本：

9

OH_AVFormat_SetDoubleValue()

bool OH_AVFormat_SetDoubleValue (struct OH_AVFormat *format, const char *key, double value)

描述：

将double数据写入OH_AVFormat。

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
format 指向OH_AVFormat实例的指针
key 写入数据的键
value 写入数据的值

返回：

返回值为true表示成功，为false表示失败

起始版本：

9

OH_AVFormat_SetFloatValue()

bool OH_AVFormat_SetFloatValue (struct OH_AVFormat *format, const char *key, float value)

描述：

将float数据写入OH_AVFormat。

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
format 指向OH_AVFormat实例的指针
key 写入数据的键
value 写入数据的值

返回：

返回值为true表示成功，为false表示失败

起始版本：

9

OH_AVFormat_SetIntValue()

bool OH_AVFormat_SetIntValue (struct OH_AVFormat *format, const char *key, int32_t value)

描述：

将int数据写入OH_AVFormat。

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
format 指向OH_AVFormat实例的指针
key 写入数据的键
value 写入数据的值

返回：

返回值为true表示成功，为false表示失败

起始版本：

9

OH_AVFormat_SetLongValue()

bool OH_AVFormat_SetLongValue (struct OH_AVFormat *format, const char *key, int64_t value)

描述：

将long数据写入OH_AVFormat。

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
format 指向OH_AVFormat实例的指针
key 写入数据的键
value 写入数据的值

返回：

返回值为true表示成功，为false表示失败

起始版本：

9

OH_AVFormat_SetStringValue()

bool OH_AVFormat_SetStringValue (struct OH_AVFormat *format, const char *key, const char *value)

描述：

将string数据写入OH_AVFormat。

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
format 指向OH_AVFormat实例的指针
key 写入数据的键
value 写入数据的值

返回：

返回值为true表示成功，为false表示失败

起始版本：

9

OH_AVMemory_Create()

OH_AVMemory* OH_AVMemory_Create (int32_t size)

描述：

创建OH_AVMemory实例的指针

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
size 创建内存的大小，单位字节

返回：

如果创建成功返回OH_AVMemory实例的指针，如果失败，返回nullptr， 使用结束后需要通过OH_AVMemory_Destroy释放内存

起始版本：

10

OH_AVMemory_Destroy()

OH_AVErrCode OH_AVMemory_Destroy (struct OH_AVMemory *mem)

描述：

释放OH_AVMemory实例指针的资源

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
mem 指向OH_AVMemory实例的指针

返回：

如果释放成功返回AV_ERR_OK, 如果失败返回具体错误码, 参考OH_AVErrCode

起始版本：

10

OH_AVMemory_GetAddr()

uint8_t* OH_AVMemory_GetAddr (struct OH_AVMemory *mem)

描述：

获取入参的内存虚拟地址

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
mem 指向OH_AVMemory实例的指针

返回：

如果内存有效，返回内存的虚拟地址，如果内存无效，返回nullptr

起始版本：

9

OH_AVMemory_GetSize()

int32_t OH_AVMemory_GetSize (struct OH_AVMemory *mem)

描述：

获取入参的内存长度

\@syscap SystemCapability.Multimedia.Media.Core

参数：

名称 描述
mem 指向OH_AVMemory实例的指针

返回：

如果内存有效，返回内存长度，如果内存无效，返回-1

起始版本：

9

你可能感兴趣的鸿蒙文章

harmony 鸿蒙Native API

harmony 鸿蒙AVCapability

harmony 鸿蒙AVDemuxer

harmony 鸿蒙AVMuxer

harmony 鸿蒙AVScreenCapture

harmony 鸿蒙AVSource

harmony 鸿蒙AudioDecoder

harmony 鸿蒙AudioEncoder

harmony 鸿蒙CodecBase

harmony 鸿蒙Drawing

0  赞
  • 所属分类： 后端技术
  • 本文标签：
  • 版权声明： 原创文章如转载，请注明本文链接: https://www.seaxiang.com/blog/980590cbfad24565b0556af6c5a98e57
热门推荐
标签云
Linux Java Spring Spring Boot docker 大数据 前端 生活 maven golang 软件 spring cloud fintech mac vscode 其他 区块链 以太坊 V神 开发者 技术 股票 git greenplum 分布式事务 chrome mysql flink kafka 设计模式 原理 鸿蒙 seo
最新文章
本文目录