AudioAdapter

概述

AudioAdapter音频适配器接口。

提供音频适配器（声卡）对外支持的驱动能力，包括初始化端口、创建Render、创建Capture、获取端口能力集等。

Since:

1.0

Version:

1.0

相关模块:

Audio

参见：

AudioRender

AudioCapture

汇总

Public 属性

类成员变量说明

CreateCapture

int32_t(* AudioAdapter::CreateCapture) (struct AudioAdapter *adapter, const struct AudioDeviceDescriptor *desc, const struct AudioSampleAttributes *attrs, struct AudioCapture **capture)

描述：

创建一个音频录音（Capture）接口的对象。

参数:

返回:

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

参见:

GetPortCapability

DestroyCapture

CreateRender

int32_t(* AudioAdapter::CreateRender) (struct AudioAdapter *adapter, const struct AudioDeviceDescriptor *desc, const struct AudioSampleAttributes *attrs, struct AudioRender **render)

描述：

创建一个音频播放（Render）接口的对象。

参数:

返回:

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

参见:

GetPortCapability

DestroyRender

DestroyCapture

int32_t(* AudioAdapter::DestroyCapture) (struct AudioAdapter *adapter, struct AudioCapture *capture)

描述：

销毁一个音频录音（Capture）接口的对象。

参数:

注意:

在音频录音过程中，不能销毁该接口对象。

返回:

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

参见:

CreateCapture

DestroyRender

int32_t(* AudioAdapter::DestroyRender) (struct AudioAdapter *adapter, struct AudioRender *render)

描述：

销毁一个音频播放（Render）接口的对象。

参数:

注意:

在音频播放过程中，不能销毁该接口对象

返回:

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

参见:

CreateRender

GetPassthroughMode

int(* AudioAdapter::GetPassthroughMode) (struct AudioAdapter *adapter, struct AudioPort *port, enum AudioPortPassthroughMode *mode)

描述：

获取音频端口驱动的数据透传模式。

参数:

返回:

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

参见:

SetPassthroughMode

GetPortCapability

int(* AudioAdapter::GetPortCapability) (struct AudioAdapter *adapter, struct AudioPort *port, struct AudioPortCapability *capability)

描述：

获取一个音频适配器的端口驱动的能力集。

参数:

返回:

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

InitAllPorts

int(* AudioAdapter::InitAllPorts) (struct AudioAdapter *adapter)

描述：

初始化一个音频适配器所有的端口驱动。

在音频服务中，调用其他驱动接口前需要首先调用该接口检查端口是否已经初始化完成：

• 如果端口驱动初始化完成，则函数返回值0， 否则返回负值。

• 如果端口没有初始化完成，则需要等待一段时间（例如100ms）后重新进行检查，直到端口初始化完成后再继续操作。

参数:

返回:

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

ReleaseAudioRoute

int32_t(* AudioAdapter::ReleaseAudioRoute) (struct AudioAdapter *adapter, int32_t routeHandle)

描述：

释放一个音频路由。

参数:

返回:

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

SetPassthroughMode

int(* AudioAdapter::SetPassthroughMode) (struct AudioAdapter *adapter, struct AudioPort *port, enum AudioPortPassthroughMode mode)

描述：

设置音频端口驱动的数据透传模式。

参数:

返回:

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

参见:

GetPassthroughMode

UpdateAudioRoute

int32_t(* AudioAdapter::UpdateAudioRoute) (struct AudioAdapter *adapter, const struct AudioRoute *route, int32_t *routeHandle)

描述：

更新一个或多个发送端和接受端之间的路由。

参数:

返回:

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