自定义视频采集

功能简介

自定义视频采集，是指由开发者自行采集视频，向 ZEGO Express SDK 提供视频数据，并由 ZEGO Express SDK 进行编码推流的功能。

当开发者业务中出现以下情况时，推荐使用 SDK 的自定义视频采集功能：

• 普通摄像头的采集无法满足需求。例如，包含了大量的原有业务。
• 直播非摄像头数据。例如视频播放、屏幕分享、游戏直播等。
• 使用第三方虚拟摄像头外部采集来做自定义美颜等视频预处理。

示例源码下载

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

相关源码请查看 “src/Examples/AdvancedVideoProcessing/CustomVideoCapture” 目录下的文件。

前提条件

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

使用步骤

要推送自定义视频源的流，可以在调用 createStream 创建流时，可以通过设置 “source” 参数来指定第三方数据源。然后，调用 startPublishingStream 发布流。

• 设置第三方媒体流

  调用 createStream 接口预览第三方媒体流，再调用 startPublishingStream 接口推流。

  //开始预览本地视频
  previewVideo.srcObject = mediaStream;
  const stream = await zg.createStream({custom: {
              source: mediaStream
          }})
  //推流
  zg.startPublishingStream(idName, stream);
  

• 设置第三方音视频

  调用 createStream 接口预览第三方音视频，再调用 startPublishingStream 接口推流。

  source 为 <video> 或 <audio> 对象时，从其指定的视频或音频源作为预览。

  //localVideo 为 <video> 对象
  const stream = await zg.createStream({custom: {
              source: localVideo
          }})
  //推流
  zg.startPublishingStream(idName, stream);