原始音频数据获取
2024-01-02
功能简介
SDK 为开发者提供了获取原始音频数据的功能，获取的原始音频数据格式为 PCM，开发者可以将此数据写到本地设备中，实现录制音频。
前提条件
在获取原始音频数据之前，请确保：
- 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目信息。
- 已在项目中集成 ZEGO Express SDK，并实现了基本的音视频推拉流功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。
使用步骤
1 初始化 SDK
请参考 快速开始 - 实现流程 的 “创建引擎”。
2 获取本地采集流的原始音频数据功能
开发者可调用 setCaptureAudioFrameCallback 接口开启原始音频数据回调监测，回调参数 ZegoAudioFrame 包含了音频原始数据（channels），声道数（channelCount）和音频采样率（sampleRate）。当回调函数设置为 null 时会停止监听此条音频数据。
// 创建音频流
const localStream = await zg.createZegoStream({camera :{audio:true,video:false}});
// 获取原始音频数据功能
zg.setCaptureAudioFrameCallback(
localStream,
(data) => {
// data 的类型是 { channels: Float32Array[]; channelCount: number; sampleRate: number }
}
);
// 停止音频数据回调
zg.setCaptureAudioFrameCallback(localStream, null);3 获取拉流的原始音频数据功能
开发者可调用 setAudioFrameCallback 接口开启原始音频数据回调监测，回调参数 ZegoAudioFrame 包含了音频原始数据（channels），声道数（channelCount）和音频采样率（sampleRate）。当回调函数设置为 null 时会停止监听此条音频数据。
// 拉流
const remoteStream = await zg.startPlayingStream(streamID);
// 获取原始音频数据功能
zg.setAudioFrameCallback(
remoteStream,
(data) => {
// data 的类型是 { channels: Float32Array[]; channelCount: number; sampleRate: number }
}
);
// 停止音频数据回调
zg.setAudioFrameCallback(streamID, null);