音视频通话

自定义视频采集

功能介绍

本节介绍自定义摄像头:

  • 自定义采集:不采用 SDK 内置的摄像头/网络源,由应用自己采集视频帧并送入 SDK,作为一路"视频"发送(如第三方采集、滤镜后数据、文件推流等)。

1. 自定义采集

通过创建"自定义摄像头"设备,再向 SDK 送入图像帧,即可实现自定义采集。

创建与销毁

  • 调用 createCustomVideoDev(camName, pixFmt, width, height) 创建自定义摄像头。
  • 返回值:≥0 表示成功,返回值为 videoID;<0 表示失败。最多支持添加5个;在 SDK 实例销毁时被删除。
  • 调用 destroyCustomVideoDev(videoID) 删除自定义摄像头。

送入数据

  • 创建成功后,调用 inputCustomVideoDat(videoID, frm) 将采集到的 CRVideoFrame 送入 SDK。格式、宽高需与创建时一致;推荐像素格式为 YUV420P 以获较好性能。

示例(逻辑示意):

const videoID = sdk_engine.createCustomVideoDev("我的采集", CRVSDK_VIDEO_FORMAT.CRVSDK_VFMT_YUV420P, 640, 480);
if (videoID >= 0) {
  const frm = {
    // 填充 frm(格式、宽高与创建一致)
  };
  sdk_engine.inputCustomVideoDat(videoID, frm);
}
// 不再使用时
sdk_engine.destroyCustomVideoDev(videoID);

相关 API 请参考:

自定义摄像头会出现在 getAllVideoInfo 中,可 setDefaultVideo 或加入 setMutiVideos 使用。

2. 使用方式

  • 添加成功后与本地视频设备处理一致:可 setDefaultVideo 设为默认视频设备,或通过 setMutiVideos 作为多路之一发送,远端通过 addCanvas 按 videoID 订阅观看。
  • 若需在发送前对帧做处理,可自行处理好后,再调用 inputCustomVideoDat 送入即可。