1# AudioScene 2 3 4## **概述** 5 6AudioScene音频场景接口。 7 8提供音频播放（Render）或录音（Capture）需要的公共场景驱动能力，包括选择音频场景等。 9 10**Since：** 11 121.0 13 14**Version：** 15 161.0 17 18**相关模块:** 19 20[Audio](_audio.md) 21 22 23## **汇总** 24 25 26### Public 属性 27 28 | 名称 | 描述 | 29| -------- | -------- | 30| ([CheckSceneCapability](#checkscenecapability))(AudioHandle handle, const struct AudioSceneDescriptor \*scene, bool \*supported) | 是否支持某个音频场景的配置 | 31| ([SelectScene](#selectscene))(AudioHandle handle, const struct AudioSceneDescriptor \*scene) | 选择音频场景 | 32 33 34## **类成员变量说明** 35 36 37### CheckSceneCapability 38 39 40``` 41int32_t(* AudioScene::CheckSceneCapability) (AudioHandle handle, const struct AudioSceneDescriptor *scene, bool *supported) 42``` 43 44**描述：** 45 46是否支持某个音频场景的配置。 47 48**参数:** 49 50 | 名称 | 描述 | 51| -------- | -------- | 52| handle | 输入参数，待操作的音频句柄。 | 53| scene | 输入参数，待获取的音频场景描述符。 | 54| supported | 输出参数，是否支持的状态保存到supported中，true表示支持，false表示不支持。 | 55 56**返回:** 57 58成功返回值0，失败返回负值。 59 60**参见:** 61 62[SelectScene](#selectscene) 63 64 65### SelectScene 66 67 68``` 69int32_t(* AudioScene::SelectScene) (AudioHandle handle, const struct AudioSceneDescriptor *scene) 70``` 71 72**描述：** 73 74选择音频场景。 75 76- 选择一个非常具体的音频场景（应用场景和输出设备的组合），例如同样是使用手机中的喇叭作为输出设备： 77 - 在媒体播放场景scene为media_speaker 78 - 在语音通话免提场景scene为voice_speaker 79 80- 只是选择一个音频场景，例如使用场景为媒体播放（media）、电影播放（movie）、游戏播放（game）。 81 82- 只是选择一个音频输出设备，例如输出设备为听筒（receiver）、喇叭（speaker）、有线耳机（headset）。 83 84**参数:** 85 86 | 名称 | 描述 | 87| -------- | -------- | 88| handle | 输入参数，待操作的音频句柄。 | 89| scene | 输入参数，待设置的音频场景描述符。 | 90 91**返回:** 92 93成功返回值0，失败返回负值。 94 95**参见:** 96 97[CheckSceneCapability](#checkscenecapability) 98