harmony 鸿蒙AudioAttribute

  • 2022-08-09
  • 浏览 (1022)

AudioAttribute

概述

AudioAttribute音频属性接口。

提供音频播放（Render）或录音（Capture）需要的公共属性驱动能力，包括获取帧（frame）信息、设置采样属性等。

Since:

1.0

Version:

1.0

相关模块:

Audio

汇总

Public 属性

名称 描述
(GetFrameSize)(AudioHandle handle, uint64_t *size) 获取音频帧（frame）的大小
(GetFrameCount)(AudioHandle handle, uint64_t *count) 获取音频buffer中的音频帧数
(SetSampleAttributes)(AudioHandle handle, const struct AudioSampleAttributes *attrs) 设置音频采样的属性参数
(GetSampleAttributes)(AudioHandle handle, struct AudioSampleAttributes *attrs) 获取音频采样的属性参数
(GetCurrentChannelId)(AudioHandle handle, uint32_t *channelId) 获取音频的数据通道ID
(SetExtraParams)(AudioHandle handle, const char *keyValueList) 设置音频拓展参数
(GetExtraParams)(AudioHandle handle, char *keyValueList) 获取音频拓展参数
(ReqMmapBuffer)(AudioHandle handle, int32_t reqSize, struct AudioMmapBufferDescriptor *desc) 请求Mmap缓冲区
(GetMmapPosition)(AudioHandle handle, uint64_t *frames, struct AudioTimeStamp *time) 获取当前Mmap的读/写位置
(AddAudioEffect)(AudioHandle handle, uint64_t effectid) 添加音频效果算法实例
(RemoveAudioEffect)(AudioHandle handle, uint64_t effectid) 移除音频效果算法实例
(GetFrameBufferSize)(AudioHandle handle, uint64_t *bufferSize) 获取播放或录音的缓冲区大小

类成员变量说明

AddAudioEffect

int32_t (*AudioAttribute::AddAudioEffect)(AudioHandle handle, uint64_t effectid)

描述：

添加音频效果算法实例。

参数:

名称 描述
handle 输入参数，待操作的音频句柄。
effectid 输入参数，待添加的音频效果算法实例ID。

返回:

成功返回值0，失败返回负值。

GetCurrentChannelId

int32_t(* AudioAttribute::GetCurrentChannelId) (AudioHandle handle, uint32_t *channelId)

描述：

获取音频的数据通道ID。

参数:

名称 描述
handle 输入参数，待操作的音频句柄。
channelId 输出参数，获取的通道ID保存到channelId中。

返回:

成功返回值0，失败返回负值。

GetExtraParams

int32_t(* AudioAttribute::GetExtraParams) (AudioHandle handle, char *keyValueList)

描述：

获取音频拓展参数。

参数:

名称 描述
handle 输入参数，待操作的音频句柄。
keyValueList 输出参数，拓展参数键值对字符串列表，格式为key=value，多个键值对通过分号分割。

返回:

成功返回值0，失败返回负值。

GetFrameBufferSize

int32_t (*AudioAttribute::GetFrameBufferSize)(AudioHandle handle, uint64_t *bufferSize)

描述：

获取播放或录音的缓冲区大小。

参数:

名称 描述
handle 输入参数，待操作的音频句柄。
bufferSize 输出参数，获取的缓冲区大小保存到bufferSize中。

返回:

成功返回值0，失败返回负值。

GetFrameCount

int32_t(* AudioAttribute::GetFrameCount) (AudioHandle handle, uint64_t *count)

描述：

获取音频buffer中的音频帧数。

参数:

名称 描述
handle 输入参数，待操作的音频句柄。
count 输出参数，一个音频buffer中包含的音频帧数，获取后保存到count中。

返回:

成功返回值0，失败返回负值。

GetFrameSize

int32_t(* AudioAttribute::GetFrameSize) (AudioHandle handle, uint64_t *size)

描述：

获取音频帧（frame）的大小，即一帧音频数据的长度（字节数）。

参数:

名称 描述
handle 输入参数，待操作的音频句柄。
size 输出参数，获取的音频帧大小（字节数）保存到size中。

返回:

成功返回值0，失败返回负值。

GetMmapPosition

int32_t(* AudioAttribute::GetMmapPosition) (AudioHandle handle, uint64_t *frames, struct AudioTimeStamp *time)

描述：

获取当前Mmap的读/写位置。

参数:

名称 描述
handle 输入参数，待操作的音频句柄。
frames 输出参数，获取的音频帧计数保存到frames中。
time 输出参数，获取的关联时间戳保存到time中。

返回:

成功返回值0，失败返回负值。

GetSampleAttributes

int32_t(* AudioAttribute::GetSampleAttributes) (AudioHandle handle, struct AudioSampleAttributes *attrs)

描述：

获取音频采样的属性参数。

参数:

名称 描述
handle 输入参数，待操作的音频句柄。
attrs 输出参数，获取的音频采样属性（例如采样频率、采样精度、通道）保存到attrs中。

返回:

成功返回值0，失败返回负值。

参见:

GetSampleAttributes

RemoveAudioEffect

int32_t (*AudioAttribute::RemoveAudioEffect)(AudioHandle handle, uint64_t effectid)

描述：

移除音频效果算法实例。

参数:

名称 描述
handle 输入参数，待操作的音频句柄。
effectid 输入参数，待移除的音频效果算法实例ID。

返回:

成功返回值0，失败返回负值。

ReqMmapBuffer

int32_t(* AudioAttribute::ReqMmapBuffer) (AudioHandle handle, int32_t reqSize, struct AudioMmapBufferDescriptor *desc)

描述：

请求Mmap缓冲区。

参数:

名称 描述
handle 输入参数，待操作的音频句柄。
reqSize 输入参数，请求缓冲区的大小。
desc 输出参数，缓冲区描述符。

返回:

成功返回值0，失败返回负值。

SetExtraParams

int32_t(* AudioAttribute::SetExtraParams) (AudioHandle handle, const char *keyValueList)

描述：

设置音频拓展参数。

参数:

名称 描述
handle 输入参数，待操作的音频句柄。
keyValueList 输入参数，拓展参数键值对字符串列表，格式为key=value，多个键值对通过分号分割。

返回:

成功返回值0，失败返回负值。

SetSampleAttributes

int32_t(* AudioAttribute::SetSampleAttributes) (AudioHandle handle, const struct AudioSampleAttributes *attrs)

描述：

设置音频采样的属性参数。

参数:

名称 描述
handle 输入参数，待操作的音频句柄。
attrs 输入参数，待设置的音频采样属性，例如采样频率、采样精度、通道。

返回:

成功返回值0，失败返回负值。

参见:

GetSampleAttributes

你可能感兴趣的鸿蒙文章

harmony 鸿蒙HDI 参数参考

harmony 鸿蒙ActRecognitionEvent

harmony 鸿蒙Alignment

harmony 鸿蒙AllocInfo

harmony 鸿蒙Audio

harmony 鸿蒙AudioAdapter

harmony 鸿蒙AudioAdapterDescriptor

harmony 鸿蒙AudioCapture

harmony 鸿蒙AudioControl

harmony 鸿蒙AudioDevExtInfo

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