查询和监听其他应用录制状态
=============

对于录制音频类的应用，开发者需要关注该应用的音频流的状态以做出相应的操作，比如监听到状态为结束时，及时提示用户录制已结束。

以下各步骤示例为片段代码，可通过示例代码右下方链接获取[完整示例](https://gitcode.com/openharmony/applications_app_samples/blob/master/code/DocsSample/Media/Audio/AudioCaptureSampleJS)。

#### 读取或监听应用内音频流状态变化

参考[使用AudioCapturer开发音频录制功能(ArkTs)](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/using-audiocapturer-for-recording)或[audio.createAudioCapturer](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-f#audiocreateaudiocapturer8)，先完成AudioCapturer的创建，再通过以下两种方法查看音频流状态的变化。

*   方法1：直接查看AudioCapturer的[属性](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-audiocapturer#属性)state：
    
    let audioCapturerState: audio.AudioState = audioCapturer.state;
    console.info(\`Current state is: ${audioCapturerState }\`)
    
*   方法2：注册stateChange监听AudioCapturer的状态变化：
    
    audioCapturer.on('stateChange', (capturerState: audio.AudioState) => {
      console.info(\`State change to: ${capturerState}\`)
      // ...
    });
    

获取state后可对照[AudioState](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-e#audiostate8)来进行相应的操作，比如显示录制结束的提示等。

#### 读取或监听所有录制流的变化

如果部分应用需要查询获取所有音频流的变化信息，可以通过AudioStreamManager读取或监听所有音频流的变化。

如下为音频流管理调用关系图：

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/18/v3/3TbM6VpxRw2jflsnOAaaCw/zh-cn_image_0000002594668782.png?HW-CC-KV=V1&HW-CC-Date=20260612T073505Z&HW-CC-Expire=86400&HW-CC-Sign=9F4CB4016085546ED2765F018EAE37B319A935556A65AB0BC4FBEF3F3A070FE6)

在进行应用开发的过程中，开发者需要先调用[getStreamManager](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-audiomanager#getstreammanager9)创建AudioStreamManager实例，进而通过该实例管理音频流。

详细API含义可参考[AudioStreamManager](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-audiostreammanager)。

#### 开发步骤及注意事项

1.  创建AudioStreamManager实例。
    
    import { audio } from '@kit.AudioKit';
    import { BusinessError } from '@kit.BasicServicesKit';
    
    let audioManager = audio.getAudioManager();
    let audioStreamManager = audioManager.getStreamManager();
    
2.  使用[on('audioCapturerChange')](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-audiostreammanager#onaudiocapturerchange9)监听音频录制流更改事件。 如果音频流监听应用需要在音频录制流状态变化、设备变化时获取通知，可以订阅该事件。
    
    audioStreamManager.on('audioCapturerChange', (audioCapturerChangeInfoArray: audio.AudioCapturerChangeInfoArray) =>  {
      // ...
      for (let i = 0; i < audioCapturerChangeInfoArray.length; i++) {
        console.info(\`## CapChange on is called for element ${i} ##\`);
        console.info(\`StreamId for ${i} is: ${audioCapturerChangeInfoArray\[i\].streamId}\`);
        console.info(\`Source for ${i} is: ${audioCapturerChangeInfoArray\[i\].capturerInfo.source}\`);
        console.info(\`Flag  ${i} is: ${audioCapturerChangeInfoArray\[i\].capturerInfo.capturerFlags}\`);
    
        // ...
    
        let devDescriptor: audio.AudioDeviceDescriptors = audioCapturerChangeInfoArray\[i\].deviceDescriptors;
        for (let j = 0; j < audioCapturerChangeInfoArray\[i\].deviceDescriptors.length; j++) {
          console.info(\`Id: ${i} : ${audioCapturerChangeInfoArray\[i\].deviceDescriptors\[j\].id}\`);
          console.info(\`Type: ${i} : ${audioCapturerChangeInfoArray\[i\].deviceDescriptors\[j\].deviceType}\`);
          console.info(\`Role: ${i} : ${audioCapturerChangeInfoArray\[i\].deviceDescriptors\[j\].deviceRole}\`);
          console.info(\`Name: ${i} : ${audioCapturerChangeInfoArray\[i\].deviceDescriptors\[j\].name}\`);
          console.info(\`Address: ${i} : ${audioCapturerChangeInfoArray\[i\].deviceDescriptors\[j\].address}\`);
          console.info(\`SampleRates: ${i} : ${audioCapturerChangeInfoArray\[i\].deviceDescriptors\[j\].sampleRates\[0\]}\`);
          console.info(\`ChannelCounts ${i} : ${audioCapturerChangeInfoArray\[i\].deviceDescriptors\[j\].channelCounts\[0\]}\`);
          console.info(\`ChannelMask: ${i} : ${audioCapturerChangeInfoArray\[i\].deviceDescriptors\[j\].channelMasks}\`);
        }
      }
      // ...
    });
    
3.  （可选）使用[off('audioCapturerChange')](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-audiostreammanager#offaudiocapturerchange9)取消监听音频录制流变化。
    
    audioStreamManager.off('audioCapturerChange');
    console.info('CapturerChange Off is called');
    
4.  （可选）使用[getCurrentAudioCapturerInfoArray](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-audiostreammanager#getcurrentaudiocapturerinfoarray9)获取当前音频录制流的信息。该接口可获取音频录制流唯一ID、音频采集器信息以及音频录制设备信息。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/22/v3/Rl4q2QXiTs6WbeSOg-pdeg/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073505Z&HW-CC-Expire=86400&HW-CC-Sign=8A7B13F0DF106A954C59E98608C7A7E6C21DAE0FDDF82D10CB211225729AA67D)
    
    对所有音频流状态进行监听的应用需要[声明权限](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/declare-permissions)ohos.permission.USE\_BLUETOOTH，否则无法获得实际的设备名称和设备地址信息，查询到的设备名称和设备地址（蓝牙设备的相关属性）将为空字符串。
    
    从API version 20开始，通常在音频录制启动前调用[isRecordingAvailable](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/arkts-apis-audio-audiostreammanager#isrecordingavailable20)，判断当前传入的音频采集器信息中音源类型的录制是否可以启动成功。
    
    async function getCurrentAudioCapturerInfoArray(updateCallback?:
      (msg: string, isError: boolean) => void): Promise<void>{
      // ...
    
      await audioStreamManager.getCurrentAudioCapturerInfoArray()
        .then((audioCapturerChangeInfoArray: audio.AudioCapturerChangeInfoArray) => {
          console.info('getCurrentAudioCapturerInfoArray Get Promise Called');
          let detailInfo = 'getCurrentAudioCapturerInfoArray Get Promise Called\\n';
          if (audioCapturerChangeInfoArray != null) {
            for (let i = 0; i < audioCapturerChangeInfoArray.length; i++) {
              console.info(\`StreamId for ${i} is: ${audioCapturerChangeInfoArray\[i\].streamId}\`);
              console.info(\`Source for ${i} is: ${audioCapturerChangeInfoArray\[i\].capturerInfo.source}\`);
              console.info(\`Flag  ${i} is: ${audioCapturerChangeInfoArray\[i\].capturerInfo.capturerFlags}\`);
    
              detailInfo += \`StreamId for ${i} is: ${audioCapturerChangeInfoArray\[i\].streamId}\\n\`;
              detailInfo += \`Source for ${i} is: ${audioCapturerChangeInfoArray\[i\].capturerInfo.source}\\n\`;
              detailInfo += \`Flag ${i} is: ${audioCapturerChangeInfoArray\[i\].capturerInfo.capturerFlags}\\n\`;
    
              for (let j = 0; j < audioCapturerChangeInfoArray\[i\].deviceDescriptors.length; j++) {
                console.info(\`Id: ${i} : ${audioCapturerChangeInfoArray\[i\].deviceDescriptors\[j\].id}\`);
                console.info(\`Type: ${i} : ${audioCapturerChangeInfoArray\[i\].deviceDescriptors\[j\].deviceType}\`);
                console.info(\`Role: ${i} : ${audioCapturerChangeInfoArray\[i\].deviceDescriptors\[j\].deviceRole}\`);
                console.info(\`Name: ${i} : ${audioCapturerChangeInfoArray\[i\].deviceDescriptors\[j\].name}\`);
                console.info(\`Address: ${i} : ${audioCapturerChangeInfoArray\[i\].deviceDescriptors\[j\].address}\`);
                console.info(\`SampleRates: ${i} : ${audioCapturerChangeInfoArray\[i\].deviceDescriptors\[j\].sampleRates\[0\]}\`);
                console.info(\`ChannelCounts ${i} : ${audioCapturerChangeInfoArray\[i\]
                  .deviceDescriptors\[j\].channelCounts\[0\]}\`);
                console.info(\`ChannelMask: ${i} : ${audioCapturerChangeInfoArray\[i\].deviceDescriptors\[j\].channelMasks}\`);
              }
            }
          }
          if (updateCallback) {
            updateCallback(detailInfo, false);
          }
        }).catch((err: BusinessError) => {
          console.error(\`Invoke getCurrentAudioCapturerInfoArray failed, code is ${err.code}, message is ${err.message}\`);
          const errorMsg = \`Invoke getCurrentAudioCapturerInfoArray failed, code is ${err.code}, message is ${err.message}\`;
          if (updateCallback) {
            updateCallback(errorMsg, true);
          }
        });
      // 获取后取消监听
      cancelListenAudioStreamManager();
    }