音视频通话

订阅并显示视频

功能介绍

本节介绍如何在房间内订阅并显示视频画面,包括:

  • 使用 VideoUIView 组件显示指定用户的视频
  • 大小流选择
  • 获取当前显示图像、视频流信息

1. 订阅与取消订阅

  • 订阅时机: 自已进入房间成功后才能发起订阅操作。 被订阅者也必须是房间内人员(参见getAllMembers、userEnterMeeting)。
  • 订阅内容: 订阅时需要指定UsrVideoId(userID + videoID)。videoID指定为-1时,代表订阅对方的默认摄像头。 用户当前启用的摄像头为:getDefaultVideo、getMutiVideos。
  • 订阅:创建VideoUIView,并设置UsrVideoId。其中他人的视频从服务器订阅,本地视频从本地采集模块订阅。
  • 取消订阅:消毁VideoUIView,或设置无效UserVideoID。

2. 使用 VideoUIView 显示视频

在布局文件中添加视频显示控件:

<com.rtc.sdk.VideoUIView
    android:id="@+id/video_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

设置要显示的用户视频:

VideoUIView videoView = findViewById(R.id.video_view);
UsrVideoId usrVideoId = new UsrVideoId(userID, (short) -1); // -1 代表默认视频设备
videoView.setUsrVideoId(usrVideoId);

相关 API 请参考:

3. 显示模式与镜像

// 设置显示模式(保持比例 / 拉伸填充等)
videoView.setScaleType(VideoUIView.SCALE_TYPE_FITXY);

// 设置镜像
videoView.setMirrorType(VideoUIView.MIRROR_TYPE_HORIZONTAL);

相关 API 请参考:

4. 获取视频流信息

UsrVideoId cam = new UsrVideoId(userID, videoID);
VideoStreamInfo streamInfo = RTCMeeting.getInstance().getVideoStreamInfo(cam);

相关 API 请参考:

5. 视频数据通知

如需自行处理视频帧,可监听 notifyVideoData 回调:

@Override
void notifyVideoData(UsrVideoId usrVideoID, long frameTime) {
    // 收到新视频帧通知
}

相关 API 请参考:

6. 大小流

若发送端开启了大小流,订阅时可指定档位,详见 视频大小流支持。

// qualityLv: 1=默认档位,2=第二档,3=第三档
videoView.setUsrVideoId(usrVideoId, 2);