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