AudioScene

概述

AudioScene音频场景接口。

提供音频播放（Render）或录音（Capture）需要的公共场景驱动能力，包括选择音频场景等。

Since：

1.0

Version：

1.0

相关模块:

Audio

汇总

Public 属性

名称 描述
(CheckSceneCapability)(AudioHandle handle, const struct AudioSceneDescriptor *scene, bool *supported) 是否支持某个音频场景的配置
(SelectScene)(AudioHandle handle, const struct AudioSceneDescriptor *scene) 选择音频场景

类成员变量说明

CheckSceneCapability

int32_t(* AudioScene::CheckSceneCapability) (AudioHandle handle, const struct AudioSceneDescriptor *scene, bool *supported)

描述：

是否支持某个音频场景的配置。

参数:

名称 描述
handle 输入参数，待操作的音频句柄。
scene 输入参数，待获取的音频场景描述符。
supported 输出参数，是否支持的状态保存到supported中，true表示支持，false表示不支持。

返回:

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

参见:

SelectScene

SelectScene

int32_t(* AudioScene::SelectScene) (AudioHandle handle, const struct AudioSceneDescriptor *scene)

描述：

选择音频场景。

  • 选择一个非常具体的音频场景（应用场景和输出设备的组合），例如同样是使用手机中的喇叭作为输出设备：

    • 在媒体播放场景scene为media_speaker
    • 在语音通话免提场景scene为voice_speaker

  • 只是选择一个音频场景，例如使用场景为媒体播放（media）、电影播放（movie）、游戏播放（game）。

  • 只是选择一个音频输出设备，例如输出设备为听筒（receiver）、喇叭（speaker）、有线耳机（headset）。

参数:

名称 描述
handle 输入参数，待操作的音频句柄。
scene 输入参数，待设置的音频场景描述符。

返回:

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

参见:

CheckSceneCapability