@tencentcloud/sdk-mcp 1.7.2 → 1.7.3

package/resource/knowledge/roomkit/preset/uniapp-app/integration.md

@@ -0,0 +1,581 @@
+TUIRoomKit 是腾讯云提供的一站式多人视频会议解决方案，集成了完整的 UI 组件和核心功能。通过本文档，开发者可以快速了解如何将 TUIRoomKit 集成到项目中，实现多人视频会议功能。本文还将详细介绍如何快速接入 UI 项目，替换图片资源，自定义样式，帮助开发者打造符合品牌特色的音视频应用。
+
+<style>
+.vsdk-survey-card * {
+  box-sizing: border-box;
+}
+
+.vsdk-survey-card {
+  position: relative;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 20px;
+  padding: 18px 22px;
+  margin: 16px 0;
+  border-radius: 14px;
+  overflow: hidden;
+  background: linear-gradient(180deg, #FFFFFF 0%, #F8FBFF 100%);
+  border: 1px solid #D7E8FF;
+  box-shadow: 0 4px 16px rgba(0,110,255,.05);
+  transition: all .25s ease;
+}
+
+.vsdk-survey-card::before{
+  content:"";
+  position:absolute;
+  right:-60px;
+  top:-60px;
+  width:180px;
+  height:180px;
+  background:radial-gradient(circle,
+      rgba(0,110,255,.16) 0%,
+      rgba(0,110,255,.08) 45%,
+      transparent 75%);
+  pointer-events:none;
+}
+
+.vsdk-survey-card::after{
+  content:"";
+  position:absolute;
+  left:-40px;
+  bottom:-60px;
+  width:120px;
+  height:120px;
+  background:radial-gradient(circle,
+      rgba(76,169,255,.08),
+      transparent 70%);
+  pointer-events:none;
+}
+
+.vsdk-survey-card:hover{
+  border-color:#006EFF;
+  box-shadow:
+      0 10px 28px rgba(0,110,255,.10),
+      0 0 36px rgba(0,110,255,.08);
+  transform:translateY(-2px);
+}
+
+.vsdk-card-left{
+  display:flex;
+  align-items:center;
+  gap:14px;
+  flex:1;
+  min-width:0;
+  position:relative;
+  z-index:1;
+}
+
+.vsdk-ico{
+  width:46px;
+  height:46px;
+  flex:0 0 46px;
+  border-radius:12px;
+  background:linear-gradient(180deg,#EDF5FF,#DCEBFF);
+  display:flex;
+  align-items:center;
+  justify-content:center;
+  font-size:22px;
+  box-shadow:
+      inset 0 1px 0 rgba(255,255,255,.8),
+      0 6px 18px rgba(0,110,255,.12);
+}
+
+.vsdk-text{
+  min-width:0;
+}
+
+.vsdk-title{
+  display:flex;
+  align-items:center;
+  gap:8px;
+  flex-wrap:wrap;
+  font-size:18px;
+  font-weight:600;
+  color:#1F2329;
+  line-height:1.4;
+}
+
+.vsdk-badge{
+  padding:2px 8px;
+  border-radius:999px;
+  background:#EAF3FF;
+  color:#006EFF;
+  font-size:11px;
+  font-weight:600;
+}
+
+.vsdk-desc{
+  margin-top:6px;
+  font-size:13px;
+  line-height:1.7;
+  color:#4E5969;
+}
+
+.vsdk-card-right{
+  flex-shrink:0;
+  position:relative;
+  z-index:1;
+}
+
+.vsdk-cta{
+  display:inline-flex;
+  align-items:center;
+  justify-content:center;
+  min-width:112px;
+  height:40px;
+  padding:0 22px;
+  border-radius:8px;
+  background:#006EFF;
+  color:#FFFFFF;
+  text-decoration:none;
+  font-size:14px;
+  font-weight:600;
+  box-shadow:0 8px 20px rgba(0,110,255,.25);
+  transition:all .2s ease;
+}
+
+.vsdk-cta:hover{
+  background:#0052D9;
+  box-shadow:0 10px 24px rgba(0,110,255,.35);
+}
+
+@media (max-width:768px){
+
+.vsdk-survey-card{
+    flex-direction:column;
+    align-items:flex-start;
+}
+
+.vsdk-card-left{
+    width:100%;
+    align-items:flex-start;
+}
+
+.vsdk-title{
+    font-size:16px;
+}
+
+.vsdk-desc{
+    font-size:12px;
+}
+
+.vsdk-card-right{
+    width:100%;
+    margin-top:14px;
+}
+
+.vsdk-cta{
+    width:100%;
+}
+
+}
+</style>
+
+<div class="vsdk-survey-card">
+
+<div class="vsdk-card-left">
+
+<div class="vsdk-ico">💡</div>
+
+<div class="vsdk-text">
+
+<div class="vsdk-title">
+有接入卡点？30 秒反馈
+<span class="vsdk-badge">全部选填</span>
+</div>
+
+<div class="vsdk-desc">
+正在了解或评估视频会议 SDK？UI、功能、文档或套餐开通如有卡点，欢迎填写反馈。
+</div>
+
+</div>
+
+</div>
+
+<div class="vsdk-card-right">
+<a class="vsdk-cta" href="https://wj.qq.com/s2/27395009/ac34/" target="_blank">
+填写反馈
+</a>
+</div>
+
+</div>
+
+## 前提条件
+
+### 开通服务
+
+请参考 开通服务 领取 TUIRoomKit 体验版，并在 [应用管理](https://console.cloud.tencent.com/trtc) 页面获取以下信息：
+- **SDKAppID**：应用标识（必填），腾讯云基于 SDKAppID 完成计费统计。
+
+- **SDKSecretKey**：应用密钥，用于初始化配置文件的密钥信息。
+
+### 环境准备
+
+> **说明：**
+> HBuilderX 4.64 和 4.65 版本对 UTS 插件打包存在已知兼容性问题，建议使用 4.66 或更高版本。
+>
+
+- [HBuilderX](https://www.dcloud.io/hbuilderx.html)：HBuilderX 是 **uni-app 官方**的集成开发环境（IDE），我们需要用它来导入、配置和运行我们的 Demo。
+
+- 2个移动设备： Android 5.0 以上的设备 / iOS 13.0 及以上设备。
+
+## 快速接入
+
+### **步骤1：下载 TUIRoomKit 组件**
+
+#### 1. 克隆项目源码
+``` bash
+git clone
+```
+
+#### 2. 导入 atomic-x 组件
+- 将源码中 `TUIKit_uni-app/App/uni_modules` 目录下的 `tuikit-atomic-x` 文件夹，完整拷贝到您项目根目录下的 `uni_modules` 文件夹中。
+
+- 将源码中 `TUIKit_uni-app/App/components` 下的文件，完整的拷贝到您项目的 `components` 文件夹中。
+
+- 将源码中 `TUIKit_uni-app/App/static` 目录下的文件，完整拷贝到您项目根目录下的同名文件夹下。
+
+#### 3. 拷贝创建房间，加入房间，房间主界面等页面
+- 将源码中 `TUIKit_uni-app/App/pages` 目录下的文件，完整拷贝到您项目根目录下的同名文件夹中。
+
+- 将源码中 `TUIKit_uni-app/App/debug` 文件夹拷贝到您项目的根目录下，这个目录提供有可以方便您在客户端快速生成的 **UserSig** 的快捷函数。
+
+#### 4. 合并 App.vue 配置
+
+**TUIKit_uni-app/App/App.vue** 文件中包含多人视频会议能力的初始化逻辑，因此您需要将 **TUIKit_uni-app/App/App.vue** 文件和您项目下的 **App.vue** 文件进行合并。
+
+   > **注意：**
+   >
+   > 不要直接覆盖 **App.vue** 文件！ 打开源码中的 **TUIKit_uni-app/App/App.vue**， 将其 `<script>` 部分的 ts 内容追加到您自己项目的 **App.vue** 的 `<script>`  标签内。
+   >
+
+### 步骤2：工程配置
+1. 配置 `manifest.json`
+
+   打开您项目的 **manifest.json** 文件，在 **app-plus** > **distribute** 节点下，确保添加了以下必要的权限：
+
+  - Android 平台（`android` 节点）：在 `permissions` 数组中，请确保包含以下权限：
+
+      ``` json
+      "<uses-permission android:name=\"android.permission.CAMERA\"/>",
+      "<uses-permission android:name=\"android.permission.RECORD_AUDIO\" />",
+      "<uses-permission android:name=\"android.permission.INTERNET\"/>",
+      "<uses-permission android:name=\"android.permission.ACCESS_NETWORK_STATE\"/>",
+      "<uses-permission android:name=\"android.permission.WRITE_EXTERNAL_STORAGE\"/>"
+      ```
+  - iOS 平台（ios 节点）：在 `privacyDescription` 对象中，请确保包含以下描述：
+
+      ``` json
+      "NSCameraUsageDescription" : "应用需要访问您的相机以进行多人音视频互动",
+      "NSMicrophoneUsageDescription" : "应用需要访问您的麦克风以进行多人音视频互动"
+      ```
+
+      在 `UIBackgroundModes` 数组中，添加 `audio` 以支持后台播放音频。
+
+      ``` json
+      "UIBackgroundModes" : [ "audio" ]
+      ```
+2. 制作自定义基座。
+
+   > **说明：**
+   >
+   > 由于 TUIRoomKit 包含原生代码（UTS 插件），您**必须**制作自定义调试基座才能在真机上运行。
+   >
+
+  1. 在 HBuilderX 顶部菜单选择**运行** > **运行到手机或模拟器** > **制作自定义调试基座**。
+
+  2. 制作成功后，再次选择**运行** > **运行到手机或模拟器**，在弹窗中勾选**使用自定义调试基座**后运行到您的手机。
+
+      具体操作指引参见 编译并运行 Demo。
+
+### 步骤3：登录
+
+集成完成后，您需要完成登录。在您项目中需要使用到多人视频会议能力的地方进行登录，这是**使用 TUIRoomKit 的关键步骤**，因为只有在登录成功后才能正常使用 TUIRoomKit 的各项功能，故请您耐心检查相关参数是否配置正确：
+``` typescript
+import { useLoginState } from "@/uni_modules/tuikit-atomic-x/state/LoginState";
+
+const { login } = useLoginState();
+
+onMounted(() => {
+  login({
+	sdkAppID: 1400000001,     // 请替换为开通服务控制台的 SDKAppID
+	userID: "your userID",        // 请替换为您的 UserID
+	userSig: "xxxxxxxxxxx",  // 您可以在控制台中计算一个 UserSig 并填在这个位置
+  });
+});
+
+```
+
+**登录接口参数说明**
+| 参数 | 类型 | 说明 |
+| --- | --- | --- |
+| SDKAppID | Number | 从 <a href="https://console.cloud.tencent.com/trtc">TRTC 控制台 > 应用管理</a> 获取。 |
+| userID | String | 当前用户的唯一 ID，仅包含英文字母、数字、连字符和下划线。 |
+| userSig | String | 用于腾讯云鉴权的票据。请注意：<br>- 开发环境：您可以采用本地 <code>GenerateTestUserSig.genTestSig</code> 函数生成 UserSig 或者通过 <a href="https://console.cloud.tencent.com/im/tool-usersig">UserSig 辅助工具</a> 生成临时的 UserSig。<br>- 生产环境：为了防止密钥泄露，请务必采用服务端生成 UserSig 的方式。详细信息请参见 <a href="https://cloud.tencent.com/document/product/647/17275#formal">服务端生成 UserSig</a>。<br>更多信息请参见 <a href="https://cloud.tencent.com/document/product/647/17275">如何计算及使用 UserSig</a>。 |
+
+### 步骤4：注册多人视频会议主页面
+
+现在，您需要在 `pages.json` 文件中告诉您的应用，这个新页面是存在的。
+
+打开您项目根目录下的 `pages.json` 文件，在 `"pages"` 数组中，添加以下对象来注册多人视频会议主页面。
+``` json
+{
+    "pages": [
+        // ... 您项目已有的其他页面配置
+        {
+            "path": "pages/scenes/room/main/index",
+            "style": {
+                "navigationBarTitleText": "",
+                "disableSwipeBack": true, // 禁止右滑返回，防止会中误操作退出
+                "app-plus": {
+                    "titleNView": false // 隐藏原生导航栏，使用页面内的自定义导航
+                }
+            }
+        }
+    ]
+    // ... 其他配置
+}
+```
+
+### 步骤5：跳转多人视频会议主页面
+
+#### 创建房间
+
+在您需要创建多人视频会议的地方（具体由您的业务决定，在其点击事件里执行），调用 `uni.navigateTo` 或 `uni.redirectTo` 方法，即可进入多人视频会议主页面。
+``` typescript
+// 示例：在一个按钮的点击事件中
+function startBroadcast() {
+  const roomID = '123456'; //房间id
+  const roomName = '123456'; //房间名称
+  const query = [
+    'mode=create',
+    `roomID=${encodeURIComponent(roomID)}`,
+    `roomName=${encodeURIComponent(roomName)}`,
+    'autoEnableCamera=1',     //进房是否开启摄像头（1 开启， 0 关闭）
+    'autoEnableMicrophone=1', //进房是否开启麦克风（1 开启， 0 关闭）
+    'autoEnableSpeaker=1',    //进房是否开启扬声器（1 开启， 0 关闭）
+  ].join('&');
+  uni.navigateTo({ url: `/pages/scenes/room/main/index?${query}` }); // URL 对应 pages.json 中配置的 path
+}
+```
+
+> **说明：**
+> **navigateTo** 与 **redirectTo**
+>
+> - `uni.navigateTo`：保留当前页面，跳转到新页面，用户可以从多人视频会议主页返回到上一页。适用于创建房间前可以取消的场景。
+> - `uni.redirectTo`：关闭当前页面，跳转到新页面，用户无法返回。适用于支持人直接进入主流程的场景，不需要保存上个界面， 您可以根据自己的业务需求选择使用。
+
+#### 加入房间
+
+在您需要加入多人视频会议的地方（具体由您的业务决定，在其点击事件里执行），调用 `uni.navigateTo` 或 `uni.redirectTo` 方法，即可进入多人视频会议主页面。
+``` typescript
+// 示例：在一个按钮的点击事件中
+function startBroadcast() {
+  const roomID = '123456'; //房间id
+  const query = [
+    'mode=join',
+    `roomID=${encodeURIComponent(roomID)}`,
+    'autoEnableCamera=1',     //进房是否开启摄像头（1 开启， 0 关闭）
+    'autoEnableMicrophone=1', //进房是否开启麦克风（1 开启， 0 关闭）
+    'autoEnableSpeaker=1',    //进房是否开启扬声器（1 开启， 0 关闭）
+  ].join('&');
+  uni.navigateTo({ url: `/pages/scenes/room/main/index?${query}` }); // URL 对应 pages.json 中配置的 path
+}
+```
+
+## 定制您的 UI
+
+### 替换主界面底部栏，顶部栏和视频流用户信息界面图标
+
+TUIRoomKit 用到的所有图标都存放于 `static/images` 目录下，部分示例如下，您可以根据您的诉求来替换目录下的图标。
+
+顶部栏：
+
+|图标路径|详细描述|
+|---------|---------|
+|/static/images/room/room_switch_camera.png|顶部操作栏切换摄像头图标。|
+|/static/images/room/room_speakerphone.png|顶部操作栏扬声器图标。|
+|/static/images/room/room_earpiece.png|顶部操作栏听筒图标。|
+
+底部栏：
+
+|图标路径|详细描述|
+|---------|---------|
+|/static/images/room/room_member.png|底部操作栏成员图标。|
+|/static/images/room/room_mic_on.png|底部操作栏麦克风开启图标。|
+|/static/images/room/room_mic_off.png|底部操作栏麦克风关闭图标。|
+|/static/images/room/room_camera_on.png|底部操作栏摄像头开启图标。|
+|/static/images/room/room_camera_off.png|底部操作栏摄像头关闭图标。|
+
+视频流区域用户状态信息：
+
+|图标路径|详细描述|
+|---------|---------|
+|/static/images/room/room_video_view_mic_on.png|视频流用户麦克风开启图标。|
+|/static/images/room/room_video_view_mic_off.png|视频流用户麦克风关闭图标。|
+|/static/images/room/room_video_view_owner.png|视频流用户主持人角色图标。|
+|/static/images/room/room_video_view_admin.png|底部操作栏管理员角色图标。|
+
+### 设置字体的大小/颜色
+
+uni-app 官方对 **nvue** 页面限制字体的大小和颜色只能在 `text` 标签上设置，对于您想修改的文案，直接修改其 `css` 样式即可，示例如下
+
+以 “解除静音” 文字为例：
+``` typescript
+<template>
+  <text class="bottom-text">解除静音</text>
+</template>
+
+<style>
+  .bottom-text {
+    color: #FFFFFF;
+    font-size: 20rpx;
+    margin-top: 6rpx;
+    text-overflow: ellipsis;
+  }
+</style>
+```
+
+修改其 css 样式：
+``` typescript
+<template>
+  <text class="bottom-text">开启音频</text>
+</template>
+
+<style>
+ .bottom-text {
+    color: red;
+    font-size: 24rpx;
+    margin-top: 6rpx;
+    text-overflow: ellipsis;
+  }
+</style>
+
+```
+
+最终效果：
+
+### 设置按钮的大小
+
+设置按钮的大小，也可以直接通过修改 `css` 属性来进行设置，示例如下：
+
+以底部操作栏麦克风按钮为例：
+``` typescript
+<template>
+<image class="bottom-icon" src="/static/images/room/room_mic_on.png" mode="aspectFit"/>
+<text class="bottom-text">解除静音</text>
+</template>
+
+<style>
+  .bottom-icon {
+    width: 48rpx;
+    height: 48rpx;
+  }
+</style>
+```
+
+设置对应的 `css` 属性：
+``` typescript
+<template>
+<image class="bottom-icon" src="/static/images/room/room_mic_off.png" mode="aspectFit"/>
+<text class="bottom-text">解除静音</text>
+</template>
+
+<style>
+  .bottom-icon {
+    width: 70rpx;
+    height: 70rpx;
+  }
+</style>
+
+```
+
+最终效果：
+
+### 隐藏按钮
+
+隐藏按钮可以通过注释代码的方式来进行直接隐藏，示例如下
+
+以底部操作栏的麦克风按钮为例：
+``` typescript
+<!-- 底部操作栏 -->
+<view class="bottom-bar">
+  <MembersButton />
+   <!-- <MicButton /> -->   <!-- 隐藏麦克风图标 -->
+  <CameraButton />
+</view>
+```
+
+将其注释掉即可实现隐藏按钮。
+
+### 新增按钮
+
+在您需要新增的位置，插入对应的按钮实现。
+
+以底部栏新增“更多”按钮为例：
+``` typescript
+<template>
+  ......
+ <!-- 底部操作栏 -->
+    <view class="bottom-bar">
+    ......
+	  <view class="action-button-item">
+	    <image class="bottom-icon" src="/static/images/more.png" mode="aspectFit" />
+	    <text class="bottom-text">更多</text>
+	  </view>
+    </view>
+</template>
+
+<style>
+  .bottom-icon {
+    width: 48rpx;
+    height: 48rpx;
+  }
+  .bottom-text {
+    color: #FFFFFF;
+    font-size: 20rpx;
+    margin-top: 6rpx;
+    text-overflow: ellipsis;
+	text-align: center;
+  }
+</style>
+```
+
+## 常见问题
+
+#### **Q：该 TUIKit 插件是否支持编译到 H5 或微信小程序？**
+
+A：**不支持。**由于新版 TUIKit 基于 **UTS (Uni-app Type Script)** 插件架构开发，深度依赖 Android 和 iOS 的原生能力（如原生渲染引擎、本地数据库、音视频编解码），因此仅支持打包为 **App (Android/iOS)**。
+
+#### **Q：我的现有项目全是** `.vue` **页面（Webview 渲染），能直接集成吗？**
+
+A：**可以混用，但需要注意页面模式。**
+
+nvue 页面和 vue 页面可以互相跳转，但是 vue 页面的子组件不建议是 nvue 组件。TUIKit 的 UI 组件是 nvue 组件，因此使用 TUIKit 所在的**页面（pages）**必须也是 nvue 文件。
+
+#### **Q：页面样式错乱、布局塌陷？**
+
+A：**没有严格遵守 nvue 的 Flex 布局规范。**
+
+nvue 页面中：
+- 默认 `flex-direction` 是 `column`（纵向），而非 Web 的 `row`。
+
+- 文本必须包裹在 `<text>` 组件中，不能直接写在 `<div>` 或 `<view>` 里。
+
+- 不支持简写属性（例如 `margin: 10px 20px`），必须写全（`margin-top`, `margin-left` 等）。
+
+#### **Q：**运行报错 "uni is not defined" 或组件无法加载？
+
+A：请检查是否制作并使用了**自定义调试基座**。
+
+由于插件包含原生代码（Java/Objective-C），标准基座不包含这些原生库。
+- **解决步骤：** 请严格按照文档“运行和测试-步骤2”操作，在 HBuilderX 中点击 **运行** > **运行到手机或模拟器** > **制作自定义调试基座**。制作完成后，运行时请务必选择**运行到 Android/iOS 基座**，并勾选“使用自定义基座”。
+
+#### **Q：制作自定义基座时一直失败或卡顿怎么办？**
+
+A：这通常是本地原生编译环境（Gradle 或 CocoaPods）配置问题导致的。
+- **Android：** 请检查本地 JDK 版本是否兼容，以及网络是否能正常访问 Maven/Google 仓库。
+
+- **iOS：** 请确保已安装 CocoaPods 且版本更新，同时检查网络环境是否能访问 GitHub 或 CDN 库。
+

package/resource/knowledge/roomkit/preset/vue/features/ai-caption-translation.md

@@ -0,0 +1,69 @@
+TUIRoomKit 内置 AI 会议助手功能，为在线会议提供 AI 智能辅助。会议界面默认提供 AI 会议助手入口按钮，用户可通过该按钮使用以下核心功能：
+- **AI 实时字幕：**在会议进行中，实时将语音讨论内容转化为文字字幕并显示在屏幕上，辅助沟通与理解。
+
+- **AI 实时翻译：**开启 AI 实时字幕后，默认同步开启实时翻译功能。房主可设置翻译语言，具体支持的语言。
+
+- **AI 实时会议记录：**在会议进行中，持续将语音讨论内容转录为文本记录，便于会后整理与回顾。
+
+## 前提条件
+
+### 1. 开通智能语音服务
+
+使用 AI 功能，会产生费用消耗，计费规则参考 AI 智能语音。
+
+### 2. 基础环境集成
+
+请参考 [快速接入](https://cloud.tencent.com/document/product/647/81962) 将 `@tencentcloud/roomkit-web-vue3` 集成到项目中，确保版本 `≥ 5.1.2`。
+
+## 显示或隐藏 AI 会议助手
+
+AI 会议助手入口按钮默认显示在会议界面，无需额外配置即可使用。如需隐藏或重新显示该按钮，可调用 `conference.setWidgetVisible` 接口控制 `AIToolsWidget` 组件的可见性。
+
+> **说明：**
+> 入口按钮显示后不会自动开启转录任务，需由房主主动点击「AI 实时字幕」或「AI 实时会议记录」后，组件内部才会开启 AI 转录任务。
+>
+
+``` typescript
+<template>
+  <ConferenceMainView />
+</template>
+
+<script setup lang="ts">
+import { conference, BuiltinWidget } from '@tencentcloud/roomkit-web-vue3';
+
+// AI 会议助手入口按钮默认显示；如需隐藏，可将其可见性设为 false
+conference.setWidgetVisible({ [BuiltinWidget.AIToolsWidget]: false });
+</script>
+```
+
+## 关闭 AI 会议助手
+
+使用 **AI 会议助手**组件时，开发者无需手动关闭 AI 转录任务。组件内部已实现自动清理机制：
+- **退出房间时**：自动停止 AI 转录任务。
+
+- **资源释放**：自动清理相关内存资源。
+
+## 开发注意事项
+- **版本依赖**：AI 会议助手功能需要 `@tencentcloud/roomkit-web-vue3` 版本 ≥ 5.1.2，请确保已安装符合要求的版本。
+
+- **调用时机：**入口按钮默认显示，无需额外配置。如需通过 `conference.setWidgetVisible` 调整按钮的显示状态，请确保该代码在 `ConferenceMainView` 加载前执行。
+
+- **计费逻辑：**AI 转录任务由房主主动开启，同一个房间只计费一次，普通成员使用不会重复计费。
+
+- **网络要求：**AI 识别依赖稳定的上行网络，网络抖动可能导致字幕出现延迟或丢失。
+
+## 常见问题
+
+### 会议界面未出现“AI 会议助手”按钮？
+
+**问题描述：**已集成 TUIRoomKit，但会议界面未出现“AI 会议助手”按钮。
+
+**解决方案：**AI 会议助手入口按钮默认显示，若未出现请依次排查：1. 是否调用了 `conference.setWidgetVisible` 将 `AIToolsWidget` 设为了 `false`；2. 当前是否为直播（Webinar）房间，该场景暂不展示该按钮；3. `@tencentcloud/roomkit-web-vue3` 版本是否符合要求。
+
+### 房间内所有成员都能使用 AI 功能吗？
+
+**功能说明**：转录任务仅房主可开启。房主点击开启 AI 转录任务后，房间内所有成员均可使用 AI 实时字幕与会议记录功能。
+
+### AI 功能是否会产生重复计费？
+
+**计费说明**：不会重复计费。转录任务仅由房主开启一次，因此每个会议房间只会产生一次计费。若房主未开启转录任务，则不会开启转录，也不会产生相关费用。