​

一、功能概述

目标：实现在HarmonyOS应用中动态切换通话音频输出设备（如听筒、扬声器、蓝牙耳机、车载设备等）。

适用场景：语音通话、视频会议、车载系统等需要灵活控制音频路由的场景。

技术基础：基于call模块的AudioDeviceManager能力。

二、核心概念与接口

1. 音频设备类型（AudioDevice）

2. 关键接口

三、开发步骤详解

步骤1：导入模块

import call from '@ohos.telephony.call';

步骤2：获取设备管理器

const audioDeviceManager = call.getAudioDeviceManager();

步骤3：获取当前设备信息

// 获取当前激活设备
const currentDevice: call.AudioDevice = audioDeviceManager.getCurrentAudioDevice();
console.log(`当前设备: ${currentDevice}`);

// 获取所有可用设备
const deviceList: Array<call.AudioDevice> = audioDeviceManager.getCurrentAudioDevices();
deviceList.forEach(device => console.log(`可用设备: ${device}`));

步骤4：切换通话设备

// 目标设备（示例切换至车载设备）
const targetDevice: call.AudioDevice = call.AudioDevice.AUDIO_DEVICE_VEHICLE;

audioDeviceManager.setAudioDevice(targetDevice, (err) => {
  if (err) {
    console.error(`切换失败: ${err.code}, ${err.message}`);
  } else {
    console.log("已切换至车载设备");
  }
});

步骤5：监听设备变更

audioDeviceManager.on('deviceChange', (data) => {
  console.log(`设备变更: 新设备=${data.device}, 变更原因=${data.reason}`);
  // 原因枚举：DEVICE_ACTIVE=0, DEVICE_DISABLE=1, DEVICE_ENABLE=2
});

四、关键注意事项

1. 权限要求：必须申请：ohos.permission.MANAGE_VOICECALL（系统权限）车载场景需额外声明：ohos.permission.ACCESS_VEHICLE_BLUETOOTH
2. 兼容性限制：仅支持API 10+（HarmonyOS 4.0及以上版本）车载设备（VEHICLE）需设备厂商预置对应驱动
3. 错误处理重点：401：参数非法（如无效设备类型）8010002：权限未授权（需引导用户开启）8010004：设备不支持（如无听筒的平板设备）
4. 设备切换策略：蓝牙设备需先配对并连接成功监听deviceChange事件处理意外断开（如拔出耳机自动切回听筒）

五、最佳实践建议

1. 用户界面设计：动态生成设备列表：基于getCurrentAudioDevices()实时更新可选设备禁用不可用选项：如无蓝牙设备时隐藏对应按钮
2. 车载场景特殊处理：// 检测到车载设备时自动切换 if (deviceList.includes(call.AudioDevice.AUDIO_DEVICE_VEHICLE)) { setAudioDevice(call.AudioDevice.AUDIO_DEVICE_VEHICLE); }
3. 异常恢复机制：audioDeviceManager.on('deviceChange', (data) => { if (data.reason === 1 /* DEVICE_DISABLE */) { // 设备失效时切回扬声器 setAudioDevice(call.AudioDevice.AUDIO_DEVICE_SPEAKER); } });

六、流程图解

此功能是实现多设备协同通话的核心能力，尤其在车机互联场景下，正确管理音频路由可显著提升用户体验。​