音视频通话

自定义视频采集/渲染

功能介绍

本节介绍自定义摄像头:

自定义采集:不采用 SDK 内置的摄像头/桌面/网络源,由应用自己采集视频帧并送入 SDK,作为一路"视频"发送。

1. 自定义采集

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

创建与销毁

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

送入数据

创建成功后,调用 inputCustomVideoDat(videoID, frm) 将采集到的视频帧送入 SDK。格式、宽高需与创建时一致。

示例:

const rtcsdk = new RTCSDK();

// 采集 canvas 的图像并送入
const canvas = document.getElementById('canvas');
const ctx = canvas.getContext("2d");
const imageData = ctx.getImageData(0, 0, canvas.width, canvas.height);
const _data = new Uint8Array(imageData.data.buffer);

const frame = {
    _format: 12, // RGBA 格式
    _data: _data,
    _width: canvas.width,
    _height: canvas.height,
    _timestamp: Date.now(),
};

const sdkErr = rtcsdk.inputCustomVideoDat(videoID, frame);
if (sdkErr !== 0) {
    console.log('更新失败,错误码: ' + sdkErr);
}

需保证 _format、_width、_height 与创建自定义摄像头时的参数值相同。

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

相关 API 请参考: