自定义视频采集/渲染
功能介绍
本节介绍自定义摄像头与自定义渲染:
- 自定义采集:不采用 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. 使用方式
- 添加成功后与本地视频设备处理一致:可 setDefaultVideo 设为默认视频设备,或通过 setMutiVideos 作为多路之一发送,远端通过 addCanvas / addCustomRender 按 videoID 订阅观看。
- 若需在发送前对帧做处理,可自行处理好后,再调用 inputCustomVideoDat 送入即可。