自定义视频采集

  • Web

更新时间

了解实时互动 RTC 在不同平台上的自定义视频采集方式,包括接入流程、关键配置和平台差异。

实时音视频传输过程中,声网 SDK 通常会启动默认的音视频模块进行采集。在以下场景中,你可能会发现默认的音视频模块无法满足开发需求:

  • App 中已有自己的音频或视频模块。
  • 希望使用非摄像头采集的视频源,比如 Canvas 数据。
  • 需要使用自定义的视频前处理库。

本文介绍如何使用声网 Web SDK 在项目中实现自定义的视频采集。

实现方法

开始前,请确保你已参考快速开始在你的项目中实现基本的实时音视频功能。

SDK 提供 createCustomVideoTrack,支持通过传入一个 MediaStreamTrack 对象来创建本地视频轨道。

你可以通过获取 MediaStreamTrack 对象来实现自定义视频采集或者前处理。例如,你可以自己调用 getUserMedia 方法来获取 MediaStreamTrack,再通过 createCustomVideoTrack 来创建可以在 SDK 中使用的本地视频对象。

JavaScript
navigator.mediaDevices.getUserMedia({ video: true, audio: false })
  .then((mediaStream) => {
    const videoMediaStreamTrack = mediaStream.getVideoTracks()[0];
    // Create a custom video track
    return AgoraRTC.createCustomVideoTrack({
      mediaStreamTrack: videoMediaStreamTrack,
    });
  })
  .then((localVideoTrack) => {
    // ...
  });

信息

API 参考