소식 및 공지 사항

제품 업데이트

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 정책

개인 정보 보호 정책

데이터 처리 및 보안 계약

용어집

Switch Seat(New version)

PDF

포커스 모드

폰트 크기

마지막 업데이트 시간: 2025-08-20 17:21:19

Feature Description
The App admin can use this API to move a certain on-mic user to another seat. Automatic unlock is triggered when muting, and it also supports forcing a move, exchanging seats, and other operations.
Note:
This API is for the new version of the Moving Mic feature. For the earlier version, refer to Switch Seat(Old version). The earlier version supports only moving to an empty mic slot.
API Call Description
Sample Request URL
https://console.tim.qq.com/v4/room_engine_http_mic/move_user_to_seat?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json
Request Parameters
The following table lists only the parameters involved in modification when calling this API and their descriptions. For more details about the parameters, please refer to REST API introduction.
Parameter
Description
v4/room_engine_http_mic/move_user_to_seat
Request API
sdkappid
The SDKAppID assigned by the IM console when creating an application.
identifier
It must be an App administrator account. For more details, see app admin.
usersig
The signature generated by the App administrator account. For specific operations, see generate UserSig.
random
Enter a random 32-bit unsigned integer in the range of [0, 4294967295].
contenttype
The request format is fixed as json.
Maximum Calling Frequency
200 times/second.
Sample Request Packet
Basic form
{
  "RoomId":"room-test",
  "SeatIndex": 1,
  "Member_Account": "user",
  "Policy": 0 // Specify the seat move mode when occupied, 0 cancel, 1 force move and kick this user, 2 exchange seats
}
Request Packet Fields
Field
Type
Attribute
Description
RoomId
String
Required
room ID
SeatIndex
Integer
Required
Seat ID.
Member_Account
String
Required
user ID.
Policy
Integer
Required
Seat move mode. When the seat is occupied, 0 cancel, 1 force move and kick this user, 2 exchange seats.
Response Payload Example
Basic form
{
  "ErrorCode": 0,
  "ErrorInfo": "",
  "ActionStatus": "OK",
  "RequestId": "Id-7c1680be52734bdc8d6de398ab9505e7-O-Seq-57717"
}
Response Packet Fields
Field
Type
Description
ActionStatus
String
Request processing result. OK: processing successful; FAIL: processing failed.
ErrorCode
Integer
Error code: 0 indicates success, non-zero indicates failure.
ErrorInfo
String
Error message.
RequestId
String
Unique request ID, returned for each request. To troubleshoot a request, its RequestId should be provided.
Error Code Description
Unless a network error (such as 502) occurs, the HTTP return code of this API is 200. The actual error code and error information are indicated by ErrorCode and ErrorInfo in the response payload.
Common error codes (60000 to 79999), please refer to the Error Code document.
Private error codes of this API are as follows:
Error Code
Description
100001
Server internal error, please try again.
100002
Illegal request parameters. Check whether the request is correct according to the error description.
100004
The room does not exist, or it may have existed but has been dismissed.
100005
Microphone User Non-room Member
100200
Seat locked. Can try another seat.
100203
Already on mic
100206
User not on mic
100210
User on seat
﻿

도움말 및 지원

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

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

피드백

tencent cloud

Tencent Real-Time Communication

Switch Seat(New version)

Feature Description

API Call Description

Sample Request URL

Request Parameters

Maximum Calling Frequency

Sample Request Packet

Request Packet Fields

Response Payload Example

Response Packet Fields

Error Code Description

도움말 및 지원

Parameter	Description
v4/room_engine_http_mic/move_user_to_seat	Request API
sdkappid	The SDKAppID assigned by the IM console when creating an application.
identifier	It must be an App administrator account. For more details, see app admin.
usersig	The signature generated by the App administrator account. For specific operations, see generate UserSig.
random	Enter a random 32-bit unsigned integer in the range of [0, 4294967295].
contenttype	The request format is fixed as `json`.

Field	Type	Attribute	Description
RoomId	String	Required	room ID
SeatIndex	Integer	Required	Seat ID.
Member_Account	String	Required	user ID.
Policy	Integer	Required	Seat move mode. When the seat is occupied, 0 cancel, 1 force move and kick this user, 2 exchange seats.

Error Code	Description
100001	Server internal error, please try again.
100002	Illegal request parameters. Check whether the request is correct according to the error description.
100004	The room does not exist, or it may have existed but has been dismissed.
100005	Microphone User Non-room Member
100200	Seat locked. Can try another seat.
100203	Already on mic
100206	User not on mic
100210	User on seat