@tencentcloud/sdk-mcp 1.6.7 → 1.7.0

package/resource/knowledge/trtc/c++/ITRTCCloud.md

@@ -175,7 +175,7 @@ TRTC 的所有用户都需要进入房间才能“发布”或“订阅”音视
 
 |参数|描述|
 |---------|---------|
-|param|进房参数，用于指定用户的身份、角色和安全票据等信息，详情请参见  TRTCParams 。|
+|param|进房参数，用于指定用户的身份、角色和安全票据等信息。|
 |scene|应用场景，用于指定您的业务场景，同一个房间内的所有用户需要设定相同的 TRTCAppScene。|
 
 > **注意**
@@ -253,7 +253,7 @@ TRTC 的所有用户都需要进入房间才能“发布”或“订阅”音视
 
 |参数|描述|
 |---------|---------|
-|config|房间参数，详情请参见 TRTCSwitchRoomConfig。|
+|config|房间参数。|
 
 > **注意**
 >
@@ -709,7 +709,7 @@ TRTCCloud 一开始被设计成单例模式，限制了多房间并发观看的
 
 |参数|描述|
 |---------|---------|
-|param|用于设置视频编码器的相关参数，详情请参见 TRTCVideoEncParam。|
+|param|用于设置视频编码器的相关参数。|
 
 > **注意**
 >
@@ -724,7 +724,7 @@ TRTCCloud 一开始被设计成单例模式，限制了多房间并发观看的
 
 |参数|描述|
 |---------|---------|
-|param|用于设置网络质量控制的相关参数，详情请参见 TRTCNetworkQosParam。|
+|param|用于设置网络质量控制的相关参数。|
 
 ## setLocalRenderParams
 
@@ -734,7 +734,7 @@ TRTCCloud 一开始被设计成单例模式，限制了多房间并发观看的
 
 |参数|描述|
 |---------|---------|
-|params|画面渲染参数，详情请参见 TRTCRenderParams。|
+|params|画面渲染参数。|
 
 ## setRemoteRenderParams
 
@@ -744,7 +744,7 @@ TRTCCloud 一开始被设计成单例模式，限制了多房间并发观看的
 
 |参数|描述|
 |---------|---------|
-|params|画面渲染参数，详情请参见 TRTCRenderParams。|
+|params|画面渲染参数。|
 |streamType|可以设置为主路画面（TRTCVideoStreamTypeBig）或辅路画面（TRTCVideoStreamTypeSub）。|
 |userId|指定远端用户的 ID。|
 
@@ -819,7 +819,7 @@ TRTCCloud 一开始被设计成单例模式，限制了多房间并发观看的
 
 |参数|描述|
 |---------|---------|
-|mode|重力感应模式，详情请参见 TRTCGravitySensorAdaptiveMode_Disable、TRTCGravitySensorAdaptiveMode_FillByCenterCrop 和 TRTCGravitySensorAdaptiveMode_FitWithBlackBorder 默认值：TRTCGravitySensorAdaptiveMode_Disable。|
+|mode|重力感应模式。|
 
 ## startLocalAudio
 
@@ -955,7 +955,7 @@ SDK 默认不开启麦克风，当用户需要发布本地音频时，需要调
 |参数|描述|
 |---------|---------|
 |enable|是否启用音量提示，默认为关闭状态。|
-|params|音量评估等相关参数，请参见 TRTCAudioVolumeEvaluateParams。|
+|params|音量评估等相关参数。|
 
 > **注意**
 >
@@ -974,7 +974,7 @@ SDK 默认不开启麦克风，当用户需要发布本地音频时，需要调
 
 |参数|描述|
 |---------|---------|
-|param|录音参数，请参见 TRTCAudioRecordingParams。|
+|param|录音参数。|
 
 > **注意**
 >
@@ -999,7 +999,7 @@ SDK 默认不开启麦克风，当用户需要发布本地音频时，需要调
 
 |参数|描述|
 |---------|---------|
-|params|录制参数，请参见 TRTCLocalRecordingParams。|
+|params|录制参数。|
 
 ## stopLocalRecording
 
@@ -1015,7 +1015,7 @@ SDK 默认不开启麦克风，当用户需要发布本地音频时，需要调
 
 |参数|描述|
 |---------|---------|
-|params|音频并发参数，请参见 TRTCAudioParallelParams。|
+|params|音频并发参数。|
 
 ## enable3DSpatialAudioEffect
 
@@ -1122,7 +1122,7 @@ SDK 默认不开启麦克风，当用户需要发布本地音频时，需要调
 |nHeight|水印图片像素高度（源数据为文件路径时忽略该参数）。|
 |nWidth|水印图片像素宽度（源数据为文件路径时忽略该参数）。|
 |srcData|水印图片源数据（传 nullptr 表示去掉水印）。|
-|srcType|水印图片源数据类型。请参见 TRTCWaterMarkSrcType。|
+|srcType|水印图片源数据类型。。|
 |streamType|要设置水印的流类型（TRTCVideoStreamTypeBig，TRTCVideoStreamTypeSub）。|
 |xOffset|水印显示的左上角 x 轴偏移。|
 |yOffset|水印显示的左上角 y 轴偏移。|
@@ -1299,7 +1299,7 @@ AI 转录管理类 AITranscriberManager。
 
 |参数|描述|
 |---------|---------|
-|param|辅流编码参数，详情请参见 TRTCVideoEncParam。|
+|param|辅流编码参数。|
 
 ## setSubStreamMixVolume
 
@@ -1578,7 +1578,7 @@ AI 转录管理类 AITranscriberManager。
 
 |参数|描述|
 |---------|---------|
-|callback|自定义美颜回调，详见 ITRTCVideoFrameCallback。|
+|callback|自定义美颜回调。|
 
 ## setLocalVideoRenderCallback
 

package/resource/knowledge/trtc/c++/ITXAudioEffectManager.md

@@ -137,7 +137,7 @@ Function: 用于对背景音乐、短音效和人声特效进行设置的管理
 
 **设置人声的混响效果。**
 
-通过该接口您可以设置人声的混响效果，具体特效请参见枚举定义 TXVoiceReverbType。
+通过该接口您可以设置人声的混响效果，具体特效。
 
 > **注意**
 >
@@ -148,7 +148,7 @@ Function: 用于对背景音乐、短音效和人声特效进行设置的管理
 
 **设置人声的变声特效。**
 
-通过该接口您可以设置人声的变声特效，具体特效请参见枚举定义 TXVoiceChangeType。
+通过该接口您可以设置人声的变声特效，具体特效。
 
 > **注意**
 >

package/resource/knowledge/trtc/c++/ITXDeviceManager.md

@@ -134,7 +134,7 @@ Function: 用于管理摄像头、麦克风和扬声器等音视频相关的硬
 
 |参数|描述|
 |---------|---------|
-|type|设备类型，指定需要获取哪种设备的列表。详见 TXMediaDeviceType 定义。|
+|type|设备类型，指定需要获取哪种设备的列表。。|
 
 > **注意**
 >
@@ -150,7 +150,7 @@ Function: 用于管理摄像头、麦克风和扬声器等音视频相关的硬
 |参数|描述|
 |---------|---------|
 |deviceId|设备 ID，您可以通过接口 getDevicesList 获得设备 ID。|
-|type|设备类型，详见 TXMediaDeviceType 定义。|
+|type|设备类型。|
 **返回值说明：**
 
 0：操作成功；负数：操作失败。
@@ -195,7 +195,7 @@ Function: 用于管理摄像头、麦克风和扬声器等音视频相关的硬
 | 参数 | 描述 |
 | --- | --- |
 | enable | 是否跟随系统默认的音频设备。<br>-  true：跟随。当系统默认音频设备发生改变或者有新音频设备插入时，SDK 立即切换音频设备。<br>-  false：不跟随。当系统默认音频设备发生改变或者有新音频设备插入时，SDK 不会切换音频设备。 |
-| type | 设备类型，详见 TXMediaDeviceType 定义。 |
+| type | 设备类型。 |
 
 ## startCameraDeviceTest
 
@@ -375,7 +375,7 @@ SDK 目前提供了三种系统音量类型的控制模式：自动切换模式
 |枚举类型|描述|
 |---------|---------|
 |height|**字段含义：** 采集图像宽度|
-|mode|**字段含义：** 摄像头采集偏好，请参见 TXCameraCaptureMode|
+|mode|**字段含义：** 摄像头采集偏好，
 |width|**字段含义：** 采集图像长度|
 
 ## TXMediaDeviceInfo

package/resource/knowledge/trtc/c++/TRTCCloudCallback.md

@@ -433,7 +433,7 @@ SDK 会使用一组内嵌的自研算法对当前网络的延迟高低、带宽
 
 |参数|描述|
 |---------|---------|
-|statistics|统计数据，包括自己本地的统计信息和远端用户的统计信息，详情请参考 TRTCStatistics。|
+|statistics|统计数据，包括自己本地的统计信息和远端用户的统计信息。|
 
 > **注意**
 >
@@ -448,7 +448,7 @@ SDK 会使用一组内嵌的自研算法对当前网络的延迟高低、带宽
 
 |参数|描述|
 |---------|---------|
-|result|网速测试结果，包括丢包、往返延迟、上下行的带宽速率，详情请参见 TRTCSpeedTestResult。|
+|result|网速测试结果，包括丢包、往返延迟、上下行的带宽速率。|
 
 ## onConnectionLost
 
@@ -1131,6 +1131,6 @@ int onProcessVideoFrame(TRTCVideoFrame *srcFrame, TRTCVideoFrame *dstFrame) {
 
 |参数|描述|
 |---------|---------|
-|level|日志等级请参见 TRTC_LOG_LEVEL。|
+|level|日志等级。|
 |log|日志内容。|
 |module|保留字段，暂无具体意义，目前为固定值  `TXLiteAVSDK` 。|

package/resource/knowledge/trtc/c++/TRTCTypeDef.md

@@ -567,7 +567,7 @@ v11.7 版本开始支持，只在 SDK 内部摄像头采集场景生效
 | enableAdjustRes | 【字段含义】是否允许动态调整分辨率（开启后会对云端录制产生影响）。<br>【推荐取值】该功能适用于不需要云端录制的场景，开启后 SDK 会根据当前网络情况，智能选择出一个合适的分辨率，避免出现“大分辨率+小码率”的低效编码模式。<br>【特别说明】默认值：关闭。如有云端录制的需求，请不要开启此功能，因为如果视频分辨率发生变化后，云端录制出的 MP4 在普通的播放器上无法正常播放。 |
 | minVideoBitrate | 【字段含义】最低视频码率，SDK 会在网络不佳的情况下主动降低视频码率以保持流畅度，最低会降至 minVideoBitrate 所设定的数值。<br>【特别说明】 默认值：0，此时最低码率由 SDK 会根据您指定的分辨率，自动计算出合适的数值。<br>【推荐取值】您可以通过同时设置 videoBitrate 和 minVideoBitrate 两个参数，用于约束 SDK 对视频码率的调整范围：<br>-  如果您追求 <code>弱网络下允许卡顿但要保持清晰</code> 的效果，可以设置 minVideoBitrate 为 videoBitrate 的 60%。<br>-  如果您追求 <code>弱网络下允许模糊但要保持流畅</code> 的效果，可以设置 minVideoBitrate 为一个较低的数值（例如 100kbps）。<br>-  如果您将 videoBitrate 和 minVideoBitrate 设置为同一个值，等价于关闭 SDK 对视频码率的自适应调节能力。 |
 | resMode | 【字段含义】分辨率模式（横屏分辨率 or 竖屏分辨率）。<br>【推荐取值】手机平台（iOS、Android）建议选择 Portrait，桌面平台（Windows、Mac）建议选择 Landscape。<br>【特别说明】如需使用竖屏分辨率，请指定 resMode 为 Portrait，例如：  <code>640 × 360 + Portrait = 360 × 640</code> 。 |
-| videoBitrate | 【字段含义】目标视频码率，SDK 会按照目标码率进行编码，只有在弱网络环境下才会主动降低视频码率。<br>【推荐取值】请参见本 TRTCVideoResolution 在各档位注释的最佳码率，也可以在此基础上适当调高。例如：TRTCVideoResolution_1280_720 对应 1200kbps 的目标码率，您也可以设置为 1500kbps 用来获得更好的观感清晰度。<br>【特别说明】您可以通过同时设置 videoBitrate 和 minVideoBitrate 两个参数，用于约束 SDK 对视频码率的调整范围：<br>-  如果您追求“弱网络下允许卡顿但要保持清晰”的效果，可以设置 minVideoBitrate 为 videoBitrate 的 60%。<br>-  如果您追求“弱网络下允许模糊但要保持流畅”的效果，可以设置 minVideoBitrate 为一个较低的数值（例如 100kbps）。<br>-  如果您将 videoBitrate 和 minVideoBitrate 设置为同一个值，等价于关闭 SDK 对视频码率的自适应调节能力。 |
+| videoBitrate | 【字段含义】目标视频码率，SDK 会按照目标码率进行编码，只有在弱网络环境下才会主动降低视频码率。<br>【推荐取值】。例如：TRTCVideoResolution_1280_720 对应 1200kbps 的目标码率，您也可以设置为 1500kbps 用来获得更好的观感清晰度。<br>【特别说明】您可以通过同时设置 videoBitrate 和 minVideoBitrate 两个参数，用于约束 SDK 对视频码率的调整范围：<br>- 如果您追求“弱网络下允许卡顿但要保持清晰”的效果，可以设置 minVideoBitrate 为 videoBitrate 的 60%。<br>- 如果您追求“弱网络下允许模糊但要保持流畅”的效果，可以设置 minVideoBitrate 为一个较低的数值（例如 100kbps）。<br>- 如果您将 videoBitrate 和 minVideoBitrate 设置为同一个值，等价于关闭 SDK 对视频码率的自适应调节能力。 |
 | videoFps | 【字段含义】视频采集帧率。<br>【推荐取值】15fps或20fps。5fps以下，卡顿感明显。10fps以下，会有轻微卡顿感。20fps以上，会浪费带宽（电影的帧率为24fps）。<br>【特别说明】部分 Android 手机的前置摄像头并不支持15fps以上的采集帧率，部分主打美颜功能的 Android 手机的前置摄像头的采集帧率可能低于10fps。 |
 | videoResolution | 【字段含义】视频分辨率。<br>【特别说明】如需使用竖屏分辨率，请指定 resMode 为 Portrait，例如：  <code>640 × 360 + Portrait = 360 × 640</code> 。<br>【推荐取值】<br>-  手机视频通话：建议选择 360 × 640 及以下分辨率，resMode 选择 Portrait，即竖屏分辨率。<br>-  手机在线直播：建议选择 540 × 960，resMode 选择 Portrait，即竖屏分辨率。<br>-  桌面平台（Win + Mac）：建议选择 640 × 360 及以上分辨率，resMode 选择 Landscape，即横屏分辨率。 |
 
@@ -627,9 +627,9 @@ v11.7 版本开始支持，只在 SDK 内部摄像头采集场景生效
 | expectedDownBandwidth | 预期的下行带宽（kbps，取值范围：[10, 5000]，为 0 时不测试）。<br><strong>注意</strong><br>当参数 scene 设置为 TRTCSpeedTestScene_OnlineChorusTesting 时，为了获取更准确的  <code>rtt / jitter</code>  等信息，取值范围限制为 [10, 1000]。 |
 | expectedUpBandwidth | 预期的上行带宽（kbps，取值范围： [10, 5000]，为 0 时不测试）。<br><strong>注意</strong><br>当参数 scene 设置为 TRTCSpeedTestScene_OnlineChorusTesting 时，为了获取更准确的  <code>rtt / jitter</code>  等信息，取值范围限制为 [10, 1000]。 |
 | scene | 测速场景。 |
-| sdkAppId | 应用标识，请参见 TRTCParams 中的相关说明。 |
-| userId | 用户标识，请参见 TRTCParams 中的相关说明。 |
-| userSig | 用户签名，请参见 TRTCParams 中的相关说明。 |
+| sdkAppId | 应用标识。 |
+| userId | 用户标识。 |
+| userSig | 用户签名。 |
 
 ## TRTCSpeedTestResult
 
@@ -645,7 +645,7 @@ v11.7 版本开始支持，只在 SDK 内部摄像头采集场景生效
 |downLostRate|下行丢包率，取值范围是 [0 - 1.0]，例如 0.2 表示每从服务器收取 10 个数据包可能会在中途丢失 2 个。|
 |errMsg|带宽测试错误信息。|
 |ip|服务器 IP 地址。|
-|quality|内部通过评估算法测算出的网络质量，更多信息请参见 TRTCQuality。|
+|quality|内部通过评估算法测算出的网络质量。|
 |rtt|延迟（毫秒），指当前设备到 TRTC 服务器的一次网络往返时间，该值越小越好，正常数值范围是10ms - 100ms。|
 |success|测试是否成功。|
 |upJitter|上行数据包抖动（ms)，指用户当前网络环境下数据通信的稳定性，该值越小越好，正常数值范围是 [0, 100]，-1 代表此次测速没有成功测得有效值，一般情况下 Wi-Fi 网络的 Jitter 会比 4G/5G 环境稍大。|

package/resource/knowledge/trtc/ios/TRTCCloud.md

@@ -186,7 +186,7 @@ TRTC 的所有用户都需要进入房间才能“发布”或“订阅”音视
 
 |参数|描述|
 |---------|---------|
-|param|进房参数，用于指定用户的身份、角色和安全票据等信息，详情请参见  TRTCParams 。|
+|param|进房参数，用于指定用户的身份、角色和安全票据等信息。|
 |scene|应用场景，用于指定您的业务场景，同一个房间内的所有用户需要设定相同的 TRTCAppScene。|
 
 > **注意**
@@ -264,7 +264,7 @@ TRTC 的所有用户都需要进入房间才能“发布”或“订阅”音视
 
 |参数|描述|
 |---------|---------|
-|config|房间参数，详情请参见 TRTCSwitchRoomConfig。|
+|config|房间参数。|
 
 > **注意**
 >
@@ -720,7 +720,7 @@ TRTCCloud 一开始被设计成单例模式，限制了多房间并发观看的
 
 |参数|描述|
 |---------|---------|
-|param|用于设置视频编码器的相关参数，详情请参见 TRTCVideoEncParam。|
+|param|用于设置视频编码器的相关参数。|
 
 > **注意**
 >
@@ -735,7 +735,7 @@ TRTCCloud 一开始被设计成单例模式，限制了多房间并发观看的
 
 |参数|描述|
 |---------|---------|
-|param|用于设置网络质量控制的相关参数，详情请参见 TRTCNetworkQosParam。|
+|param|用于设置网络质量控制的相关参数。|
 
 ## setLocalRenderParams:
 
@@ -745,7 +745,7 @@ TRTCCloud 一开始被设计成单例模式，限制了多房间并发观看的
 
 |参数|描述|
 |---------|---------|
-|params|画面渲染参数，详情请参见 TRTCRenderParams。|
+|params|画面渲染参数。|
 
 ## setRemoteRenderParams:streamType:params:
 
@@ -755,7 +755,7 @@ TRTCCloud 一开始被设计成单例模式，限制了多房间并发观看的
 
 |参数|描述|
 |---------|---------|
-|params|画面渲染参数，详情请参见 TRTCRenderParams。|
+|params|画面渲染参数。|
 |streamType|可以设置为主路画面（TRTCVideoStreamTypeBig）或辅路画面（TRTCVideoStreamTypeSub）。|
 |userId|指定远端用户的 ID。|
 
@@ -842,7 +842,7 @@ TRTCCloud 一开始被设计成单例模式，限制了多房间并发观看的
 
 |参数|描述|
 |---------|---------|
-|mode|重力感应模式，详情请参见 TRTCGravitySensorAdaptiveMode_Disable、TRTCGravitySensorAdaptiveMode_FillByCenterCrop 和 TRTCGravitySensorAdaptiveMode_FitWithBlackBorder 默认值：TRTCGravitySensorAdaptiveMode_Disable。|
+|mode|重力感应模式。|
 
 ## startLocalAudio:
 
@@ -994,7 +994,7 @@ SDK 默认不开启麦克风，当用户需要发布本地音频时，需要调
 |参数|描述|
 |---------|---------|
 |enable|是否启用音量提示，默认为关闭状态。|
-|params|音量评估等相关参数，请参见 TRTCAudioVolumeEvaluateParams。|
+|params|音量评估等相关参数。|
 
 > **注意**
 >
@@ -1013,7 +1013,7 @@ SDK 默认不开启麦克风，当用户需要发布本地音频时，需要调
 
 |参数|描述|
 |---------|---------|
-|param|录音参数，请参见 TRTCAudioRecordingParams。|
+|param|录音参数。|
 
 > **注意**
 >
@@ -1038,7 +1038,7 @@ SDK 默认不开启麦克风，当用户需要发布本地音频时，需要调
 
 |参数|描述|
 |---------|---------|
-|params|录制参数，请参见 TRTCLocalRecordingParams。|
+|params|录制参数。|
 
 ## stopLocalRecording
 
@@ -1054,7 +1054,7 @@ SDK 默认不开启麦克风，当用户需要发布本地音频时，需要调
 
 |参数|描述|
 |---------|---------|
-|params|音频并发参数，请参见 TRTCAudioParallelParams。|
+|params|音频并发参数。|
 
 ## enable3DSpatialAudioEffect:
 
@@ -1166,7 +1166,7 @@ SDK 默认不开启麦克风，当用户需要发布本地音频时，需要调
 |---------|---------|
 |image|水印图片，**必须使用透明底色的 png 格式**。|
 |rect|水印相对于编码分辨率的归一化坐标，x，y，width，height 取值范围 [0, 1]。|
-|streamType|指定给哪一路画面设置水印，详情请参见TRTCVideoStreamType。|
+|streamType|指定给哪一路画面设置水印。|
 
 > **注意**
 >
@@ -1364,7 +1364,7 @@ iPhone 推荐的屏幕分享视频编码参数（TRTCVideoEncParam）：
 
 |参数|描述|
 |---------|---------|
-|param|辅流编码参数，详情请参见 TRTCVideoEncParam。|
+|param|辅流编码参数。|
 
 ## setSubStreamMixVolume:
 
@@ -1625,7 +1625,7 @@ iPhone 推荐的屏幕分享视频编码参数（TRTCVideoEncParam）：
 |参数|描述|
 |---------|---------|
 |bufferType|指定回调的数据格式，目前仅支持 TRTCVideoBufferType_Texture。|
-|delegate|自定义预处理回调，详见 TRTCVideoFrameDelegate。|
+|delegate|自定义预处理回调。|
 |pixelFormat|指定回调的像素格式，目前仅支持 TRTCVideoPixelFormat_Texture_2D。|
 **返回值说明：**
 

package/resource/knowledge/trtc/ios/TRTCCloudDelegate.md

@@ -426,7 +426,7 @@ SDK 会使用一组内嵌的自研算法对当前网络的延迟高低、带宽
 
 |参数|描述|
 |---------|---------|
-|statistics|统计数据，包括自己本地的统计信息和远端用户的统计信息，详情请参考 TRTCStatistics。|
+|statistics|统计数据，包括自己本地的统计信息和远端用户的统计信息。|
 
 > **注意**
 >
@@ -441,7 +441,7 @@ SDK 会使用一组内嵌的自研算法对当前网络的延迟高低、带宽
 
 |参数|描述|
 |---------|---------|
-|result|网速测试结果，包括丢包、往返延迟、上下行的带宽速率，详情请参见 TRTCSpeedTestResult。|
+|result|网速测试结果，包括丢包、往返延迟、上下行的带宽速率。|
 
 ## onConnectionLost
 
@@ -1070,6 +1070,6 @@ uint32_t onProcessVideoFrame(TRTCVideoFrame * _Nonnull)srcFrame dstFrame:(TRTCVi
 
 |参数|描述|
 |---------|---------|
-|level|日志等级请参见 TRTC_LOG_LEVEL。|
+|level|日志等级。|
 |log|日志内容。|
 |module|保留字段，暂无具体意义，目前为固定值  `TXLiteAVSDK` 。|

package/resource/knowledge/trtc/ios/TXAudioEffectManager.md

@@ -82,7 +82,7 @@ Function: 用于对背景音乐、短音效和人声特效进行设置的管理
 
 **设置人声的混响效果。**
 
-通过该接口您可以设置人声的混响效果，具体特效请参见枚举定义 TXVoiceReverbType。
+通过该接口您可以设置人声的混响效果，具体特效。
 
 > **注意**
 >
@@ -93,7 +93,7 @@ Function: 用于对背景音乐、短音效和人声特效进行设置的管理
 
 **设置人声的变声特效。**
 
-通过该接口您可以设置人声的变声特效，具体特效请参见枚举定义 TXVoiceChangeType。
+通过该接口您可以设置人声的变声特效，具体特效。
 
 > **注意**
 >

package/resource/knowledge/trtc/ios/TXDeviceManager.md

@@ -161,7 +161,7 @@ Function: 用于管理摄像头、麦克风和扬声器等音视频相关的硬
 
 |参数|描述|
 |---------|---------|
-|type|设备类型，指定需要获取哪种设备的列表。详见 TXMediaDeviceType 定义。|
+|type|设备类型，指定需要获取哪种设备的列表。。|
 
 > **注意**
 >
@@ -177,7 +177,7 @@ Function: 用于管理摄像头、麦克风和扬声器等音视频相关的硬
 |参数|描述|
 |---------|---------|
 |deviceId|设备 ID，您可以通过接口 getDevicesList 获得设备 ID。|
-|type|设备类型，详见 TXMediaDeviceType 定义。|
+|type|设备类型。|
 **返回值说明：**
 
 0：操作成功；负数：操作失败。
@@ -222,7 +222,7 @@ Function: 用于管理摄像头、麦克风和扬声器等音视频相关的硬
 | 参数 | 描述 |
 | --- | --- |
 | enable | 是否跟随系统默认的音频设备。<br>-  true：跟随。当系统默认音频设备发生改变或者有新音频设备插入时，SDK 立即切换音频设备。<br>-  false：不跟随。当系统默认音频设备发生改变或者有新音频设备插入时，SDK 不会切换音频设备。 |
-| type | 设备类型，详见 TXMediaDeviceType 定义。 |
+| type | 设备类型。 |
 
 ## startCameraDeviceTest:
 
@@ -380,7 +380,7 @@ SDK 目前提供了三种系统音量类型的控制模式：自动切换模式
 |枚举类型|描述|
 |---------|---------|
 |height|**字段含义：** 采集图像宽度|
-|mode|**字段含义：** 摄像头采集偏好，请参见 TXCameraCaptureMode|
+|mode|**字段含义：** 摄像头采集偏好，
 |width|**字段含义：** 采集图像长度|
 
 ## TXMediaDeviceInfo

package/resource/knowledge/trtc/ios/TXLiveSDKTypeDef.md

@@ -626,7 +626,7 @@ v11.7 版本开始支持，只在 SDK 内部摄像头采集场景生效
 | enableAdjustRes | 【字段含义】是否允许动态调整分辨率（开启后会对云端录制产生影响）。<br>【推荐取值】该功能适用于不需要云端录制的场景，开启后 SDK 会根据当前网络情况，智能选择出一个合适的分辨率，避免出现“大分辨率+小码率”的低效编码模式。<br>【特别说明】默认值：关闭。如有云端录制的需求，请不要开启此功能，因为如果视频分辨率发生变化后，云端录制出的 MP4 在普通的播放器上无法正常播放。 |
 | minVideoBitrate | 【字段含义】最低视频码率，SDK 会在网络不佳的情况下主动降低视频码率以保持流畅度，最低会降至 minVideoBitrate 所设定的数值。<br>【特别说明】 默认值：0，此时最低码率由 SDK 会根据您指定的分辨率，自动计算出合适的数值。<br>【推荐取值】您可以通过同时设置 videoBitrate 和 minVideoBitrate 两个参数，用于约束 SDK 对视频码率的调整范围：<br>-  如果您追求 <code>弱网络下允许卡顿但要保持清晰</code> 的效果，可以设置 minVideoBitrate 为 videoBitrate 的 60%。<br>-  如果您追求 <code>弱网络下允许模糊但要保持流畅</code> 的效果，可以设置 minVideoBitrate 为一个较低的数值（例如 100kbps）。<br>-  如果您将 videoBitrate 和 minVideoBitrate 设置为同一个值，等价于关闭 SDK 对视频码率的自适应调节能力。 |
 | resMode | 【字段含义】分辨率模式（横屏分辨率 or 竖屏分辨率）。<br>【推荐取值】手机平台（iOS、Android）建议选择 Portrait，桌面平台（Windows、Mac）建议选择 Landscape。<br>【特别说明】如需使用竖屏分辨率，请指定 resMode 为 Portrait，例如：  <code>640 × 360 + Portrait = 360 × 640</code> 。 |
-| videoBitrate | 【字段含义】目标视频码率，SDK 会按照目标码率进行编码，只有在弱网络环境下才会主动降低视频码率。<br>【推荐取值】请参见本 TRTCVideoResolution 在各档位注释的最佳码率，也可以在此基础上适当调高。例如：TRTCVideoResolution_1280_720 对应 1200kbps 的目标码率，您也可以设置为 1500kbps 用来获得更好的观感清晰度。<br>【特别说明】您可以通过同时设置 videoBitrate 和 minVideoBitrate 两个参数，用于约束 SDK 对视频码率的调整范围：<br>-  如果您追求“弱网络下允许卡顿但要保持清晰”的效果，可以设置 minVideoBitrate 为 videoBitrate 的 60%。<br>-  如果您追求“弱网络下允许模糊但要保持流畅”的效果，可以设置 minVideoBitrate 为一个较低的数值（例如 100kbps）。<br>-  如果您将 videoBitrate 和 minVideoBitrate 设置为同一个值，等价于关闭 SDK 对视频码率的自适应调节能力。 |
+| videoBitrate | 【字段含义】目标视频码率，SDK 会按照目标码率进行编码，只有在弱网络环境下才会主动降低视频码率。<br>【推荐取值】。例如：TRTCVideoResolution_1280_720 对应 1200kbps 的目标码率，您也可以设置为 1500kbps 用来获得更好的观感清晰度。<br>【特别说明】您可以通过同时设置 videoBitrate 和 minVideoBitrate 两个参数，用于约束 SDK 对视频码率的调整范围：<br>- 如果您追求“弱网络下允许卡顿但要保持清晰”的效果，可以设置 minVideoBitrate 为 videoBitrate 的 60%。<br>- 如果您追求“弱网络下允许模糊但要保持流畅”的效果，可以设置 minVideoBitrate 为一个较低的数值（例如 100kbps）。<br>- 如果您将 videoBitrate 和 minVideoBitrate 设置为同一个值，等价于关闭 SDK 对视频码率的自适应调节能力。 |
 | videoFps | 【字段含义】视频采集帧率。<br>【推荐取值】15fps或20fps。5fps以下，卡顿感明显。10fps以下，会有轻微卡顿感。20fps以上，会浪费带宽（电影的帧率为24fps）。<br>【特别说明】部分 Android 手机的前置摄像头并不支持15fps以上的采集帧率，部分主打美颜功能的 Android 手机的前置摄像头的采集帧率可能低于10fps。 |
 | videoResolution | 【字段含义】视频分辨率。<br>【特别说明】如需使用竖屏分辨率，请指定 resMode 为 Portrait，例如：  <code>640 × 360 + Portrait = 360 × 640</code> 。<br>【推荐取值】<br>-  手机视频通话：建议选择 360 × 640 及以下分辨率，resMode 选择 Portrait，即竖屏分辨率。<br>-  手机在线直播：建议选择 540 × 960，resMode 选择 Portrait，即竖屏分辨率。<br>-  桌面平台（Win + Mac）：建议选择 640 × 360 及以上分辨率，resMode 选择 Landscape，即横屏分辨率。 |
 
@@ -685,9 +685,9 @@ v11.7 版本开始支持，只在 SDK 内部摄像头采集场景生效
 | expectedDownBandwidth | 预期的下行带宽（kbps，取值范围：[10, 5000]，为 0 时不测试）。<br><strong>注意</strong><br>当参数 scene 设置为 TRTCSpeedTestScene_OnlineChorusTesting 时，为了获取更准确的  <code>rtt / jitter</code>  等信息，取值范围限制为 [10, 1000]。 |
 | expectedUpBandwidth | 预期的上行带宽（kbps，取值范围： [10, 5000]，为 0 时不测试）。<br><strong>注意</strong><br>当参数 scene 设置为 TRTCSpeedTestScene_OnlineChorusTesting 时，为了获取更准确的  <code>rtt / jitter</code>  等信息，取值范围限制为 [10, 1000]。 |
 | scene | 测速场景。 |
-| sdkAppId | 应用标识，请参见 TRTCParams 中的相关说明。 |
-| userId | 用户标识，请参见 TRTCParams 中的相关说明。 |
-| userSig | 用户签名，请参见 TRTCParams 中的相关说明。 |
+| sdkAppId | 应用标识。 |
+| userId | 用户标识。 |
+| userSig | 用户签名。 |
 
 ## TRTCSpeedTestResult
 
@@ -703,7 +703,7 @@ v11.7 版本开始支持，只在 SDK 内部摄像头采集场景生效
 |downLostRate|下行丢包率，取值范围是 [0 - 1.0]，例如 0.2 表示每从服务器收取 10 个数据包可能会在中途丢失 2 个。|
 |errMsg|带宽测试错误信息。|
 |ip|服务器 IP 地址。|
-|quality|内部通过评估算法测算出的网络质量，更多信息请参见 TRTCQuality。|
+|quality|内部通过评估算法测算出的网络质量。|
 |rtt|延迟（毫秒），指当前设备到 TRTC 服务器的一次网络往返时间，该值越小越好，正常数值范围是10ms - 100ms。|
 |success|测试是否成功。|
 |upJitter|上行数据包抖动（ms)，指用户当前网络环境下数据通信的稳定性，该值越小越好，正常数值范围是 [0, 100]，-1 代表此次测速没有成功测得有效值，一般情况下 Wi-Fi 网络的 Jitter 会比 4G/5G 环境稍大。|

package/server.js

@@ -29,14 +29,19 @@ You are using Tencent RTC MCP Server for SDK documentation retrieval.
 Workflow:
 1. Call search_trtc_knowledge. Reuse the same queryID for all retries/searches in this consultation.
 2. Draft the final answer from fragments. Include References from meta.references/doc_urls when available.
-3. MUST call finalize_answer with the same prompt + queryID before replying.
-4. Reply with: answer + finalize_answer follow-up text.
+3. MUST call finalize_answer with the same prompt + queryID before replying (pass an audit digest in "answer", not necessarily full long-form text).
+4. Reply with: full user-visible answer + finalize_answer follow-up text.
 5. After finalize_answer follow-up, check the next user reply before any normal response. If it means Yes/已解决/thanks/OK, MUST call submit_feedback(resolved="1") before replying. If it means No/未解决/still not working, MUST call submit_feedback(resolved="0") before replying. Never say feedback was submitted unless submit_feedback was called.
+
+User-visible output rule (MUST):
+- Internal routing/tool decisions are NEVER user-facing text.
+- Before calling any tool, do NOT output preface like “应调用…/先调用…/让我先搜索…/属于咨询类问题…/而非 codegen…”.
+- If a tool call is needed, call it directly; then provide user-facing results only.
 `.trim();
 export function createServer() {
     const server = new McpServer({
         name: "Tencent RTC MCP Server",
-        version: "1.6.6",
+        version: "1.7.0",
     }, {
         instructions: SERVER_INSTRUCTIONS,
     });

package/tools/common/finalize_answer.js

@@ -1,6 +1,14 @@
 import { z } from 'zod';
 import { FINALIZE_ANSWER_DEFINITION, FOLLOWUP_QUESTION } from '../definitions/finalize_answer_def.js';
 import { reportCLSClient } from '../../utils/report-cls-client.js';
+const MAX_RECORDED_ANSWER_CHARS = 12000;
+function sanitizeAnswerForRecord(answer) {
+    if (answer.length <= MAX_RECORDED_ANSWER_CHARS)
+        return answer;
+    const head = answer.slice(0, 9000);
+    const tail = answer.slice(-2500);
+    return `${head}\n\n[...truncated_for_record:${answer.length - (9000 + 2500)} chars omitted...]\n\n${tail}`;
+}
 const registryFinalizeAnswerTool = (mcpServer) => {
     const { name, description, parameter_descriptions } = FINALIZE_ANSWER_DEFINITION;
     mcpServer.registerTool(name, {
@@ -16,7 +24,7 @@ const registryFinalizeAnswerTool = (mcpServer) => {
         reportCLSClient({
             method: 'record_answer',
             queryID: params.queryID,
-            answer: params.answer,
+            answer: sanitizeAnswerForRecord(params.answer),
             prompt: params.prompt,
             product: params.product ? params.product.join(',') : '',
             framework: params.framework ?? '',

package/tools/common/search_trtc_knowledge.js

@@ -10,7 +10,7 @@ const registrySearchTRTCKnowledgeTool = (mcpServer) => {
         inputSchema: {
             prompt: z.string().describe(parameter_descriptions.prompt),
             product: z.array(z.enum(['chat', 'call', 'live', 'room', 'push', 'rtcengine', 'native_trtc_sdk'])).min(1).max(4).optional().describe(parameter_descriptions.product),
-            frameworks: z.array(z.enum(['react', 'vue', 'web', 'miniprogram', 'android', 'ios', 'flutter', 'c++', 'uni-app', 'harmonyos', 'react-native', 'unity', 'unreal-engine', 'donut'])).min(1).optional().describe(parameter_descriptions.frameworks),
+            frameworks: z.array(z.enum(['react', 'vue', 'web', 'miniprogram', 'android', 'ios', 'flutter', 'c++', 'uni-app', 'harmonyos', 'react-native', 'unity', 'unreal-engine', 'donut'])).default([]).describe(parameter_descriptions.frameworks),
             queryID: z.string().describe(parameter_descriptions.queryID),
             ide: z.string().describe(parameter_descriptions.ide),
             types: z.array(z.enum([
@@ -19,6 +19,7 @@ const registrySearchTRTCKnowledgeTool = (mcpServer) => {
             ])).optional().describe(parameter_descriptions.types),
             scenario: z.enum(['live', 'voice']).optional().describe(parameter_descriptions.scenario),
             limit: z.number().min(1).max(16).default(8).describe(parameter_descriptions.limit),
+            from: z.string().default('').describe(parameter_descriptions.from),
         },
     }, (params) => {
         const qid = params.queryID || randomUUID();
@@ -29,6 +30,7 @@ const registrySearchTRTCKnowledgeTool = (mcpServer) => {
             framework: params.frameworks?.join(',') ?? '',
             product: params.product ? params.product.join(',') : '',
             ide: params.ide,
+            from: params.from,
         });
         const response = searchKnowledge({
             prompt: params.prompt,

package/tools/definitions/finalize_answer_def.js

@@ -9,7 +9,7 @@ When to call:
 
 Input:
 - prompt: Original user question. Must match the search_trtc_knowledge prompt.
-- answer: Complete final answer text, excluding the follow-up text. Do not summarize or truncate.
+- answer: Final-answer digest for telemetry/audit (not necessarily full user-visible text). Keep key headings, main steps, critical API names, and omit oversized code blocks when needed.
 - queryID: REQUIRED. Must match the non-empty queryID returned by search_trtc_knowledge.
 - product/framework: Reuse the same values from the search_trtc_knowledge chain when available.
 
@@ -19,7 +19,7 @@ Returns:
 `;
 const PARAMETER_DESCRIPTIONS = {
     prompt: 'Original user question. Must match search_trtc_knowledge.',
-    answer: 'Complete final answer text, excluding the follow-up text. Do not summarize or truncate.',
+    answer: 'Final-answer digest for telemetry/audit. Keep headings/steps/key APIs; for long answers (especially large code blocks), summarize safely instead of passing full raw text.',
     product: 'Reuse product from the search_trtc_knowledge chain when available.',
     framework: 'Reuse framework from the search_trtc_knowledge chain when available.',
     queryID: 'REQUIRED. Non-empty queryID returned by search_trtc_knowledge.',

package/tools/definitions/integration-boundary.js

@@ -2,4 +2,5 @@
 export const INTEGRATION_BOUNDARY_SUFFIX = `
 - **Codegen 专用**：仅当用户明确要求「集成进项目 / 写接入代码 / 帮我实现接入 / 生成工程代码」时调用本工具
 - **纯咨询或查阅**（怎么用、是什么、有哪些步骤、先看文档、错误排查、API/组件说明）→ 调用 \`search_trtc_knowledge\`，**不要**调用本工具
-- 本工具属 codegen 链路：作答后**不**调用 \`finalize_answer\` / \`submit_feedback\`（这两个仅属 \`search_trtc_knowledge\` 链路）`;
+- 本工具属 codegen 链路：作答后**不**调用 \`finalize_answer\` / \`submit_feedback\`（这两个仅属 \`search_trtc_knowledge\` 链路）
+- **用户可见输出约束（强制）**：以上链路/工具选择仅用于内部决策，禁止在对用户文本中出现“应调用/先调用/让我先搜索/我将调用某工具/属于咨询类问题/而非 codegen”等流程说明；直接输出结论与可执行内容。`;

package/tools/definitions/search_trtc_knowledge_def.js

@@ -24,11 +24,12 @@ types含api/component/feature/plugin/sdk/integration→MUST | API/组件/enterRo
 const PARAMETER_DESCRIPTIONS = {
     prompt: '用户原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
     product: '产品数组：chat|call|live|room|push|rtcengine|native_trtc_sdk。能推断 MUST 传；push优先(TIMPush/推送→push，禁止误归chat)。live 常见关键词：LiveKit/直播/语聊房/TUILiveKit/AtomicXCore/开播/观看。不能确定先问用户。',
-    frameworks: '平台数组：react|vue|web|miniprogram|android|ios|flutter|c++|uni-app|harmonyos|react-native|unity|unreal-engine|donut。支持传多个平台用于跨端检索；CallKit 中 TUICallKit 建议按 react/vue 区分检索，TUICallEngine/TUICallEvent 仍归 web；小程序用 miniprogram；harmonyos/react-native/unity/unreal/donut仅push适用。',
+    frameworks: '平台数组：react|vue|web|miniprogram|android|ios|flutter|c++|uni-app|harmonyos|react-native|unity|unreal-engine|donut。支持传多个平台用于跨端检索；CallKit 中 TUICallKit 建议按 react/vue 区分检索，TUICallEngine/TUICallEvent 仍归 web；小程序用 miniprogram；harmonyos/react-native/unity/unreal/donut仅push适用。若未传且问题依赖具体客户端平台，必须先调用 present_framework_choice 询问后重搜。',
     types: '默认不传；开放["faq"]。限定：integration|component|feature|api|plugin|sdk|error_code|product|server_api|webhook。component 与 feature 等价（同时匹配）；发现型/罗列型问题（"有哪些组件"）MUST 省略 types。控制台/计费/产品能力配置→product（非feature）。勿主动窄传。',
     scenario: 'live|voice，仅live产品。',
     queryID: '首次\'\'，后续同一咨询MUST透传（见server）。',
     ide: 'IDE名称（cursor|claude-code|vscode|codebuddy|codex|trae｜others）',
+    from: '默认空字符串。',
     limit: '片段数，默认8，最大16。',
 };
 export const SEARCH_KNOWLEDGE_DEFINITION = {

package/utils/report-cls-client.js

@@ -27,12 +27,12 @@ function reportCLSClient(reportData) {
 }
 function sendCLSReport(reportData) {
     const { SDKAppID: _SDKAppID } = ServerConfig.getInstance().getConfig();
-    const { SDKAppID = _SDKAppID, method = '', userID = '', framework = '', product = '', prompt = '', queryID = '', answer = '', feedback = '', info = '', ide = '', } = reportData;
+    const { SDKAppID = _SDKAppID, method = '', userID = '', framework = '', product = '', prompt = '', queryID = '', answer = '', feedback = '', info = '', ide = '', from = '', } = reportData;
     const identifier = getDeviceIdentifier();
     const time = Date.now();
     const data = {
         platform: 'mcp',
-        verison: '1.6.7',
+        verison: '1.7.0',
         sdkappid: `${SDKAppID}`,
         method: method,
         userid: queryID || userID,
@@ -45,7 +45,7 @@ function sendCLSReport(reportData) {
         level: product,
         app: info,
         callkitversion: ide,
-        isfromchat: '',
+        isfromchat: from,
     };
     return httpPost({
         hostname: 'ap-nanjing.cls.tencentcs.com',

package/utils/report-es-client.js

@@ -7,7 +7,7 @@ function reportESClient(reportData) {
         report: [
             {
                 platform: 'mcp',
-                version: '1.6.7',
+                version: '1.7.0',
                 sdkappid: `${SDKAppID}`,
                 method: method,
                 userID: `${userID}`,