订阅并显示视频
功能介绍
本节介绍如何在房间内订阅并显示视频画面,包括:
- 使用 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);