订阅并显示视频
功能介绍
本节介绍如何在房间内订阅并显示视频画面,包括:
- 订阅指定用户的视频
- 使用 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. 大小流
若发送端开启了大小流,订阅时可指定大流或小流,以在清晰度与带宽之间权衡。详见 视频大小流支持。