@tencentcloud/sdk-mcp 1.7.3 → 1.7.4

package/resource/knowledge/callkit/core-sdk/uni-app/make-call.md

@@ -145,26 +145,6 @@ const handleLogin = () => {
      };
    </script>
 
-   <style scoped>
-     .btn {
-       margin: 10px 20px;
-     }
-
-     .btn-img {
-       width: 60px;
-       height: 60px;
-       border-radius: 140px;
-     }
-
-     .btn-text {
-       font-size: 12px;
-       color: #d5e0f2;
-       font-weight: 400;
-       text-align: center;
-       margin-top: 10px;
-     }
-   </style>
-
    ```
 2. **添加麦克风开关按钮：**创建并添加麦克风开关按钮，在点击事件中调用 [openLocalMicrophone](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#openLocalMicrophone) 或 [closeLocalMicrophone](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#closeLocalMicrophone) 接口，并监听麦克风状态，实时更新按钮文本。
 
@@ -201,25 +181,6 @@ const handleLogin = () => {
      };
    </script>
 
-   <style scoped>
-     .btn {
-       margin: 10px 20px;
-     }
-
-     .btn-img {
-       width: 60px;
-       height: 60px;
-       border-radius: 140px;
-     }
-
-     .btn-text {
-       font-size: 12px;
-       color: #d5e0f2;
-       font-weight: 400;
-       text-align: center;
-       margin-top: 10px;
-     }
-   </style>
    ```
 3. **添加摄像头开关按钮：**创建并添加摄像头开关按钮，在点击事件中调用 [openLocalCamera](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#openLocalCamera) 或 [closeLocalCamera](https://liteav.sdk.qcloud.com/doc/product/tuikit/atomic-x/uni-app/zh/v1.0/api/index.html#closeLocalCamera) 接口，并监听摄像头的状态，实时更新按钮文本。
 
@@ -257,25 +218,6 @@ const handleLogin = () => {
      };
    </script>
 
-   <style>
-     .btn {
-       margin: 10px 20px;
-     }
-
-     .btn-img {
-       width: 60px;
-       height: 60px;
-       border-radius: 140px;
-     }
-
-     .btn-text {
-       font-size: 12px;
-       color: #d5e0f2;
-       font-weight: 400;
-       text-align: center;
-       margin-top: 10px;
-     }
-   </style>
    ```
 
 ### 步骤3：发起通话
@@ -450,12 +392,6 @@ const handleLogin = () => {
   });
 </script>
 
-<style>
-  .call-view-container {
-    background: rgba(15, 16, 20, 0.5);
-    overflow: hidden;
-  }
-</style>
 ```
 
 > **说明：**
@@ -534,12 +470,6 @@ const handleLogin = () => {
      });
    </script>
 
-   <style>
-     .call-view-container {
-       background: rgba(15, 16, 20, 0.5);
-       overflow: hidden;
-     }
-   </style>
    ```
 - `networkQualityIcons` **接口参数详细说明：**
 
@@ -673,12 +603,6 @@ const handleLogin = () => {
   });
 </script>
 
-<style>
-  .call-view-container {
-    background: rgba(15, 16, 20, 0.5);
-    overflow: hidden;
-  }
-</style>
 ```
 - `participantAvatars` **属性参数详细说明：**
 
@@ -737,12 +661,6 @@ const handleLogin = () => {
      });
    </script>
 
-   <style>
-     .call-view-container {
-       background: rgba(15, 16, 20, 0.5);
-       overflow: hidden;
-     }
-   </style>
    ```
 - `waitingAnimation` **接口参数详细说明：**
 
@@ -791,19 +709,6 @@ const handleLogin = () => {
   });
 </script>
 
-<style scoped>
-  .call-timer {
-    display: flex;
-    align-items: center;
-    justify-content: center;
-  }
-
-  .timer-text {
-    font-size: 28rpx;
-    color: #FFFFFF;
-    font-weight: 400;
-  }
-</style>
 ```
 
 ## 更多功能
@@ -892,13 +797,6 @@ const handleLogin = () => {
      });
    </script>
 
-   <style>
-     .call-view-container {
-       background: rgba(15, 16, 20, 0.5);
-       overflow: hidden;
-     }
-   </style>
-
    ```
 - `layoutTemplate` **属性参数详细说明：**
 

package/resource/knowledge/callkit/core-sdk/web/call-event.md

@@ -19,8 +19,8 @@ TUICallEvent API 是音视频通话组件的**事件接口**。
 |[TUICallEvent.USER_VOICE_VOLUME](https://cloud.tencent.com/document/product/647/78758#USER_VOICE_VOLUME)|所有用户音量大小的反馈事件。|
 |[TUICallEvent.ON_CALL_BEGIN](https://cloud.tencent.com/document/product/647/78758#ON_CALL_BEGIN)|通话接通的事件。|
 |[TUICallEvent.ON_CALL_RECEIVED](https://cloud.tencent.com/document/product/647/78758#ON_CALL_RECEIVED)|通话请求的事件。|
-|TUICallEvent.ON_CALL_NOT_CONNECTED|通话未建立的事件。|
-|TUICallEvent.ON_CALL_END|通话结束的事件。|
+|[TUICallEvent.ON_CALL_NOT_CONNECTED](#ON_CALL_NOT_CONNECTED)|通话未建立的事件。|
+|[TUICallEvent.ON_CALL_END](#ON_CALL_END)|通话结束的事件。|
 |[TUICallEvent.DEVICED_UPDATED](https://cloud.tencent.com/document/product/647/78758#DEVICED_UPDATED)|设备列表更新的事件。|
 |[TUICallEvent.ON_USER_NETWORK_QUALITY_CHANGED](https://cloud.tencent.com/document/product/647/78758#ON_USER_NETWORK_QUALITY_CHANGED)|所有用户网络质量的事件。|
 

package/resource/knowledge/callkit/faq/error-code.md

@@ -1,47 +1,73 @@
----
-product: 'Call'
-tech_stack: 'callKit'
-framework: 'common'
-title: 'callKit 错误码大全'
-keywords: ['错误码', '报错', 'callKit 使用报错', '通话呼叫失败']
----
+通知用户在使用音视频通话过程中出现的警告和错误。
 
-# CallKit 错误码大全
+## TUICallDefine 错误码
+| 定义 | 取值 | 描述 |
+| --- | --- | --- |
+| ERROR_PACKAGE_NOT_PURCHASED | -1001 | 您当前未购买音视频通话能力套餐，请前往 TRTC 控制台 <a href="https://cloud.tencent.com/document/product/647/104662#free">开通免费体验</a> 或 <a href="https://buy.cloud.tencent.com/trtc?tab=uikit&type=call&pkg=top">加购正式版</a>。 |
+| ERROR_PACKAGE_NOT_SUPPORTED | -1002 | 您当前购买的音视频通话能力套餐不支持该功能，建议您前往 TRTC 控制台 <a href="https://buy.cloud.tencent.com/trtc?tab=uikit&type=call&pkg=top">升级套餐类型</a>。 |
+| ERROR_TIM_VERSION_OUTDATED | -1003 | IM SDK 版本过低，请升级 <a href="https://www.npmjs.com/package/tim-js-sdk">IM SDK</a> 版本 ≥ 2.21.2（<strong>仅 web、小程序平台支持</strong>）。 |
+| ERROR_PERMISSION_DENIED | -1101 | 获取权限失败，当前未授权音/ 视频权限，请查看是否开启设备权限。 |
+| ERROR_INIT_FAIL | -1201 | 未调用 init，TUICallEngine API 使用需在 init 之后, 初始化失败。 |
+| ERROR_PARAM_INVALID | -1202 | 参数错误（参数格式、类型等错误）。 |
+| ERROR_REQUEST_REFUSED | -1203 | 当前状态不支持调用。例如：<br>需要在空闲状态才可使用的 API，在呼叫中/通话中时调用。 |
+| ERROR_REQUEST_REPEATED | -1204 | 当前方法正在执行中，请勿重复调用。 |
+| ERROR_SCENE_NOT_SUPPORTED | -1205 | 当前通话场景，不支持该功能。 |
+| ERROR_SIGNALING_SEND_FAIL | -1401 | 信令发送失败，具体失败原因可查看具体方法回调中的 errorMsg。 |
+| FAILURE_SWITCH_TO_AUDIO | 60001 | 视频切语音失败（<strong>仅 web 平台支持</strong>）。 |
+| FAILURE_SWITCH_TO_VIDEO | 60002 | 语音切视频失败（<strong>仅 web 平台支持</strong>）。 |
+| NOT_MICROPHONE_LIST | 60003 | 没有可用的麦克风设备（<strong>仅 web 平台支持</strong>）。 |
+| NOT_CAMERA_LIST | 60004 | 没有可用的摄像头设备（<strong>仅 web 平台支持</strong>）。 |
+| NOT_SUPPORT | 60005 | 当前页面不具备 webRTC 能力（<strong>仅 web 平台支持</strong>）。 |
+| MICROPHONE_NOT_READABLE | 60007 | 麦克风无法启动（<strong>被占用/硬件异常等，自 4.0.7 版本起，仅 web 平台支持</strong>）。 |
+| CAMERA_NOT_READABLE | 60008 | 摄像头无法启动（<strong>被占用/硬件异常等，自 4.0.7 版本起，仅 web 平台支持</strong>）。 |
+| DEVICE_START_ABORTED | 60009 | 设备采集被中途中止（<strong>自 4.0.7 版本起仅 web 平台支持</strong>）。 |
+| UNKNOWN | 65535 | 未知错误（<strong>仅 web、小程序平台支持</strong>）。 |
 
-## CallKit 错误码 (Topic: CallKit Error Code)
+## IM 错误码
 
-## 错误码 -1001
-**原因：** 您的应用还未开通音视频通话（TUICallKit）能力。
-**解决方案：** 您可以去控制台申请免费体验: https://console.cloud.tencent.com/im/detail 或购买通话能力套餐包：https://buy.cloud.tencent.com/avc?addRavLicense=1&position=1600110000&ravLicenseType=1&regionId=1
+音视频通话使用了腾讯云 IM SDK 作为通信的基础服务，例如通话拨打信令、通话忙线信令等核心逻辑。常见错误码如下：
 
-## 错误码 -1002
-**原因：** 您暂不支持使用该能力。
-**解决方案：** 请前往购买页购买开通: https://buy.cloud.tencent.com/avc?addRavLicense=1&position=1600110000&ravLicenseType=1&regionId=1
+|错误码|描述|
+|---------|---------|
+|6014|IM SDK 未登录，请先登录，成功回调之后重试，或者已被移下线，可使用 TIMManager getLoginUser 检查当前是否在线。|
+|6017|参数无效，请检查参数是否符合要求，具体可查看错误信息进一步定义哪个字段。|
+|6206|UserSig 过期，请重新获取有效的 UserSig 后再重新登录，获取方法请参见 [生成 UserSig](https://cloud.tencent.com/document/product/269/32688)。|
+|7013|套餐包不支持该接口的使用，请升级到旗舰版套餐。|
+|8010|信令请求 ID 无效或已经被处理过。|
+|8021|呼叫的用户还没有登录过 TIM，导致呼叫失败。|
 
-## 错误码 -1101
-**原因：** 摄像头/麦克风权限被拒绝。
-**解决方案：** 请检查浏览器设置，确保已允许使用您的摄像头和麦克风。如果您确认已授予权限， 请前往 [音视频能力检测工具] 检查您的设备和环境是否支持通话： https://web.sdk.qcloud.com/trtc/webrtc/demo/detect/index.html
+> **说明：**
+> 更多 IM SDK 错误码详见：[IM 错误码](https://cloud.tencent.com/document/product/269/1671)。
+>
 
-## 错误码 -1201
-**原因：** TUICallEngine 尚未完成初始化或登录。
-**解决方案：** 请确保在调用此功能前，已成功执行 init 或 login 操作。解决方案：https://cloud.tencent.com/document/product/647/78769#3a61f42b-e06f-49af-88bf-362d40025887
+## TRTC 错误码
 
-## 错误码 60003
-**原因：** 未检测到麦克风设备。
-**解决方案：** 请确保您的设备已连接麦克风，并检查系统或浏览器设置中麦克风是否可用。
+音视频通话使用了腾讯云 TRTC SDK 作为音频和视频的基础服务，例如开关摄像头、开关麦克风等核心逻辑。常见错误码如下（Web TRTC SDK 错误码详见：[TRTC 错误码](https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/module-ErrorCode.html)）：
 
-## 错误码 60004
-**原因：** 未检测到摄像头设备。
-**解决方案：** 请确保您的摄像头已连接，并检查系统或浏览器设置中摄像头是否可用。
+|枚举|取值|描述|
+|---------|---------|---------|
+|ERR_CAMERA_START_FAIL|-1301|打开摄像头失败，例如在 Windows 或 Mac 设备，摄像头的配置程序（驱动程序）异常，禁用后重新启用设备，或者重启机器，或者更新配置程序。|
+|ERR_CAMERA_NOT_AUTHORIZED|-1314|摄像头设备未授权，通常在移动设备出现，可能是权限被用户拒绝了。|
+|ERR_CAMERA_SET_PARAM_FAIL|-1315|摄像头参数设置出错（参数不支持或其它）。|
+|ERR_CAMERA_OCCUPY|-1316|摄像头正在被占用中，可尝试打开其他摄像头。|
+|ERR_MIC_START_FAIL|-1302|打开麦克风失败，例如在 Windows 或 Mac 设备，麦克风的配置程序（驱动程序）异常，禁用后重新启用设备，或者重启机器，或者更新配置程序。|
+|ERR_MIC_NOT_AUTHORIZED|-1317|麦克风设备未授权，通常在移动设备出现，可能是权限被用户拒绝了。|
+|ERR_MIC_SET_PARAM_FAIL|-1318|麦克风设置参数失败。|
+|ERR_MIC_OCCUPY|-1319|麦克风正在被占用中，例如移动设备正在通话时，打开麦克风会失败。|
+|ERR_TRTC_ENTER_ROOM_FAILED|-3301|进入房间失败，请查看 onError 中的 -3301 对应的 msg 提示确认失败原因。|
 
-## 错误码 60006
-**原因：** 当前浏览器环境不支持 WebRTC 功能。
-**解决方案：** 请前往 [音视频能力检测工具] 检查您的设备和环境兼容性：https://web.sdk.qcloud.com/trtc/webrtc/demo/detect/index.html
+> **说明：**
+> 更多 TRTC SDK 错误码详见：[TRTC 错误码](https://cloud.tencent.com/document/product/647/38307)。Web TRTC SDK 错误码详见：[TRTC 错误码](https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/module-ErrorCode.html)。
+>
 
-## 错误码 30000
-**原因：** 检测到当前页面正处于 http 协议下。
-**解决方案：** 为确保生产环境用户顺畅接入和体验 TUICallEngine SDK 的全部功能，请使用 https 协议(或 localhost)访问音视频应用页面。详情请前往：https://web.sdk.qcloud.com/trtc/webrtc/v5/doc/zh-cn/tutorial-05-info-browser.html#h2-3
+## Callkit 服务端错误码
 
-## 错误码 20007
-**原因：** 呼叫失败：您已被对方拉黑或您拉黑了对方。
-**解决方案：** 检查账号是否被对方拉黑。
+新版本 Callkit RestAPI 错误码，例如获取通话状态和通话记录。常见错误码如下：
+
+|错误码|描述|
+|---------|---------|
+|101001|服务器内部错误，请重试|
+|101002|参数无效，请检查参数是否符合要求，具体可查看错误信息进一步定义哪个字段。|
+|101004|通话不存在，或者曾经存在过，但是目前已经结束|
+|101050|通话记录不存在|
+|101011|您当前未购买音视频通话能力套餐，请前往 TRTC 控制台 [开通免费体验](https://cloud.tencent.com/document/product/647/104662#free) 或 [加购正式版](https://buy.cloud.tencent.com/trtc)。|

package/resource/knowledge/callkit/faq/uniapp-miniprogram.md

@@ -64,7 +64,7 @@ npm init -y && npm install xx
 
 ### 如何使用 `copy-webpack-plugin` 提升效率？
 
-上面 3. 如何构建 npm 中，需要在 **微信开发者工具** 的终端里创建`package.json`，然后安装依赖才行。通过`copy-webpack-plugin`可减少该步骤，并提升效率。
+上面 [3. 如何构建 npm](#e999cfb9-07ef-4a7c-b32c-acf55caaac6b) 中，需要在 **微信开发者工具** 的终端里创建`package.json`，然后安装依赖才行。通过`copy-webpack-plugin`可减少该步骤，并提升效率。
 以 [TUICallKit-Vue2 demo](https://github.com/tencentyun/TUICallKit/tree/main/uni-app/TUICallKit-Miniprogram/TUICallKit-Vue2) 举例，下图给出使用`copy-webpack-plugin`的前后对比：
 
 具体使用如下：

package/resource/knowledge/callkit/preset/android/api.md

@@ -6,16 +6,16 @@ TUICallKit API 是音视频通话组件的**含 UI 接口**，使用 TUICallKit
 
 |API|描述|
 |---------|---------|
-|createInstance|创建 TUICallKit 实例（单例模式）。|
-|setSelfInfo|设置用户的头像、昵称。|
-|calls|发起单人或多人通话。|
-|join|主动加入通话。|
-|setCallingBell|设置自定义来电铃声。|
-|enableMuteMode|开启/关闭静音模式。|
-|enableFloatWindow|开启/关闭悬浮窗功能。|
-|enableIncomingBanner|开启/关闭来电横幅显示。|
-|setScreenOrientation|设置通话界面显示方向。|
-|enableVirtualBackground|设置模糊背景。|
+|[createInstance](#createInstance)|创建 TUICallKit 实例（单例模式）。|
+|[setSelfInfo](#setSelfInfo)|设置用户的头像、昵称。|
+|[calls](#calls)|发起单人或多人通话。|
+|[join](#join)|主动加入通话。|
+|[setCallingBell](#setCallingBell)|设置自定义来电铃声。|
+|[enableMuteMode](#enableMuteMode)|开启/关闭静音模式。|
+|[enableFloatWindow](#enableFloatWindow)|开启/关闭悬浮窗功能。|
+|[enableIncomingBanner](#enableIncomingBanner)|开启/关闭来电横幅显示。|
+|[setScreenOrientation](#setScreenOrientation)|设置通话界面显示方向。|
+|[enableVirtualBackground](#enableVirtualBackground)|设置模糊背景。|
 
 ## API 详情