音视频通话

自定义视频采集/渲染

功能介绍

本节介绍自定义摄像头与自定义渲染:

  • 自定义采集:不采用 SDK 内置的摄像头/桌面/网络源,由应用自己采集视频帧并送入 SDK,作为一路“视频”发送(如第三方采集、滤镜后数据、文件推流等)。
  • 自定义渲染:不采用 SDK 内置的渲染,由应用自己接收解码后的视频帧并绘制(如自绘 UI、跨平台、特殊效果等)。

1. 自定义采集

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

创建与销毁

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

送入数据

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

示例(逻辑示意):

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

相关 API 请参考:

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

2. 自定义渲染

不采用 SDK 内置窗口渲染时,可通过 自定义渲染 由应用自己绘制视频画面。

  • 实现 CRCustomRenderHandler 接口,在回调中接收视频帧或渲染相关数据并完成绘制。
  • 通过 CRCustomRenderHandler::setVideoID 绑定要观看的 userID、videoID,即可订阅并绘制该路视频。
  • 通过 addCustomRender 将渲染对象提交给 SDK;SDK 将订阅Handler需要的视频流并将解码后图像帧回调给该 Handler。

具体接口签名、回调时机与数据格式请参考:

3. 使用方式