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

package/resource/doc/chatkit/vue/components/component-list.md

@@ -1,89 +0,0 @@
-# atomicx 组件库清单与组件的适用场景与注意事项
-
-## 组件清单
-
-共 25 个组件:
-
-### 适用于聊天场景的组件
-
-1. ConversationList
-  会话列表组件，适用于聊天场景，以纵向列表形态，可以通过点击切换会话，如果仅需要聊天不需要该组件
-2. ChatHeader
-  聊天头部组件，是聊天界面的顶部导航组件，用于显示当前会话的基本信息。能够展示会话标题、头像、在线状态、输入状态提示等信息。组件采用容器组件模式，提供了灵活的插槽机制用于自定义左右两侧的操作区域。
-3. MessageInput
-  消息输入组件，聊天场景的核心组件，可以发送聊天消息，需要发送消息则必须使用该组件
-4. MessageList
-  消息列表组件，聊天场景的核心组件，可以显示聊天消息列表，支持消息的上下滑动，聊天场景必须使用该组件
-5. ContactList
-  联系人列表组件，适用于聊天场景，可以显示和管理用户联系人，如果仅需要聊天不需要该组件
-6. ChatSetting
-  聊天设置组件，适用于聊天场景，管理聊天相关配置，比如置顶、免打扰，群聊加人、踢人、管理员管理、禁言等，如果仅需要聊天不需要该组件
-7. Search
-  搜索组件，用于搜索消息、用户等内容，如果仅需要聊天不需要该组件
-
-### 适用于会议场景的组件
-
-1. CameraButton
-  摄像头控制按钮，仅适用于会议场景，用于开启/关闭摄像头
-2. StreamView
-  视频流显示组件，仅适用于会议场景，用于显示视频流
-3. UserList
-  用户列表组件，仅适用于会议场景，显示会议或房间中的用户
-4. VideoSetting
-  视频设置组件，仅适用于会议场景，用于摄像头、画质等视频配置
-5. VideoSettingPanel
-  视频设置面板，仅适用于会议场景，提供完整的视频配置界面
-6. AudioSetting
-  音频设置组件，仅适用于会议场景，可以设置麦克风、音量等音频设备配置
-7. AudioSettingPanel
-  音频设置面板，仅适用于会议场景，提供完整的音频配置界面
-8. BarrageInput
-  弹幕输入组件，适用于会议、直播场景，用于发送直播弹幕消息
-9. BarrageList
-  弹幕列表组件，适用于会议、直播场景，显示直播间的弹幕消息
-10. UserPicker
-  用户选择器，适用于会议、直播场景，用于邀请用户或分配权限
-11. MicButton
-  麦克风控制按钮，适用于会议、直播场景，用于静音/取消静音
-
-### 适用于直播场景的组件
-
-1. CoGuestPanel
-  连麦嘉宾管理面板，仅适用于直播场景，用于直播连麦功能
-2. LiveAudienceList
-  直播观众列表，仅适用于直播场景，显示当前直播间的观众
-3. LiveList
-  直播房间列表，仅适用于直播场景，展示可用的直播房间
-4. LiveMonitorView
-  直播监控视图，仅适用于直播场景，用于直播管理和监控
-5. LiveScenePanel
-  直播场景控制面板，仅适用于直播场景，管理直播场景和效果
-6. LiveStreamView
-  直播视频流显示组件，仅适用于直播场景，播放直播画面
-7. StreamMixer
-  流混合器组件，仅适用于直播场景，用于多路视频流合成
-8. BarrageInput
-  弹幕输入组件，适用于会议、直播场景，用于发送直播弹幕消息
-9. BarrageList
-  弹幕列表组件，适用于会议、直播场景，显示直播间的弹幕消息
-10. UserPicker
-  用户选择器，适用于会议、直播场景，用于邀请用户或分配权限
-11. MicButton
-  麦克风控制按钮，适用于会议、直播场景，用于静音/取消静音
-
-### 通用组件
-
-1. Avatar
-  通用头像组件，显示用户头像/在线状态/消息未读数
-2. UserPicker
-  用户选择器，用于发起群聊、发起群视频、群语音等选择用户的场景
-
-## 注意事项
-
-在开始集成任何组件到真实项目之前，**必须**首先确保已经调用以下工具获取到了集成文档，并根据文档进行集成：
-
-1. 当创建真实的项目时，请调用 MCP Tools get_atomicx_integration_guide(framework) 的组件集成文档
-2. 当选择使用的组件时，应先考虑满足需求的最少组件，再考虑推荐可额外使用的扩展组件，不要放大需求
-3. 不同场景适用的组件有交集
-4. 根据用户需求，判断有没有可能是一个综合场景，比如聊天 + 直播，概率较低，应该谨慎
-5. 如需了解具体组件的使用方法，请询问用户："你可以问 ${componentname} 怎么用？" 这样的问题

package/resource/doc/chatkit/vue/components/tuikit.md

@@ -1,45 +0,0 @@
-## TUIKit 介绍
-
-TUIKit 是基于腾讯云 IM SDK 的一款 UI 组件库，它提供了一些通用的 UI 组件，包含会话、聊天、关系链、群组、音视频通话等功能。
-基于 UI 组件您可以像搭积木一样快速搭建起自己的业务逻辑。
-TUIKit 中的组件在实现 UI 功能的同时，会调用 IM SDK 相应的接口实现 IM 相关逻辑和数据的处理，因而开发者在使用 TUIKit 时只需关注自身业务或个性化扩展即可。
-
-## TUIKit 主要功能介绍
-
-TUIKit 主要分为 Chat、ConversationList、 ChatSetting 、ContactList、Search 几个 UI 子组件，每个 UI 组件负责展示不同的内容。
-TUIKit Web 端界面效果如下图所示：
-
-## Chat 重点功能介绍
-
-TUIChat 主要负责消息界面的展示。您可以利用它直接发送不同类型的消息，支持文字/表情/图片/视频/文件/自定义等消息类型，同时您还可以利用它对消息长按进行转发/撤回/引用、查询消息已读回执详情等。TUIChat Web 端界面效果如下图所示：
-| 消息界面 | 消息引用/撤回/转发 |
-| --- | --- |
-|  |  |
-
-| 消息快捷操作 | 消息已读回执 |
-| --- | --- |
-|  |  |
-
-## ConversationList 重点功能介绍
-
-ConversationList 主要负责会话列表的展示和编辑，包括会话置顶、会话消息免打扰、会话删除等功能。TUIConversation Web 端界面效果如下图所示：
-| 会话菜单 | 在线状态 |
-| --- | --- |
-|  |  |
-
-## Search 重点功能介绍
-
-| 全局搜索 | 会话内搜索 |
-| --- | --- |
-| 通过全局搜索，搜索所有包含“你好”的相关文本 | 搜索指定会话内所有文件消息 |
-
-## ChatSetting 重点功能介绍
-
-ChatSetting 主要负责群资料、群成员、群组权限的管理。TUIGroup Web 端界面效果如下图所示：
-| 群资料及管理 | 群成员管理 |
-| --- | --- |
-|  |  |
-
-## ContactList 重点功能介绍
-
-TUIContact 主要负责联系人的展示、权限设置等。TUIContact Web 端界面效果如下图所示：

package/resource/doc/chatkit/vue/components/userpicker.md

@@ -1,256 +0,0 @@
-## 概述
-
-UserPicker 是一个功能强大的用户选择器组件，支持列表和树形两种显示模式。组件提供了搜索、多选、懒加载、自定义渲染等功能，适用于用户选择、组织架构选择、权限分配等业务场景。组件内置了选择状态管理、搜索过滤、树形展开等复杂逻辑，提供了简洁易用的 API 接口。
-
-## Props 速查表
-
-| 字段                   | 类型                                           | 默认值                        | 描述          |
-| -------------------- | -------------------------------------------- | -------------------------- | ----------- |
-| displayMode          | `'list' \| 'tree'`                           | 必填                         | 显示模式，列表或树形  |
-| dataSource           | `UserPickerDataSource<T>`                    | `[]`                       | 数据源         |
-| defaultSelectedItems | `Array<{ key: string; [key: string]: any }>` | `[]`                       | 默认选中项       |
-| lockedItems          | `Array<{ key: string; [key: string]: any }>` | `[]`                       | 锁定项（不可取消选择） |
-| maxCount             | `number`                                     | `Number.POSITIVE_INFINITY` | 最大选择数量      |
-| minCount             | `number`                                     | `0`                        | 最小选择数量      |
-| enableSearch         | `boolean`                                    | `true`                     | 是否启用搜索功能    |
-| searchPlaceholder    | `string`                                     | `undefined`                | 搜索框占位符      |
-| renderItem           | `Function`                                   | `undefined`                | 自定义渲染函数     |
-| onSelectedChange     | `Function`                                   | `undefined`                | 选择变化回调      |
-| onMaxCountExceed     | `Function`                                   | `undefined`                | 超出最大数量回调    |
-| onSearch             | `Function`                                   | `undefined`                | 搜索回调        |
-| onReachEnd           | `Function`                                   | `undefined`                | 列表模式滚动到底部回调 |
-| onExpand             | `Function`                                   | `undefined`                | 树形模式展开回调    |
-
-## Ref expose 方法速查表
-
-|方法名	| 参数	| 返回值 | 描述 |
-| -------- | ---- | ---- | ---- |
-| getSelectedItems |	无	| UserPickerResult<T>	| 获取当前选中的项目 |
-| updateTreeData |	nodeKey: string, partialNode: Partial<UserPickerNode<T>> | void	| 更新树形模式节点数据
-
-## Props 详细介绍
-
-### displayMode
-
-- `类型`: `'list' | 'tree'`
-- `描述`：组件的显示模式。`list` 模式显示平铺列表，`tree` 模式显示树形结构，支持层级展开和懒加载。
-
-### dataSource
-
-- `类型`: `UserPickerDataSource<T>`
-- `描述`：组件的数据源，根据 displayMode 的不同接受不同的数据结构，默认值为 `[]`。
-
-```typescript
-// 列表模式数据结构
-interface UserPickerRow<T = unknown> {
-  key: string;           // 唯一标识符
-  label: string;         // 显示名称
-  avatarUrl?: string;    // 头像URL
-  extraData?: T;         // 扩展数据
-}
-
-// 树形模式数据结构
-interface UserPickerNode<T = unknown> {
-  key: string;                        // 唯一标识符
-  label: string;                      // 显示名称
-  isLeafNode: boolean;                // 是否为叶子节点
-  avatarUrl?: string;                 // 头像URL
-  lazyLoad?: boolean;                 // 是否支持懒加载
-  children?: Array<UserPickerNode<T>>; // 子节点
-  extraData?: T;                      // 扩展数据
-}
-
-export type UserPickerDataSource<T = unknown> = Array<UserPickerRow<T>> | Array<UserPickerNode<T>>;
-```
-
-#### Example 1: 列表模式数据源
-
-```vue
-<template>
-  <UserPicker
-    display-mode="list"
-    :data-source="listData"
-    @selected-change="handleSelectionChange"
-  />
-</template>
-
-<script setup lang="ts">
-import { ref } from 'vue';
-import { UserPicker } from 'tuikit-atomicx-vue3';
-import type { UserPickerRow } from 'tuikit-atomicx-vue3/types';
-
-// 用户列表数据
-const listData = ref<UserPickerRow[]>([
-  {
-    key: 'user1',
-    label: '张三',
-    avatarUrl: 'https://example.com/avatar1.jpg',
-    extraData: { department: '技术部', role: '前端工程师' }
-  },
-  {
-    key: 'user2',
-    label: '李四',
-    avatarUrl: 'https://example.com/avatar2.jpg',
-    extraData: { department: '产品部', role: '产品经理' }
-  }
-]);
-
-const handleSelectionChange = (selectedItems: any[]) => {
-  console.log('选中的用户:', selectedItems);
-};
-</script>
-```
-
-### defaultSelectedItems
-
-- `类型`: `Array<{ key: string; [key: string]: any }>`
-- `描述`：默认选中的项目列表，通过 key 字段标识选中项，默认值为 `[]`。
-
-### lockedItems
-
-- `类型`: `Array<{ key: string; [key: string]: any }>`
-- `描述`：锁定的项目列表，这些项目将被强制选中且用户无法取消选择，默认值为 `[]`。
-
-### maxCount
-
-- `类型`: `number`
-- `描述`：允许选择的最大数量限制，超出时会触发 onMaxCountExceed 回调，默认值为 `Number.POSITIVE_INFINITY`。
-
-### minCount
-
-- `类型`: `number`
-- `描述`：要求选择的最小数量，用于表单验证等场景，默认值为 `0`。
-
-### enableSearch
-
-- `类型`: `boolean`
-- `描述`：是否启用搜索功能，启用后会显示搜索框，默认值为 `true`。
-
-### searchPlaceholder
-
-- `类型`: `string`
-- `描述`：搜索框的占位符文本，如果不设置则使用默认的国际化文本，默认值为 `undefined`。
-
-### renderItem
-
-- `类型`: `(data: UserPickerRow<T> | UserPickerNode<T>) => any`
-- `描述`：自定义项目渲染函数，可以自定义每个选项的显示内容和样式，默认值为 `undefined`。
-
-```typescript
-type RenderItemFunction<T> = (data: UserPickerRow<T> | UserPickerNode<T>) => VNode | string;
-```
-
-#### Example: 自定义渲染函数
-
-```vue
-<template>
-  <UserPicker
-    display-mode="list"
-    :data-source="userData"
-    :render-item="customRenderItem"
-  />
-</template>
-
-<script setup lang="ts">
-import { h } from 'vue';
-import { UserPicker } from 'tuikit-atomicx-vue3';
-import type { UserPickerRow } from 'tuikit-atomicx-vue3/types';
-
-const userData = ref<UserPickerRow[]>([
-  {
-    key: 'user1',
-    label: '张三',
-    extraData: { status: 'online', department: '技术部' }
-  }
-]);
-
-// 自定义渲染函数，显示用户状态和部门信息
-const customRenderItem = (data: UserPickerRow) => {
-  return h('div', { class: 'custom-user-item' }, [
-    h('div', { class: 'user-name' }, data.label),
-    h('div', { class: 'user-info' }, [
-      h('span', {
-        class: `status ${data.extraData?.status}`
-      }, data.extraData?.status === 'online' ? '在线' : '离线'),
-      h('span', { class: 'department' }, data.extraData?.department)
-    ])
-  ]);
-};
-</script>
-```
-
-### onSelectedChange
-
-- `类型`: `(selectedItems: UserPickerResult<T>) => void`
-- `描述`：选择状态变化时的回调函数，会传入当前选中的所有项目，默认值为 `undefined`。应该尽量减少使用避免频繁的触发回调函数。
-
-```typescript
-interface UserPickerResultItem<T = unknown> {
-  key: string;
-  label: string;
-  avatarUrl?: string;
-  isLeafNode?: boolean;    // 仅树形模式有意义
-  extraData?: T;
-  path?: string[];         // 仅树形模式有意义，记录节点路径
-}
-
-type UserPickerResult<T = unknown> = Array<UserPickerResultItem<T>>;
-```
-
-### onMaxCountExceed
-
-- `类型`: `(selectedItems: UserPickerResult<T>) => void`
-- `描述`：当选择数量超出 maxCount 限制时触发的回调函数，默认值为 `undefined`。
-
-### onSearch
-
-- `类型`: `(value: string) => void`
-- `描述`：搜索输入变化时的回调函数，可用于实现服务端搜索，默认值为 `undefined`。
-
-### onReachEnd
-
-- `类型`: `() => void`
-- `描述`：列表模式下滚动到底部时的回调函数，常用于实现分页加载，默认值为 `undefined`。
-
-### onExpand
-
-- `类型`: `(node: UserPickerNode<T>) => void`
-- `描述`：树形模式下节点展开时的回调函数，用于实现懒加载子节点，默认值为 `undefined`。
-
-## Ref Expose 方法详细介绍
-
-### getSelectedItems
-
-- `类型`：`() => UserPickerResult<T>`
-- `描述`：作为选择完成后确认时的最佳实践。
-
-```typescript
-interface UserPickerResultItem<T = unknown> {
-  key: string;
-  label: string;
-  avatarUrl?: string;
-  isLeafNode?: boolean;    // 仅树形模式有意义
-  extraData?: T;
-  path?: string[];         // 仅树形模式有意义，记录节点路径
-}
-
-type UserPickerResult<T = unknown> = Array<UserPickerResultItem<T>>;
-```
-
-#### Example: 选择完成后确认时获取选中的项
-
-```vue
-<template>
-  <UserPicker
-    ref="userPickerRef"
-    display-mode="list"
-    :data-source="userData"
-  />
-</template>
-
-<script setup lang="ts">
-const userPickerRef = useRef();
-
-function onConfirm() {
-  userPickerRef.value.getSelectedItems();
-}

package/resource/doc/chatkit/vue/faq.md

@@ -1,35 +0,0 @@
----
-product: 'Chat'
-tech_stack: 'web_js_sdk'
-framework: 'vue'
-title: 'vue uikit 集成和常见问题解决方案'
-keywords: ['vue', '初始化', '组件', '集成', 'TUIKit']
----
-
-# Vue TUIKit 集成与常见问题解决方案
-
-## 模块一：环境准备与快速初始化 (Topic: Setup)
-
-### Q: 如何在 Vue 项目中安装 TUIKit？
-
-**A:** TUIKit 是基于 Web SDK 开发的，您需要安装 `@tencentcloud/chat-uikit-vue3`。
-
-```bash
-# 安装 TUIKit Vue 版本
-npm install @tencentcloud/chat-uikit-vue3@latest
-```
-
-## 模块二：常见问题解决方案 (Topic: Question)
-
-### Q: 我能不能在 TUIKit 中使用第三方组件库，例如 Element-Plus？
-
-**A:** 核心组件之间的粘连代码可以使用其他组件库，这一点在示例代码中也可以看到，例如您可以将 <ChatSetting /> 封装成全屏抽屉组件。但是核心组件内部已经存在的组件暂时不支持修改。
-```typescript
-const isChatSettingShow = ref(false);
-<el-drawer
-  v-model="isChatSettingShow"
-  title="设置"
->
-  <ChatSetting />
-</el-drawer>
-```

package/resource/doc/livekit/core-sdk/live/android/api-reference/BarrageStore.md

@@ -1,148 +0,0 @@
-## 简介
-
-**BarrageStore** 提供了一套完整的弹幕管理 API，包括发送文本弹幕、发送自定义弹幕和添加本地提示消息。
-通过该类，可以在直播间内实现弹幕互动功能。
-
-> **重要：**
->
-
-> 使用 **BarrageStore.create** 工厂方法创建 **BarrageStore** 实例，需要传入有效的直播间 ID。
->
-
-> **说明：**
->
-
-> 弹幕状态更新通过 **barrageState** 发布者传递。订阅它以接收房间内弹幕数据的实时更新。
->
-
-## 功能特性
-- **文本弹幕**：支持发送纯文本弹幕消息。
-
-- **自定义弹幕**：支持发送自定义格式的弹幕（如带特效的弹幕）。
-
-- **本地提示**：支持添加仅本地可见的提示消息。
-
-## 可订阅数据
-
-**BarrageState** 的字段描述如下：
-| **属性名** | **类型** | **描述** |
-| --- | --- | --- |
-| messageList | StateFlow<List<Barrage>> | 当前房间的弹幕消息列表，支持实时更新并可被订阅监听。 |
-
-## API 列表
-| **函数名** | **描述** |
-| --- | --- |
-| BarrageStore.create | 创建弹幕管理实例。 |
-| sendTextMessage | 发送文本弹幕。 |
-| sendCustomMessage | 发送自定义弹幕。 |
-| appendLocalTip | 添加本地提示消息。 |
-
-### 创建实例
-
-#### BarrageStore.create
-
-创建弹幕管理实例。
-
-### 发送弹幕
-
-#### sendTextMessage
-
-发送文本类型弹幕。
-``` kotlin
-abstract fun sendTextMessage(
-        text: String?,
-        extensionInfo: Map<String, String>?,
-        completion: CompletionHandler?
-    )
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| text | String? | 必填 | 文本弹幕内容。 |
-| extensionInfo | Map<String,String>? | 必填 | 扩展信息，可包含自定义字段（如指定弹幕颜色、字体大小等）。 |
-| completion | CompletionHandler? | 必填 | 完成回调（成功/失败状态）。 |
-
-#### sendCustomMessage
-
-发送自定义类型弹幕。
-``` kotlin
-abstract fun sendCustomMessage(
-        businessID: String?,
-        data: String?,
-        completion: CompletionHandler?
-    )
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| businessID | String? | 必填 | 业务标识ID，用于区分不同业务场景的自定义弹幕。 |
-| data | String? | 必填 | 自定义数据内容，通常为JSON格式字符串，用于传递业务自定义的数据。 |
-| completion | CompletionHandler? | 必填 | 完成回调（成功/失败状态）。 |
-
-### 本地消息
-
-#### appendLocalTip
-
-添加本地提示消息（在本地添加提示或操作反馈消息，仅当前客户端可见）。
-``` kotlin
-abstract fun appendLocalTip(message: Barrage)
-```
-
-**版本信息**
-
-从 3.5 版本开始支持。
-
-**注意事项**
-
-> **说明：**
->
-
-> 该消息仅在本地显示，不会通过网络发送给其他用户。
->
-
-**参数说明**
-| **参数名** | **类型** | **是否必填** | **描述** |
-| --- | --- | --- | --- |
-| message | Barrage | 必填 | 本地弹幕消息（如系统提示、操作反馈等，仅当前用户可见）。 |
-
-## 数据结构
-
-### BarrageType
-
-弹幕类型枚举，用于区分不同的弹幕消息种类。
-| **枚举值** | **值** | **说明** |
-| --- | --- | --- |
-| TEXT | 0 | 文本类型弹幕，包含纯文字内容。 |
-| CUSTOM | 1 | 自定义类型弹幕，支持业务自定义数据格式（如带特效的弹幕、互动消息等）。 |
-
-### Barrage
-
-弹幕数据模型，包含单条弹幕的完整属性信息。
-| **属性** | **类型** | **说明** |
-| --- | --- | --- |
-| liveID | String | 弹幕所属直播间/语音聊天房的唯一标识ID。 |
-| sender | LiveUserInfo | 弹幕发送者的用户信息（如用户ID、昵称、头像等）。 |
-| sequence | Long | 弹幕消息的唯一序列ID，用于消息排序和去重。 |
-| timestampInSecond | Long | 弹幕发送时间戳（单位：秒），用于展示发送时间顺序。 |
-| messageType | BarrageType | 弹幕消息类型（文本或自定义）。 |
-| textContent | String | 文本类型弹幕的消息内容，即弹幕的文本内容。 |
-| extensionInfo | Map<String,String> | 弹幕扩展信息，可自定义字段（如显示样式、优先级等）。当 messageType 为 TEXT 时有效。 |
-| businessID | String | 自定义类型弹幕的业务标识ID，用于区分不同业务场景的自定义弹幕。 |
-| data | String | 自定义类型弹幕的具体数据内容（通常为JSON格式字符串），当 messageType 为 CUSTOM 时有效。 |
-
-### BarrageState
-
-弹幕状态，管理当前房间的弹幕数据状态。
-| **属性** | **类型** | **说明** |
-| --- | --- | --- |
-| messageList | StateFlow<List<Barrage>> | 当前房间的弹幕消息列表，支持实时更新并可被订阅监听。 |