原始音频数据获取
功能介绍
本节介绍如何获取房间内的原始 PCM 音频数据,供录制、语音分析、可视化或质检等使用,不改变 SDK 原有的采集与播放链路。
Web SDK 通过 CRVideo_StartGetAudioPCM / CRVideo_StopGetAudioPCM 获取以下两类数据:
| aSide | 含义 |
|---|---|
| 0 | 本端麦克风采集侧 PCM(送房间前) |
| 1 | 本端扬声器播放侧 PCM(房间内混音后送入播放链路) |
- 支持 回调分片(
getType = 0)与 停止后文件下载(getType = 1)两种方式。 - 可同时开启
aSide为 0 和 1 的两路获取,但同一路 aSide 不能重复开启。
注意:
须在成功进入房间后,方可获取房间内 PCM 音频数据。
本端获取的 PCM 一般为未变声原始音频(变声在服务端处理,详见 变声)。
1. 开始与停止获取
// aSide:0 麦克风,1 扬声器
// getType:0 回调,1 文件下载
var jsonParam = {
sampleRate: 16000,
sampleBits: 16,
eachTime: 1 // getType=0 时,eachTime 与 eachSize 二选一
};
var err = CRVideo_StartGetAudioPCM(0, 0, jsonParam);
if (err != 0){
// 开启失败,err 为错误码
}
// 停止获取(getType=1 时停止后将触发浏览器下载 PCM 文件)
CRVideo_StopGetAudioPCM(0);
相关 API:
2. 回调方式获取(getType = 0)
getType 为 0 时,按 jsonParam 中的 eachSize(字节)或 eachTime(秒)分片触发 CRVideo_NotifyAudioPCMDat。二者至少配置其一;若同时配置,先满足任一条件即触发回调。
var jsonParam = {
sampleRate: 16000,
sampleBits: 16,
eachSize: 3200
};
var err = CRVideo_StartGetAudioPCM(0, 0, jsonParam);
if (err == 0){
CRVideo_NotifyAudioPCMDat.callback = function(aSide, PCMDat){
// aSide:0 麦克风,1 扬声器
// PCMDat:ArrayBuffer,可按业务累积后转 Blob 播放或下载
};
}
相关 API:
3. 文件下载方式(getType = 1)
getType 为 1 时,须在 jsonParam 中配置 fileName(不带后缀)。获取过程中无 PCM 回调;调用 CRVideo_StopGetAudioPCM 停止后,浏览器将自动下载 PCM 文件至默认下载目录。
var jsonParam = {
sampleRate: 16000,
sampleBits: 16,
fileName: "meeting_mic_pcm"
};
CRVideo_StartGetAudioPCM(0, 1, jsonParam);
// 结束录制并下载
CRVideo_StopGetAudioPCM(0);
若同时录制麦克风与扬声器,需分别对 aSide 0、1 调用停止接口。
4. 参数说明
CRVideo_PCMJSONParams 常用字段:
| 参数 | 说明 |
|---|---|
| sampleRate | 采样率,如 16000、48000 等,默认 16000 |
| sampleBits | 采样位数,一般 8、16,默认 16 |
| eachSize | getType=0 时,按字节分片回调(与 eachTime 二选一) |
| eachTime | getType=0 时,按时间间隔(秒)分片回调 |
| fileName | getType=1 时必填,下载文件名(无后缀) |
5. 使用注意事项
- 性能:回调中不宜做耗时处理,以免影响实时音质与流畅性;大段数据建议异步落盘或转码。
- 与 NotifyAudioStream 的区别:
NotifyAudioStream提供 WebRTCMediaStream,适合直接播放或 Web Audio 处理;本接口提供 PCM ArrayBuffer,适合按字节分析、转码、离线处理。 - 与变声的关系:本端 PCM 一般为未变声原始数据;会议中他人听到的是服务端变声后的效果(见 变声)。
- 并行录制:可同时开启
aSide=0与aSide=1,须分别调用 CRVideo_StopGetAudioPCM 停止。