音视频通话

拍照

功能介绍

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

拍照能力依赖「已订阅并正在渲染」的视频画面,通过 VideoUIView 的 getShowPic 接口获取 Bitmap 实现。

1. 获取视频图像

VideoUIView videoView = findViewById(R.id.video_view);
videoView.setUsrVideoId(new UsrVideoId(userID, (short) -1));

// 检查是否有有效图像
if (!videoView.isPicEmpty()) {
    Bitmap bitmap = videoView.getShowPic();
    if (bitmap != null) {
        // 保存为文件或用于业务处理
    }
}

相关 API 请参考:

2. 本端与远端

  • 远端:对远端 userID 设置 VideoUIView 后,调用 getShowPic 可截取已订阅的远端视频画面。
  • 本端:对本端 userID 设置 VideoUIView 后,可截取本端当前发送前的渲染画面。

3. 注意事项

  • 仅能获取 VideoUIView 正在显示的视频图像;若尚未解码出有效帧,isPicEmpty 将返回 true。
  • 屏幕共享画面可通过 ScreenShareUIView 的 getShowPic 同样方式获取。