tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
实时音视频
    文档
    Download PDF

    麦位管理（TUILiveKit）

    最后更新时间：2024-12-19 17:59:26
    下载PDF

      功能介绍

      麦位管理是一种实时互动交流方式，主播可以麦位上的观众进行实时互动，无论是解答问题、分享经验还是进行娱乐互动，都能极大地提升观众的参与感和满意度。这种直接的互动和交流为商业化运营提供了更加便捷和高效的渠道，使用此功能，可以实现申请上麦，邀请上麦，移动麦位，踢人下麦，锁定麦位能功能，极大的丰富了语音聊天室的可玩性。
      麦位列表
      观众申请上麦
      主播处理上麦
      
      
      
      
      
      
      
      
      

      接入流程

      观众申请上麦流程

      TUILiveKit 观众申请上麦功能 主要是通过 SeatGridView 实现，您可以调用如下 API 函数，实现观众申请上麦功能。以观众 B 申请上麦为例实现如下。

      观众发送申请上麦请求

      观众 B 给主播 A 发送申请上麦请求，主播 A 会在 onSeatRequestReceived 回调中收到观众 B 的上麦请求。
      Android
      iOS
      Kotlin
      Java
      val seatIndex = 1; 
      val timeout = 60; 
      seatGridView.takeSeat(seatIndex, timeout, object : VoiceRoomDefine.RequestCallback {
          override fun onAccepted(userInfo: TUIRoomDefine.UserInfo) {
              Log.i(TAG, "申请上麦被同意")
          }
      
          override fun onRejected(userInfo: TUIRoomDefine.UserInfo) {
              Log.i(TAG, "申请上麦被拒绝")
          }
      
          override fun onCancelled(userInfo: TUIRoomDefine.UserInfo) {
              Log.i(TAG, "申请上麦被取消")
          }
      
          override fun onTimeout(userInfo: TUIRoomDefine.UserInfo) {
              Log.i(TAG, "申请上麦超时")
          }
      
          override fun onError(userInfo: TUIRoomDefine.UserInfo, error: TUICommonDefine.Error, message: String) {
              Log.i(TAG, "申请上麦错误")
          }
      })
      int seatIndex = 1; 
      int timeout = 60;
      seatGridView.takeSeat(seatIndex, timeout, new VoiceRoomDefine.RequestCallback() {
          @Override
          public void onAccepted(TUIRoomDefine.UserInfo userInfo) {
              Log.i(TAG, "申请上麦被同意");
          }
      
          @Override
          public void onRejected(TUIRoomDefine.UserInfo userInfo) {
              Log.i(TAG, "申请上麦被拒绝");
          }
      
          @Override
          public void onCancelled(TUIRoomDefine.UserInfo userInfo) {
              Log.i(TAG, "申请上麦被取消");
          }
      
          @Override
          public void onTimeout(TUIRoomDefine.UserInfo userInfo) {
              Log.i(TAG, "申请上麦超时");
          }
      
          @Override
          public void onError(TUIRoomDefine.UserInfo userInfo, TUICommonDefine.Error error, String message) {
              Log.i(TAG, "申请上麦错误");
          }
      });
      swift
      let seatIndex = 1
      let timeout = 60 
      seatGridView.takeSeat(index: index, timeout: timeout) { userInfo in
            print("申请上麦被同意")
          } onRejected: { userInfo in
            print("申请上麦被拒绝")
          } onCancelled: { userInfo in
            print("申请上麦被取消")
          } onTimeout: { userInfo in
            print("申请上麦超时")
          } onError: { userInfo, code, message in
            print("申请上麦错误")
          }
      TUILiveKit 观众申请上麦功能 主要是通过 SeatGridView 实现，您可以调用如下 API 函数，实现观众申请上麦功能。以观众 B 申请上麦为例实现如下。
      注意：
      只有当房间模式是 APPLY_TO_TAKE (申请上麦)，房主才会收到上麦请求，FREE_TO_TAKE (自由上麦) 模式下，takeSeat会直接上麦成功。

      主播端收到申请上麦请求

      主播 A 会在 onSeatRequestReceived 回调方法中收到 观众B 的上麦请求。
      Android
      iOS
      Kotlin
      Java
      override fun onSeatRequestReceived(type: VoiceRoomDefine.RequestType, userInfo: TUIRoomDefine.UserInfo) {
         if (type == VoiceRoomDefine.RequestType.APPLY_TO_TAKE_SEAT) {
            Log.i(TAG, "收到观众申请上麦请求：${userInfo.userId}")
         }
      }
      @Override
      public void onSeatRequestReceived(VoiceRoomDefine.RequestType type, TUIRoomDefine.UserInfo userInfo) {
          if (type == VoiceRoomDefine.RequestType.APPLY_TO_TAKE_SEAT) {
              Log.i(TAG, "收到观众上麦请求：" + userInfo.userId);
          }
      }
      swift
      func onSeatRequestReceived(type: SGRequestType, userInfo: TUIUserInfo) {
         if type == .applyToTakeSeat {
           print("收到观众申请上麦请求：\\(userInfo.userId)")
         }
      }
      注意：
      只有当房间模式是 APPLY_TO_TAKE (申请上麦)，房主才会收到上麦请求，FREE_TO_TAKE (自由上麦) 模式下，takeSeat会直接上麦成功。

      主播响应上麦请求

      主播 A 收到观众的上麦请求后，可以调用 responseRemoteRequest 响应观众 B 是否同意上麦， 观众 B 会收到主播 A 同意和拒绝（onAccepted/onRejected）的回调。
      Android
      iOS
      Kotlin
      Java
      // 主播同意观众上麦
      seatGridView.responseRemoteRequest(userId, true, null);
      
      // 主播拒绝观众上麦
      seatGridView.responseRemoteRequest(userId, false, null);
      // 主播同意观众上麦
      seatGridView.responseRemoteRequest(userId, true, null);
      
      // 主播拒绝观众上麦
      seatGridView.responseRemoteRequest(userId, false, null);
      swift
      // 主播同意观众上麦
      seatGridView.responseRemoteRequest(userId, true) {
      } onError: { code, message in 
      }
      
      // 主播拒绝观众上麦
      seatGridView.responseRemoteRequest(userId, false) {
      } onError: { code, message in 
      }

      麦位信息发生变化的回调

      Android
      iOS
      如果您已经设置过 自定义麦位视图, 可以监听 updateSeatView 回调来刷新自己的自定义 UI。
      Kotlin
      Java
      override fun updateSeatView(seatGridView: SeatGridView, seatInfo: TUIRoomDefine.SeatInfo, seatView: View) {
         Log.i(TAG, "麦位信息发生变化");
      }
      @Override
      public void void updateSeatView(SeatGridView seatGridView, TUIRoomDefine.SeatInfo seatInfo, View seatView) {
          Log.i(TAG, "麦位信息发生变化");
      }
      如果您已经设置过 自定义麦位视图, 可以监听updateSeatView回调来刷新自己的自定义 UI。
      swift
      func seatGridView(_ view: SeatGridView, updateSeatView seatInfo: TUISeatInfo, seatView: UIView) {
          print("麦位信息发生变化")
      }

      主播邀请观众上麦流程

      主播发送邀请上麦请求

      主播 A 给观众 C 发送邀请上麦请求，观众 C 会在 onSeatRequestReceived 回调中收到主播 A 的邀请上麦请求。
      Android
      iOS
      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, "邀请上麦被同意")
          }
      
          override fun onRejected(userInfo: TUIRoomDefine.UserInfo) {
              Log.i(TAG, "邀请上麦被拒绝")
          }
      
          override fun onCancelled(userInfo: TUIRoomDefine.UserInfo) {
              Log.i(TAG, "邀请上麦被取消")
          }
      
          override fun onTimeout(userInfo: TUIRoomDefine.UserInfo) {
              Log.i(TAG, "邀请上麦超时")
          }
      
          override fun onError(userInfo: TUIRoomDefine.UserInfo, error: TUICommonDefine.Error, message: String) {
              Log.i(TAG, "邀请上麦错误")
          }
      })
      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, "邀请上麦被同意");
          }
      
          @Override
          public void onRejected(TUIRoomDefine.UserInfo userInfo) {
              Log.i(TAG, "邀请上麦被拒绝");
          }
      
          @Override
          public void onCancelled(TUIRoomDefine.UserInfo userInfo) {
              Log.i(TAG, "邀请上麦被取消");
          }
      
          @Override
          public void onTimeout(TUIRoomDefine.UserInfo userInfo) {
              Log.i(TAG, "邀请上麦超时");
          }
      
          @Override
          public void onError(TUIRoomDefine.UserInfo userInfo, TUICommonDefine.Error error, String message) {
              Log.i(TAG, "邀请上麦错误");
          }
      });
      swift
      let seatIndex = 1
      let userId = "userIdC" 
      
      seatGridView.takeUserOnSeatByAdmin(index: seatIndex, timeout: timeout, userId: userId) { userInfo in
          print("邀请上麦被同意")
      } onRejected: { userInfo in
          print("邀请上麦被拒绝")
      } onCancelled: { userInfo in
          print("邀请上麦被取消")
      } onTimeout: { userInfo in
          print("邀请上麦超时")
      } onError: { userInfo, code, message in
          print("邀请上麦错误")
      }

      观众端收到邀请上麦请求

      观众 C 会在 onSeatRequestReceived 回调方法中收到 主播A 的邀请上麦请求。
      Android
      iOS
      Kotlin
      Java
      override fun onSeatRequestReceived(type: VoiceRoomDefine.RequestType, userInfo: TUIRoomDefine.UserInfo) {
         if (type == VoiceRoomDefine.RequestType.INVITE_TO_TAKE_SEAT) {
            Log.i(TAG, "收到主播邀请上麦请求：${userInfo.userId}")
         }
      }
      @Override
      public void onSeatRequestReceived(VoiceRoomDefine.RequestType type, TUIRoomDefine.UserInfo userInfo) {
          if (type == VoiceRoomDefine.RequestType.INVITE_TO_TAKE_SEAT) {
              Log.i(TAG, "收到主播邀请上麦请求：" + userInfo.userId);
          }
      }
      swift
      func onSeatRequestReceived(type: SGRequestType, userInfo: TUIUserInfo) {
         if type == .inviteToTakeSeat {
            print("收到主播邀请上麦请求：\\(userInfo.userId)")
         }
      }

      观众响应邀请上麦请求

      观众 C 收到观众的上麦请求后，可以调用 responseRemoteRequest 响应主播 A 是否同意上麦， 主播 A 会收到观众 C 同意和拒绝（onAccepted/onRejected）的回调。
      Android
      iOS
      Kotlin
      Java
      // 观众同意主播邀请
      seatGridView.responseRemoteRequest("", true, null);
      
      // 观众拒绝主播邀请
      seatGridView.responseRemoteRequest("", false, null);
      // 观众同意主播邀请
      seatGridView.responseRemoteRequest("", true, null);
      
      // 观众拒绝主播邀请
      seatGridView.responseRemoteRequest("", false, null);
      swift
      // 观众同意主播邀请
      seatGridView.responseRemoteRequest("userId of anchor", true) {
      } onError: { code, message in 
      }
      
      // 观众拒绝主播邀请
      seatGridView.responseRemoteRequest("userId of anchor", false, null) {
      } onError: { code, message in 
      }
      说明：
      如果自定义麦位视图，主播和观众都可以通过监听 麦位信息发生变化的回调 刷新麦位UI。

      下麦流程

      观众上麦成功后，主动下麦

      观众 B 上麦成功后，观众 B 主动下麦可以调用 leaveSeat。
      Android
      iOS
      Kotlin
      Java
      seatGridView.leaveSeat()
      seatGridView.leaveSeat();
      swift
      seatGridView.leaveSeat() { 
      } onError: { code, message in 
      }

      观众上麦成功后，主播踢观众下麦

      观众 B 上麦成功后，主播 A 踢观众 B 下麦。
      Android
      iOS
      Kotlin
      Java
      val userId = "userIdB"
      seatGridView.kickUserOffSeatByAdmin(userId, null)
      String userId = "userIdB";
      seatGridView.kickUserOffSeatByAdmin(userId, null);
      swift
       userId = "userIdB"
      seatGridView.kickUserOffSeatByAdmin(userId) {
      } onError: { code, message in 
      }

      观众收到被主播踢下麦的回调

      主播 A 踢观众 B 下麦后，观众 B 会收到 onKickedOffSeat 回调。
      Android
      iOS
      Kotlin
      Java
      override fun onKickedOffSeat(inviterUser: UserInfo) {
         Log.i(TAG, "主播踢下麦")
      }
      @Override
      public void onKickedOffSeat(TUIRoomDefine.UserInfo userInfo) {
          Log.i(TAG, "主播踢下麦");
      }
      swift
      func onKickedOffSeat(userInfo: TUIUserInfo) {
          print("主播踢下麦")
      }
      
      说明：
      如果自定义麦位视图，主播和观众都可以通过监听 麦位信息发生变化的回调 刷新麦位UI。

      锁麦流程

      位置锁定

      主播可将某个麦位进行锁定，此麦位就会被封禁，此麦位就无法进行上下麦操作。
      Android
      iOS
      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
      let index = 1
      let isLockSeat = true
      
      let params = TUISeatLockParams()
      params.lockSeat = isLockSeat
      
      seatGridView.lockSeat(index: index, lockMode: params) {
      } onError: { code, message in 
      }

      音频锁定

      主播可将某个麦位进行音频锁定，此麦位上的用户就会被静音。
      Android
      iOS
      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
      let index = 1
      let isAudioLocked = true
      
      let params = TUISeatLockParams()
      params.lockAudio = isAudioLocked
      
      seatGridView.lockSeat(index: index, lockMode: params) {
      } onError: { code, message in 
      }
      说明：
      如果自定义麦位视图，主播和观众都可以通过监听 麦位信息发生变化的回调 刷新麦位UI。

      其它麦位管理功能扩展

      麦位管理功能是基于 SeatGridView 实现，若您需要扩展麦位管理功能，可参见 SeatGridView 文档。
      
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2025 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款