@tencentcloud/sdk-mcp 1.4.7 → 1.6.0-beta.1

package/resource/doc/livekit/core-sdk/live/flutter/api-reference/LiveAudienceStore.md

@@ -1,231 +0,0 @@
-## 简介
-
-**LiveAudienceStore** 提供了一套完整的观众管理 API，包括获取观众列表、设置管理员、踢出用户、禁言等功能。
-通过该类，可以在直播间内实现观众管理功能。
-
-> **重要：**
->
-
-> 使用 **LiveAudienceStore.create** 工厂方法创建 **LiveAudienceStore** 实例，需要传入有效的直播间 ID。
->
-
-> **说明：**
->
-
-> 观众状态更新通过 **liveAudienceState** 发布者传递。订阅它以接收房间内观众数据的实时更新。
->
-
-## 功能特性
-- **观众列表**：获取和管理当前房间的观众列表。
-
-- **权限管理**：设置和撤销管理员权限。
-
-- **用户管理**：踢出用户、禁言等操作。
-
-- **事件监听**：监听观众加入、离开等事件。
-
-## 可订阅数据
-
-**LiveAudienceState** 的字段描述如下：
-| **属性名** | **类型** | **描述** |
-| --- | --- | --- |
-| audienceList | ValueListenable<List<LiveUserInfo>> | 观众列表。 |
-| audienceCount | ValueListenable<int> | 观众数量。 |
-| messageBannedUserList | ValueListenable<List<LiveUserInfo>> | 消息被禁言的用户列表。 |
-
-## API 列表
-| **函数名** | **描述** |
-| --- | --- |
-| LiveAudienceStore.create | 创建观众管理实例。 |
-| addLiveAudienceListener | 观众事件回调。 |
-| removeLiveAudienceListener | 观众事件回调。 |
-| fetchAudienceList | 获取观众列表。 |
-| setAdministrator | 设置管理员。 |
-| revokeAdministrator | 撤销管理员。 |
-| kickUserOutOfRoom | 踢出用户。 |
-| disableSendMessage | 禁言/解禁用户。 |
-
-### 创建实例
-
-#### LiveAudienceStore.create
-
-创建观众管理实例。
-
-### 观察状态和事件
-
-#### addLiveAudienceListener
-
-添加观众事件监听器
-``` dart
-void addLiveAudienceListener(LiveAudienceListener listener);
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| listener | LiveAudienceListener | 必填 | 监听器。 |
-
-#### removeLiveAudienceListener
-
-移除观众事件监听器
-``` dart
-void removeLiveAudienceListener(LiveAudienceListener listener);
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| listener | LiveAudienceListener | 必填 | 监听器。 |
-
-### 观众管理
-
-#### fetchAudienceList
-
-获取观众列表
-``` dart
-Future<CompletionHandler> fetchAudienceList();
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-#### setAdministrator
-
-设置管理员
-``` dart
-Future<CompletionHandler> setAdministrator(String userID);
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| userID | String | 必填 | 要设置为管理员的用户ID。 |
-
-#### revokeAdministrator
-
-撤销管理员
-``` dart
-Future<CompletionHandler> revokeAdministrator(String userID);
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| userID | String | 必填 | 要撤销管理员权限的用户ID。 |
-
-#### kickUserOutOfRoom
-
-将用户踢出房间
-``` dart
-Future<CompletionHandler> kickUserOutOfRoom(String userID);
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| userID | String | 必填 | 要踢出的用户ID。 |
-
-#### disableSendMessage
-
-禁用/解禁用户发送消息
-``` dart
-Future<CompletionHandler> disableSendMessage({
-  required String userID,
-  required bool isDisable,
-});
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| userID | String | 必填 | 目标用户ID。 |
-| isDisable | bool | 必填 | true 表示禁用发送消息，false 表示解禁。 |
-
-## 数据结构
-
-### Role
-
-用户角色。
-| **枚举值** | **说明** |
-| --- | --- |
-| owner | 房主。 |
-| admin | 管理员。 |
-| generalUser | 普通用户。 |
-
-### LiveUserInfo
-
-直播用户信息。
-| **属性** | **类型** | **说明** |
-| --- | --- | --- |
-| userID | String | 用户唯一标识ID。 |
-| userName | String | 用户名称。 |
-| avatarURL | String | 用户头像URL。 |
-
-### LiveAudienceState
-
-直播观众状态。
-| **属性** | **类型** | **说明** |
-| --- | --- | --- |
-| audienceList | ValueListenable<List<LiveUserInfo>> | 观众列表。 |
-| audienceCount | ValueListenable<int> | 观众数量。 |
-| messageBannedUserList | ValueListenable<List<LiveUserInfo>> | 消息被禁言的用户列表。 |
-
-### LiveAudienceListener
-
-直播观众事件。
-
-此监听器用于接收直播间内的观众动态事件。
-
-**方法**
-
-**onAudienceJoined**: 观众加入事件。
-``` dart
-void Function(LiveUserInfo audience)? onAudienceJoined;
-```
-| **参数名** | **类型** | **说明** |
-| --- | --- | --- |
-| audience | LiveUserInfo | 加入的观众信息。 |
-
-**onAudienceLeft**: 观众离开事件。
-``` dart
-void Function(LiveUserInfo audience)? onAudienceLeft;
-```
-| **参数名** | **类型** | **说明** |
-| --- | --- | --- |
-| audience | LiveUserInfo | 离开的观众信息。 |
-
-**onAudienceMessageDisabled**: 观众被禁止发言事件。
-``` dart
-void Function(LiveUserInfo audience, bool isDisable)? onAudienceMessageDisabled;
-
-LiveAudienceListener({this.onAudienceJoined, this.onAudienceLeft, this.onAudienceMessageDisabled});
-```
-| **参数名** | **类型** | **说明** |
-| --- | --- | --- |
-| audience | LiveUserInfo | 观众信息。 |
-| isDisable | bool | 是否被禁止发言。 |

package/resource/doc/livekit/core-sdk/live/flutter/api-reference/LiveSeatStore.md

@@ -1,375 +0,0 @@
-## 简介
-
-**LiveSeatStore** 提供了一套完整的麦位管理 API，包括上麦、下麦、锁麦、解锁麦位、踢用户下麦、远程控制设备等功能。
-通过该类，可以在直播间内实现麦位管理功能。
-
-> **重要：**
->
-
-> 使用 **LiveSeatStore.create** 工厂方法创建 **LiveSeatStore** 实例，需要传入有效的直播间 ID。
->
-
-> **说明：**
->
-
-> 麦位状态更新通过 **liveSeatState** 发布者传递。订阅它以接收房间内麦位数据的实时更新。
->
-
-## 功能特性
-- **麦位管理**：上麦、下麦、锁麦、解锁麦位等操作。
-
-- **用户管理**：踢用户下麦、移动用户到指定麦位。
-
-- **设备控制**：远程控制用户的摄像头和麦克风。
-
-- **事件监听**：监听麦位相关事件。
-
-## 可订阅数据
-
-**LiveSeatState** 的字段描述如下：
-| **属性名** | **类型** | **描述** |
-| --- | --- | --- |
-| seatList | ValueListenable<List<SeatInfo>> | 麦位列表。 |
-| canvas | ValueListenable<LiveCanvas> | 画布信息。 |
-| speakingUsers | ValueListenable<Map<String,int>> | 正在说话的用户。 |
-| avStatistics | ValueListenable<List<AVStatistics>> | 音视频相关统计信息。 |
-
-## API 列表
-| **函数名** | **描述** |
-| --- | --- |
-| LiveSeatStore.create | 创建麦位管理实例。 |
-| addLiveSeatEventListener | 麦位事件回调。 |
-| removeLiveSeatEventListener | 麦位事件回调。 |
-| takeSeat | 上麦。 |
-| leaveSeat | 下麦。 |
-| lockSeat | 锁麦。 |
-| unlockSeat | 解锁麦位。 |
-| kickUserOutOfSeat | 踢用户下麦。 |
-| moveUserToSeat | 移动用户。 |
-| openRemoteCamera | 开启远程摄像头。 |
-| closeRemoteCamera | 关闭远程摄像头。 |
-| openRemoteMicrophone | 开启远程麦克风。 |
-| closeRemoteMicrophone | 关闭远程麦克风。 |
-
-### 创建实例
-
-#### LiveSeatStore.create
-
-创建麦位管理实例。
-
-### 观察状态和事件
-
-#### addLiveSeatEventListener
-
-添加麦位事件监听器
-``` dart
-void addLiveSeatEventListener(LiveSeatListener listener);
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| listener | LiveSeatListener | 必填 | 监听器。 |
-
-#### removeLiveSeatEventListener
-
-移除麦位事件监听器
-``` dart
-void removeLiveSeatEventListener(LiveSeatListener listener);
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| listener | LiveSeatListener | 必填 | 监听器。 |
-
-### 麦位操作
-
-#### takeSeat
-
-上麦
-``` dart
-Future<CompletionHandler> takeSeat(int seatIndex);
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| seatIndex | int | 必填 | 麦位索引。 |
-
-#### leaveSeat
-
-下麦
-``` dart
-Future<CompletionHandler> leaveSeat();
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-#### lockSeat
-
-锁定麦位
-``` dart
-Future<CompletionHandler> lockSeat(int seatIndex);
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| seatIndex | int | 必填 | 麦位索引。 |
-
-#### unlockSeat
-
-解锁麦位
-``` dart
-Future<CompletionHandler> unlockSeat(int seatIndex);
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| seatIndex | int | 必填 | 麦位索引。 |
-
-### 用户管理
-
-#### kickUserOutOfSeat
-
-踢用户下麦
-``` dart
-Future<CompletionHandler> kickUserOutOfSeat(String userID);
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| userID | String | 必填 | 用户 ID。 |
-
-#### moveUserToSeat
-
-移动用户到麦位
-``` dart
-Future<CompletionHandler> moveUserToSeat({
-  required String userID,
-  required int targetIndex,
-  MoveSeatPolicy policy = MoveSeatPolicy.abortWhenOccupied,
-});
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| userID | String | 必填 | 用户 ID。 |
-| targetIndex | int | 必填 | 目标麦位索引。 |
-| policy | MoveSeatPolicy | 必填 | 移动策略。 |
-
-### 远程设备控制
-
-#### openRemoteCamera
-
-开启远程摄像头
-``` dart
-Future<CompletionHandler> openRemoteCamera({
-  required String userID,
-  required DeviceControlPolicy policy,
-});
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| userID | String | 必填 | 用户 ID。 |
-| policy | DeviceControlPolicy | 必填 | 设备控制策略。 |
-
-#### closeRemoteCamera
-
-关闭远程摄像头
-``` dart
-Future<CompletionHandler> closeRemoteCamera(String userID);
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| userID | String | 必填 | 用户 ID。 |
-
-#### openRemoteMicrophone
-
-开启远程麦克风
-``` dart
-Future<CompletionHandler> openRemoteMicrophone({
-  required String userID,
-  required DeviceControlPolicy policy,
-});
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| userID | String | 必填 | 用户 ID。 |
-| policy | DeviceControlPolicy | 必填 | 设备控制策略。 |
-
-#### closeRemoteMicrophone
-
-关闭远程麦克风
-``` dart
-Future<CompletionHandler> closeRemoteMicrophone(String userID);
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| userID | String | 必填 | 用户 ID。 |
-
-## 数据结构
-
-### MoveSeatPolicy
-
-移动麦位策略。
-| **枚举值** | **说明** |
-| --- | --- |
-| abortWhenOccupied | 被占用时中止。 |
-| forceReplace | 强制替换。 |
-| swapPosition | 交换位置。 |
-
-### DeviceControlPolicy
-
-设备控制策略。
-| **枚举值** | **说明** |
-| --- | --- |
-| unlockOnly | 仅解锁。 |
-
-### SuspendStatus
-
-用户的挂起状态。
-| **枚举值** | **说明** |
-| --- | --- |
-| none | 未挂起。 |
-| inBackground | 用户进入后台挂起。 |
-| inCalling | 用户正在接听电话。 |
-
-### LiveSeatListener
-
-麦位相关的回调事件。
-
-**方法**
-| **方法名** | **说明** |
-| --- | --- |
-| onLocalCameraOpenedByAdmin | 当本地摄像头被管理员开启时触发此回调。 |
-| onLocalCameraClosedByAdmin | 当本地摄像头被管理员关闭时触发此回调。 |
-| onLocalMicrophoneOpenedByAdmin | 当本地麦克风被管理员开启时触发此回调。 |
-| onLocalMicrophoneClosedByAdmin | 当本地麦克风被管理员关闭时触发此回调。 |
-
-### SeatUserInfo
-
-麦位用户信息。
-| **属性** | **类型** | **说明** |
-| --- | --- | --- |
-| userID | String | 用户 ID。 |
-| userName | String | 用户名。 |
-| avatarURL | String | 头像URL。 |
-| role | Role | 用户角色。 |
-| liveID | String | 直播间ID。 |
-| microphoneStatus | DeviceStatus | 麦克风状态。 |
-| allowOpenMicrophone | bool | 是否允许开启麦克风。 |
-| cameraStatus | DeviceStatus | 摄像头状态。 |
-| allowOpenCamera | bool | 是否允许开启摄像头。 |
-| userSuspendStatus | SuspendStatus | 用户挂起状态。 |
-
-### RegionInfo
-
-麦位视图坐标信息。
-| **属性** | **类型** | **说明** |
-| --- | --- | --- |
-| x | int | X坐标。 |
-| y | int | Y坐标。 |
-| w | int | 宽度。 |
-| h | int | 高度。 |
-| zorder | int | 层级顺序。 |
-
-### AVStatistics
-
-音视频相关统计信息。
-| **属性** | **类型** | **说明** |
-| --- | --- | --- |
-| userID | String | 用户 ID。 |
-| videoBitrate | int | 本地视频的码率。 |
-| videoWidth | int | 本地视频的宽度。 |
-| videoHeight | int | 本地视频的高度。 |
-| frameRate | int | 本地视频的帧率。 |
-| audioSampleRate | int | 音频的采样率。 |
-| audioBitrate | int | 音频码率。 |
-
-### SeatInfo
-
-麦位信息。
-| **属性** | **类型** | **说明** |
-| --- | --- | --- |
-| index | int | 麦位索引。 |
-| isLocked | bool | 是否锁定。 |
-| userInfo | SeatUserInfo | 用户信息。 |
-| region | RegionInfo | 区域信息。 |
-
-### LiveCanvas
-
-直播画布。
-| **属性** | **类型** | **说明** |
-| --- | --- | --- |
-| w | int | 宽度。 |
-| h | int | 高度。 |
-| templateID | int | 模板ID。 |
-
-### LiveSeatState
-
-LiveSeatStore 对外提供的麦位状态数据。
-| **属性** | **类型** | **说明** |
-| --- | --- | --- |
-| seatList | ValueListenable<List<SeatInfo>> | 麦位列表。 |
-| canvas | ValueListenable<LiveCanvas> | 画布信息。 |
-| speakingUsers | ValueListenable<Map<String,int>> | 正在说话的用户。 |
-| avStatistics | ValueListenable<List<AVStatistics>> | 音视频相关统计信息。 |