@tencentcloud/sdk-mcp 1.7.2 → 1.7.4

package/resource/knowledge/roomkit/core-sdk/android/room-state.md

@@ -79,7 +79,7 @@ fun createAndJoinRoom() {
 | --- | --- | --- | --- |
 | <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>options</code> | <code>CreateRoomOptions</code> | 是 | - 创建房间配置对象。<br>- 详细用法
+| <code>options</code> | <code>CreateRoomOptions</code> | 是 | - 创建房间配置对象。<br>- 详细用法请参考：<a href="#a065626d-21a2-476e-bbaf-65bca29b44d2">CreateRoomOptions 结构体详细说明</a> |
 | <code>completion</code> | <code>CompletionHandler</code> | 否 | 操作完成回调，用于返回创建和加入房间的结果。若创建失败则会返回错误码和错误信息。 |
 
 ##### CreateRoomOptions 结构体详细说明
@@ -225,8 +225,8 @@ fun updateRoomInfo() {
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | <code>roomID</code> | <code>String</code> | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| <code>options</code> | <code>UpdateRoomOptions</code> | 是 | - 更新房间属性配置对象。<br>- 详细用法
-| <code>modifyFlagList</code> | <code>List<UpdateRoomOptions.ModifyFlag></code> | 是 | - 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>房间密码</strong>。<br>- 详细用法。 |
+| <code>options</code> | <code>UpdateRoomOptions</code> | 是 | - 更新房间属性配置对象。<br>- 详细用法请参考：<a href="#UpdateRoomOptionsStruct">UpdateRoomOptions 结构体详细说明</a> |
+| <code>modifyFlagList</code> | <code>List<UpdateRoomOptions.ModifyFlag></code> | 是 | - 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>房间密码</strong>。<br>- 详细用法请参考：<a href="#UpdateRoomOptions.ModifyFlag">UpdateRoomOptions.ModifyFlag 详细说明</a>。 |
 | <code>completion</code> | <code>CompletionHandler</code> | 否 | 操作完成回调，用于返回更新房间信息的结果。若更新失败则会返回错误码和错误信息。 |
 
 **UpdateRoomOptions 结构体详细说明**

package/resource/knowledge/roomkit/core-sdk/android/schedule-room.md

@@ -78,7 +78,7 @@ fun scheduleRoom() {
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | <code>roomID</code> | <code>String</code> | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| <code>options</code> | <code>ScheduleRoomOptions</code> | 是 | - 创建房间配置对象。<br>- 详细用法。 |
+| <code>options</code> | <code>ScheduleRoomOptions</code> | 是 | - 创建房间配置对象。<br>- 详细用法请参考：<a href="#a065626d-21a2-476e-bbaf-65bca29b44d2">ScheduleRoomOptions 结构体详细说明</a>。 |
 | <code>completion</code> | <code>CompletionHandler</code> | 否 | 操作完成回调，用于返回预定房间的结果。若预定失败则会返回错误码和错误信息。 |
 
 ##### ScheduleRoomOptions 结构体详细说明
@@ -89,7 +89,7 @@ fun scheduleRoom() {
 | <code>scheduleStartTime</code> | <code>Long</code> | 是 | - 预定的房间开始时间（Unix 时间戳，单位：秒）。<br>- 取值必须大于当前时间。<br>- 推荐设置为未来的整分时间。例如：1736164800（代表 2025-01-06 20:00:00）。 |
 | <code>scheduleEndTime</code> | <code>Long</code> | 是 | - 预定的房间结束时间（Unix 时间戳，单位：秒）。<br>- 取值必须大于 <code>scheduleStartTime</code>。<br>- 建议根据预期时长设置。例如：<code>scheduleStartTime</code> + 3600（预定 1 小时时长的房间）。 |
 | <code>reminderSecondsBeforeStart</code> | <code>Int</code> | 否 | - 房间开始前的提醒时间（单位：秒）。用于系统触发开始提醒。<br>- 推荐设置为 300（5分钟）或 900（15分钟），用于在 App 端触发本地通知。 |
-| <code>scheduleAttendees</code> | <code>List<String></code> | 否 | - 预定参与者的用户 ID 列表，在预定房间时设置，系统将向这些用户发送预定邀请。<br>- 获取方式。 |
+| <code>scheduleAttendees</code> | <code>List<String></code> | 否 | - 预定参与者的用户 ID 列表，在预定房间时设置，系统将向这些用户发送预定邀请。<br>- 获取方式请参考 <a href="#88039583-8ee8-4662-bf73-d71c3af652fe">获取指定预定房间的参与成员列表</a>。 |
 | <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 ：取消禁止（默认值）。 |
@@ -159,8 +159,8 @@ fun updateScheduledRoom() {
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | <code>roomID</code> | <code>String</code> | 是 | 字符串类型的房间唯一标识符。<br>限制长度为 0-48 字节。<br>建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| <code>options</code> | <code>ScheduleRoomOptions</code> | 是 | 预定房间配置对象。<br>详细用法。 |
-| <code>modifyFlagList</code> | <code>List<ScheduleRoomOptions.ModifyFlag></code> | 是 | 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>开始时间</strong>、<strong>结束时间。</strong><br>详细用法。 |
+| <code>options</code> | <code>ScheduleRoomOptions</code> | 是 | 预定房间配置对象。<br>详细用法请参考：<a href="#a065626d-21a2-476e-bbaf-65bca29b44d2">ScheduleRoomOptions 结构体详细说明</a>。 |
+| <code>modifyFlagList</code> | <code>List<ScheduleRoomOptions.ModifyFlag></code> | 是 | 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>开始时间</strong>、<strong>结束时间。</strong><br>详细用法请参考：<a href="#ScheduleRoomOptions.ModifyFlag">ScheduleRoomOptions.ModifyFlag 详细说明</a>。 |
 | <code>completion</code> | <code>CompletionHandler</code> | 否 | 操作完成回调，用于返回更新预定房间的结果。若更新失败则会返回错误码和错误信息。 |
 
 **ScheduleRoomOptions.ModifyFlag 详细说明**

package/resource/knowledge/roomkit/core-sdk/flutter/room-state.md

@@ -205,8 +205,8 @@ Future<void> updateRoomInfo() async {
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | <code>roomID</code> | <code>String</code> | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| <code>options</code> | <code>UpdateRoomOptions</code> | 是 | - 更新房间属性配置对象。<br>- 详细用法
-| <code>modifyFlag</code> | <code>UpdateRoomOptionsModifyFlag</code> | 是 | - 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>房间密码</strong>。<br>- 详细用法。 |
+| <code>options</code> | <code>UpdateRoomOptions</code> | 是 | - 更新房间属性配置对象。<br>- 详细用法请参考：<a href="#UpdateRoomOptionsStruct">UpdateRoomOptions 结构体详细说明</a> |
+| <code>modifyFlag</code> | <code>UpdateRoomOptionsModifyFlag</code> | 是 | - 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>房间密码</strong>。<br>- 详细用法请参考：<a href="#UpdateRoomOptions.ModifyFlag">UpdateRoomOptionsModifyFlag 详细说明</a>。 |
 
 **UpdateRoomOptions 结构体详细说明**
 | 参数名 | 类型 | 必填 | 说明 |

package/resource/knowledge/roomkit/core-sdk/flutter/schedule-room.md

@@ -77,7 +77,7 @@ Future<void> scheduleRoom() async {
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | <code>roomID</code> | <code>String</code> | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| <code>options</code> | <code>ScheduleRoomOptions</code> | 是 | - 创建房间配置对象。<br>- 详细用法
+| <code>options</code> | <code>ScheduleRoomOptions</code> | 是 | - 创建房间配置对象。<br>- 详细用法请参考：<a href="#a065626d-21a2-476e-bbaf-65bca29b44d2">ScheduleRoomOptions 结构体详细说明</a> |
 
 ##### ScheduleRoomOptions 结构体详细说明
 | 参数名 | 类型 | 必填 | 说明 |
@@ -87,7 +87,7 @@ Future<void> scheduleRoom() async {
 | scheduleStartTime | int | 是 | - 预定的房间开始时间（Unix 时间戳，单位：秒）。<br>- 取值必须大于当前时间。<br>- 推荐设置为未来的整分时间。例如：1736164800（代表 2025-01-06 20:00:00）。 |
 | scheduleEndTime | int | 是 | - 预定的房间结束时间（Unix 时间戳，单位：秒）。<br>- 取值必须大于 scheduleStartTime。<br>- 建议根据预期时长设置。例如：scheduleStartTime + 3600（预定 1 小时时长的房间）。 |
 | reminderSecondsBeforeStart | int | 否 | - 房间开始前的提醒时间（单位：秒）。用于系统触发开始提醒。<br>- 推荐设置为 300（5分钟）或 900（15分钟），用于在 App 端触发本地通知。 |
-| scheduleAttendees | List<String> | 否 | - 预定参与者的用户 ID 列表，在预定房间时设置，系统将向这些用户发送预定邀请。<br>- 获取方式。 |
+| scheduleAttendees | List<String> | 否 | - 预定参与者的用户 ID 列表，在预定房间时设置，系统将向这些用户发送预定邀请。<br>- 获取方式请参考 <a href="#88039583-8ee8-4662-bf73-d71c3af652fe">获取指定预定房间的参与成员列表</a>。 |
 | isAllMicrophoneDisabled | bool | 否 | - 是否全员禁止打开麦克风。开启后，除房主/管理员外，普通参与者默认禁止打开麦克风。<br>- 参数含义：<br>- true : 禁止。<br>- false ：取消禁止 （默认值）。 |
 | isAllCameraDisabled | bool | 否 | - 是否全员禁止打开摄像头。开启后，除房主/管理员外，普通参与者默认禁止打开摄像头。<br>- 参数含义：<br>- true : 禁止。<br>- false ：取消禁止（默认值）。 |
 | isAllScreenShareDisabled | bool | 否 | - 是否全员禁止发起屏幕共享。开启后，仅房主/管理员可进行屏幕共享。<br>- 参数含义：<br>- true : 禁止。<br>- false ：取消禁止（默认值）。 |
@@ -150,8 +150,8 @@ Future<void> scheduleRoom() async {
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | roomID | String | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| options | ScheduleRoomOptions | 是 | - 预定房间配置对象。<br>- 详细用法
-| modifyFlagList | List<ScheduleRoomOptionsModifyFlag> | 是 | - 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>开始时间</strong>、<strong>结束时间。</strong><br>- 详细用法。 |
+| options | ScheduleRoomOptions | 是 | - 预定房间配置对象。<br>- 详细用法请参考：<a href="#a065626d-21a2-476e-bbaf-65bca29b44d2">ScheduleRoomOptions 结构体详细说明</a> |
+| modifyFlagList | List<ScheduleRoomOptionsModifyFlag> | 是 | - 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>开始时间</strong>、<strong>结束时间。</strong><br>- 详细用法请参考：<a href="#ScheduleRoomOptionsModifyFlag">ScheduleRoomOptionsModifyFlag 详细说明</a>。 |
 
 **ScheduleRoomOptionsModifyFlag 详细说明**
 | 参数名 | 说明 |

package/resource/knowledge/roomkit/core-sdk/ios/room-state.md

@@ -72,7 +72,7 @@ func createAndJoinRoom() {
 | --- | --- | --- | --- |
 | <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>options</code> | <code>CreateRoomOptions</code> | 是 | - 创建房间配置对象。<br>- 详细用法。 |
+| <code>options</code> | <code>CreateRoomOptions</code> | 是 | - 创建房间配置对象。<br>- 详细用法请参考：<a href="#a065626d-21a2-476e-bbaf-65bca29b44d2">CreateRoomOptions 结构体详细说明</a>。 |
 | <code>completion</code> | <code>CompletionClosure</code> | 否 | 操作完成回调，用于返回创建和加入房间的结果。若创建失败则会返回错误码和错误信息。 |
 
 ##### CreateRoomOptions 结构体详细说明
@@ -203,8 +203,8 @@ func updateRoomInfo() {
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | <code>roomID</code> | <code>String</code> | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| <code>options</code> | <code>UpdateRoomOptions</code> | 是 | - 更新房间属性配置对象。<br>- 详细用法。 |
-| <code>modifyFlag</code> | <code>UpdateRoomOptions.ModifyFlag</code> | 是 | - 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>房间密码</strong>。<br>- 详细用法。 |
+| <code>options</code> | <code>UpdateRoomOptions</code> | 是 | - 更新房间属性配置对象。<br>- 详细用法请参考：<a href="#UpdateRoomOptionsStruct">UpdateRoomOptions 结构体详细说明</a>。 |
+| <code>modifyFlag</code> | <code>UpdateRoomOptions.ModifyFlag</code> | 是 | - 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>房间密码</strong>。<br>- 详细用法请参考：<a href="#UpdateRoomOptions.ModifyFlag">UpdateRoomOptions.ModifyFlag 详细说明</a>。 |
 | <code>completion</code> | <code>CompletionClosure</code> | 否 | 操作完成回调，用于返回更新房间信息的结果。若更新失败则会返回错误码和错误信息。 |
 
 **UpdateRoomOptions 结构体详细说明**

package/resource/knowledge/roomkit/core-sdk/ios/schedule-room.md

@@ -76,7 +76,7 @@ func scheduleRoom() {
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | <code>roomID</code> | <code>String</code> | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| <code>options</code> | <code>ScheduleRoomOptions</code> | 是 | - 创建房间配置对象。<br>- 详细用法
+| <code>options</code> | <code>ScheduleRoomOptions</code> | 是 | - 创建房间配置对象。<br>- 详细用法请参考：<a href="#a065626d-21a2-476e-bbaf-65bca29b44d2">ScheduleRoomOptions 结构体详细说明</a> |
 | <code>completion</code> | <code>CompletionClosure</code> | 否 | 操作完成回调，用于返回预定房间的结果。若预定失败则会返回错误码和错误信息。 |
 
 ##### ScheduleRoomOptions 结构体详细说明
@@ -87,7 +87,7 @@ func scheduleRoom() {
 | <code>scheduleStartTime</code> | <code>Int</code> | 是 | - 预定的房间开始时间（Unix 时间戳，单位：秒）。<br>- 取值必须大于当前时间。<br>- 推荐设置为未来的整分时间。例如：1736164800（代表 2025-01-06 20:00:00）。 |
 | <code>scheduleEndTime</code> | <code>Int</code> | 是 | - 预定的房间结束时间（Unix 时间戳，单位：秒）。<br>- 取值必须大于 <code>scheduleStartTime</code>。<br>- 建议根据预期时长设置。例如：<code>scheduleStartTime</code> + 3600（预定 1 小时时长的房间）。 |
 | <code>reminderSecondsBeforeStart</code> | <code>Int</code> | 否 | - 房间开始前的提醒时间（单位：秒）。用于系统触发开始提醒。<br>- 推荐设置为 300（5分钟）或 900（15分钟），用于在 App 端触发本地通知。 |
-| <code>scheduleAttendees</code> | <code>[String]</code> | 否 | - 预定参与者的用户 ID 列表，在预定房间时设置，系统将向这些用户发送预约邀请。<br>- 获取。 |
+| <code>scheduleAttendees</code> | <code>[String]</code> | 否 | - 预定参与者的用户 ID 列表，在预定房间时设置，系统将向这些用户发送预约邀请。<br>- 获取请参考<a href="#88039583-8ee8-4662-bf73-d71c3af652fe">获取指定预定房间的参与成员列表</a>。 |
 | <code>isAllMicrophoneDisabled</code> | <code>Bool</code> | 否 | 是否全员禁止打开麦克风。开启后，除房主/管理员外，普通参与者默认禁止打开麦克风。<br>- true : 禁止<br>- false ：取消禁止 （默认值） |
 | <code>isAllCameraDisabled</code> | <code>Bool</code> | 否 | 是否全员禁止打开摄像头。开启后，除房主/管理员外，普通参与者默认禁止打开摄像头。<br>- true : 禁止<br>- false ：取消禁止（默认值） |
 | <code>isAllScreenShareDisabled</code> | <code>Bool</code> | 否 | 是否全员禁止发起屏幕共享。开启后，仅房主/管理员可进行屏幕共享。<br>- true : 禁止<br>- false ：取消禁止（默认值） |
@@ -150,8 +150,8 @@ func updateScheduledRoom() {
 | 参数名 | 类型 | 必填 | 说明 |
 | --- | --- | --- | --- |
 | <code>roomID</code> | <code>String</code> | 是 | - 字符串类型的房间唯一标识符。<br>- 限制长度为 0-48 字节。<br>- 建议仅包含数字、英文字母（区分大小写）、下划线（_）和连字符（-）。避免使用空格和中文字符。 |
-| <code>options</code> | <code>ScheduleRoomOptions</code> | 是 | - 预定房间配置对象。<br>- 详细用法
-| <code>modifyFlag</code> | <code>ScheduleRoomOptions.ModifyFlag</code> | 是 | - 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>开始时间</strong>、<strong>结束时间。</strong><br>- 详细用法。 |
+| <code>options</code> | <code>ScheduleRoomOptions</code> | 是 | - 预定房间配置对象。<br>- 详细用法请参考：<a href="#a065626d-21a2-476e-bbaf-65bca29b44d2">ScheduleRoomOptions 结构体详细说明</a> |
+| <code>modifyFlag</code> | <code>ScheduleRoomOptions.ModifyFlag</code> | 是 | - 更新房间属性修改标志位。目前支持更新<strong>房间名称</strong>、<strong>开始时间</strong>、<strong>结束时间。</strong><br>- 详细用法请参考：<a href="#ScheduleRoomOptions.ModifyFlag">ScheduleRoomOptions.ModifyFlag 详细说明</a>。 |
 | <code>completion</code> | <code>CompletionClosure</code> | 否 | 操作完成回调，用于返回更新预定房间的结果。若更新失败则会返回错误码和错误信息。 |
 
 **ScheduleRoomOptions.ModifyFlag 详细说明**

package/resource/knowledge/roomkit/core-sdk/react/network-proxy.md

@@ -0,0 +1,84 @@
+视频会议 SDK 基于腾讯云即时通信 IM 与实时音视频 TRTC 提供服务，支持在内网 / 防火墙环境下统一配置 IM 与 TRTC 代理，适用于私有化部署、企业内网隔离等无法直连腾讯云服务的场景。
+
+## 代理架构
+
+|代理服务器|代理链路|
+|---------|---------|
+|IM 代理|代理 IM 登录、消息收发等信令通道（WebSocket），以及聊天图片、文件等资源的上传与下载。|
+|TRTC WebSocket 代理（如 Nginx）|代理 TRTC 进房、控制等信令通道（WebSocket），负责房间管理与用户状态同步。|
+|TRTC TURN Server|中继转发 TRTC 音视频媒体流。|
+
+> **说明：**
+> 代理服务器（IM 代理、Nginx、TURN）需自行部署，搭建方式参见 [TRTC Web SDK 应对防火墙受限](https://web.sdk.qcloud.com/trtc/webrtc/v5/doc/zh-cn/tutorial-34-advanced-proxy.html)。
+>
+
+## 接口与参数
+
+视频会议 SDK 支持用户在调用 `login()` 之前通过 `callExperimentalAPI` 接口统一配置内网代理：
+``` typescript
+callExperimentalAPI({
+  api: 'setNetworkProxy',
+  params: {
+    im?: { /* IM 代理参数 */ },
+    rtc?: { /* TRTC 代理参数 */ },
+  },
+});
+```
+
+### IM 代理参数
+
+|参数|类型|说明|
+|---------|---------|---------|
+|`proxyServer`|String|IM 信令 WebSocket 代理地址。|
+|`fileUploadProxy`|String|IM 文件上传代理地址。|
+|`fileDownloadProxy`|String|IM 文件下载代理地址。|
+
+### TRTC 代理参数
+
+|参数|类型|说明|
+|---------|---------|---------|
+|`websocketProxy`|String|TRTC 信令 WebSocket 代理地址，如 `wss://proxy.example.com/ws/`。|
+|`turnServer`|Array|TURN 服务器列表，每项含 `url` / `username` / `credential`。|
+|`iceTransportPolicy`|`'relay' \| 'all'`|客户端 ICE 传输策略；内网环境建议设为 `'relay'`，强制连接 TURN server。|
+
+## 示例代码
+
+``` typescript
+import { callExperimentalAPI } from 'tuikit-atomicx-react';
+import { useLoginState, useRoomState } from 'tuikit-atomicx-react/room';
+
+callExperimentalAPI({
+  api: 'setNetworkProxy',
+  params: {
+    im: {
+      proxyServer: 'wss://proxy.example.com:8080',
+      fileUploadProxy: 'https://proxy.example.com:8080',
+      fileDownloadProxy: 'https://proxy.example.com:8080',
+    },
+    rtc: {
+      websocketProxy: 'wss://proxy.example.com/ws/',
+      turnServer: [
+        { url: '14.3.3.3:3478', username: 'turn', credential: 'turn' },
+      ],
+      iceTransportPolicy: 'relay',
+    },
+  },
+});
+
+const { login } = useLoginState();
+await login({ sdkAppId, userId, userSig });
+
+const { createAndJoinRoom } = useRoomState();
+await createAndJoinRoom({ roomId });
+```
+
+## 常见问题
+
+### 用户在外网正常进会，但是内网无法进会？
+
+检查是否在 `login()` 前调用了 `setNetworkProxy`；若已配置仍失败，排查 TURN 端口与代理服务器出站白名单。
+
+### 用户能进会但看不到远端画面、听不到远端声音？
+
+确认 `turnServer` 可达，内网环境将 `iceTransportPolicy` 设为 `'relay'`。
+

package/resource/knowledge/roomkit/core-sdk/vue/device-detection.md

@@ -112,9 +112,6 @@ const handleCameraChange = async (event: Event) => {
 };
 </script>
 
-<style scoped>
-.preview-container {  position: relative;  width: 100%;  max-width: 640px;  margin: 0 auto;}.camera-preview {  width: 100%;  position: relative;  aspect-ratio: 16 / 9;  background-color: #000;  border-radius: 8px;  overflow: hidden;}.loading-overlay {  position: absolute;  inset: 0;  display: flex;  flex-direction: column;  align-items: center;  justify-content: center;  gap: 12px;  background-color: rgba(0, 0, 0, 0.7);  color: white;  border-radius: 8px;}.loading-spinner {  width: 40px;  height: 40px;  border: 4px solid rgba(255, 255, 255, 0.3);  border-top-color: white;  border-radius: 50%;  animation: spin 0.8s linear infinite;}@keyframes spin {  to { transform: rotate(360deg); }}.error-message {  display: flex;  align-items: center;  gap: 8px;  padding: 12px;  margin-top: 12px;  background-color: #ffebee;  color: #c62828;  border-radius: 4px;  font-size: 14px;}.camera-selector {  margin-top: 16px;  display: flex;  align-items: center;  gap: 12px;}.camera-selector label {  font-weight: 500;  min-width: 80px;}.camera-selector select {  flex: 1;  padding: 8px 12px;  border: 1px solid #e0e0e0;  border-radius: 4px;  font-size: 14px;}.control-buttons {  margin-top: 16px;  display: flex;  gap: 12px;}.control-buttons button {  flex: 1;  padding: 12px 24px;  background-color: #1976d2;  color: white;  border: none;  border-radius: 4px;  font-size: 14px;  font-weight: 500;  cursor: pointer;  transition: background-color 0.3s;}.control-buttons button:hover:not(:disabled) {  background-color: #1565c0;}.control-buttons button:disabled {  background-color: #bdbdbd;  cursor: not-allowed;}
-</style>
 ```
 
 【React】
@@ -332,9 +329,6 @@ const handleMicrophoneChange = async (event: Event) => {
 };
 </script>
 
-<style scoped>
-.microphone-test {  width: 100%;  max-width: 640px;  margin: 0 auto;}.volume-display {  padding: 24px;  background-color: #f5f5f5;  border-radius: 8px;  margin-bottom: 16px;}.volume-label {  font-size: 14px;  font-weight: 500;  color: #666;  margin-bottom: 12px;}.volume-bar-container {  width: 100%;  height: 24px;  background-color: #e0e0e0;  border-radius: 12px;  overflow: hidden;  margin-bottom: 8px;}.volume-bar {  height: 100%;  transition: width 0.1s ease;  border-radius: 12px;}.volume-bar.volume-zero {  background-color: #9e9e9e;}.volume-bar.volume-low {  background-color: #ff9800;}.volume-bar.volume-medium {  background-color: #4caf50;}.volume-bar.volume-high {  background-color: #2196f3;}.volume-value {  text-align: center;  font-size: 18px;  font-weight: 600;  color: #333;}.microphone-selector {  display: flex;  align-items: center;  gap: 12px;  margin-bottom: 16px;}.microphone-selector label {  font-weight: 500;  min-width: 80px;}.microphone-selector select {  flex: 1;  padding: 8px 12px;  border: 1px solid #e0e0e0;  border-radius: 4px;  font-size: 14px;}.error-message {  display: flex;  align-items: center;  gap: 8px;  padding: 12px;  margin-bottom: 16px;  background-color: #ffebee;  color: #c62828;  border-radius: 4px;  font-size: 14px;}.control-buttons {  margin-bottom: 12px; display: flex; gap: 8px; }.control-buttons button {  flex: 1; width: 100%;  padding: 12px 24px;  background-color: #1976d2;  color: white;  border: none;  border-radius: 4px;  font-size: 14px;  font-weight: 500;  cursor: pointer;  transition: background-color 0.3s;}.control-buttons button:hover:not(:disabled) {  background-color: #1565c0;}.control-buttons button:disabled {  background-color: #bdbdbd;  cursor: not-allowed;}.test-tip {  display: flex;  align-items: center;  gap: 8px;  padding: 12px;  background-color: #e3f2fd;  color: #1565c0;  border-radius: 4px;  font-size: 13px;}
-</style>
 ```
 
 【React】
@@ -552,9 +546,6 @@ const handleSpeakerChange = async (event: Event) => {
 };
 </script>
 
-<style scoped>
-.speaker-test {  width: 100%;  max-width: 640px;  margin: 0 auto;}.speaker-selector {  display: flex;  align-items: center;  gap: 12px;  margin-bottom: 24px;}.speaker-selector label {  font-weight: 500;  min-width: 80px;}.speaker-selector select {  flex: 1;  padding: 8px 12px;  border: 1px solid #e0e0e0;  border-radius: 4px;  font-size: 14px;}.volume-slider-container {  display: flex;  align-items: center;  gap: 12px;}.volume-slider {  flex: 1;  height: 6px;  border-radius: 3px;  background: #e0e0e0;  outline: none;  -webkit-appearance: none;}.volume-slider::-webkit-slider-thumb {  -webkit-appearance: none;  width: 18px;  height: 18px;  border-radius: 50%;  background: #1976d2;  cursor: pointer;}.volume-slider::-moz-range-thumb {  width: 18px;  height: 18px;  border-radius: 50%;  background: #1976d2;  cursor: pointer;  border: none;}.volume-value {  min-width: 50px;  text-align: right;  font-weight: 500;  color: #333;}.control-buttons {  display: flex;  gap: 12px;  margin-bottom: 12px;}button {  flex: 1;  padding: 12px 24px;  background-color: #1976d2;  color: white;  border: none;  border-radius: 4px;  font-size: 14px;  font-weight: 500;  cursor: pointer;  transition: background-color 0.3s;}.control-buttons button:hover:not(:disabled) {  background-color: #1565c0;}.control-buttons button:disabled {  background-color: #bdbdbd;  cursor: not-allowed;}.test-tip {  display: flex;  align-items: center;  gap: 8px;  padding: 12px;  background-color: #e3f2fd;  color: #1565c0;  border-radius: 4px;  font-size: 13px;}
-</style>
 ```
 
 【React】

package/resource/knowledge/roomkit/core-sdk/vue/free-beauty-panel.md

@@ -87,15 +87,6 @@ const openBeautySettings = () => {
 };
 </script>
 
-<style scoped>
-.modal-mask {
-  position: fixed; top: 0; left: 0; width: 100%; height: 100%;
-  background: rgba(0,0,0,0.5); display: flex; justify-content: center; align-items: center; z-index: 1000;
-}
-.modal-content { background: white; width: 600px; border-radius: 8px; overflow: hidden; }
-.modal-header { padding: 16px; display: flex; justify-content: space-between; border-bottom: 1px solid #eee; }
-.modal-body { padding: 16px; }
-</style>
 ```
 
 该组件内部逻辑如下：

package/resource/knowledge/roomkit/core-sdk/vue/network-proxy.md

@@ -0,0 +1,84 @@
+视频会议 SDK 基于腾讯云即时通信 IM 与实时音视频 TRTC 提供服务，支持在内网 / 防火墙环境下统一配置 IM 与 TRTC 代理，适用于私有化部署、企业内网隔离等无法直连腾讯云服务的场景。
+
+## 代理架构
+
+|代理服务器|代理链路|
+|---------|---------|
+|IM 代理|代理 IM 登录、消息收发等信令通道（WebSocket），以及聊天图片、文件等资源的上传与下载。|
+|TRTC WebSocket 代理（如 Nginx）|代理 TRTC 进房、控制等信令通道（WebSocket），负责房间管理与用户状态同步。|
+|TRTC TURN Server|中继转发 TRTC 音视频媒体流。|
+
+> **说明：**
+> 代理服务器（IM 代理、Nginx、TURN）需自行部署，搭建方式参见 [TRTC Web SDK 应对防火墙受限](https://web.sdk.qcloud.com/trtc/webrtc/v5/doc/zh-cn/tutorial-34-advanced-proxy.html)。
+>
+
+## 接口与参数
+
+视频会议 SDK 支持用户在调用 `login()` 之前通过 `callExperimentalAPI` 接口统一配置内网代理：
+``` typescript
+callExperimentalAPI({
+  api: 'setNetworkProxy',
+  params: {
+    im?: { /* IM 代理参数 */ },
+    rtc?: { /* TRTC 代理参数 */ },
+  },
+});
+```
+
+### IM 代理参数
+
+|参数|类型|说明|
+|---------|---------|---------|
+|`proxyServer`|String|IM 信令 WebSocket 代理地址。|
+|`fileUploadProxy`|String|IM 文件上传代理地址。|
+|`fileDownloadProxy`|String|IM 文件下载代理地址。|
+
+### TRTC 代理参数
+
+|参数|类型|说明|
+|---------|---------|---------|
+|`websocketProxy`|String|TRTC 信令 WebSocket 代理地址，如 `wss://proxy.example.com/ws/`。|
+|`turnServer`|Array|TURN 服务器列表，每项含 `url` / `username` / `credential`。|
+|`iceTransportPolicy`|`'relay' \| 'all'`|客户端 ICE 传输策略；内网环境建议设为 `'relay'`，强制连接 TURN server。|
+
+## 示例代码
+
+``` typescript
+import { callExperimentalAPI } from 'tuikit-atomicx-vue3';
+import { useLoginState, useRoomState } from 'tuikit-atomicx-vue3/room';
+
+callExperimentalAPI({
+  api: 'setNetworkProxy',
+  params: {
+    im: {
+      proxyServer: 'wss://proxy.example.com:8080',
+      fileUploadProxy: 'https://proxy.example.com:8080',
+      fileDownloadProxy: 'https://proxy.example.com:8080',
+    },
+    rtc: {
+      websocketProxy: 'wss://proxy.example.com/ws/',
+      turnServer: [
+        { url: '14.3.3.3:3478', username: 'turn', credential: 'turn' },
+      ],
+      iceTransportPolicy: 'relay',
+    },
+  },
+});
+
+const { login } = useLoginState();
+await login({ sdkAppId, userId, userSig });
+
+const { createAndJoinRoom } = useRoomState();
+await createAndJoinRoom({ roomId });
+```
+
+## 常见问题
+
+### 用户在外网正常进会，但是内网无法进会？
+
+检查是否在 `login()` 前调用了 `setNetworkProxy`；若已配置仍失败，排查 TURN 端口与代理服务器出站白名单。
+
+### 用户能进会但看不到远端画面、听不到远端声音？
+
+确认 `turnServer` 可达，内网环境将 `iceTransportPolicy` 设为 `'relay'`。
+

package/resource/knowledge/roomkit/core-sdk/vue/recording.md

@@ -0,0 +1,245 @@
+本篇文档旨在指导开发者在标准会议无 UI 集成方案中实现云端录制能力。您可以通过 `useRoomState()` 提供的 `startRecording()` / `stopRecording()` 控制录制的发起与停止，并通过 `currentRoom.recordingInfo` 与 `RoomEvent` 实时监听录制状态变化。
+
+> **版本说明：**
+>
+> 云端录制接口（`startRecording` / `stopRecording`）自 **tuikit-atomicx-vue3 6.4.0** 和 **tuikit-atomicx-react 6.2.0** 起支持，请确认您使用的版本满足要求。
+>
+
+## 前提条件
+- 用户已通过 `useLoginState` 完成登录鉴权。
+
+- 用户已通过 `useRoomState` 进入标准会议房间。
+
+- 已完成云端录制套餐开通及存储配置：
+
+  - 购买含云录制能力的视频会议 SDK 套餐。
+
+  - 开通录制文件存储服务：录制文件支持存储至 [云点播（VOD）](https://console.cloud.tencent.com/vod) 或 [对象存储（COS）](https://console.cloud.tencent.com/cos)，请在对应控制台完成开通并记录存储信息。
+
+  - [提交工单](https://console.cloud.tencent.com/workorder/category)，选择**实时音视频**产品，申请为您的 SDKAppID 配置云端录制存储信息。
+
+## 录制效果
+
+视频会议 SDK 默认采用**合流录制**模式，将房间内发布的音视频流混合为一份完整的录制文件。录制布局会随会中状态**自动切换**，切换过程中不重启录制任务：
+
+|**会中状态**|**混流布局**|**画面数量上限**|
+|---------|---------|---------|
+|无屏幕分享 / 白板|九宫格布局|最多 **25** 路视频画面|
+|有屏幕分享 / 白板|屏幕分享布局（共享为主画面）|最多 **1** 路屏幕分享 + **16** 路视频画面|
+|仅音频|-|—|
+
+## 接口说明
+
+视频会议 SDK 无 UI 集成通过 `useRoomState()` 提供录制控制与状态订阅能力，录制任务由服务端全程托管，客户端仅负责发起与停止。
+
+|**类型**|**名称**|**说明**|
+|---------|---------|---------|
+|方法|`startRecording(): Promise<void>`|发起云端录制。仅**房主或管理员**可调用，须在进房成功后调用。|
+|方法|`stopRecording(): Promise<void>`|停止云端录制。仅**房主或管理员**可调用。|
+|状态|`currentRoom.recordingInfo`|当前房间的录制信息，含 `status` 字段（`RecordingStatus.Recording` 表示录制中）。|
+|事件|`RoomEvent.onRecordingStarted`|录制任务启动成功时触发，回调参数为 `{ roomInfo, operator }`。|
+|事件|`RoomEvent.onRecordingStopped`|录制任务停止时触发，回调参数为 `{ roomInfo, operator, reason }`。`reason` 可区分主动停止与异常中断。|
+
+## 步骤1：发起云端录制
+
+### 权限要求
+
+仅**房主或管理员**可调用 `startRecording()`，其他角色调用将抛出权限错误。同一房间内同时只能存在一个录制任务，重复调用也会返回错误。
+
+### 示例代码
+
+【Vue3】
+``` typescript
+import { useRoomState } from 'tuikit-atomicx-vue3/room';
+
+const { startRecording } = useRoomState();
+
+await startRecording();
+```
+
+【React】
+``` typescript
+import { useRoomState } from 'tuikit-atomicx-react/room';
+
+const { startRecording } = useRoomState();
+
+await startRecording();
+```
+
+### 错误处理
+
+`startRecording()` 调用失败时会抛出错误，常见错误情况如下：
+
+|**错误码**|**含义**|**处理建议**|
+|---------|---------|---------|
+|`100001`|后端系统错误。|稍后重试；若持续出现，请提交工单排查。|
+|`100004`|房间不存在。|确认已通过 `createAndJoinRoom()` 或 `joinRoom()` 进房成功后再调用录制接口。|
+|`100006`|没有权限，必须是房主或管理员。|检查当前用户角色，仅房主或管理员可发起录制。|
+|`101072`|录制配置不存在或未启用。|确认已完成控制台套餐开通、工单配置及增值功能开关，参考本文「前提条件」。|
+
+【Vue3】
+``` typescript
+import { useRoomState } from 'tuikit-atomicx-vue3/room';
+
+const { startRecording } = useRoomState();
+
+try {
+  await startRecording();
+} catch (error: any) {
+  switch (error?.code) {
+    case 100001:
+      console.error('后端系统错误，请稍后重试。');
+      break;
+    case 100004:
+      console.error('房间不存在，请确认已进房后再发起录制。');
+      break;
+    case 100006:
+      console.error('权限不足，仅房主或管理员可发起录制。');
+      break;
+    case 101072:
+      console.error('录制配置不存在或未启用，请检查控制台开通配置。');
+      break;
+    default:
+      console.error('发起录制失败：', error);
+  }
+}
+```
+
+【React】
+``` typescript
+import { useRoomState } from 'tuikit-atomicx-react/room';
+
+const { startRecording } = useRoomState();
+
+try {
+  await startRecording();
+} catch (error: any) {
+  switch (error?.code) {
+    case 100001:
+      console.error('后端系统错误，请稍后重试。');
+      break;
+    case 100002:
+      console.error('参数错误，请检查传入参数。');
+      break;
+    case 100004:
+      console.error('房间不存在，请确认已进房后再发起录制。');
+      break;
+    case 100006:
+      console.error('权限不足，仅房主或管理员可发起录制。');
+      break;
+    case 101072:
+      console.error('录制配置不存在或未启用，请检查控制台开通配置。');
+      break;
+    default:
+      console.error('发起录制失败：', error);
+  }
+}
+```
+
+## 步骤2：停止云端录制
+
+### 前置条件
+
+当前房间内有进行中的录制任务（`RecordingStatus.Recording`）。
+
+### 权限要求
+
+仅**房主或管理员**可调用 `stopRecording()`。
+
+### 示例代码
+
+【Vue3】
+``` typescript
+import { useRoomState } from 'tuikit-atomicx-vue3/room';
+
+const { stopRecording } = useRoomState();
+
+try {
+  await stopRecording();
+} catch (error: any) {
+  console.error('停止录制失败：', error);
+}
+```
+
+【React】
+``` typescript
+import { useRoomState } from 'tuikit-atomicx-react/room';
+
+const { stopRecording } = useRoomState();
+
+try {
+  await stopRecording();
+} catch (error: any) {
+  console.error('停止录制失败：', error);
+}
+```
+
+## 步骤3：监听录制状态变化
+
+### 前置条件
+- 已进房成功。
+
+- 建议在进房后**立即**订阅事件，避免遗漏由其他端（例如移动端房主）发起的录制通知。
+
+### 示例代码
+
+【Vue3】
+``` typescript
+import { useRoomState, RecordingStatus, RecordingStopReason, RoomEvent } from 'tuikit-atomicx-vue3/room';
+
+const { currentRoom, subscribeEvent } = useRoomState();
+
+// 主动查询当前录制状态
+const isRecording = currentRoom.value?.recordingInfo?.status === RecordingStatus.Recording;
+
+// 监听录制开始
+subscribeEvent(RoomEvent.onRecordingStarted, ({ operator }) => {
+  console.log('录制已开始，操作人：', operator.userId);
+});
+
+// 监听录制停止
+subscribeEvent(RoomEvent.onRecordingStopped, ({ operator, reason }) => {
+  if (reason === RecordingStopReason.StoppedByUser) {
+    console.log('录制已停止，操作人：', operator.userId);
+  } else if (reason === RecordingStopReason.RecorderLeftRoom) {
+    console.warn('录制异常中断，录制机器人已退出房间，请视需要重新发起录制。');
+  }
+});
+```
+
+【React】
+``` typescript
+import { useRoomState, RecordingStatus, RecordingStopReason, RoomEvent } from 'tuikit-atomicx-react/room';
+
+const { currentRoom, subscribeEvent } = useRoomState();
+
+// 主动查询当前录制状态
+const isRecording = currentRoom?.recordingInfo?.status === RecordingStatus.Recording;
+
+// 监听录制开始
+subscribeEvent(RoomEvent.onRecordingStarted, ({ operator }) => {
+  console.log('录制已开始，操作人：', operator.userId);
+});
+
+// 监听录制停止
+subscribeEvent(RoomEvent.onRecordingStopped, ({ operator, reason }) => {
+  if (reason === RecordingStopReason.StoppedByUser) {
+    console.log('录制已停止，操作人：', operator.userId);
+  } else if (reason === RecordingStopReason.RecorderLeftRoom) {
+    console.warn('录制异常中断，录制机器人已退出房间，请视需要重新发起录制。');
+  }
+});
+```
+
+### 错误情况
+
+`onRecordingStopped` 事件的 `reason` 字段标识录制停止原因：
+
+|**枚举值**|**值**|**说明**|
+|---------|---------|---------|
+|`RecordingStopReason.StoppedByUser`|`0`|房主或管理员主动调用 `stopRecording()` 正常停止。|
+|`RecordingStopReason.RecorderLeftRoom`|`1`|录制机器人异常退出房间，录制中断。建议提示用户并视业务需要决定是否重新发起录制。|
+
+> **注意：**
+> - 云端录制功能需提前完成套餐购买、存储服务开通及工单配置，请确认已完成本文**前提条件**中的全部步骤。
+> - 录制文件存储在您配置的云点播（VOD）或对象存储（COS）中，请前往对应控制台查看和管理。

package/resource/knowledge/roomkit/core-sdk/vue/room-chat.md

@@ -144,9 +144,6 @@ const placeholder = computed(() =>
 const messageActionList = useMessageActions(['copy', 'recall', 'delete']);
 </script>
 
-<style scoped>
-.room-chat-container{display:flex;flex-direction:column;height:100%;padding:8px;gap:8px}.message-list{flex:1;overflow:hidden}.message-input{flex-shrink:0;border:1px solid #e0e0e0;border-radius:8px}
-</style>
 ```
 
 【React】