鸿蒙5.0&next开发【使用AudioSession管理应用音频焦点(C/C++)】音视频

是秃子总会反光

墨衍会员 · AI 创作全网分发码龄2年

关注

原创最新推荐文章于 2026-09-19 11:11:25 发布 743 阅读 AI 写同款· GEO 优化 ›

限时加码！20+主流AI编程工具免费用购周边加赠Coding Plan Lite，Claude Code、Cursor等即刻畅享，学习进阶更高效！阅读详情

使用AudioSession管理应用音频焦点(C/C++)

对于涉及多个音频流并发播放的场景，系统已预设了默认的[音频焦点策略]，该策略将对所有音频流（包括播放和录制）实施统一的焦点管理。

应用可利用音频会话管理（AudioSessionManager）提供的接口，通过AudioSession主动管理应用内音频流的焦点，自定义本应用音频流的焦点策略，调整本应用音频流释放音频焦点的时机，从而贴合应用特定的使用需求。

本文档主要介绍AudioSession相关C API的使用方法和注意事项，更多音频焦点及音频会话的信息

使用入门

应用要使用OHAudio提供的音频会话管理（AudioSessionManager）能力，需要添加对应的头文件。

在 CMake 脚本中链接动态库

target_link_libraries(sample PUBLIC libohaudio.so)
cmake

添加头文件

应用通过引入[native_audio_session_manager.h]头文件，使用音频播放相关API。

#include <ohaudio/native_audio_session_manager.h>
cpp

获取音频会话管理器

创建[OH_AudioSessionManager]实例。在使用音频会话管理功能前，需要先通过[OH_AudioManager_GetAudioSessionManager]创建音频会话管理实例。

OH_AudioSessionManager *audioSessionManager;
OH_AudioManager_GetAudioSessionManager(&audioSessionManager);
cpp

激活音频会话

应用可以通过[OH_AudioSessionManager_ActivateAudioSession]接口激活当前应用的音频会话。

应用在[激活音频会话]时，需指定[音频会话策略（OH_AudioSession_Strategy）]，其中包含[音频并发模式（OH_AudioSession_ConcurrencyMode）]参数，用于声明不同的音频并发策略。

OH_AudioSession_Strategy strategy = {CONCURRENCY_MIX_WITH_OTHERS};

OH_AudioSessionManager_ActivateAudioSession(audioSessionManager, &strategy);
cpp

查询音频会话是否已激活

应用可以通过[OH_AudioSessionManager_IsAudioSessionActivated]接口检查当前应用的音频会话是否已激活。

bool isActivated = OH_AudioSessionManager_IsAudioSessionActivated(audioSessionManager);
cpp

停用音频会话

应用可以通过[OH_AudioSessionManager_DeactivateAudioSession]接口停用当前应用的音频会话。

OH_AudioSessionManager_DeactivateAudioSession(audioSessionManager);
cpp

监听音频会话停用事件

在使用AudioSession功能的过程中，推荐应用监听[音频会话停用事件（OH_AudioSession_DeactivatedEvent）]。

当AudioSession被停用（非主动停用）时，应用会收到[音频会话停用事件（OH_AudioSession_DeactivatedEvent）]，其中包含[音频会话停用原因（OH_AudioSession_DeactivatedReason）]。

在收到AudioSessionDeactivatedEvent时，应用可根据自身业务需求，做相应的处理，例如释放相应资源、重新激活AudioSession等。

定义回调函数

int32_t MyAudioSessionDeactivatedCallback(OH_AudioSession_DeactivatedEvent event)
{
  switch(event.reason) {
    case DEACTIVATED_LOWER_PRIORITY:
      // 应用焦点被抢占
      return 0;
    case DEACTIVATED_TIMEOUT:
      // 超时
      return 0;
  }
}
cpp

注册音频会话停用事件回调

应用可以通过[OH_AudioSessionManager_RegisterSessionDeactivatedCallback]接口监听音频会话停用事件。

OH_AudioSessionManager_RegisterSessionDeactivatedCallback(audioSessionManager, MyAudioSessionDeactivatedCallback);
cpp

取消注册音频会话停用事件回调

应用可以通过[OH_AudioSessionManager_UnregisterSessionDeactivatedCallback]接口取消监听音频会话停用事件。

OH_AudioSessionManager_UnregisterSessionDeactivatedCallback(audioSessionManager, MyAudioSessionDeactivatedCallback);
cpp

完整示例

参考以下示例，完成音频会话从创建到激活并监听的过程。

#include <cstdint>
#include "ohaudio/native_audio_session_manager.h"

int32_t MyAudioSessionDeactivatedCallback(OH_AudioSession_DeactivatedEvent event)
{
  switch(event.reason) {
    case DEACTIVATED_LOWER_PRIORITY:
      // 应用焦点被抢占
      return 0;
    case DEACTIVATED_TIMEOUT:
      // 超时
      return 0;
  }
}

OH_AudioSessionManager *audioSessionManager;

// 创建音频会话管理器
OH_AudioCommon_Result resultManager = OH_AudioManager_GetAudioSessionManager(&audioSessionManager);

OH_AudioSession_Strategy strategy = {CONCURRENCY_MIX_WITH_OTHERS};

// 设置音频并发模式并激活音频会话
OH_AudioCommon_Result resultActivate = OH_AudioSessionManager_ActivateAudioSession(audioSessionManager, &strategy);

// 查询音频会话是否已激活。
bool isActivated = OH_AudioSessionManager_IsAudioSessionActivated(audioSessionManager);

// 监听音频会话停用事件
OH_AudioCommon_Result resultRegister = OH_AudioSessionManager_RegisterSessionDeactivatedCallback(audioSessionManager, MyAudioSessionDeactivatedCallback);

// 音频会话激活后应用在此处正常执行音频播放、暂停、停止、释放等操作即可。 

// 取消监听音频会话停用事件
OH_AudioCommon_Result resultUnregister = OH_AudioSessionManager_UnregisterSessionDeactivatedCallback(audioSessionManager, MyAudioSessionDeactivatedCallback);

// 停用音频会话
OH_AudioCommon_Result resultDeactivate = OH_AudioSessionManager_DeactivateAudioSession(audioSessionManager);

收录于