音视频通话

订阅并显示视频

功能介绍

本节介绍如何在房间内订阅并显示视频画面,包括:

  • 订阅指定用户的视频
  • 使用 SDK 渲染或自定义渲染显示画面
  • 获取图像、视频流信息与大小流选择

1. 订阅与取消订阅

  • 订阅时机: 自已进入房间成功后才能发起订阅操作。 被订阅者也必须是房间内人员(参见getAllMembers、notifyUserEnterMeeting)。
  • 订阅内容: 订阅时需要指定CRUserVideoID(userID + videoID)。videoID指定为-1时,代表订阅对方的默认摄像头。 用户当前启用的摄像头为:getDefaultVideo、getMutiVideos。
  • 订阅:通过 addCanvas 或 addCustomRender 将渲染对象与CRUserVideoID(userID + videoID)绑定来完成订阅,其中他人的视频从服务器订阅,本地视频从本地采集模块订阅。
  • 取消订阅:rmCanvas 或 rmCustomRender,或渲染对象绑定为无效CRUserVideoID。

2. 显示画面

  • SDK 渲染:通过 addCanvas 添加,由 SDK 内部完成解码与绘制,使用简单但只有部份平台支持(支持情况以接口描述为准)。
  • 自定义渲染:通过 addCustomRender 添加,由 SDK 内部完成解码,应用完成绘制,适用于更多应用场景,全平台支持。

3. 获取图像与视频流信息

  • 获取当前渲染中的图像帧:调用 GetVideoImg,传入 CRUserVideoID 与可选的大小流类型,可得到当前解码后的视频帧(如用于截图、录像等)。只能获取已在观看的视频画面;若尚未有帧或解码失败,返回空。
  • 获取流信息:调用 getVideoStreamInfo 可获取该路视频的实时分辨率、帧率、码率等,用于展示质量或做自适应策略。

示例(获取默认视频设备图像):

CRVideoSDKMeeting& meeting = g_sdkMain->getSDKMeeting();

CRUserVideoID vID;
vID._userID = "remote_user_id";
vID._videoID = -1; //默认视频设备
CRVideoFrame frm = meeting.GetVideoImg(vID);
// 若 frm 有效,可进行保存或二次处理

相关 API 请参考:

4. 大小流

若发送端开启了大小流,订阅时可指定大流或小流,以在清晰度与带宽之间权衡。详见 视频大小流支持。