tencent cloud

Tencent Real-Time Communication

문서Tencent Real-Time CommunicationConferenceClient APIsiOSRoomParticipantView

RoomParticipantView

Download
포커스 모드
폰트 크기
마지막 업데이트 시간: 2026-07-29 10:54:51

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 init(streamType:participant:) 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

init

Create view instance.

Video Stream Control

updateStreamType

Update video stream type.
public func updateStreamType(streamType: VideoStreamType) {
    updateStreamTypeInternal(streamType: 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.
public func updateParticipant(participant: RoomParticipant) {
    updateParticipantInternal(participant: 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.
public func setFillMode(fillMode: FillMode) {
    setFillModeInternal(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.
public func setActive(isActive: Bool) {
    setActiveInternal(isActive: 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.
public func setOnClickAction(action: @escaping () -> Void) {
    setOnClickActionInternal(action: action)
}
Set the callback closure when the view is clicked.
Version
Supported since version 3.5.
Parameters
Parameter
Type
Description
action
() -> Void
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

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백