音视频通话

原始音频数据获取

功能介绍

本节介绍如何获取房间内的原始 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 提供 WebRTC MediaStream,适合直接播放或 Web Audio 处理;本接口提供 PCM ArrayBuffer,适合按字节分析、转码、离线处理。
  • 与变声的关系:本端 PCM 一般为未变声原始数据;会议中他人听到的是服务端变声后的效果(见 变声)。
  • 并行录制:可同时开启 aSide=0 与 aSide=1,须分别调用 CRVideo_StopGetAudioPCM 停止。