音视频通话

订阅并显示视频

功能介绍

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

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

1. 订阅与取消订阅

  • 订阅时机: 自已进入房间成功后才能发起订阅操作。 被订阅者也必须是房间内人员(参见getAllMembers、userEnterMeeting)。
  • 订阅内容: 订阅时需要指定usrVideoId(userID + videoID)。videoID指定为-1时,代表订阅对方的默认摄像头。 用户当前启用的摄像头为:getDefaultVideo、getMutiVideos。
  • 订阅:创建CLCameraView,并设置usrVideoId。其中他人的视频从服务器订阅,本地视频从本地采集模块订阅。
  • 取消订阅:消毁CLCameraView,或设置无效usrVideoId。

2. 显示画面

  • SDK 渲染:将 CLCameraView 添加到屏幕上,由 SDK 内部完成解码与绘制,使用简单。

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

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

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

RTCMeeting *meeting = [RTCMeeting shareInstance];

// 创建用户视频ID对象
UsrVideoId *userVideoId = [[UsrVideoId alloc] init];
userVideoId.userId = @"remote_user_id";  // 远端用户ID
userVideoId.videoId = -1;                // -1 表示默认视频设备

// 获取视频帧
VideoFrame *frame = [meeting getVideoImg:userVideoId];

// 若 frame 有效,可进行保存或二次处理
if (frame != nil && frame.picData != nil && frame.picData.length > 0) {
    NSLog(@"获取视频帧成功: %dx%d, 格式:%d, 大小:%d bytes",
          frame.frameWidth,
          frame.frameHeight,
          frame.fmt,
          (int)frame.picData.length);
} else {
    NSLog(@"获取视频帧失败");
}

相关 API 请参考:

4. 大小流

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