音视频通话

拍照

功能介绍

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

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

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