多源采集

---

功能简介

多源采集用于管理各个通道的音视频源配置，通过此能力您可以灵活快速的实现不同音视频内容的实时互动，如屏幕共享、混音等功能。

多源采集主要的能力特性与限制如下：

• 推流通道支持设置的多种音视频源，但同一个音视频源仅能被一个通道占用。
• 主路的音视频源支持动态切换，也支持音频的混音能力。辅路仅支持推流前指定采集源，不支持混音。
• 采集屏幕时，仅 iOS 及 Android 平台支持同时采集视频和音频；其他平台仅支持采集视频，如需采集音频，请开发者自行实现相关逻辑。

示例源码

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

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

前提条件

在使用多源采集功能之前，请确保：

• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目信息。
• 已在项目中集成 ZEGO Express SDK，并实现了基本的音视频推拉流功能，详情请参考 快速开始 - 集成 和 快速开始 - 实现流程。

实现流程

1 创建 ZegoExpressEngine 引擎

创建 ZegoExpressEngine 引擎流程，请参考实现视频通话的 创建引擎。

ZegoEngineProfile profile;
/** AppID 和 AppSign 由 ZEGO 分配给各 App；其中，为了安全考虑，建议将 AppSign 存储在 App 的业务后台，需要使用时从后台获取*/
profile.appID = appID;
profile.appSign = appSign;
/** 指定使用直播场景 (请根据实际情况填写适合你业务的场景)*/
profile.scenario = ZegoScenario::ZEGO_SCENARIO_BROADCAST;
/** 创建引擎实例 */
auto engine = ZegoExpressSDK::createEngine(profile, nullptr);

2 设置音视频采集源

1. 调用 setVideoSource 接口设置视频采集源。

/** 使用摄像头作为视频采集源 */
engine->setVideoSource(ZEGO_VIDEO_SOURCE_TYPE_CAMERA);

2. 调用 setAudioSource 接口设置音频采集源。

   • 仅设置音频采集源

     /** 使用麦克风作为音频采集源 */
     engine->setAudioSource(ZEGO_AUDIO_SOURCE_TYPE_MICROPHONE);

   • 设置音频采集源，同时设置混音配置

     ZegoAudioSourceMixConfig audioSourceMixConfig;
     /** 混入系统声卡播放的声音*/
     audioSourceMixConfig.enableMixSystemPlayout = true;
     /** 混入 SDK 播放的声音*/
     audioSourceMixConfig.enableMixEnginePlayout = true;
     
     /** 混入序号为 0 的媒体播放器播放的声音*/
     audioSourceMixConfig.mediaPlayerCount = 1;
     audioSourceMixConfig.mediaPlayerIndexList = new int[1];
     audioSourceMixConfig.mediaPlayerIndexList[0] = 0;
     
     /** 混入序号为 0 的音效播放器播放的声音*/
     audioSourceMixConfig.audioEffectPlayerCount= 1;
     audioSourceMixConfig.audioEffectPlayerIndexList= new int[1];
     audioSourceMixConfig.audioEffectPlayerIndexList[0] = 0;
     
     /** 使用麦克风作为音频采集源，且设置混音配置 */
     engine->setAudioSource(ZEGO_AUDIO_SOURCE_TYPE_MICROPHONE, audioSourceMixConfig);
     
     delete[] audioSourceMixConfig.audioEffectPlayerIndexList;
     delete[] audioSourceMixConfig.mediaPlayerIndexList;

3 登录房间并推流

登录房间及推流流程，请参考实现视频通话的 登录房间 及 推流 。

4 （可选）切换音视频采集源

1. 调用 setVideoSource 接口切换视频采集源。

/** 使用屏幕共享作为视频采集源 */
engine->setVideoSource(ZEGO_VIDEO_SOURCE_TYPE_SCREEN_CAPTURE);

2. 调用 setAudioSource 接口切换音频采集源。

/** 使用媒体播放器作为音频采集源 */
engine->setAudioSource(ZEGO_AUDIO_SOURCE_TYPE_MEDIA_PLAYER);

5 结束推流

结束推流流程，请参考实现视频通话的 停止推拉流。

/** 停止推流*/
engine->stopPublishingStream();

常见问题

1. 如何采集屏幕视频与系统声音?

如需采集屏幕视频与系统声音，请参考 屏幕共享。

2. 是否支持设置多个媒体播放器?

支持，但需要注意相同的播放器实例仅能被一个通道占用。

3. 组合使用视频源和音频源时有哪些限制？

组合使用视频源和音频源限制如下：

1. 主路不能使用媒体播放器的视频或音频源。
2. 辅路使用媒体播放器作为音视频源时，需要主路使用并启动麦克风设备（enableMicrophone）。 如果您主路不需要麦克风声音，可通过 mutePublishStreamAudio 禁用音频推流保持麦克风启动。
3. 仅在主路使用摄像头视频源或者麦克风音频源时，辅路复制主路视频源或者音频源才能生效。
4. 主路的音频来源不能设置为 None，否则会导致音频无法渲染。