# dotNet.audio 库模块帮助文档

## dotNet.audio 成员列表 <a id="dotNet.audio" href="#dotNet.audio">&#x23;</a>

录音

### dotNet.audio.convertToMp3 <a id="dotNet.audio.convertToMp3" href="#dotNet.audio.convertToMp3">&#x23;</a>
转换音频为 MP3 文件，或提取视频中的音频为 MP3 文件

### dotNet.audio.convertToMp3(inPath,outPath,desiredBitRate) <a id="dotNet.audio.convertToMp3" href="#dotNet.audio.convertToMp3">&#x23;</a>
参数 @inPath 可指定 *.wav 文件路径，  
也可指定 MP3, WMA, AAC（MP4）音频文件、MP4 视频文件路径或网址。  
参数 @outPath 指定输出 *.mp3 文件路径。  
可选用 @desiredBitRate 指定比特率，省略则默认值为 192000

### dotNet.audio.convertToWav <a id="dotNet.audio.convertToWav" href="#dotNet.audio.convertToWav">&#x23;</a>
转换音频为 WAV 文件，或提取视频中的音频为 WAV 文件

### dotNet.audio.convertToWav(inPath,outPath,desiredBitRate) <a id="dotNet.audio.convertToWav" href="#dotNet.audio.convertToWav">&#x23;</a>
参数 @inPath 可指定 MP3, WMA, AAC（MP4）音频文件、MP4 视频文件路径或网址。  
参数 @outPath 指定输出 *.wav 文件路径

### dotNet.audio.eachWaveInDevice() <a id="dotNet.audio.eachWaveInDevice" href="#dotNet.audio.eachWaveInDevice">&#x23;</a>

```aardio
for deviceNumber,deviceName,caps in dotNet.audio.eachWaveInDevice(){
	/*遍历录音设备。  
deviceNumber 为设备 ID，deviceName 为设备名称。  
caps 参数用法请参考源码与 NAudio 文档*/
}
```

### dotNet.audio.startWaveIn() <a id="dotNet.audio.startWaveIn" href="#dotNet.audio.startWaveIn">&#x23;</a>
开始录音。  
录音前会自动调用 stopWaveIn 函数停止之前创建的录音操作。  
可选用参数 @1 指定 *.wav 文件路径。  
可选用参数 @2 指定设备 ID，省略则默认指定为 -2。  
设备 ID 指定为 -2 录制系统声音，  
指定为 -1 则使用默认录音设备  

如果不指定任何参数，则仅用于捕获系统声音并触发 onWaveIn 事件

### dotNet.audio.stopWaveIn() <a id="dotNet.audio.stopWaveIn" href="#dotNet.audio.stopWaveIn">&#x23;</a>
停止录音

## dotNet.audio 事件列表 <a id="dotNet.audioEvent" href="#dotNet.audioEvent">&#x23;</a>

### dotNet.audio.onWaveIn <a id="dotNet.audio.onWaveIn" href="#dotNet.audio.onWaveIn">&#x23;</a>

```aardio
dotNet.audio.onWaveIn = function(max){
	/*表示当前录制声音峰值百分比的小数*/
}
```

