@tencentcloud/sdk-mcp 1.3.8 → 1.4.0

package/resource/doc/livekit/live/vue/workflow.md

@@ -1,219 +0,0 @@
-# Web Live TUIKit 代码生成工作流指令 (Vue) 
-
-**【指令目的】**: 为 Agent 提供实现 Vue Web Live TUIKit 核心功能的 **代码生成蓝图**，并指导 Agent **优先使用工具实时获取的最新文档内容**。
-
-**💡 特别提醒：**
-1. **当用户需求包含【直播列表】、【开播页】和【观看页】时，Agent 必须在生成的代码中增加一个**【主播和观众身份入口选择】**的页面或逻辑，以便用户使用不同的 UserID 进行测试**。
-2. **当用户需要实现申请上麦相关功能时需要调用** `get_web_live_state_detail` **来获取 liveKit 客户端 API 实现相关功能**。
-
----
-
-## 📦 UIKit 版本与依赖说明
-
-### 推荐版本
-```json
-{
-  "tuikit-atomicx-vue3": "latest",
-  "@tencentcloud/uikit-base-component-vue3": "latest",
-}
-```
-
-### 自动依赖安装流程
-Agent 在生成代码后，**必须自动执行**以下步骤：
-
-1. **检测依赖完整性**：检查 `package.json` 是否包含所有必需依赖
-2. **自动安装依赖**：执行 `npm install` 或 `pnpm install`
-3. **验证安装**：确认依赖安装成功后再提示用户运行项目
-
-### esbuild 问题解决方案
-在 `package.josn` 中增加以下内容，`resolutions` 兼容 `yarn`，`overrides` 兼容 `npm` 和 `pnpm`
-```json
-{
- "resolutions": {
-    "esbuild": "npm:esbuild-wasm@latest"
-  },
-   "overrides": {
-    "esbuild": "npm:esbuild-wasm@latest"
-  }
-}
-```
----
-
-## 🔐 测试凭证自动生成
-
-### UserSig 自动获取工作流
-
-在生成代码前，Agent **必须**：
-
-1. **调用 `get_usersig` MCP 工具**自动生成测试账号信息
-2. **生成测试 UserID**：
- - 主播 UserID: 格式为 live001 或 host001
- - 观众 UserID: 格式为 user001 或 viewer001
-3. **嵌入代码**：将生成的 SDKAppID、userID（主播和观众）、userSig 直接写入代码中的配置区域
-4. **安全提示**：在代码注释中明确标注这是测试凭证，生产环境必须后端生成
-
----
-
-## ⚙️ 代码生成核心工作流 (LLM 行动指南)
-
-Agent，本工具已为您**实时获取**了用户所需功能（Goals）对应的最新文档内容，并将其内容附在了**本指令下方**（在 `llm_code_generation_instructions_md` 字段中）。
-
-### 严格执行步骤：
-
-#### 步骤 0: 前置准备（自动化）
-```
-a. 调用 get_usersig 工具生成测试凭证
-   - 主播 userID: 使用 `live001` 格式
-   - 观众 userID: 使用 `user001` 格式
-   
-b. 检查并准备项目环境
-   - 验证 package.json 中的依赖版本
-   - 如缺少依赖，自动添加到 dependencies
-   
-c. 执行依赖安装
-   - 运行 npm install 或 pnpm install
-   - 等待安装完成并检查是否有错误
-```
-
-#### 步骤 1: 选择功能模块
-根据用户提出的具体功能需求，从以下功能块中选择对应的指令。
-
-#### 步骤 2: 使用实时文档
-**必须优先且唯一**使用本工具返回结果中**提供的实时文档内容**（而非自行访问 URL）来生成 Vue 代码片段。
-
----
-
-## 🎯 功能实现指令
-
-### 1. 实现直播列表页 (`liveList`)
-
-**目标组件**: `liveList`
-
-**代码生成指令**:
-- 生成 Vue 组件结构，引入 `liveList`
-- **自动注入测试凭证**：在组件初始化时使用自动生成的**观众** `SDKAppID`、`userID`、`userSig`
-- **核心逻辑**: 参考本工具返回结果中实时获取的文档内容，提取最新的 API 调用和示例代码
-
-**依赖组件**: `liveList`
-
-**生成后操作**:
-```bash
-# Agent 自动执行
-npm install  # 安装依赖
-npm run dev  # 启动开发服务器
-```
-
----
-
-### 2. 实现 PC 直播观看页 (`livePlayer` & `barrage`)
-
-**目标组件**: `livePlayer`, `barrage`
-
-**代码生成指令**:
-- 根据实时文档的示例代码生成观看页
-- **自动注入测试凭证**：在播放器初始化时配置**观众**测试账号
-- **核心逻辑**: 参考本工具返回结果中实时获取的文档内容，必须按照文档的步骤集成 `livePlayer` 和 `barrage`（弹幕），并展示如何监听视频流状态
-- **交互优化**: 添加加载状态、错误处理、重连机制
-
-**依赖组件**: `livePlayer`, `barrage`
-
----
-
-### 3. 实现 H5 直播观看页 (`livePlayer` & `barrage`)
-
-**目标组件**: `livePlayer`, `barrage`
-
-**代码生成指令**:
-- 根据实时文档的示例代码生成观看页
-- **自动注入测试凭证**：在播放器初始化时配置**观众**测试账号
-- **核心逻辑**: 参考本工具返回结果中实时获取的文档内容，必须按照文档的步骤集成 `livePlayer` 和 `barrage`（弹幕），并展示如何监听视频流状态
-- **交互优化**: 添加加载状态、错误处理、重连机制
-
-**依赖组件**: `livePlayer`, `barrage`
-
----
-
-### 4. 实现直播开播页 (`livePusher`)
-
-**目标组件**: `livePusher`
-
-**代码生成指令**:
-- 根据实时文档的示例代码生成开播页
-- **自动注入测试凭证**：在推流器初始化时配置**主播**测试账号
-- **核心逻辑**: 参考本工具返回结果中实时获取的文档内容，必须包含 Vue 逻辑来处理摄像头和麦克风的**权限请求和开关控制**
-- **设备检测**: 自动检测可用的摄像头和麦克风设备
-- **错误处理**: 处理权限拒绝、设备不可用等异常情况
-
-**依赖组件**: `livePusher`
-
----
-
-### 5. 实现直播连麦功能 (`CoGuestPanel`)
-
-**目标组件**: `CoGuestPanel`
-
-**代码生成指令**:
-- 根据实时文档的示例代码生成连麦相关的复杂组件或逻辑模块
-- **自动注入测试凭证**：为主播和连麦观众分别配置测试账号
-- **核心逻辑**: 参考本工具返回结果中实时获取的文档内容，代码应展示如何使用 `CoGuestPanel` 管理连麦申请，并协调推流/播放器的逻辑切换
-- **状态管理**: 处理连麦邀请、接受、拒绝、断开等状态流转
-- **多人连麦**: 支持多人同时连麦的场景
-
-**依赖组件**: `CoGuestPanel`, `livePusher`, `livePlayer`
-```
-
----
-
-## 🔄 完整自动化流程总结
-
-```mermaid
-graph TD
-    A[接收用户需求] --> B[调用 get_web_live_uikit_integration 获取最新文档]
-    B --> C[检查 package.json 依赖]
-    C --> D[自动添加缺失依赖]
-    D --> E[执行 npm install]
-    E --> F[根据实时文档生成代码]
-    F --> G[调用 get_usersig 生成测试凭证]
-    G --> H[注入测试凭证到代码]
-    H --> I[添加安全注释和提示]
-    I --> J[启动开发服务器]
-    J --> K[输出测试信息给用户]
-```
-
----
-
-## 📋 Agent 检查清单
-
-在完成代码生成后，Agent 必须确认：
-
-- [x] 已调用 `get_usersig` 生成测试凭证
-- [x] 已将凭证嵌入代码配置区域
-- [x] 已在代码中添加安全警告注释
-- [x] 已检查 `package.json` 依赖完整性
-- [x] 已自动执行 `npm install`
-- [x] 已验证依赖安装成功
-- [x] 已使用实时文档内容（非外部 URL）
-- [x] 已添加错误处理和日志输出
-- [x] 已为用户提供测试账号信息
-- [x] 已提示用户运行 `npm run dev`
-
----
-
-## 🚨 安全提醒（必须包含在生成的代码注释中）
-
-```javascript
-/**
- * ⚠️ 重要安全提示
- * 
- * 1. 当前使用的 userSig 是通过开发工具自动生成的测试凭证
- * 2. userSig 有效期为 7 天，过期后需要重新生成
- * 3. ❌ 生产环境严禁在前端生成 userSig
- * 4. ✅ 正式上线前，必须在后端服务生成 userSig
- * 5. 参考文档: https://cloud.tencent.com/document/product/647/17275
- * 
- * SDKAppID 和 secretKey 获取位置：
- * - IM 应用: https://console.cloud.tencent.com/im
- * - TRTC 应用: https://console.cloud.tencent.com/trtc
- */
-```
-

package/resource/doc/native_live/android/V2TXLiveCode_api_android.md

@@ -1,334 +0,0 @@
-# 腾讯云直播SDK V2TXLiveCode 错误码文档
-
-## 概述
-
-`V2TXLiveCode.java` 是腾讯云直播SDK Android平台的错误码和警告码定义文件，包含了推流器、播放器、混流、录制等功能的错误码分类和详细说明。
-
-**文件路径**: `com/tencent/live2/V2TXLiveCode.java`  
-**平台支持**: Android  
-**错误码总数**: 20个核心错误码和警告码
-
-## 📋 目录结构
-
-### 1. [错误码分类](#错误码分类)
-### 2. [通用错误码](#通用错误码)
-### 3. [网络相关警告码](#网络相关警告码)
-### 4. [摄像头相关警告码](#摄像头相关警告码)
-### 5. [麦克风相关警告码](#麦克风相关警告码)
-### 6. [屏幕分享相关警告码](#屏幕分享相关警告码)
-### 7. [编解码相关警告码](#编解码相关警告码)
-### 8. [错误码使用指南](#错误码使用指南)
-### 9. [错误处理最佳实践](#错误处理最佳实践)
-
-## 1. 错误码分类
-
-### 🎯 错误码统计
-
-| 类别 | 错误码数量 | 主要功能 |
-|------|----------|----------|
-| 通用错误码 | 9个 | API调用、参数验证、权限检查等 |
-| 网络相关警告码 | 2个 | 网络状况、视频卡顿监控 |
-| 摄像头相关警告码 | 3个 | 摄像头设备状态监控 |
-| 麦克风相关警告码 | 3个 | 麦克风设备状态监控 |
-| 屏幕分享相关警告码 | 3个 | 屏幕分享功能状态监控 |
-| 编解码相关警告码 | 2个 | 音视频编解码器状态监控 |
-
-### 🔧 技术特点
-
-- **层次化分类**: 按功能模块进行错误码分组
-- **详细描述**: 每个错误码都有明确的说明和使用场景
-- **平台适配**: 针对Android平台的特定错误码
-- **调试友好**: 提供错误码的详细解释和处理建议
-
-## 2. 通用错误码
-
-### ✅ V2TXLIVE_OK - 操作成功
-
-```java
-public static final int V2TXLIVE_OK = 0;
-```
-
-**含义**: 没有错误，操作成功完成
-
-**使用场景**:
-- API调用成功返回
-- 操作执行成功确认
-- 状态检查正常
-
-
-### ❌ V2TXLIVE_ERROR_FAILED - 通用错误
-
-```java
-public static final int V2TXLIVE_ERROR_FAILED = -1;
-```
-
-**含义**: 暂未归类的通用错误
-
-**触发场景**:
-- 内部处理异常
-
-
-### ❌ V2TXLIVE_ERROR_INVALID_PARAMETER - 参数不合法
-
-```java
-public static final int V2TXLIVE_ERROR_INVALID_PARAMETER = -2;
-```
-
-**含义**: 调用API时传入的参数不合法
-
-**常见场景**:
-- 推流地址格式错误
-- 设置的参数不支持
-
-
-### ❌ V2TXLIVE_ERROR_REFUSED - API调用被拒绝
-
-```java
-public static final int V2TXLIVE_ERROR_REFUSED = -3;
-```
-
-**含义**: API调用被拒绝
-
-**触发场景**:
-- 调用时机不正确
-
-
-### ❌ V2TXLIVE_ERROR_NOT_SUPPORTED - API不支持
-
-```java
-public static final int V2TXLIVE_ERROR_NOT_SUPPORTED = -4;
-```
-
-**含义**: 当前API不支持调用
-
-**常见场景**:
-- 平台不支持的功能
-- SDK版本过低
-- 硬件不支持的特性
-
-
-### ❌ V2TXLIVE_ERROR_INVALID_LICENSE - License无效
-
-```java
-public static final int V2TXLIVE_ERROR_INVALID_LICENSE = -5;
-```
-
-**含义**: License不合法，调用失败
-
-**触发场景**:
-- License文件未设置
-- License已过期
-- License与包名不匹配
-
-
-### ❌ V2TXLIVE_ERROR_REQUEST_TIMEOUT - 请求超时
-
-```java
-public static final int V2TXLIVE_ERROR_REQUEST_TIMEOUT = -6;
-```
-
-**含义**: 请求服务器超时
-
-**常见场景**:
-- 网络连接不稳定
-- 服务器响应缓慢
-
-
-### ❌ V2TXLIVE_ERROR_SERVER_PROCESS_FAILED - 服务器处理失败
-
-```java
-public static final int V2TXLIVE_ERROR_SERVER_PROCESS_FAILED = -7;
-```
-
-**含义**: 服务器无法处理您的请求
-
-**触发场景**:
-- 服务器内部错误
-- 请求格式不正确
-- 服务器资源不足
-
-
-### ❌ V2TXLIVE_ERROR_DISCONNECTED - 连接断开
-
-```java
-public static final int V2TXLIVE_ERROR_DISCONNECTED = -8;
-```
-
-**含义**: 网络连接断开
-
-**常见场景**:
-- 推流网络断开
-- 拉流网络断开
-
-
-### ❌ V2TXLIVE_ERROR_NO_AVAILABLE_HEVC_DECODERS - 无可用HEVC解码器
-
-```java
-public static final int V2TXLIVE_ERROR_NO_AVAILABLE_HEVC_DECODERS = -2304;
-```
-
-**含义**: 找不到可用的HEVC解码器
-
-**触发场景**:
-- 设备不支持HEVC硬解
-- HEVC解码器初始化失败
-- 系统版本过低
-
-
-## 3. 网络相关警告码
-
-### ⚠️ V2TXLIVE_WARNING_NETWORK_BUSY - 网络繁忙
-
-```java
-public static final int V2TXLIVE_WARNING_NETWORK_BUSY = 1101;
-```
-
-**含义**: 网络状况不佳，上行带宽太小，上传数据受阻
-
-**监控指标**:
-- 上行带宽限制
-- 网络延迟增加
-- 数据包丢失率升高
-
-
-### ⚠️ V2TXLIVE_WARNING_VIDEO_BLOCK - 视频卡顿
-
-```java
-public static final int V2TXLIVE_WARNING_VIDEO_BLOCK = 2105;
-```
-
-**含义**: 当前视频播放出现卡顿
-
-**卡顿原因分析**:
-- 网络带宽不足
-- 解码性能瓶颈
-- 渲染性能问题
-
-
-## 4. 摄像头相关警告码
-
-### ⚠️ V2TXLIVE_WARNING_CAMERA_START_FAILED - 摄像头打开失败
-
-```java
-public static final int V2TXLIVE_WARNING_CAMERA_START_FAILED = -1301;
-```
-
-**含义**: 摄像头打开失败
-
-**失败原因**:
-- 硬件故障
-- 驱动问题
-- 资源冲突
-
-
-### ⚠️ V2TXLIVE_WARNING_CAMERA_OCCUPIED - 摄像头被占用
-
-```java
-public static final int V2TXLIVE_WARNING_CAMERA_OCCUPIED = -1316;
-```
-
-**含义**: 摄像头正在被占用中
-
-**占用场景**:
-- 其他应用正在使用摄像头
-- 系统相机应用运行中
-- 视频通话进行中
-
-
-### ⚠️ V2TXLIVE_WARNING_CAMERA_NO_PERMISSION - 摄像头未授权
-
-```java
-public static final int V2TXLIVE_WARNING_CAMERA_NO_PERMISSION = -1314;
-```
-
-**含义**: 摄像头设备未授权，通常在移动设备出现，可能是权限被用户拒绝了
-
-
-## 5. 麦克风相关警告码
-
-### ⚠️ V2TXLIVE_WARNING_MICROPHONE_START_FAILED - 麦克风打开失败
-
-```java
-public static final int V2TXLIVE_WARNING_MICROPHONE_START_FAILED = -1302;
-```
-
-**含义**: 麦克风打开失败
-
-**故障原因**:
-- 硬件连接问题
-- 系统音频设置异常
-- 音频会话初始化失败
-
-
-### ⚠️ V2TXLIVE_WARNING_MICROPHONE_OCCUPIED - 麦克风被占用
-
-```java
-public static final int V2TXLIVE_WARNING_MICROPHONE_OCCUPIED = -1319;
-```
-
-**含义**: 麦克风正在被占用中，例如移动设备正在通话时，打开麦克风会失败
-
-**占用场景**:
-- 设备正在通话中
-- 其他音频应用占用麦克风
-- 音频会话冲突
-
-
-### ⚠️ V2TXLIVE_WARNING_MICROPHONE_NO_PERMISSION - 麦克风未授权
-
-```java
-public static final int V2TXLIVE_WARNING_MICROPHONE_NO_PERMISSION = -1317;
-```
-
-**含义**: 麦克风设备未授权，通常在移动设备出现，可能是权限被用户拒绝了
-
-
-## 6. 屏幕分享相关警告码
-
-### ⚠️ V2TXLIVE_WARNING_SCREEN_CAPTURE_NOT_SUPPORTED - 系统不支持屏幕分享
-
-```java
-public static final int V2TXLIVE_WARNING_SCREEN_CAPTURE_NOT_SUPPORTED = -1309;
-```
-
-**含义**: 当前系统不支持屏幕分享
-
-
-### ⚠️ V2TXLIVE_WARNING_SCREEN_CAPTURE_START_FAILED - 开始录屏失败
-
-```java
-public static final int V2TXLIVE_WARNING_SCREEN_CAPTURE_START_FAILED = -1308;
-```
-
-**含义**: 开始录屏失败，如果在移动设备出现，可能是权限被用户拒绝了
-
-
-### ⚠️ V2TXLIVE_WARNING_SCREEN_CAPTURE_INTERRUPTED - 录屏被系统中断
-
-```java
-public static final int V2TXLIVE_WARNING_SCREEN_CAPTURE_INTERRUPTED = -7001;
-```
-
-**含义**: 录屏被系统中断
-
-
-## 7. 编解码相关警告码
-
-### ⚠️ V2TXLIVE_WARNING_CURRENT_ENCODE_TYPE_CHANGED - 编码器改变更
-
-```java
-public static final int V2TXLIVE_WARNING_CURRENT_ENCODE_TYPE_CHANGED = 1104;
-```
-
-**含义**: 表示编码器发生改变，可以通过onWarning函数的扩展信息中的codec_type字段来获取当前的编码格式
-
-
-### ⚠️ V2TXLIVE_WARNING_CURRENT_DECODE_TYPE_CHANGED - 解码器变更
-
-```java
-public static final int V2TXLIVE_WARNING_CURRENT_DECODE_TYPE_CHANGED = 2008;
-```
-
-**含义**: 表示解码器发生改变，可以通过onWarning函数的扩展信息中的codec_type字段来获取当前的解码格式
-
-**注意**: Windows端不支持此错误码的扩展信息