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