简介
RoomParticipantView 是一个专门用于渲染房间参与者视频流的视图组件。 它支持摄像头和屏幕共享两种视频流类型,并提供填充模式设置、激活状态控制等功能。说明:
使用前需要通过 init 方法初始化视频流类型和参与者信息。
功能特性
视频流渲染:支持渲染摄像头视频流和屏幕共享视频流。
填充模式:支持填充(FILL)和适应(FIT)两种视频填充模式。
激活状态:支持设置视图的激活状态,控制视频渲染。
手势交互:支持点击等手势交互。
API 列表
函数名 | 描述 |
创建视图实例。 | |
更新视频流类型。 | |
更新参与者信息。 | |
设置填充模式。 | |
设置激活状态。 | |
设置点击监听器。 |
创建实例
RoomParticipantView
创建视图实例。
视频流控制
updateStreamType
更新视频流类型。
fun updateStreamType(streamType: VideoStreamType) {updateStreamTypeInternal(streamType)}
切换视频流类型,例如从摄像头切换到屏幕共享。
版本信息
从3.5版本开始支持。
参数说明
参数名 | 类型 | 描述 |
streamType | 视频流类型。 |
updateParticipant
更新参与者信息。
fun updateParticipant(participant: RoomParticipant) {updateParticipantInternal(participant)}
更新视图渲染的参与者,切换到显示新参与者的视频流。
版本信息
从3.5版本开始支持。
参数说明
参数名 | 类型 | 描述 |
participant | RoomParticipant | 参与者信息。 |
视图设置
setFillMode
设置填充模式。
fun setFillMode(fillMode: FillMode) {setFillModeInternal(fillMode)}
设置视频画面的填充模式,可选择填充(FILL)或适应(FIT)模式。
版本信息
从3.5版本开始支持。
参数说明
参数名 | 类型 | 描述 |
fillMode | 填充模式。 |
setActive
设置激活状态。
fun setActive(isActive: Boolean) {setActiveInternal(isActive)}
设置视图的激活状态。激活状态下视图会渲染视频,非激活状态下会停止渲染以节省资源。
版本信息
从3.5版本开始支持。
参数说明
参数名 | 类型 | 描述 |
isActive | Boolean | 是否激活。 |
交互
setOnClickListener
设置点击监听器。
数据结构
VideoStreamType
视频流类型。
枚举值 | 值 | 说明 |
CAMERA | 0 | 摄像头视频流。 |
SCREEN | 1 | 屏幕共享视频流。 |
FillMode
视频填充模式。
枚举值 | 值 | 说明 |
FILL | 0 | 填充模式,视频会填满整个视图区域,可能会裁剪部分内容。 |
FIT | 1 | 适应模式,视频会完整显示,可能会有黑边。 |