Docs Overview/
Live/
UIKit/
iOS/
Voice Room Features/
Seat Management/

Seat Management

Description of the Feature

Seat Management is a real-time interaction and communication method where anchors can interact with the audience on the seat in real-time. Whether it's answering questions, sharing experiences, or entertainment interactions, it greatly enhances the audience's sense of participation and satisfaction. This direct interaction and communication provide more convenient and efficient channels for commercial operations. Using this feature, you can achieve applying to join the seat, inviting to take seat, moving seat positions, kicking someone off the seat, and locking seats, greatly enriching the playability of the voice chat room.
Seat List
Audience applies to take seat
Anchor Handling Seat Request










Apply To take Seat Process

Audience applies to take seat process

The TUILiveKit audience application for seat feature is mainly implemented through SeatGridView. You can call the following API Function to achieve the audience application for seat feature. The implementation is as follows, with Audience B applying for a seat as an example.

Audience sends a request to join the seat

Audience B sends a request to join the seat to Anchor A. Anchor A will receive the join request from Audience B in the onSeatRequestReceived Callback.
Android
iOS
Flutter
Kotlin
Java
val seatIndex = 1; 
val timeout = 60; 
seatGridView.takeSeat(seatIndex, timeout, object : VoiceRoomDefine.RequestCallback {
    override fun onAccepted(userInfo: TUIRoomDefine.UserInfo) {
        Log.i(TAG, "Application for speaking is approved")
    }

    override fun onRejected(userInfo: TUIRoomDefine.UserInfo) {
        Log.i(TAG, "Application for speaking is rejected")
    }

    override fun onCancelled(userInfo: TUIRoomDefine.UserInfo) {
        Log.i(TAG, "Application for speaking is canceled")
    }

    override fun onTimeout(userInfo: TUIRoomDefine.UserInfo) {
        Log.i(TAG, "Application for speaking times out")
    }

    override fun onError(userInfo: TUIRoomDefine.UserInfo, error: TUICommonDefine.Error, message: String) {
        Log.i(TAG, "Application for speaking error")
    }
})
int seatIndex = 1; 
int timeout = 60;
seatGridView.takeSeat(seatIndex, timeout, new VoiceRoomDefine.RequestCallback() {
    @Override
    public void onAccepted(TUIRoomDefine.UserInfo userInfo) {
        Log.i(TAG, "Application for speaking is approved");
    }

    @Override
    public void onRejected(TUIRoomDefine.UserInfo userInfo) {
        Log.i(TAG, "Application for speaking is rejected");
    }

    @Override
    public void onCancelled(TUIRoomDefine.UserInfo userInfo) {
        Log.i(TAG, "Application for speaking is canceled");
    }

    @Override
    public void onTimeout(TUIRoomDefine.UserInfo userInfo) {
        Log.i(TAG, "Application for speaking times out");
    }

    @Override
    public void onError(TUIRoomDefine.UserInfo userInfo, TUICommonDefine.Error error, String message) {
        Log.i(TAG, "Application for speaking error");
    }
});
swift
import RTCRoomEngine
import LiveStreamCore

let seatIndex = 1
let timeout = 60 
seatGridView.takeSeat(index: index, timeout: timeout) { userInfo in
      print("Application for speaking is approved")
    } onRejected: { userInfo in
      print("Application for speaking is rejected")
    } onCancelled: { userInfo in
      print("Application for speaking is canceled")
    } onTimeout: { userInfo in
      print("Application for speaking times out")
    } onError: { userInfo, code, message in
      print("Application for speaking error")
    }
Dart
import 'package:live_stream_core/live_stream_core.dart';
import 'package:rtc_room_engine/rtc_room_engine.dart';

const int seatIndex = 1;
const int timeout = 60;
final controller = SeatGridController();
final result = await controller.takeSeat(seatIndex, timeout);
if (result.code == TUIError.success) {                          
    switch (result.type) {                            
      case RequestResultType.onAccepted:                              
        debugPrint('Request to speak approved');                              
        break;                            
      case RequestResultType.onRejected:                              
        debugPrint('Application for speaking is rejected');                              
        break;                            
      case RequestResultType.onCancelled:                              
        debugPrint('Application for speaking is canceled');                              
        break;                            
      case RequestResultType.onTimeout:                              
        debugPrint('Request to speak timeout');                              
        break;                            
      default:                              
        break;                          
    }                        
} else {                          
    debugPrint('Error in requesting to speak');   
}
The TUILiveKit audience application for seat feature is mainly implemented through SeatGridView. You can call the following API Function to achieve the audience application for seat feature. The implementation is as follows, with Audience B applying for a seat as an example.
Note:
The room owner will only receive a request to speak when the room mode is APPLY_TO_TAKE, in FREE_TO_TAKE mode, takeSeat will directly succeed in taking the seat.

Host end receives a Request to Speak

Anchor A will receive Audience B's request to join the seat in the onSeatRequestReceived callback method.
Android
iOS
Flutter
Kotlin
Java
override fun onSeatRequestReceived(type: VoiceRoomDefine.RequestType, userInfo: TUIRoomDefine.UserInfo) {
   if (type == VoiceRoomDefine.RequestType.APPLY_TO_TAKE_SEAT) {
      Log.i(TAG, "Received request to join the seat from the audience: ${userInfo.userId}")
   }
}
@Override
public void onSeatRequestReceived(VoiceRoomDefine.RequestType type, TUIRoomDefine.UserInfo userInfo) {
    if (type == VoiceRoomDefine.RequestType.APPLY_TO_TAKE_SEAT) {
        Log.i(TAG, "Received request to join the mi from the audience: " + userInfo.userId);
    }
}
swift
import RTCRoomEngine
import LiveStreamCore

func onSeatRequestReceived(type: SGRequestType, userInfo: TUIUserInfo) {
   if type == .applyToTakeSeat {
     print("Received audience's request to join the seat: \(userInfo.userId)")
   }
}
Dart
import 'package:live_stream_core/live_stream_core.dart';
import 'package:rtc_room_engine/rtc_room_engine.dart';

// Create a listening Observer instance
final controller = SeatGridController();
final exampleObserver = ExampleObserver(); 

// Add an observer
controller.addObserver(exampleObserver);

class ExampleObserver extends SeatGridWidgetObserver {  
    ExampleObserver() {   
       super.onSeatRequestReceived = (type, userInfo) { 
         if (type == RequestType.applyToTakeSeat) {   
           debugPrint('Receive an audience''s request to become a speaker: ${userInfo.userId}');  
         }  
       };    
    }
}
Note:
The room owner will only receive a request to take seat when the room mode is APPLY_TO_TAKE, in FREE_TO_TAKE mode, takeSeat will directly succeed in taking the seat.

Anchor responds to the request to take the seat

After Anchor A receives Audience B's request to join the seat, they can call responseRemoteRequest to respond whether they agree to let Audience B take seat. Audience B will receive a callback of Anchor A's acceptance or rejection (onAccepted/onRejected).
Android
iOS
Flutter
Kotlin
Java
// Anchor agrees to let the audience take the seat
seatGridView.responseRemoteRequest(userId, true, null);

// Anchor rejects the audience's request to take the seat
seatGridView.responseRemoteRequest(userId, false, null);
// Anchor agrees to let the audience take the seat
seatGridView.responseRemoteRequest(userId, true, null);

// Anchor rejects the audience's request to take the seat
seatGridView.responseRemoteRequest(userId, false, null);
swift
import RTCRoomEngine
import LiveStreamCore

// Anchor agrees to let the audience take the seat
seatGridView.responseRemoteRequest(userId, true) {
} onError: { code, message in 
}

// Anchor rejects the audience's request to take the seat
seatGridView.responseRemoteRequest(userId, false) {
} onError: { code, message in 
}
Dart
import 'package:live_stream_core/live_stream_core.dart';
import 'package:rtc_room_engine/rtc_room_engine.dart';

final controller = SeatGridController();

const String userId = 'Replace with the userId of userB';

// Broadcaster agrees to let the audience become a speaker
final result = await controller.responseRemoteRequest(userId, true);

// Broadcaster denies audience to become a speaker
final result = await controller.responseRemoteRequest(userId, false);

Callback for seat information changes

Android
iOS
Flutter
If you have already set up the Custom Seat View, you can listen to the updateSeatView callback to refresh your custom UI.
Kotlin
Java
override fun updateSeatView(seatGridView: SeatGridView, seatInfo: TUIRoomDefine.SeatInfo, seatView: View) {
   Log.i(TAG, "Seat information changes");
}
@Override
public void void updateSeatView(SeatGridView seatGridView, TUIRoomDefine.SeatInfo seatInfo, View seatView) {
    Log.i(TAG, "Seat information changes");
}
If you have already set up the Custom Seat View, you can listen to the updateSeatView callback to refresh your custom seat UI.
swift
import RTCRoomEngine
import LiveStreamCore

func seatGridView(_ view: SeatGridView, updateSeatView seatInfo: TUISeatInfo, seatView: UIView) {
    print("Seat information changes")
}
When the seat information changes, the corresponding value of the seatInfoNotifier parameter of SeatWidgetBuilder will change. You can use your custom seat component as a child of ValueListenableBuilder so that your custom seat UI can be updated instantly.
Dart
// Definition of seatWidetBuilder
typedef SeatWidgetBuilder = Widget Function(    
    BuildContext context,    
    ValueNotifier<TUISeatInfo> seatInfoNotifier,
    ValueNotifier<int> volumeNotifier);
    
// Usage example
import 'package:live_stream_core/live_stream_core.dart';
import 'package:rtc_room_engine/rtc_room_engine.dart';

SeatGridWidget(   
    controller: controller,   
    seatWidgetBuilder: (         
          BuildContext context,         
          ValueNotifier<TUISeatInfo> seatInfoNotifier,         
          ValueNotifier<int> volumeNotifier) {            
              return ValueListenableBuilder(
                        valueListenable: seatInfoNotifier,
                        builder: (context, seatInfo, _) {
                          // Return your custom seat component        
                          return Container();
                        }
                     );         
          }
)

Anchor invites audience to speak flow

Anchor sends invite speaking request

Anchor A sends an invite speaking request to Audience C. Audience C will receive the invite speaking request from Anchor A in the onSeatRequestReceived Callback.
Android
iOS
Flutter
Kotlin
Java
val seatIndex = 1; 
val userId = "userIdC"; 
val timeout = 60; 
seatGridView.takeUserOnSeatByAdmin(seatIndex, timeout, userId, object : VoiceRoomDefine.RequestCallback {
    override fun onAccepted(userInfo: TUIRoomDefine.UserInfo) {
        Log.i(TAG, "Invitation to Become a Speaker Accepted")
    }

    override fun onRejected(userInfo: TUIRoomDefine.UserInfo) {
        Log.i(TAG, "Invitation to Become a Speaker Rejected")
    }

    override fun onCancelled(userInfo: TUIRoomDefine.UserInfo) {
        Log.i(TAG, "Invitation to Become a Speaker Cancelled")
    }

    override fun onTimeout(userInfo: TUIRoomDefine.UserInfo) {
        Log.i(TAG, "Invitation to Become a Speaker Timed Out")
    }

    override fun onError(userInfo: TUIRoomDefine.UserInfo, error: TUICommonDefine.Error, message: String) {
        Log.i(TAG, "Invitation to Become a Speaker Error")
    }
})
val seatIndex = 1; 
val userId = "userIdC"; 
val timeout = 60; 
seatGridView.takeUserOnSeatByAdmin(seatIndex, userId, timeout, new VoiceRoomDefine.RequestCallback() {
    @Override
    public void onAccepted(TUIRoomDefine.UserInfo userInfo) {
        Log.i(TAG, "Invitation to Become a Speaker Accepted");
    }

    @Override
    public void onRejected(TUIRoomDefine.UserInfo userInfo) {
        Log.i(TAG, "Invitation to Become a Speaker Rejected");
    }

    @Override
    public void onCancelled(TUIRoomDefine.UserInfo userInfo) {
        Log.i(TAG, "Invitation to Become a Speaker Cancelled");
    }

    @Override
    public void onTimeout(TUIRoomDefine.UserInfo userInfo) {
        Log.i(TAG, "Invitation to Become a Speaker Timed Out");
    }

    @Override
    public void onError(TUIRoomDefine.UserInfo userInfo, TUICommonDefine.Error error, String message) {
        Log.i(TAG, "Invitation to Become a Speaker Error");
    }
});
swift
import RTCRoomEngine
import LiveStreamCore

let seatIndex = 1
let userId = "userIdC" 

seatGridView.takeUserOnSeatByAdmin(index: seatIndex, timeout: timeout, userId: userId) { userInfo in
    print("Invitation to join the microphone is approved")
} onRejected: { userInfo in
    print("Invitation to join the microphone is rejected")
} onCancelled: { userInfo in
    print("Invitation to join the microphone is canceled")
} onTimeout: { userInfo in
    print("Invitation to join the microphone times out")
} onError: { userInfo, code, message in
    print("Invitation to join the microphone error")
}
Dart
import 'package:live_stream_core/live_stream_core.dart';
import 'package:rtc_room_engine/rtc_room_engine.dart';

const int seatIndex = 1;
const String userId = 'userIdC'
const int timeout = 60;
final controller = SeatGridController();
final result = await controller.takeUserOnSeatByAdmin(seatIndex, userId, timeout);
if (result.code == TUIError.success) {                          
    switch (result.type) {                            
      case RequestResultType.onAccepted:                              
        debugPrint('Invitation to become a speaker accepted');                              
        break;                            
      case RequestResultType.onRejected:                              
        debugPrint('Invitation to become a speaker rejected');                              
        break;                            
      case RequestResultType.onCancelled:                              
        debugPrint('Invitation to become a speaker cancelled');                              
        break;                            
      case RequestResultType.onTimeout:                              
        debugPrint('Invitation to become a speaker timed out');                              
        break;                            
      default:                              
        break;                          
    }                        
} else {                          
    debugPrint('Error in invitation to become a speaker');   
}

Audience Side received an Invite Speaking Request

Audience C will receive Anchor A's invite to join the seat in the onSeatRequestReceived callback method.
Android
iOS
Flutter
Kotlin
Java
override fun onSeatRequestReceived(type: VoiceRoomDefine.RequestType, userInfo: TUIRoomDefine.UserInfo) {
   if (type == VoiceRoomDefine.RequestType.INVITE_TO_TAKE_SEAT) {
      Log.i(TAG, "Received invite to join the seat from the anchor: ${userInfo.userId}")
   }
}
@Override
public void onSeatRequestReceived(VoiceRoomDefine.RequestType type, TUIRoomDefine.UserInfo userInfo) {
    if (type == VoiceRoomDefine.RequestType.INVITE_TO_TAKE_SEAT) {
        Log.i(TAG, "Received invite to join the seat from the anchor: " + userInfo.userId);
    }
}
swift
import RTCRoomEngine
import LiveStreamCore

func onSeatRequestReceived(type: SGRequestType, userInfo: TUIUserInfo) {
   if type == .inviteToTakeSeat {
      print("Received invite to join the seat from the anchor: \(userInfo.userId)")
   }
}
Dart
import 'package:live_stream_core/live_stream_core.dart';
import 'package:rtc_room_engine/rtc_room_engine.dart';

// Create a listening Observer instance
final controller = SeatGridController();
final exampleObserver = ExampleObserver(); 

// Add an observer
controller.addObserver(exampleObserver);

class ExampleObserver extends SeatGridWidgetObserver {  
    ExampleObserver() {   
       super.onSeatRequestReceived = (type, userInfo) { 
         if (type == RequestType.inviteToTakeSeat) {   
           debugPrint('Receive an invitation to become a speaker from the anchor: ${userInfo.userId}');  
         }  
       };    
    }
}

Audience responds to the invite to speak

After Audience C receives the join request from Anchor A, they can call responseRemoteRequest to respond whether they agree to speak. Anchor A will receive Audience C's acceptance or rejection (onAccepted/onRejected) callback.
Android
iOS
Flutter
Kotlin
Java
// Audience agrees to the anchor's invite
seatGridView.responseRemoteRequest("", true, null);

// Audience rejects the anchor's invite
seatGridView.responseRemoteRequest("", false, null);
// Audience agrees to the anchor's invite
seatGridView.responseRemoteRequest("", true, null);

// Audience rejects the anchor's invite
seatGridView.responseRemoteRequest("", false, null);
swift
import RTCRoomEngine
import LiveStreamCore

// Audience agrees to the anchor's invite
seatGridView.responseRemoteRequest("userId of anchor", true) {
} onError: { code, message in 
}

// Audience rejects the anchor's invite
seatGridView.responseRemoteRequest("userId of anchor", false, null) {
} onError: { code, message in 
}
Dart
import 'package:live_stream_core/live_stream_core.dart';

final controller = SeatGridController();

const String userId = 'userId of anchor';

// Audience accepts the anchor's invitation
final result = await controller.responseRemoteRequest(userId, true);

// Audience rejects the anchor's invitation
final result = await controller.responseRemoteRequest(userId, false);
Note:
If using a custom seat view, both anchors and the audience can refresh the seat UI by listening to the callback for seat information changes.

Leave the Seat Process

After the audience successfully becomes a speaker, they proactively become a listener again.

After Audience B becomes a speaker successfully, they can call leaveSeat to leave the mic voluntarily.
Android
iOS
Flutter
Kotlin
Java
seatGridView.leaveSeat()
seatGridView.leaveSeat();
swift
import RTCRoomEngine
import LiveStreamCore

seatGridView.leaveSeat() { 
} onError: { code, message in 
}
Dart
import 'package:live_stream_core/live_stream_core.dart';

final controller = SeatGridController();
final result = await controller.leaveSeat();

After the audience successfully joins the stage, the host kicks them off stage

After Audience B becomes a speaker successfully, Anchor A can kick Audience B off.
Android
iOS
Flutter
Kotlin
Java
val userId = "userIdB"
seatGridView.kickUserOffSeatByAdmin(userId, null)
String userId = "userIdB";
seatGridView.kickUserOffSeatByAdmin(userId, null);
swift
import RTCRoomEngine
import LiveStreamCore
 
let userId = "userIdB"
seatGridView.kickUserOffSeatByAdmin(userId) {
} onError: { code, message in 
}
Dart
import 'package:live_stream_core/live_stream_core.dart';

const String userId = "userIdB";
final controller = SeatGridController();
final result = await controller.kickUserOffSeatByAdmin();

Audience receives a callback when the host kicks them off stage

After Anchor A kicks Audience B off, Audience B will receive the onKickedOffSeat callback.
Android
iOS
Flutter
Kotlin
Java
override fun onKickedOffSeat(inviterUser: UserInfo) {
   Log.i(TAG, "Anchor kicked off the seat")
}
@Override
public void onKickedOffSeat(TUIRoomDefine.UserInfo userInfo) {
    Log.i(TAG, "Anchor kicked off the seat");
}
swift
import RTCRoomEngine
import LiveStreamCore

func onKickedOffSeat(userInfo: TUIUserInfo) {
    print("Anchor kicked off the seat")
}

Flutter
import 'package:live_stream_core/live_stream_core.dart';
import 'package:rtc_room_engine/rtc_room_engine.dart';

// Create a listening Observer instance
final controller = SeatGridController();
final exampleObserver = ExampleObserver(); 

// Add an observer
controller.addObserver(exampleObserver);

class ExampleObserver extends SeatGridWidgetObserver {  
    ExampleObserver() {   
       super.onKickedOffSeat = (userInfo) { 
         debugPrint('Anchor kicks off the mic');  
       };    
    }
}
Note:
If using a custom seat view, both anchors and the audience can refresh the seat UI by listening to the callback for seat information changes.

Lock Seat Process

Position Lock

The anchor can lock a specific seat, and it will be blocked, preventing any seat operations.
Android
iOS
Flutter
Kotlin
Java
val index = 1;
val isLockSeat = true
val params = TUIRoomDefine.SeatLockParams().apply {
   lockSeat = isLockSeat
}
seatGridView.lockSeat(index, params, null)
int index = 1;
bool isLockSeat = true;
TUIRoomDefine.SeatLockParams params = new TUIRoomDefine.SeatLockParams();
params.lockSeat = isLockSeat;
seatGridView.lockSeat(index, params, null);
swift
import RTCRoomEngine
import LiveStreamCore

let index = 1
let isLockSeat = true

let params = TUISeatLockParams()
params.lockSeat = isLockSeat

seatGridView.lockSeat(index: index, lockMode: params) {
} onError: { code, message in 
}
Dart
import 'package:live_stream_core/live_stream_core.dart';
import 'package:rtc_room_engine/rtc_room_engine.dart';

const int index = 1;
const bool isLockSeat = true
final params = TUISeatLockParams();
params.lockSeat = isLockSeat;
final controller = SeatGridController();
final result = await controller.lockSeat(index, params);

Audio Lock

The anchor can lock the audio for a specific seat position, and the user on that position will be muted.
Android
iOS
Flutter
Kotlin
Java
val index = 1;
bool isAudioLocked = true;
val params = TUIRoomDefine.SeatLockParams().apply {
   isAudioLocked = isLockSeat
}
seatGridView.lockSeat(index, params, null)
int index = 1;
bool isAudioLocked = true;
TUIRoomDefine.SeatLockParams params = new TUIRoomDefine.SeatLockParams();
params.lockAudio = seatInfo.isAudioLocked;
seatGridView.lockSeat(index, params, null);
swift
import RTCRoomEngine
import LiveStreamCore

let index = 1
let isAudioLocked = true

let params = TUISeatLockParams()
params.lockAudio = isAudioLocked

seatGridView.lockSeat(index: index, lockMode: params) {
} onError: { code, message in 
}
Dart
import 'package:live_stream_core/live_stream_core.dart';
import 'package:rtc_room_engine/rtc_room_engine.dart';

const int index = 1;
const bool isAudioLocked = true
final params = TUISeatLockParams();
params.lockAudio = isAudioLocked;
final controller = SeatGridController();
final result = await controller.lockSeat(index, params);
Note:
If using a custom seat view, both anchors and the audience can refresh the seat UI by listening to the callback for seat information changes.

Other seat management feature extensions

Android
iOS
Flutter
The seat management feature is implemented based on SeatGridView. If you need to extend the seat management feature, please refer to the SeatGridView documentation.
The seat management feature is implemented based on SeatGridView. If you need to extend the seat management feature, please refer to the SeatGridView documentation.
The seat management feature is implemented based on SeatGridView. If you need to extend the seat management feature, please refer to the SeatGridWidget documentation.
WebRTC Trtc Logo
Copyright © 2013-2025 Tencent RTC. All Rights Reserved.
  1. Privacy Policy
  3. Legal
  5. Cookie Policy
  7. Tencent Cloud