tencent cloud

Tencent Real-Time Communication

ドキュメントTencent Real-Time CommunicationConferenceClient APIsFlutterRoomParticipantView

RoomParticipantView

Download
フォーカスモード
フォントサイズ
最終更新日: 2026-07-29 10:56:31

Introduction

RoomParticipantView is a view component specifically designed for rendering room participant video streams. It supports both camera and screen sharing video stream types, and provides fill mode settings, active state control and other features.
Note:
Before use, you need to initialize the video stream type and participant info through RoomParticipantController.create method.

Features

Video Stream Rendering: Supports rendering camera video streams and screen sharing video streams.
Fill Mode: Supports FILL and FIT video fill modes.
Active State: Supports setting the active state of the view to control video rendering.
Gesture Interaction: Supports click and other gesture interactions.

API List

Function
Description
Create view instance.
Update video stream type.
Update participant info.
Set fill mode.
Set active state.
Set click callback.

Creating Instance

RoomParticipantController.create

Create view instance.

Video Stream Control

updateStreamType

Update video stream type.
void updateStreamType(VideoStreamType streamType);
Switch video stream type, for example from camera to screen sharing.
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
streamType
Video stream type.

updateParticipant

Update participant info.
void updateParticipant(RoomParticipant participant);
Update the participant rendered by the view, switch to display the new participant's video stream.
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
participant
RoomParticipant
Participant info.

View Settings

setFillMode

Set fill mode.
void setFillMode(FillMode fillMode);
Set the fill mode of the video, can choose FILL or FIT mode.
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
fillMode
Fill mode.

setActive

Set active state.
void setActive(bool isActive);
Set the active state of the view. When active, the view will render video; when inactive, it will stop rendering to save resources.
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
isActive
bool
Whether active.

Interaction

setOnClickAction

Set click callback.
void setOnClickAction(VoidCallback action);
Set the callback closure when the view is clicked.
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
action
VoidCallback
Click callback closure.

Data Structures

VideoStreamType

Video stream type.
Enum Value
Value
Description
camera
0
Camera video stream.
screen
1
Screen sharing video stream.

FillMode

Video fill mode.
Enum Value
Value
Description
fill
0
Fill mode, video fills the entire view area, may crop some content.
fit
1
Fit mode, video displays completely, may have black borders.
前の記事へ: RoomStore次の記事へ: RoomParticipantStore

ヘルプとサポート

この記事はお役に立ちましたか？

フィードバック