音视频通话

拍照

功能介绍

本节介绍如何基于当前正在渲染的视频画面进行“拍照”截帧,即获取当前视频图像并保存为图片文件或用于业务处理。

拍照能力依赖“已订阅并正在渲染”的视频画面,通过获取视频帧再转换为图片格式实现。

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,可截取已订阅的远端视频画面作为“拍照”来源。