
# 音频采集器
该接口用于构造一个音频采集器，从本地麦克风获取音频或者本地音频文件获取音频数据。
- **接口调用**
  1.0.8及以上固件版本
  hilens.AudioCapture(file_path)
  1.1.2及以上固件版本
  hilens.AudioCapture(sample_rate, bit_width, nSamples, sound_mode)
  
- **参数** **说明**
  表1参数说明 
  | **参数名**     | **是否必选** | **参数类型** | **描述**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
  |:---|:---|:---|:---|
  | file_path   | 否        | 字符串      | 音频文件路径，从该文件获取音频数据，构造一个音频文件数据的采集器。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
  | sample_rate | 否        | 整型       | 采样率，本地麦克风录音参数。默认值为"AUDIO_SAMPLE_RATE_44100"，可取值： AUDIO_SAMPLE_RATE_8000 AUDIO_SAMPLE_RATE_12000 AUDIO_SAMPLE_RATE_11025 AUDIO_SAMPLE_RATE_16000 AUDIO_SAMPLE_RATE_22050 AUDIO_SAMPLE_RATE_24000 AUDIO_SAMPLE_RATE_32000 AUDIO_SAMPLE_RATE_44100 AUDIO_SAMPLE_RATE_48000 AUDIO_SAMPLE_RATE_64000 AUDIO_SAMPLE_RATE_96000 |
  | bit_width   | 否        | 整型       | 位宽，本地麦克风录音参数。默认值为"AUDIO_BIT_WIDTH_16"。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
  | nSamples    | 否        | 整型       | 每帧音频采样点数，本地麦克风录音参数。默认值为1024，取值范围\[80，2048\]。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
  | sound_mode  | 否        | 整型       | 声道模式，本地麦克风录音参数。默认值为"AUDIO_SOUND_MODE_MONO"，可取值： AUDIO_SOUND_MODE_MONO AUDIO_SOUND_MODE_STEREO                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
     
  ![](https://support.huaweicloud.com/devg-hilens/public_sys-resources/note_3.0-zh-cn.png)
  - 本地麦克风只有一个，不支持多个进程设置不同的录音参数，先设置的生效。
  
  
  
  - 麦克风录音接口和[播放音频文件](https://support.huaweicloud.com/devg-hilens/hilens_05_0066.html)的接口不能同时使用。
    

- **返回值**
  - 音频数据采集器。
  
  - 如果创建失败则抛出一个CreateError。开发者可以在查看技能日志输出。
   
 
