原始音频数据获取

---

功能简介

SDK 为开发者提供了获取原始音频数据的功能，获取的原始音频数据格式为 PCM，开发者可以将此数据写到本地设备中，实现录制音频。

示例源码下载

请参考 下载示例源码 获取源码。

相关源码请查看 “/ZegoExpressExample/Examples/AdvancedAudioProcessing/OriginalAudioDataAcquisition” 目录下的文件。

使用步骤

获取原始音频功能的使用流程如下：

1 初始化SDK

请参考 快速开始 - 实现流程 的 “创建引擎”

2 开启获取原始音频数据功能

开发者可调用 startAudioDataObserver 接口，开启原始音频数据回调监测。回调的音频数据类型为 ZegoAudioDataCallbackBitMask，包括有 ZEGO_AUDIO_DATA_CALLBACK_BIT_MASK_CAPTURED、ZEGO_AUDIO_DATA_CALLBACK_BIT_MASK_PLAYBACK、ZEGO_AUDIO_DATA_CALLBACK_BIT_MASK_MIXED、ZEGO_AUDIO_DATA_CALLBACK_BIT_MASK_PLAYER，这四个回调类型都需要开启。

// 开启获取原始音频数据功能
ZegoAudioFrameParam param;
param.channel = ZEGO_AUDIO_CHANNEL_STEREO;
param.sampleRate = ZEGO_AUDIO_SAMPLE_RATE_8K;
unsigned int bitmask = ZEGO_AUDIO_DATA_CALLBACK_BIT_MASK_CAPTURED | ZEGO_AUDIO_DATA_CALLBACK_BIT_MASK_PLAYBACK | ZEGO_AUDIO_DATA_CALLBACK_BIT_MASK_MIXED | ZEGO_AUDIO_DATA_CALLBACK_BIT_MASK_PLAYER;
engine->startAudioDataObserver(bitmask, param);

3 设置回调接收原始音频数据并处理

开发者可调用 setAudioDataHandler 接口设置额外接收音频数据的回调。根据需要可实现回调 onCapturedAudioData、onPlaybackAudioData、onMixedAudioData、onPlayerAudioData，分别对应上述 ZegoAudioDataCallbackBitMask 中的四个音频数据类型。

// 设置原始音频数据回调
class MyAudioDataHandler: public IZegoAudioDataHandler
{
public:
    // 本地采集音频数据，推流后可收到回调 
    virtual void onCapturedAudioData(const unsigned char* /*data*/, unsigned int /*dataLength*/, ZegoAudioFrameParam /*param*/) {

    }

    // SDK 播放的音频数据，在非拉流状态的引擎启动状态且未使用媒体播放器播放媒体文件状态时，回调的音频数据是静音的音频数据 
    virtual void onPlaybackAudioData(const unsigned char* /*data*/, unsigned int /*dataLength*/, ZegoAudioFrameParam /*param*/) {

    }

    // 本地采集与 SDK 播放的声音混合后的音频数据回调
    virtual void onMixedAudioData(const unsigned char* /*data*/, unsigned int /*dataLength*/, ZegoAudioFrameParam /*param*/) {

    }

    // 远端拉流音频数据，开始拉流后每条拉流数据的回调 
    virtual void onPlayerAudioData(const unsigned char* /*data*/, unsigned int /*dataLength*/, ZegoAudioFrameParam /*param*/, const std::string& /*streamID*/) {

    }
};

engine->setAudioDataHandler(std::make_shared<MyAudioDataHandler>());

4 停止音频数据回调监测

若想停止音频数据回调监测，可调用 stopAudioDataObserver 接口。

engine->stopAudioDataObserver();