文档中心
hybrid_hierarchical_delivery_system 超低延迟直播
文档中心
体验 App
SDK 中心
API 中心
常见问题
代码市场
进入控制台
立即注册
登录
中文站 English
  • 文档中心
  • 超低延迟直播
  • 通信能力
  • 多源采集

多源采集

更新时间:2024-09-20 14:40

功能简介

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

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

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

示例源码

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

相关源码请查看 “/ZegoExpressExample/Others/src/main/java/com/example/others/multivideosource” 目录下的文件。

前提条件

在使用多源采集功能之前,请确保:

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

实现流程

实时语音产品仅支持设置音频采集源。

1 创建 ZegoExpressEngine 引擎

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

// 创建 ZegoExpress 实例,监听常用事件
    void createEngine() {
        // 创建引擎,通用场景接入,并注册 self 为 eventHandler 回调
        // 不需要注册回调的话,eventHandler 参数可以传 null,后续可调用 "setEventHandler:" 方法设置回调
        ZegoEngineProfile profile = new ZegoEngineProfile();
        profile.appID = appID;  // 请通过官网注册获取,格式为:1234567890L
        profile.appSign = appSign; //请通过官网注册获取,格式为:@"0123456789012345678901234567890123456789012345678901234567890123"(共64个字符)
        profile.scenario = ZegoScenario.BROADCAST;  // 指定使用直播场景 (请根据实际情况填写适合你业务的场景)
        profile.application = getApplication();
        engine = ZegoExpressEngine.createEngine(profile, null);
    }

2 设置音视频采集源

  1. 调用 setVideoSource 接口设置视频采集源。
/** 使用摄像头作为视频采集源 */
engine.setVideoSource(ZegoVideoSourceType.CAMERA);
  • 如果需要使用自定义视频采集作为视频采集源,需设置视频采集源类型为 ZegoVideoSourceTypeCustom,调用 enableCustomVideoCapture 接口设置要发送的视频帧数据类型,调用 sendCustomVideoCaptureRawData,sendCustomVideoCaptureTextureData 或 sendCustomVideoCaptureEncodedData 接口向 SDK 发送视频帧数据,详情请参考 进阶功能 - 自定义视频采集。
  • 如果需要使用媒体播放器作为视频采集源,需先调用 createMediaPlayer 接口创建媒体播放器,再通过调用 setVideoSource 接口设置视频采集源类型为 ZegoVideoSourceTypePlayer 和设置视频采集源所使用的媒体播放器实例索引,然后再使用刚创建的媒体播放器加载资源并播放,详情请参考 媒体播放器 。
  • 如果需要使用屏幕共享作为视频采集源,需设置视频采集源类型为 ZegoVideoSourceTypeScreenCapture,并开启屏幕共享向 SDK 推屏幕共享视频数据,详情请参考 屏幕共享 。
  1. 调用 setAudioSource 接口设置音频采集源。

    • 仅设置音频采集源

      /** 使用麦克风作为音频采集源 */
      engine.setAudioSource(ZegoAudioSourceType.MICROPHONE);
    • 设置音频采集源,同时设置混音配置

      ZegoAudioSourceMixConfig audioSourceMixConfig = new ZegoAudioSourceMixConfig();
      
      /** 混入序号为 0 的媒体播放器播放的声音*/
      audioSourceMixConfig.mediaPlayerIndexList = new int[1];
      audioSourceMixConfig.mediaPlayerIndexList[0] = 0;
      
      /** 混入序号为 0 的音效播放器播放的声音*/
      audioSourceMixConfig.audioEffectPlayerIndexList = new int[1];
      audioSourceMixConfig.audioEffectPlayerIndexList[0] = 0;
      
      /** 使用麦克风作为音频采集源,且设置混音配置 */
      engine.setAudioSource(ZegoAudioSourceType.MICROPHONE, audioSourceMixConfig);
  • 如果需要使用自定义音频采集作为音频采集源,需设置音频采集源类型为 ZegoAudioSourceTypeCustom,调用 sendCustomAudioCaptureAACData 或 sendCustomAudioCapturePCMData 等接口向 SDK 发送音频数据,详情请参考 进阶功能 - 自定义音频采集与渲染。
  • 如果需要使用媒体播放器作为音频采集源,需设置音频采集源类型为 ZegoAudioSourceTypeMediaPlayer,调用 createMediaPlayer 接口创建媒体播放器,然后使用刚创建的媒体播放器加载资源并播放,详情请参考 媒体播放器 。

3 登录房间并推流

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

4 (可选)切换音视频采集源

  1. 调用 setVideoSource 接口切换视频采集源。
/** 使用屏幕共享作为视频采集源 */
engine.setVideoSource(ZegoVideoSourceType.SCREEN_CAPTURE);
  1. 调用 setAudioSource 接口切换音频采集源。
/** 使用媒体播放器作为音频采集源 */
engine.setAudioSource(ZegoAudioSourceType.MEDIA_PLAYER);

5 结束推流

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

/** 停止推流 */
engine.stopPublishingStream();

常见问题

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

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

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

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

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

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

  1. 主路不能使用媒体播放器的视频或音频源。
  2. 辅路使用媒体播放器作为音视频源时,需要主路使用并启动麦克风设备(enableMicrophone)。 如果您主路不需要麦克风声音,可通过 mutePublishStreamAudio 禁用音频推流保持麦克风启动。
  3. 仅在主路使用摄像头视频源或者麦克风音频源时,辅路复制主路视频源或者音频源才能生效。
  4. 主路的音频来源不能设置为 None,否则会导致音频无法渲染。
本篇目录
  • 免费试用
  • 提交工单
    咨询集成、功能及报价等问题
    电话咨询
    400 1006 604
    咨询客服
    微信扫码,24h在线

    联系我们

  • 文档反馈