拍照
功能介绍
本节介绍如何基于当前正在渲染的视频画面进行“拍照”截帧,即获取当前视频图像并保存为图片文件或用于业务处理。
拍照能力依赖“已订阅并正在渲染”的视频画面,通过获取视频帧再转换为图片格式实现。
1. 获取视频图像帧
调用 getVideoImg 可获取指定用户、指定视频设备的图像帧(CRVideoFrame)。
- 适用对象:本端或远端、已通过 CLCameraView 订阅的视频。
- 参数:传入 UsrVideoId(userID + videoID)及可选的大小流类型。
- 注意:仅能获取“正在观看”的视频图像;若本地尚无采集到帧或远端未解码出图像帧,将返回空帧。
示例(获取远端用户默认视频画面):
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) {
// 可对 frame 进行格式转换、编码为 JPEG/PNG 等并写入文件,即实现"拍照"
}
相关 API 请参考:
2. 格式转换与保存为图片
CRVideoFrame 为原始视频帧,若需保存为常见图片格式,可:
- 通过自有或第三方库将像素数据编码为 PNG、JPEG 等并写入文件。
3. 本端与远端
- 本端:对本端 userID + 本端 videoID(如默认视频设备)调用 GetVideoImg,可截取本端当前发送前的渲染画面(需已在本端对该路视频进行观看或内部有渲染)。
- 远端:对远端 userID + 其 videoID 调用 GetVideoImg,可截取已订阅的远端视频画面作为“拍照”来源。