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

package/resource/{doc/roomkit/vue/features → knowledge/roomkit/core-sdk/vue}/screen-share.md

@@ -7,7 +7,7 @@
 
 - 若在 `iframe` 中集成，需在标签中声明权限。
 
-   ``` typescript
+   ``` java
    <iframe allow="display-capture; fullscreen;"></iframe>
    ```
 
@@ -17,6 +17,7 @@
 
 使用 [startScreenShare](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#startScreenShare) 方法开始屏幕分享。在 Web 环境下，您将看到浏览器的屏幕选择器，可以选择分享整个屏幕、应用窗口或浏览器标签页。
 
+【Vue3】
 ``` typescript
 import { useDeviceState } from 'tuikit-atomicx-vue3/room';
 const { startScreenShare } = useDeviceState();
@@ -32,10 +33,27 @@ const handleStartShare = async () => {
 };
 ```
 
+【React】
+``` typescript
+import { useDeviceState } from 'tuikit-atomicx-react/room';
+const { startScreenShare } = useDeviceState();
+
+// 尝试开始屏幕分享，并尝试分享系统音频
+const handleStartShare = async () => {
+  try {
+    await startScreenShare({ screenAudio: true });
+  } catch (error) {
+    // 处理用户拒绝或浏览器不支持等错误
+    console.error('开始屏幕分享失败:', error);
+  }
+};
+```
+
 ### 步骤2：分享系统音频
 
 通过设置 `screenAudio: true` 参数，可以在屏幕分享时同时分享系统音频。这在分享视频、演示、音乐等包含音频内容时非常有用。
 
+【Vue3】
 ``` typescript
 import { useDeviceState } from 'tuikit-atomicx-vue3/room';
 const { startScreenShare } = useDeviceState();
@@ -51,13 +69,30 @@ const handleStartScreenShareWithAudio = async () => {
 };
 ```
 
+【React】
+``` typescript
+import { useDeviceState } from 'tuikit-atomicx-react/room';
+const { startScreenShare } = useDeviceState();
+
+// 开始屏幕分享并分享系统音频
+const handleStartScreenShareWithAudio = async () => {
+  try {
+    await startScreenShare({ screenAudio: true });
+    console.log('屏幕分享（含音频）已开始');
+  } catch (error) {
+    console.error('开始屏幕分享失败:', error);
+  }
+};
+```
+
 **浏览器兼容性说明：**
-| 浏览器 | 系统音频分享支持 | 备注 |
-| --- | --- | --- |
-| Chrome 74+ | 支持 | 需要在选择器中勾选**分享音频** |
-| Edge 79+ | 支持 | 基于 Chromium，体验同 Chrome |
-| Firefox | 不支持 | 暂不支持系统音频分享 |
-| Safari | 不支持 | 暂不支持系统音频分享 |
+
+|浏览器|系统音频分享支持|备注|
+|---------|---------|---------|
+|Chrome 74+|支持|需要在选择器中勾选**分享音频**|
+|Edge 79+|支持|基于 Chromium，体验同 Chrome|
+|Firefox|不支持|暂不支持系统音频分享|
+|Safari|不支持|暂不支持系统音频分享|
 
 > **注意：**
 >
@@ -70,20 +105,38 @@ const handleStartScreenShareWithAudio = async () => {
 用户可以通过以下几种方式停止屏幕分享：
 1. **调用 **[**stopScreenShare()**](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#stopScreenShare)** 接口**
 
-   ``` typescript
-   import { useDeviceState, DeviceStatus } from 'tuikit-atomicx-vue3/room';
-   const { screenStatus, stopScreenShare } = useDeviceState();
-
-   // 停止屏幕分享
-   const handleStopScreenShare = async () => {
-     try {
-       await stopScreenShare();
-       console.log('屏幕分享已停止');
-     } catch (error) {
-       console.error('停止屏幕分享失败:', error);
-     }
-   };
-   ```
+【Vue3】
+``` typescript
+import { useDeviceState, DeviceStatus } from 'tuikit-atomicx-vue3/room';
+const { screenStatus, stopScreenShare } = useDeviceState();
+
+// 停止屏幕分享
+const handleStopScreenShare = async () => {
+  try {
+    await stopScreenShare();
+    console.log('屏幕分享已停止');
+  } catch (error) {
+    console.error('停止屏幕分享失败:', error);
+  }
+};
+```
+
+【React】
+``` typescript
+import { useDeviceState, DeviceStatus } from 'tuikit-atomicx-react/room';
+const { screenStatus, stopScreenShare } = useDeviceState();
+
+// 停止屏幕分享
+const handleStopScreenShare = async () => {
+  try {
+    await stopScreenShare();
+    console.log('屏幕分享已停止');
+  } catch (error) {
+    console.error('停止屏幕分享失败:', error);
+  }
+};
+```
+
 2. **点击浏览器原生的"停止分享"按钮**
 
 3. **关闭被分享的窗口或标签页**
@@ -99,6 +152,8 @@ const handleStartScreenShareWithAudio = async () => {
 #### **设置屏幕分享权限**
 
 您可以通过 [useRoomParticipantState](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-RoomParticipantState) 提供的成员管理接口控制房间内的屏幕管理权限。
+
+【Vue3】
 ``` typescript
 import { useRoomParticipantState, DeviceType } from 'tuikit-atomicx-vue3/room';
 const { disableAllDevices } = useRoomParticipantState();
@@ -120,9 +175,33 @@ async function handleEnableAllScreen() {
 }
 ```
 
+【React】
+``` typescript
+import { useRoomParticipantState, DeviceType } from 'tuikit-atomicx-react/room';
+const { disableAllDevices } = useRoomParticipantState();
+
+// 限制仅房主/管理员可以发起屏幕分享
+async function handleDisableAllScreen() {
+  await disableAllDevices({
+    deviceType: DeviceType.Screen,
+    disable: true,
+  });
+}
+
+// 允许房间内所有用户发起屏幕分享
+async function handleEnableAllScreen() {
+  await disableAllDevices({
+    deviceType: DeviceType.Screen,
+    disable: false,
+  });
+}
+```
+
 #### **自动布局切换**
 
 当检测到房间中有用户开始屏幕分享时，建议切换到侧边栏布局（`RoomLayoutTemplate.SidebarLayout`），将分享画面放大显示，其他参会者画面显示在侧边栏。
+
+【Vue3】
 ``` typescript
 <template>
   <div class="room-container">
@@ -161,9 +240,48 @@ watch(participantWithScreen, (participant) => {
 </script>
 ```
 
+【React】
+``` typescript
+import { useState, useEffect } from 'react';
+import {
+  RoomView,
+  RoomLayoutTemplate,
+  useRoomParticipantState
+} from 'tuikit-atomicx-react/room';
+
+const RoomComponent = () => {
+  const [layoutTemplate, setLayoutTemplate] = useState(RoomLayoutTemplate.GridLayout);
+  const { participantWithScreen } = useRoomParticipantState();
+
+  // 监听屏幕分享状态，自动切换布局
+  useEffect(() => {
+    if (participantWithScreen) {
+      // 有人分享屏幕，切换到侧边栏布局
+      setLayoutTemplate(RoomLayoutTemplate.SidebarLayout);
+    } else {
+      // 没有人分享屏幕，切换回网格布局
+      setLayoutTemplate(RoomLayoutTemplate.GridLayout);
+    }
+  }, [participantWithScreen]);
+
+  return (
+    <div className="room-container">
+      <RoomView
+        layoutTemplate={layoutTemplate}
+        participantViewUI={({ participant, streamType }) => (
+          <ParticipantViewUI participant={participant} streamType={streamType} />
+        )}
+      />
+    </div>
+  );
+};
+```
+
 #### **限制仅一人屏幕分享**
 
 在房间中应该只允许一个人分享屏幕，当有人正在分享时，禁用其他人的分享按钮：
+
+【Vue3】
 ``` typescript
 <script setup>
 import { computed } from 'vue';
@@ -190,11 +308,35 @@ const canStartScreenShare = computed(() => {
 <template>
 ```
 
+【React】
+``` typescript
+import { useRoomParticipantState } from 'tuikit-atomicx-react/room';
+
+const { participantWithScreen, localParticipant } = useRoomParticipantState();
+
+const isOtherSharing = (() => {
+  const sharer = participantWithScreen;
+  if (!sharer) return false;
+  return sharer.userId !== localParticipant?.userId;
+})();
+
+const canStartScreenShare = !isOtherSharing;
+
+// 在 JSX 中使用
+return (
+  <button disabled={!canStartScreenShare} onClick={handleStartShare}>
+    开始屏幕分享
+  </button>
+);
+```
+
 ### 步骤5：处理屏幕分享错误
 
 当屏幕分享发生错误时，根据错误信息提示用户做出相应的操作。
 
 **代码示例：**
+
+【Vue3】
 ``` typescript
 import { useDeviceState, DeviceError } from 'tuikit-atomicx-vue3/room';
 import { TUIToast } from '@tencentcloud/uikit-base-component-vue3';
@@ -226,11 +368,44 @@ try {
 }
 ```
 
+【React】
+``` typescript
+import { useDeviceState, DeviceError } from 'tuikit-atomicx-react/room';
+import { TUIToast } from '@tencentcloud/uikit-base-component-react';
+
+const { startScreenShare } = useDeviceState();
+
+try {
+  await startScreenShare();
+} catch (error: any) {
+  let message = '';
+  switch (error.name) {
+    case 'NotReadableError':
+      message = '系统禁止当前浏览器访问屏幕内容，请启用屏幕分享权限。';
+      break;
+    case 'NotAllowedError':
+      if (error.message.includes('Permission denied by system')) {
+        message = '系统禁止当前浏览器访问屏幕内容，请启用屏幕分享权限。';
+      } else {
+        message = '用户取消屏幕分享';
+      }
+      break;
+    default:
+      message = '屏幕分享过程中发生未知错误，请重试。';
+      break;
+  }
+  TUIToast.warning({
+    message,
+  });
+}
+```
+
 ## API 文档
-| **State/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| **useDeviceState** | 包含音视频设备状态，音视频设备列表及操作接口。 | [API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-DeviceState) |
-| **useRoomParticipantState** | 包含房间内用户数据，用户管理接口。 | [API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-RoomParticipantState) |
+
+|**State/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|**useDeviceState**|包含音视频设备状态，音视频设备列表及操作接口。|[API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-DeviceState)|
+|**useRoomParticipantState**|包含房间内用户数据，用户管理接口。|[API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-RoomParticipantState)|
 
 ## 常见问题
 
@@ -244,6 +419,8 @@ try {
 ### 如何感知用户通过点击浏览器的“停止分享”按钮后结束屏幕分享？
 
 Atomicx 会自动监听浏览器的停止分享事件，并更新 `screenStatus` 状态。您只需要监听 `screenStatus` 的变化即可：
+
+【Vue3】
 ``` typescript
 watch(screenStatus, (newStatus, oldStatus) => {
   if (oldStatus === DeviceStatus.On && newStatus === DeviceStatus.Off) {
@@ -252,6 +429,22 @@ watch(screenStatus, (newStatus, oldStatus) => {
 });
 ```
 
+【React】
+``` typescript
+import { useEffect, useRef } from 'react';
+import { useDeviceState, DeviceStatus } from 'tuikit-atomicx-react/room';
+
+const { screenStatus } = useDeviceState();
+const prevScreenStatus = useRef(screenStatus);
+
+useEffect(() => {
+  if (prevScreenStatus.current === DeviceStatus.On && screenStatus === DeviceStatus.Off) {
+    console.log('用户已停止屏幕分享。');
+  }
+  prevScreenStatus.current = screenStatus;
+}, [screenStatus]);
+```
+
 ### 移动端浏览器是否支持屏幕分享？
 
 仅桌面端浏览器支持屏幕分享，移动端浏览器不支持屏幕分享能力。

package/resource/{doc/roomkit/vue/features → knowledge/roomkit/core-sdk/vue}/virtual-background.md

@@ -255,6 +255,7 @@ WebRTC 相关功能通常要求在 HTTPS 环境下运行，或者是 `localhost`
 腾讯云在 GitHub 上提供了示例项目 [atomicx-vite-vue3-ts](https://github.com/Tencent-RTC/TUIRoomKit/tree/main/Web/example/atomicx-vite-vue3-ts) ，您可以参考以实现完整的 RoomKit 功能。
 
 ## API 文档
-| **State/Component** | **功能描述** | **API 文档** |
-| --- | --- | --- |
-| **useVirtualBackgroundState** | 虚拟背景管理 | [API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-VirtualBackgroundState) |
+
+|**State/Component**|**功能描述**|**API 文档**|
+|---------|---------|---------|
+|**useVirtualBackgroundState**|虚拟背景管理|[API 文档](https://web.sdk.qcloud.com/trtc/live/web/doc/zh/index.html#module-VirtualBackgroundState)|

package/resource/{doc/roomkit → knowledge/roomkit/preset}/android/integration.md

@@ -1,7 +1,8 @@
 TUIRoomKit 是腾讯云提供的一站式多人音视频房间解决方案，集成了完整的 UI 组件和核心功能。通过本文档，开发者可以快速了解如何将 TUIRoomKit 集成到项目中，实现多人音视频房间功能。本文还将详细介绍如何快速替换图片资源、本地化文案等个性化配置，帮助开发者打造符合品牌特色的音视频应用。
-| 房间准备页 | 标准房间主页 | 大型研讨会房间主页 | 成员管理 |
-| --- | --- | --- | --- |
-|  |  |  |  |
+
+|房间准备页|房间主页|成员管理|
+|---------|---------|---------|
+||||
 
 ## 前提条件
 
@@ -95,7 +96,7 @@ dependencies {
 
 #### 4. 修改 AndroidManifest.xml
 
-为了防止编译时`AndroidManifest`合并过程中产生属性冲突，您需要在 `app/src/main/AndroidManifest.xml` 文件的 `<application>` 节点中，添加 `tools:replace="android:allowBackup"` 和 `android:allowBackup="false"`，用以覆盖组件内的设置。
+为了防止编译时 `AndroidManifest` 合并过程中产生属性冲突，您需要在 `app/src/main/AndroidManifest.xml` 文件的 `<application>` 节点中，添加 `tools:replace="android:allowBackup"` 和 `android:allowBackup="false"`，用以覆盖组件内的设置。
 ``` xml
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
     xmlns:tools="http://schemas.android.com/tools">
@@ -154,13 +155,13 @@ class MainActivity : AppCompatActivity() {
 **登录接口参数说明：**
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
-| `sdkAppID` | `Int32` | 从 [控制台](https://console.cloud.tencent.com/trtc) 获取，通常是以 `140` 或 `160` 开头的 10 位整数。 |
-| `userID` | `String` | 当前用户的唯一 ID，仅包含英文字母、数字、连字符和下划线。为避免多端登录冲突，**请勿使用**`1`、`123`**等简单 ID**。 |
-| `userSig` | `String` | 用于腾讯云鉴权的票据。更多信息请参见 如何计算及使用 UserSig。<br>【注意事项】<br>- 开发环境：可以采用本地 `GenerateTestUserSig.genTestSig` 函数生成 userSig 或者通过 [UserSig 辅助工具](https://console.cloud.tencent.com/im/tool-usersig) 生成临时的 userSig。<br>- 生产环境：为了防止密钥泄露，请务必采用服务端生成 userSig 的方式。详细信息请参考 服务端生成 UserSig。 |
+| <code>sdkAppID</code> | <code>Int32</code> | 从 <a href="https://console.cloud.tencent.com/trtc">控制台</a> 获取，通常是以 <code>140</code> 或 <code>160</code> 开头的 10 位整数。 |
+| <code>userID</code> | <code>String</code> | 当前用户的唯一 ID，仅包含英文字母、数字、连字符和下划线。为避免多端登录冲突，<strong>请勿使用</strong><code>1</code>、<code>123</code><strong>等简单 ID</strong>。 |
+| <code>userSig</code> | <code>String</code> | 用于腾讯云鉴权的票据。更多信息请参见 如何计算及使用 UserSig。<br>【注意事项】<br>- 开发环境：可以采用本地 <code>GenerateTestUserSig.genTestSig</code> 函数生成 userSig 或者通过 <a href="https://console.cloud.tencent.com/im/tool-usersig">UserSig 辅助工具</a> 生成临时的 userSig。<br>- 生产环境：为了防止密钥泄露，请务必采用服务端生成 userSig 的方式。详细信息请参考 服务端生成 UserSig。 |
 
 ### 步骤4：设置头像和昵称
 
-首次登录的用户没有头像和昵称信息，需要通过 `LoginStore` 的 `setSelfInfo`接口设置个人信息：
+首次登录的用户没有头像和昵称信息，需要通过 `LoginStore` 的 `setSelfInfo` 接口设置个人信息：
 ``` java
 import android.util.Log
 import io.trtc.tuikit.atomicxcore.api.CompletionHandler
@@ -188,15 +189,15 @@ fun setSelfInfo() {
 }
 ```
 
-**setSelfInfo接口参数说明：**
+**setSelfInfo 接口参数说明：**
 | 参数 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `userProfile` | `UserProfile` | 是 | 个人用户信息核心模型，包含：<br>- userID：要设置用户信息的用户 ID。<br>- nickname：昵称信息。<br>- avatarURL：头像链接。 |
-| `completion` | `CompletionHandler` | 否 | 设置个人信息接口的结果回调。若失败会返回错误码和错误信息。 |
+| <code>userProfile</code> | <code>UserProfile</code> | 是 | 个人用户信息核心模型，包含：<br>- userID：要设置用户信息的用户 ID。<br>- nickname：昵称信息。<br>- avatarURL：头像链接。 |
+| <code>completion</code> | <code>CompletionHandler</code> | 否 | 设置个人信息接口的结果回调。若失败会返回错误码和错误信息。 |
 
 ### 步骤5：创建房间
 
-在`TUIRoomKit` 组件中，`RoomMainView`是集成了完整的多人音视频房间功能的核心界面，以下将对开发者演示如何以房主身份将`RoomMainView`嵌入到应用中。
+在 `TUIRoomKit` 组件中，`RoomMainView` 是集成了完整的多人音视频房间功能的核心界面，以下将对开发者演示如何以房主身份将 `RoomMainView` 嵌入到应用中。
 
 #### **实现方式：**
 1. **加载创建视图页面**：懒加载方式实例化 `RoomMainView `。
@@ -205,13 +206,7 @@ fun setSelfInfo() {
 
 3. **初始化房间主页面**：通过房主身份初始化房间主页面。
 
-4. **将视图添加到视图 Activity**：在`Activity`的 `onCreate` 方法中，将 `RoomMainView` 添加到`Activity`中，并使用布局使其充满整个视图区域。
-
-   > **说明：**
-   >
-
-   > 移动端仅支持创建标准房间，如您需要创建大型研讨会房间，请参考 Web 快速接入 使用 Web 端创建。
-   >
+4. **将视图添加到视图 Activity**：在 `Activity` 的 `onCreate` 方法中，将 `RoomMainView` 添加到 `Activity` 中，并使用布局使其充满整个视图区域。
 
 #### **示例代码：**
 ``` java
@@ -251,30 +246,31 @@ class MainActivity : AppCompatActivity() {
 **RoomMainView init 函数参数详细说明****：**
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
-| `roomID` | `String` | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| `behavior` | `RoomBehavior` | 房间主页面初始化来源。<br>- Create: 房主身份创建房间。此方式需要构造创建房间配置项，关于 CreateRoomOptions 的详细用法请参考：CreateRoomOptions 结构体详细说明。<br>- Join：参与者身份加入房间。 |
-| `config` | `ConnectConfig` | 进房后音视频设备控制的配置项。 |
+| <code>roomID</code> | <code>String</code> | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
+| <code>roomType</code> | <code>RoomType</code> | 房间类型<br>- <code>STANDARD</code>：标准房间。<br>- <code>WEBINAR</code>：大型研讨会房间。<br>标准房间这里填写 <code>STANDARD 房间类型</code>。 |
+| <code>behavior</code> | <code>RoomBehavior</code> | 房间主页面初始化来源。<br>- Create: 房主身份创建房间。此方式需要构造创建房间配置项，关于 CreateRoomOptions 的详细用法请参考：CreateRoomOptions 结构体详细说明。<br>- Join：参与者身份加入房间。 |
+| <code>config</code> | <code>ConnectConfig</code> | 进房后音视频设备控制的配置项。 |
 
 **ConnectConfig 参数详细说明****：**
 | 参数 | 类型 | 说明 |
 | --- | --- | --- |
-| autoEnableMicrophone | `Boolean` | 进房后是否自动开启麦克风<br>- true：自动开启 （默认值）。<br>- false：不自动开启。 |
-| autoEnableCamera | `Boolean` | 进房后是否自动开启摄像头。<br>- true：自动开启 （默认值）。<br>- false：不自动开启。 |
-| autoEnableSpeaker | `Boolean` | 进房后是否自动开启扬声器。<br>- true：自动开启 （默认值）。<br>- false：不自动开启。 |
+| autoEnableMicrophone | <code>Boolean</code> | 进房后是否自动开启麦克风<br>- true：自动开启 （默认值）。<br>- false：不自动开启。 |
+| autoEnableCamera | <code>Boolean</code> | 进房后是否自动开启摄像头。<br>- true：自动开启 （默认值）。<br>- false：不自动开启。 |
+| autoEnableSpeaker | <code>Boolean</code> | 进房后是否自动开启扬声器。<br>- true：自动开启 （默认值）。<br>- false：不自动开启。 |
 
 ##### CreateRoomOptions 结构体详细说明
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
-| `roomName` | `String` | 否 | - 房间名称，可以不设置，默认为空字符串。<br>- 限制长度为 0-60 字节。<br>- 支持中英文、数字、特殊字符。 |
-| `password` | `String` | 否 | - 房间密码，空字符串 "" 通常表示该房间不设密码。<br>- 限制长度为 0-32 字节。<br>- 推荐使用 4-8 位纯数字，方便移动端输入。设置后，其他用户加入房间时需输入密码。建议不要存储明文敏感信息。 |
-| `isAllMicrophoneDisabled` | `Boolean` | 否 | 是否全员禁止打开麦克风。开启后，除房主/管理员外，普通参与者默认禁止打开麦克风。<br>- true：禁止。<br>- false：取消禁止 （默认值）。 |
-| `isAllCameraDisabled` | `Boolean` | 否 | 是否全员禁止打开摄像头。开启后，除房主/管理员外，普通参与者默认禁止打开摄像头。<br>- true：禁止。<br>- false：取消禁止（默认值）。 |
-| `isAllScreenShareDisabled` | `Boolean` | 否 | 是否全员禁止发起屏幕共享。开启后，仅房主/管理员可进行屏幕共享。<br>- true：禁止。<br>- false：取消禁止（默认值）。 |
-| `isAllMessageDisabled` | `Boolean` | 否 | 是否全员禁止发送聊天消息（禁言）。开启后，普通参与者无法在房间内发送文字消息。<br>- true：禁止。<br>- false：取消禁止（默认值）。 |
+| <code>roomName</code> | <code>String</code> | 否 | - 房间名称，可以不设置，默认为空字符串。<br>- 限制长度为 0-60 字节。<br>- 支持中英文、数字、特殊字符。 |
+| <code>password</code> | <code>String</code> | 否 | - 房间密码，空字符串 "" 通常表示该房间不设密码。<br>- 限制长度为 0-32 字节。<br>- 推荐使用 4-8 位纯数字，方便移动端输入。设置后，其他用户加入房间时需输入密码。建议不要存储明文敏感信息。 |
+| <code>isAllMicrophoneDisabled</code> | <code>Boolean</code> | 否 | 是否全员禁止打开麦克风。开启后，除房主/管理员外，普通参与者默认禁止打开麦克风。<br>- true：禁止。<br>- false：取消禁止 （默认值）。 |
+| <code>isAllCameraDisabled</code> | <code>Boolean</code> | 否 | 是否全员禁止打开摄像头。开启后，除房主/管理员外，普通参与者默认禁止打开摄像头。<br>- true：禁止。<br>- false：取消禁止（默认值）。 |
+| <code>isAllScreenShareDisabled</code> | <code>Boolean</code> | 否 | 是否全员禁止发起屏幕共享。开启后，仅房主/管理员可进行屏幕共享。<br>- true：禁止。<br>- false：取消禁止（默认值）。 |
+| <code>isAllMessageDisabled</code> | <code>Boolean</code> | 否 | 是否全员禁止发送聊天消息（禁言）。开启后，普通参与者无法在房间内发送文字消息。<br>- true：禁止。<br>- false：取消禁止（默认值）。 |
 
 ### 步骤6：加入房间
 
-以下示例将向开发者演示如何以参与者身份将`RoomMainView`嵌入到应用中。
+以下示例将向开发者演示如何以参与者身份将 `RoomMainView` 嵌入到应用中。
 
 #### **实现方式：**
 1. **加载创建视图页面**：懒加载方式实例化 `RoomMainView `。
@@ -283,13 +279,7 @@ class MainActivity : AppCompatActivity() {
 
 3. **初始化房间主页面**：通过参与者身份初始化房间主页面。
 
-4. **将视图添加到视图 Activity**：在`Activity`的 `onCreate` 方法中，将 `RoomMainView` 添加到`Activity`中，并使用布局使其充满整个视图区域。
-
-   > **说明：**
-   >
-
-   > 使用 **TUIRoomKit** 组件进入大型研讨会房间时，需确保 Web 端创建的研讨会房间的房间 ID 以 `webinar_` 开头。
-   >
+4. **将视图添加到视图 Activity**：在 `Activity` 的 `onCreate` 方法中，将 `RoomMainView` 添加到 `Activity` 中，并使用布局使其充满整个视图区域。
 
 #### 代码示例：
 ``` java
@@ -328,44 +318,40 @@ class MainActivity : AppCompatActivity() {
 
 ## 核心功能
 
-接入`RoomMainView`代码后，开发者将得到一个完整的多人音视频页面，内部包含成员管理，音视频设备控制，房间信息展示等功能，这是 `TUIRoomKit` 组件的核心。
-| 标准房间 | 大型研讨会房间 |
-| --- | --- |
-|  |  |
+接入 `RoomMainView` 代码后，开发者将得到一个完整的多人音视频页面，内部包含成员管理，音视频设备控制，房间信息展示等功能，这是 `TUIRoomKit` 组件的核心。
 
 ## 界面定制
 
-`RoomMainView`房间主页面内功能丰富，可定制化度高，开发者可以根据实际产品需求，对 UI 进行定制化修改，以适配业务交互场景。以下将详细为开发者展示`RoomMainView`页面中视图组件，便于开发者快速修改。
-| 标准房间 | 大型研讨会房间 |
-| --- | --- |
-|  |  |
+`RoomMainView` 房间主页面内功能丰富，可定制化度高，开发者可以根据实际产品需求，对 UI 进行定制化修改，以适配业务交互场景。以下将详细为开发者展示 `RoomMainView` 页面中视图组件，便于开发者快速修改。
 
 `RoomMainView`**中组件详细说明**
-| 组件 | 功能描述 | 定制化建议 |
-| --- | --- | --- |
-| [RoomMainView](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/room/tuiroomkit/src/main/java/com/trtc/uikit/roomkit/view/RoomMainView.kt) | 房间主视图容器，负责协调各子组件的布局与数据流转。 | 可调整整体背景、安全区域适配、组件显隐逻辑。 |
-| [RoomTopBarView](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/room/tuiroomkit/src/main/java/com/trtc/uikit/roomkit/view/main/RoomTopBarView.kt) | 顶部导航栏，包含房间信息、摄像头和声音控制、退出房间功能入口。 | 可替换图标、调整背景透明度、添加自定义按钮（例如录制、 窗口化）。 |
-| [RoomView](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/room/tuiroomkit/src/main/java/com/trtc/uikit/roomkit/view/main/RoomView.kt) | 视频流展示区域，采用瀑布流布局管理多个用户视频画面。 | 可修改布局算法（行列数、间距）、分页指示器样式、空状态视图。 |
-| [RoomVideoNameOverlayView](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/room/tuiroomkit/src/main/java/com/trtc/uikit/roomkit/view/main/roomview/RoomVideoNameOverlayView.kt) | 单个视频流单元格挂件，承载用户视频画面与基本信息。 | 可自定义视频渲染层、用户信息面板（头像、徽章）、互动控件（语音波形）。 |
-| [RoomBottomBarView](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/room/tuiroomkit/src/main/java/com/trtc/uikit/roomkit/view/main/RoomBottomBarView.kt) | 底部工具栏，集成麦克风、摄像头、成员管理操作按钮。 | 可重新排列按钮顺序、修改按钮样式（颜色、尺寸）、添加业务相关功能（例如屏幕分享、会中呼叫、美颜）。 |
+
+|组件|功能描述|定制化建议|
+|---------|---------|---------|
+|[RoomMainView](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/room/tuiroomkit/src/main/java/com/trtc/uikit/roomkit/view/RoomMainView.kt)|房间主视图容器，负责协调各子组件的布局与数据流转。|可调整整体背景、安全区域适配、组件显隐逻辑。|
+|[RoomTopBarView](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/room/tuiroomkit/src/main/java/com/trtc/uikit/roomkit/view/main/RoomTopBarView.kt)|顶部导航栏，包含房间信息、摄像头和声音控制、退出房间功能入口。|可替换图标、调整背景透明度、添加自定义按钮（例如录制、 窗口化）。|
+|[RoomView](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/room/tuiroomkit/src/main/java/com/trtc/uikit/roomkit/view/main/RoomView.kt)|视频流展示区域，采用瀑布流布局管理多个用户视频画面。|可修改布局算法（行列数、间距）、分页指示器样式、空状态视图。|
+|[RoomVideoNameOverlayView](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/room/tuiroomkit/src/main/java/com/trtc/uikit/roomkit/view/main/roomview/RoomVideoNameOverlayView.kt)|单个视频流单元格挂件，承载用户视频画面与基本信息。|可自定义视频渲染层、用户信息面板（头像、徽章）、互动控件（语音波形）。|
+|[RoomBottomBarView](https://github.com/Tencent-RTC/TUIKit_Android/blob/main/room/tuiroomkit/src/main/java/com/trtc/uikit/roomkit/view/main/RoomBottomBarView.kt)|底部工具栏，集成麦克风、摄像头、成员管理操作按钮。|可重新排列按钮顺序、修改按钮样式（颜色、尺寸）、添加业务相关功能（例如屏幕分享、会中呼叫、美颜）。|
 
 ## 图标定制
 
-接入 `TUIRoomKit`组件后，开发者可以根据实际 UI 交互需求直接替换组件下的图标资源， 以适配开发者的业务场景。
+接入 `TUIRoomKit` 组件后，开发者可以根据实际 UI 交互需求直接替换组件下的图标资源， 以适配开发者的业务场景。
 
 **常用的图片文件列表**
-| 图标 | 文件名 | 说明 |
-| --- | --- | --- |
-|  | roomkit_ic_camera_off.png | 摄像头关闭图标 |
-|  | roomkit_ic_camera_on.png | 摄像头开启图标 |
-|  | roomkit_ic_microphone_off.png | 麦克风关闭图标 |
-|  | roomkit_ic_microphone_on.png | 麦克风开启图标 |
-|  | roomkit_icon_user_room_manager.png | 管理员身份标识图标 |
-|  | roomkit_ic_video_seat_owner.png | 房主身份标识图标 |
+
+|图标|文件名|说明|
+|---------|---------|---------|
+||roomkit_ic_camera_off.png|摄像头关闭图标|
+||roomkit_ic_camera_on.png|摄像头开启图标|
+||roomkit_ic_microphone_off.png|麦克风关闭图标|
+||roomkit_ic_microphone_on.png|麦克风开启图标|
+||roomkit_icon_user_room_manager.png|管理员身份标识图标|
+||roomkit_ic_video_seat_owner.png|房主身份标识图标|
 
 ## 文案定制
 
-TUIRoomKit 使用 Android 通用的 XML 资源文件来管理 UI 所需的文案显示，您可以直接通过  `XML` 文件修改需要调整的文案：
+TUIRoomKit 使用 Android 通用的 XML 资源文件来管理 UI 所需的文案显示，您可以直接通过 `XML` 文件修改需要调整的文案：
 
 ## 常见问题