소식 및 공지 사항

제품 업데이트

Tencent Cloud 오디오/비디오 단말 SDK 재생 업그레이드 및 권한 부여 인증 추가

TRTC 월간 구독 패키지 출시 관련 안내

제품 소개

제품 개요

기본 개념

제품 기능

제품 장점

응용 시나리오

성능 데이터

구매 가이드

Billing Overview

무료 시간 안내

Monthly subscription

Pay-as-you-go

TRTC Overdue and Suspension Policy

과금 FAQ

Refund Instructions

신규 사용자 가이드

Demo 체험

Call

개요(TUICallKit)

Activate the Service

Run Demo

빠른 통합(TUICallKit)

오프라인 푸시

Conversational Chat

온클라우드 녹화(TUICallKit)

AI Noise Reduction

UI 사용자 정의

Calls integration to Chat

Additional Features

No UI Integration

Server APIs

Client APIs

Solution

ErrorCode

릴리스 노트

FAQs

라이브 스트리밍

Billing of Video Live Component

Overview

Activating the Service (TUILiveKit)

Demo 실행

No UI Integration

UI Customization

Live Broadcast Monitoring

Video Live Streaming

Voice Chat Room

Advanced Features

Client APIs

Server APIs

Error Codes

Release Notes

FAQs

RTC Engine

Activate Service

SDK 다운로드

API 코드 예시

Usage Guidelines

API 클라이언트 API

고급 기능

RTC RESTFUL API

History

Introduction

API Category

Room Management APIs

Stream mixing and relay APIs

On-cloud recording APIs

Data Monitoring APIs

Pull stream Relay Related interface

Web Record APIs

AI Service APIs

Cloud Slicing APIs

Cloud Moderation APIs

Making API Requests

Call Quality Monitoring APIs

Usage Statistics APIs

Data Types

Appendix

Error Codes

콘솔 가이드

애플리케이션 관리

사용량 통계

모니터링 대시보드

개발 보조

Solution

Real-Time Chorus

FAQs

과금 개요

기능 관련

UserSig 관련

방화벽 제한 처리

설치 패키지 용량 축소 관련 질문

Andriod 및 iOS 관련

Web 관련

Flutter 관련

Electron 관련

TRTCCalling Web 관련

멀티미디어 품질 관련

기타 질문

Protocols and Policies

컴플라이언스 인증

보안 백서

정보 보안에 관한 참고 사항

Service Level Agreement

Apple Privacy Policy: PrivacyInfo.xcprivacy

TRTC 정책

개인 정보 보호 정책

데이터 처리 및 보안 계약

용어집

LiveSeatStore

PDF

포커스 모드

폰트 크기

마지막 업데이트 시간: 2026-03-05 16:32:09

Introduction
LiveSeatStore provides a complete set of seat management APIs, including taking seat, leaving seat, locking seat, unlocking seat, kicking user off seat, remote device control, etc.
Through this class, seat management functionality can be implemented in the live room.

Important: 
Use the LiveSeatStore.create factory method to create a LiveSeatStore instance, passing a valid live room ID.
Note: 
Seat state updates are delivered through the liveSeatState publisher. Subscribe to it to receive real-time updates of seat data in the room.
Features
Seat Management：Take seat, leave seat, lock seat, unlock seat operations
User Management：Kick user off seat, move user to specified seat
Device Control：Remote control of user's camera and microphone
Event Listening：Listen to seat-related events
Subscribable Data
LiveSeatState fields are described below:
Property
Type
Description
seatList
ValueListenable<List<SeatInfo>>
Seat list.
canvas
ValueListenable<LiveCanvas>
Canvas information.
speakingUsers
ValueListenable<Map<String, int>>
Speaking users.
avStatistics
ValueListenable<List<AVStatistics>>
Audio and video statistics.
API List
Function
Description
LiveSeatStore.create
Create seat management instance.
addLiveSeatEventListener
Seat event callbacks.
removeLiveSeatEventListener
Seat event callbacks.
takeSeat
Take seat.
leaveSeat
Leave seat.
lockSeat
Lock seat.
unlockSeat
Unlock seat.
kickUserOutOfSeat
Kick user off seat.
moveUserToSeat
Move user.
openRemoteCamera
Open remote camera.
closeRemoteCamera
Close remote camera.
openRemoteMicrophone
Open remote microphone.
closeRemoteMicrophone
Close remote microphone.
Creating Instance
LiveSeatStore.create
Create seat management instance
Observing State and Events
addLiveSeatEventListener
Add seat event listener
void addLiveSeatEventListener(LiveSeatListener listener);
Version
Supported since version 3.5.
Parameters
Parameter
Type
Required
Description
listener
LiveSeatListener
Required
Listener.
removeLiveSeatEventListener
Remove seat event listener
void removeLiveSeatEventListener(LiveSeatListener listener);
Version
Supported since version 3.5.
Parameters
Parameter
Type
Required
Description
listener
LiveSeatListener
Required
Listener.
Seat Operations
takeSeat
Take seat
Future<CompletionHandler> takeSeat(int seatIndex);
Version
Supported since version 3.5.
Parameters
Parameter
Type
Required
Description
seatIndex
int
Required
Seat index.
leaveSeat
Leave seat
Future<CompletionHandler> leaveSeat();
Version
Supported since version 3.5.
lockSeat
Lock seat
Future<CompletionHandler> lockSeat(int seatIndex);
Version
Supported since version 3.5.
Parameters
Parameter
Type
Required
Description
seatIndex
int
Required
Seat index.
unlockSeat
Unlock seat
Future<CompletionHandler> unlockSeat(int seatIndex);
Version
Supported since version 3.5.
Parameters
Parameter
Type
Required
Description
seatIndex
int
Required
Seat index.
User Management
kickUserOutOfSeat
Kick user off seat
Future<CompletionHandler> kickUserOutOfSeat(String userID);
Version
Supported since version 3.5.
Parameters
Parameter
Type
Required
Description
userID
String
Required
User ID.
moveUserToSeat
Move user to seat
Future<CompletionHandler> moveUserToSeat({
  required String userID,
  required int targetIndex,
  MoveSeatPolicy policy = MoveSeatPolicy.abortWhenOccupied,
});
Version
Supported since version 3.5.
Parameters
Parameter
Type
Required
Description
userID
String
Required
User ID.
targetIndex
int
Required
Target seat index.
policy
MoveSeatPolicy
Required
Move policy.
Remote Device Control
openRemoteCamera
Open remote camera
Future<CompletionHandler> openRemoteCamera({
  required String userID,
  required DeviceControlPolicy policy,
});
Version
Supported since version 3.5.
Parameters
Parameter
Type
Required
Description
userID
String
Required
User ID.
policy
DeviceControlPolicy
Required
Device control policy.
closeRemoteCamera
Close remote camera
Future<CompletionHandler> closeRemoteCamera(String userID);
Version
Supported since version 3.5.
Parameters
Parameter
Type
Required
Description
userID
String
Required
User ID.
openRemoteMicrophone
Open remote microphone
Future<CompletionHandler> openRemoteMicrophone({
  required String userID,
  required DeviceControlPolicy policy,
});
Version
Supported since version 3.5.
Parameters
Parameter
Type
Required
Description
userID
String
Required
User ID.
policy
DeviceControlPolicy
Required
Device control policy.
closeRemoteMicrophone
Close remote microphone
Future<CompletionHandler> closeRemoteMicrophone(String userID);
Version
Supported since version 3.5.
Parameters
Parameter
Type
Required
Description
userID
String
Required
User ID.
Data Structures
MoveSeatPolicy
Move seat policy
Enum Value
Description
abortWhenOccupied
Abort when occupied.
forceReplace
Force replace.
swapPosition
Swap position.
DeviceControlPolicy
Device control policy
Enum Value
Description
unlockOnly
Unlock only.
SuspendStatus
User suspend status
Enum Value
Description
none
Not suspended.
inBackground
User suspended in background.
inCalling
User is on a phone call.
LiveSeatListener
Seat related callback events.
Methods
Method
Description
onLocalCameraOpenedByAdmin
Triggered when the local camera is opened by an admin.
onLocalCameraClosedByAdmin
Triggered when the local camera is closed by an admin.
onLocalMicrophoneOpenedByAdmin
Triggered when the local microphone is opened by an admin.
onLocalMicrophoneClosedByAdmin
Triggered when the local microphone is closed by an admin.
SeatUserInfo
Seat user information
Property
Type
Description
userID
String
User ID.
userName
String
User name.
avatarURL
String
Avatar URL.
role
Role
User role.
liveID
String
Live room ID.
microphoneStatus
DeviceStatus
Microphone status.
allowOpenMicrophone
bool
Whether microphone can be opened.
cameraStatus
DeviceStatus
Camera status.
allowOpenCamera
bool
Whether camera can be opened.
userSuspendStatus
SuspendStatus
User suspend status.
RegionInfo
Seat view coordinate information
Property
Type
Description
x
int
X coordinate.
y
int
Y coordinate.
w
int
Width.
h
int
Height.
zorder
int
Z-order.
AVStatistics
Audio and video statistics information
Property
Type
Description
userID
String
User ID.
videoBitrate
int
Local video bitrate.
videoWidth
int
Local video width.
videoHeight
int
Local video height.
frameRate
int
Local video frame rate.
audioSampleRate
int
Audio sample rate.
audioBitrate
int
Audio bitrate.
SeatInfo
Seat information
Property
Type
Description
index
int
Seat index.
isLocked
bool
Whether locked.
userInfo
SeatUserInfo
User information.
region
RegionInfo
Region information.
LiveCanvas
Live canvas
Property
Type
Description
w
int
Width.
h
int
Height.
templateID
int
Template ID.
LiveSeatState
Seat state data provided by LiveSeatStore.
Property
Type
Description
seatList
ValueListenable<List<SeatInfo>>
Seat list.
canvas
ValueListenable<LiveCanvas>
Canvas information.
speakingUsers
ValueListenable<Map<String, int>>
Speaking users.
avStatistics
ValueListenable<List<AVStatistics>>
Audio and video statistics.

도움말 및 지원

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

더 자세한 내용은 문의하기 또는 티겟 제출 을 통해 문의할 수 있습니다.

피드백

tencent cloud

Tencent Real-Time Communication

LiveSeatStore

Introduction

Features

Subscribable Data

API List

Creating Instance

LiveSeatStore.create

Observing State and Events

addLiveSeatEventListener

removeLiveSeatEventListener

Seat Operations

takeSeat

leaveSeat

lockSeat

unlockSeat

User Management

kickUserOutOfSeat

moveUserToSeat

Remote Device Control

openRemoteCamera

closeRemoteCamera

openRemoteMicrophone

closeRemoteMicrophone

Data Structures

MoveSeatPolicy

DeviceControlPolicy

SuspendStatus

LiveSeatListener

SeatUserInfo

RegionInfo

AVStatistics

SeatInfo

LiveCanvas

LiveSeatState

도움말 및 지원

Property	Type	Description
seatList	ValueListenable<List<SeatInfo>>	Seat list.
canvas	ValueListenable<LiveCanvas>	Canvas information.
speakingUsers	ValueListenable<Map<String, int>>	Speaking users.
avStatistics	ValueListenable<List<AVStatistics>>	Audio and video statistics.

Function	Description
LiveSeatStore.create	Create seat management instance.
addLiveSeatEventListener	Seat event callbacks.
removeLiveSeatEventListener	Seat event callbacks.
takeSeat	Take seat.
leaveSeat	Leave seat.
lockSeat	Lock seat.
unlockSeat	Unlock seat.
kickUserOutOfSeat	Kick user off seat.
moveUserToSeat	Move user.
openRemoteCamera	Open remote camera.
closeRemoteCamera	Close remote camera.
openRemoteMicrophone	Open remote microphone.
closeRemoteMicrophone	Close remote microphone.

Parameter	Type	Required	Description
listener	LiveSeatListener	Required	Listener.

Enum Value	Description
abortWhenOccupied	Abort when occupied.
forceReplace	Force replace.
swapPosition	Swap position.

Enum Value	Description
none	Not suspended.
inBackground	User suspended in background.
inCalling	User is on a phone call.

Method	Description
onLocalCameraOpenedByAdmin	Triggered when the local camera is opened by an admin.
onLocalCameraClosedByAdmin	Triggered when the local camera is closed by an admin.
onLocalMicrophoneOpenedByAdmin	Triggered when the local microphone is opened by an admin.
onLocalMicrophoneClosedByAdmin	Triggered when the local microphone is closed by an admin.