native_audio_session_manager.h

概述

声明音频会话管理相关的接口。

包含创建音频会话管理器、激活/停用音频会话、检查音频会话是否已激活，以及监听音频会话停用事件。

库： libohaudio.so

引用文件：<ohaudio/native_audio_session_manager.h>

系统能力： SystemCapability.Multimedia.Audio.Core

起始版本： 12

相关模块：OHAudio

汇总

结构体

名称	描述
struct OH_AudioSession_Strategy	音频会话策略。
struct OH_AudioSession_DeactivatedEvent	音频会话已停用事件。

类型定义

名称	描述
typedef struct OH_AudioSessionManager OH_AudioSessionManager	声明音频会话管理器。
typedef struct OH_AudioSession_Strategy OH_AudioSession_Strategy	音频会话策略。
typedef struct OH_AudioSession_DeactivatedEvent OH_AudioSession_DeactivatedEvent	音频会话已停用事件。
typedef int32_t (*OH_AudioSession_DeactivatedCallback)(OH_AudioSession_DeactivatedEvent event)	这个函数指针将指向用于监听音频会话停用事件的回调函数。

枚举

名称	描述
OH_AudioSession_ConcurrencyMode { CONCURRENCY_DEFAULT = 0, CONCURRENCY_MIX_WITH_OTHERS = 1, CONCURRENCY_DUCK_OTHERS = 2, CONCURRENCY_PAUSE_OTHERS = 3 }	音频并发模式。
OH_AudioSession_DeactivatedReason { DEACTIVATED_LOWER_PRIORITY = 0, DEACTIVATED_TIMEOUT = 1 }	音频会话停用原因。

函数

名称	描述
OH_AudioCommon_Result OH_AudioManager_GetAudioSessionManager(OH_AudioSessionManager **audioSessionManager)	获取音频会话管理器。
OH_AudioCommon_Result OH_AudioSessionManager_ActivateAudioSession(OH_AudioSessionManager *audioSessionManager, const OH_AudioSession_Strategy *strategy)	激活音频会话。
OH_AudioCommon_Result OH_AudioSessionManager_DeactivateAudioSession(OH_AudioSessionManager *audioSessionManager)	停用音频会话。
bool OH_AudioSessionManager_IsAudioSessionActivated(OH_AudioSessionManager *audioSessionManager)	检查音频会话是否已激活。
OH_AudioCommon_Result OH_AudioSessionManager_RegisterSessionDeactivatedCallback(OH_AudioSessionManager *audioSessionManager, OH_AudioSession_DeactivatedCallback callback)	注册音频会话停用事件回调。
OH_AudioCommon_Result OH_AudioSessionManager_UnregisterSessionDeactivatedCallback(OH_AudioSessionManager *audioSessionManager, OH_AudioSession_DeactivatedCallback callback)	取消注册音频会话停用事件回调。