• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 音频输入设备管理
2
3有时设备同时连接多个音频输入设备,需要指定音频输入设备进行音频录制,此时需要使用AudioRoutingManager接口进行输入设备的管理,API说明可以参考[AudioRoutingManager API文档](../reference/apis/js-apis-audio.md#audioroutingmanager9)。
4
5## 创建AudioRoutingManager实例
6
7在使用AudioRoutingManager管理音频设备前,需要先导入模块并创建实例。
8
9```ts
10import audio from '@ohos.multimedia.audio';  // 导入audio模块
11
12import { BusinessError } from '@ohos.base'; // 导入BusinessError
13
14let audioManager = audio.getAudioManager();  // 需要先创建AudioManager实例
15
16let audioRoutingManager = audioManager.getRoutingManager();  // 再调用AudioManager的方法创建AudioRoutingManager实例
17```
18
19## 支持的音频输入设备类型
20
21目前支持的音频输入设备见下表:
22
23| 名称 | 值 | 说明 |
24| -------- | -------- | -------- |
25| WIRED_HEADSET | 3 | 有线耳机,带麦克风。 |
26| BLUETOOTH_SCO | 7 | 蓝牙设备SCO(Synchronous Connection Oriented)连接。 |
27| MIC | 15 | 麦克风。 |
28| USB_HEADSET | 22 | USB耳机,带麦克风。 |
29
30## 获取输入设备信息
31
32使用getDevices()方法可以获取当前所有输入设备的信息。
33
34```ts
35audioRoutingManager.getDevices(audio.DeviceFlag.INPUT_DEVICES_FLAG).then((data: audio.AudioDeviceDescriptors) => {
36  console.info('Promise returned to indicate that the device list is obtained.');
37});
38```
39
40## 监听设备连接状态变化
41
42可以设置监听事件来监听设备连接状态的变化,当有设备连接或断开时触发回调:
43
44```ts
45// 监听音频设备状态变化
46audioRoutingManager.on('deviceChange', audio.DeviceFlag.INPUT_DEVICES_FLAG, (deviceChanged: audio.DeviceChangeAction) => {
47  console.info('device change type : ' + deviceChanged.type);  // 设备连接状态变化,0为连接,1为断开连接
48  console.info('device descriptor size : ' + deviceChanged.deviceDescriptors.length);
49  console.info('device change descriptor : ' + deviceChanged.deviceDescriptors[0].deviceRole);  // 设备角色
50  console.info('device change descriptor : ' + deviceChanged.deviceDescriptors[0].deviceType);  // 设备类型
51});
52
53// 取消监听音频设备状态变化
54audioRoutingManager.off('deviceChange', (deviceChanged: audio.DeviceChangeAction) => {
55  console.info('Should be no callback.');
56});
57```
58
59## 选择音频输入设备(仅对系统应用开放)
60
61选择音频输入设备,当前只能选择一个输入设备,以设备id作为唯一标识。AudioDeviceDescriptors的具体信息可以参考[AudioDeviceDescriptors](../reference/apis/js-apis-audio.md#audiodevicedescriptors)。
62
63> **说明:**
64>
65> 用户可以选择连接一组音频设备(如一对蓝牙耳机),但系统侧只感知为一个设备,该组设备共用一个设备id。
66
67```ts
68import audio from '@ohos.multimedia.audio';
69let inputAudioDeviceDescriptor: audio.AudioDeviceDescriptors = [{
70    deviceRole : audio.DeviceRole.INPUT_DEVICE,
71    deviceType : audio.DeviceType.EARPIECE,
72    id : 1,
73    name : "",
74    address : "",
75    sampleRates : [44100],
76    channelCounts : [2],
77    channelMasks : [0],
78    networkId : audio.LOCAL_NETWORK_ID,
79    interruptGroupId : 1,
80    volumeGroupId : 1,
81    displayName : ""
82}];
83
84async function getRoutingManager() {
85    audioRoutingManager.selectInputDevice(inputAudioDeviceDescriptor).then(() => {
86      console.info('Invoke selectInputDevice succeeded.');
87    }).catch((err: BusinessError) => {
88      console.error(`Invoke selectInputDevice failed, code is ${err.code}, message is ${err.message}`);
89    });
90}
91
92```
93