帮你快速理解、总结文档立即下载

RoomParticipantView

最近更新时间:2026-07-20 15:11:00

我的收藏

简介

RoomParticipantView 是一个专门用于渲染房间参与者视频流的视图组件。 它支持摄像头和屏幕共享两种视频流类型,并提供填充模式设置、激活状态控制等功能。
说明:
使用前需要通过 RoomParticipantController.create 方法初始化视频流类型和参与者信息。

功能特性

视频流渲染:支持渲染摄像头视频流和屏幕共享视频流。
填充模式:支持填充(FILL)和适应(FIT)两种视频填充模式。
激活状态:支持设置视图的激活状态,控制视频渲染。
手势交互:支持点击等手势交互。

API 列表

函数名
描述
创建视图实例。
更新视频流类型。
更新参与者信息。
设置填充模式。
设置激活状态。
设置点击回调。

创建实例

RoomParticipantController.create

创建视图实例。

视频流控制

updateStreamType

更新视频流类型。
void updateStreamType(VideoStreamType streamType);
切换视频流类型,例如从摄像头切换到屏幕共享。
版本信息
从3.5版本开始支持。
参数说明
参数名
类型
描述
streamType
视频流类型。

updateParticipant

更新参与者信息。
void updateParticipant(RoomParticipant participant);
更新视图渲染的参与者,切换到显示新参与者的视频流。
版本信息
从3.5版本开始支持。
参数说明
参数名
类型
描述
participant
RoomParticipant
参与者信息。

视图设置

setFillMode

设置填充模式。
void setFillMode(FillMode fillMode);
设置视频画面的填充模式,可选择填充(FILL)或适应(FIT)模式。
版本信息
从3.5版本开始支持。
参数说明
参数名
类型
描述
fillMode
填充模式。

setActive

设置激活状态。
void setActive(bool isActive);
设置视图的激活状态。激活状态下视图会渲染视频,非激活状态下会停止渲染以节省资源。
版本信息
从3.5版本开始支持。
参数说明
参数名
类型
描述
isActive
bool
是否激活。

交互

setOnClickAction

设置点击回调。
void setOnClickAction(VoidCallback action);
设置视图被点击时的回调闭包。
版本信息
从3.5版本开始支持。
参数说明
参数名
类型
描述
action
VoidCallback
点击回调闭包。

数据结构

VideoStreamType

视频流类型。
枚举值
说明
camera
0
摄像头视频流。
screen
1
屏幕共享视频流。

FillMode

视频填充模式。
枚举值
说明
fill
0
填充模式,视频会填满整个视图区域,可能会裁剪部分内容。
fit
1
适应模式,视频会完整显示,可能会有黑边。