# AudioScene ## **Overview** **Related Modules:** [Audio](Audio.md) **Description:** Provides scene-related APIs for audio rendering or capturing, including functions to select an audio scene and check whether the configuration of an audio scene is supported. **Since:** 1.0 **Version:** 1.0 ## **Summary** ## Data Fields

Variable Name

Description

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

int32_t(* 

Checks whether the configuration of an audio scene is supported.

SelectScene )(AudioHandle handle, const struct AudioSceneDescriptor *scene)

int32_t(* 

Selects an audio scene.

## **Details** ## **Field Documentation** ## CheckSceneCapability ``` int32_t(* AudioScene::CheckSceneCapability) ([AudioHandle](Audio.md#ga18675ddb073465fdeac33a897f675d79) handle, const struct [AudioSceneDescriptor](AudioSceneDescriptor.md) *scene, bool *supported) ``` **Description:** Checks whether the configuration of an audio scene is supported. **Parameters:**

Name

Description
handle Indicates the audio handle.
scene Indicates the pointer to the descriptor of the audio scene.
supported Indicates the pointer to the variable specifying whether the configuration is supported. Value true means that the configuration is supported, and false means the opposite.
**Returns:** Returns **0** if the result is obtained; returns a negative value otherwise. **See also:** [SelectScene](AudioScene.md#aacdbf3a9f488a7e71f3a5a23c68c0068) ## SelectScene ``` int32_t(* AudioScene::SelectScene) ([AudioHandle](Audio.md#ga18675ddb073465fdeac33a897f675d79) handle, const struct [AudioSceneDescriptor](AudioSceneDescriptor.md) *scene) ``` **Description:** Selects an audio scene. **Parameters:**

Name

Description
handle Indicates the audio handle.
scene Indicates the pointer to the descriptor of the audio scene to select.
**Returns:** Returns **0** if the scene is selected successfully; returns a negative value otherwise. **See also:** [CheckSceneCapability](AudioScene.md#a9b485404b2ec3b8bc2b8d1b73401d45c)