@tencentcloud/sdk-mcp 1.6.3 → 1.6.5

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

@@ -111,12 +111,12 @@ Function: 分辨率、质量等级等枚举和常量值的定义
 
 **视频宽高比模式。**
 
-TRTCVideoResolution 中仅定义了横屏分辨率（如 640 × 360），如需使用竖屏分辨率（如360 × 640），需要同时指定 ` TRTCVideoResolutionMode ` 为 Portrait。
+TRTCVideoResolution 中仅定义了横屏分辨率（如 640 × 360），如需使用竖屏分辨率（如360 × 640），需要同时指定  `TRTCVideoResolutionMode`  为 Portrait。
 
 |枚举|取值|描述|
 |---------|---------|---------|
-|TRTCVideoResolutionModeLandscape|0|横屏分辨率，例如：` TRTCVideoResolution_640_360 + TRTCVideoResolutionModeLandscape = 640 × 360 `。|
-|TRTCVideoResolutionModePortrait|1|竖屏分辨率，例如：` TRTCVideoResolution_640_360 + TRTCVideoResolutionModePortrait  = 360 × 640 `。|
+|TRTCVideoResolutionModeLandscape|0|横屏分辨率，例如： `TRTCVideoResolution_640_360 + TRTCVideoResolutionModeLandscape = 640 × 360` 。|
+|TRTCVideoResolutionModePortrait|1|竖屏分辨率，例如： `TRTCVideoResolution_640_360 + TRTCVideoResolutionModePortrait  = 360 × 640` 。|
 
 ## TRTCVideoStreamType
 
@@ -131,7 +131,6 @@ TRTC 内部有三种不同的视频流，分别是：
 
 > **注意**
 >
-
 > 不支持单独开启低清小画面，小画面必须依附于大画面而存在，SDK 会自动设定低清小画面的分辨率和码率。
 >
 
@@ -340,11 +339,12 @@ TRTC 会每隔两秒对当前的网络质量进行评估，评估结果为六个
 
 **音频采样率。**
 
-音频采样率用来衡量声音的保真程度，采样率越高保真程度越好，如果您的应用场景有音乐的存在，推荐使用 ` TRTCAudioSampleRate48000 `。
+音频采样率用来衡量声音的保真程度，采样率越高保真程度越好，如果您的应用场景有音乐的存在，推荐使用  `TRTCAudioSampleRate48000` 。
 
 |枚举|取值|描述|
 |---------|---------|---------|
 |TRTCAudioSampleRate16000|16000|16k 采样率。|
+|TRTCAudioSampleRate24000|24000|24k 采样率。|
 |TRTCAudioSampleRate32000|32000|32k 采样率。|
 |TRTCAudioSampleRate44100|44100|44.1k 采样率。|
 |TRTCAudioSampleRate48000|48000|48k采样率|
@@ -505,10 +505,10 @@ TRTC 的云端混流服务能够将房间中的多路音视频流混合成一路
 | 枚举 | 取值 | 描述 |
 | --- | --- | --- |
 | TRTCTranscodingConfigMode_Unknown | 0 | 未定义。 |
-| TRTCTranscodingConfigMode_Manual | 1 | 全手动排版模式。<br>该模式下，您需要指定每一路画面的精确排版位置。该模式的自由度最高，但易用性也最差：<br>-  您需要填写 TRTCTranscodingConfig 中的所有参数，包括每一路画面（TRTCMixUser）的位置坐标。<br>-  您需要监听 TRTCCloudDelegate 中的 onUserVideoAvailable 和 onUserAudioAvailable 事件回调，并根据当前房间中各个麦上用户的音视频状态不断地调整 <code> mixUsers </code> 参数。 |
-| TRTCTranscodingConfigMode_Template_PureAudio | 2 | 纯音频模式。<br>该模式适用于语音通话（AudioCall）和语音聊天室（VoiceChatRoom）等纯音频的应用场景。<br>-  您只需要在进入房间后，通过 setMixTranscodingConfig 接口设置一次，之后 SDK 就会自动把房间内所有上麦用户的声音混流到当前用户的直播流上。<br>-  您无需设置 TRTCTranscodingConfig 中的 <code> mixUsers </code> 参数，只需设置 <code> audioSampleRate </code>、<code> audioBitrate </code> 和 <code> audioChannels </code> 等参数即可。 |
+| TRTCTranscodingConfigMode_Manual | 1 | 全手动排版模式。<br>该模式下，您需要指定每一路画面的精确排版位置。该模式的自由度最高，但易用性也最差：<br>-  您需要填写 TRTCTranscodingConfig 中的所有参数，包括每一路画面（TRTCMixUser）的位置坐标。<br>-  您需要监听 TRTCCloudDelegate 中的 onUserVideoAvailable 和 onUserAudioAvailable 事件回调，并根据当前房间中各个麦上用户的音视频状态不断地调整  <code>mixUsers</code>  参数。 |
+| TRTCTranscodingConfigMode_Template_PureAudio | 2 | 纯音频模式。<br>该模式适用于语音通话（AudioCall）和语音聊天室（VoiceChatRoom）等纯音频的应用场景。<br>-  您只需要在进入房间后，通过 setMixTranscodingConfig 接口设置一次，之后 SDK 就会自动把房间内所有上麦用户的声音混流到当前用户的直播流上。<br>-  您无需设置 TRTCTranscodingConfig 中的  <code>mixUsers</code>  参数，只需设置  <code>audioSampleRate</code> 、 <code>audioBitrate</code>  和  <code>audioChannels</code>  等参数即可。 |
 | TRTCTranscodingConfigMode_Template_PresetLayout | 3 | 预排版模式。<br>最受欢迎的排版模式，因为该模式支持您通过占位符提前对各路画面的位置进行设定，之后 SDK 会自动根据房间中画面的路数动态进行适配调整。<br>此模式下，您依然需要设置 mixUsers 参数，但可以将 userId 设置为“占位符”，可选的占位符有：<br>-  "$PLACE_HOLDER_REMOTE$"     :  指代远程用户的画面，可以设置多个。<br>-  "$PLACE_HOLDER_LOCAL_MAIN$" ： 指代本地摄像头画面，只允许设置一个。<br>-  "$PLACE_HOLDER_LOCAL_SUB$"  :  指代本地屏幕分享画面，只允许设置一个。<br>此模式下，您不需要监听 TRTCCloudDelegate 中的 onUserVideoAvailable 和 onUserAudioAvailable 回调进行实时调整，只需要在进房成功后调用一次 setMixTranscodingConfig 即可，之后 SDK 会自动将真实的 userId 补位到您设置的占位符上。 |
-| TRTCTranscodingConfigMode_Template_ScreenSharing | 4 | 屏幕分享模式。<br>适用于在线教育场景等以屏幕分享为主的应用场景，仅支持 Windows 和 Mac 两个平台的 SDK。<br>该模式下，SDK 会先根据您通过 videoWidth 和 videoHeight 参数设置的目标分辨率构建一张画布，<br>-  当老师未开启屏幕分享时，SDK 会将老师的摄像头画面等比例拉伸绘制到该画布上；<br>-  当老师开启屏幕分享之后，SDK 会将屏幕分享画面绘制到同样的画布上。<br>此种排版模式的目的是为了确保混流模块的输出分辨率一致，避免课程回放和网页观看的花屏问题（网页播放器不支持可变分辨率）。<br>同时，连麦学生的声音也会被默认混合到老师的音视频流中。<br>由于教学模式下的视频内容以屏幕分享为主，因此同时传输摄像头画面和屏幕分享画面是非常浪费带宽的。<br>推荐的做法是直接将摄像头画面通过 setLocalVideoRenderCallback 接口自定义绘制到当前屏幕上。<br>在该模式下，您无需设置 TRTCTranscodingConfig 中的 <code> mixUsers </code> 参数，SDK 不会混合学生的画面，以免干扰屏幕分享的效果。<br>您可以将 TRTCTranscodingConfig 中的 width x height 设为 0px × 0px，SDK 会自动根据用户当前屏幕的宽高比计算出一个合适的分辨率：<br>-  如果老师当前屏幕宽度 <= 1920px，SDK 会使用老师当前屏幕的实际分辨率。<br>-  如果老师当前屏幕宽度 >  1920px，SDK 会根据当前屏幕宽高比，选择 1920x1080(16:9)、1920x1200(16:10)、1920x1440(4:3) 三种分辨率中的一种。 |
+| TRTCTranscodingConfigMode_Template_ScreenSharing | 4 | 屏幕分享模式。<br>适用于在线教育场景等以屏幕分享为主的应用场景，仅支持 Windows 和 Mac 两个平台的 SDK。<br>该模式下，SDK 会先根据您通过 videoWidth 和 videoHeight 参数设置的目标分辨率构建一张画布，<br>-  当老师未开启屏幕分享时，SDK 会将老师的摄像头画面等比例拉伸绘制到该画布上；<br>-  当老师开启屏幕分享之后，SDK 会将屏幕分享画面绘制到同样的画布上。<br>此种排版模式的目的是为了确保混流模块的输出分辨率一致，避免课程回放和网页观看的花屏问题（网页播放器不支持可变分辨率）。<br>同时，连麦学生的声音也会被默认混合到老师的音视频流中。<br>由于教学模式下的视频内容以屏幕分享为主，因此同时传输摄像头画面和屏幕分享画面是非常浪费带宽的。<br>推荐的做法是直接将摄像头画面通过 setLocalVideoRenderCallback 接口自定义绘制到当前屏幕上。<br>在该模式下，您无需设置 TRTCTranscodingConfig 中的  <code>mixUsers</code>  参数，SDK 不会混合学生的画面，以免干扰屏幕分享的效果。<br>您可以将 TRTCTranscodingConfig 中的 width x height 设为 0px × 0px，SDK 会自动根据用户当前屏幕的宽高比计算出一个合适的分辨率：<br>-  如果老师当前屏幕宽度 <= 1920px，SDK 会使用老师当前屏幕的实际分辨率。<br>-  如果老师当前屏幕宽度 >  1920px，SDK 会根据当前屏幕宽高比，选择 1920x1080(16:9)、1920x1200(16:10)、1920x1440(4:3) 三种分辨率中的一种。 |
 
 ## TRTCRecordType
 
@@ -608,11 +608,11 @@ v11.7 版本开始支持，只在 SDK 内部摄像头采集场景生效
 | bussInfo | 【字段含义】业务数据字段（选填），部分高级特性才需要用到此字段。<br>【推荐取值】请不要自行设置该字段。 |
 | privateMapKey | 【字段含义】用于权限控制的权限票据（选填），当您希望某个房间只能让特定的 userId 进入时，需要使用 privateMapKey 进行权限保护。<br>【推荐取值】仅建议有高级别安全需求的客户使用，更多详情请参见 <a href="https://cloud.tencent.com/document/product/647/32240">进房权限保护</a>。 |
 | role | 【字段含义】直播场景下的角色，仅适用于直播场景（TRTCAppSceneLIVE 和 TRTCAppSceneVoiceChatRoom），通话场景下指定该参数是无效的。<br>【推荐取值】默认值：主播（TRTCRoleAnchor）。 |
-| roomId | 【字段含义】数字房间号，在同一个房间里的用户（userId）可以彼此看到对方并进行音视频通话。<br>【推荐取值】取值范围：1 - 4294967294。<br>【特别说明】1. roomId 与 strRoomId 是互斥的，若您选用 strRoomId，则 roomId 需要填写为 0。若两者都填，SDK 将优先选用 roomId。<br>2. 不要混用 roomId 和 strRoomId，因为它们之间是不互通的，例如数字 123 和字符串 <code> 123 </code> 在 TRTC 看来是两个完全不同的房间。 |
+| roomId | 【字段含义】数字房间号，在同一个房间里的用户（userId）可以彼此看到对方并进行音视频通话。<br>【推荐取值】取值范围：1 - 4294967294。<br>【特别说明】1. roomId 与 strRoomId 是互斥的，若您选用 strRoomId，则 roomId 需要填写为 0。若两者都填，SDK 将优先选用 roomId。<br>2. 不要混用 roomId 和 strRoomId，因为它们之间是不互通的，例如数字 123 和字符串  <code>123</code>  在 TRTC 看来是两个完全不同的房间。 |
 | sdkAppId | 【字段含义】应用标识（必填），腾讯云基于 sdkAppId 完成计费统计。<br>【推荐取值】在 <a href="https://console.cloud.tencent.com/rav/">实时音视频控制台</a> 创建应用后可以在账号信息页面中得到该 ID。 |
-| strRoomId | 【字段含义】字符串房间号，在同一个房间里的用户（userId）可以彼此看到对方并进行音视频通话。<br>【推荐取值】限制长度为 64 字节。以下为支持的字符集范围（共 89 个字符）:<br>-  大小写英文字母（a-zA-Z）；<br>-  数字（0-9）；<br>-  空格、<code> ! </code>、<code> # </code>、<code> $ </code>、<code> % </code>、<code> & </code>、<code> ( </code>、<code> ) </code>、<code> + </code>、<code> - </code>、<code> : </code>、<code> ; </code>、<code> < </code>、<code> = </code>、<code> . </code>、<code> > </code>、<code> ? </code>、<code> @ </code>、<code> [ </code>、<code> ] </code>、<code> ^ </code>、<code> _ </code>、<code> { </code>、<code> } </code>、<code> \\| </code>、<code> ~ </code>、<code> , </code>。<br>【特别说明】1. roomId 与 strRoomId 是互斥的，若您选用 strRoomId，则 roomId 需要填写为0。若两者都填，SDK 将优先选用 roomId。<br>2. 不要混用 roomId 和 strRoomId，因为它们之间是不互通的，例如数字 123 和字符串 <code> 123 </code> 在 TRTC 看来是两个完全不同的房间。 |
-| streamId | 【字段含义】用于指定在腾讯云直播平台上的 streamId（选填），设置之后，您可以在腾讯云直播 CDN 上通过标准拉流方案（FLV 或 HLS）播放该用户的音视频流。<br>【推荐取值】限制长度为64字节，可以不填写，一种推荐的方案是使用 <code> sdkappid_roomid_userid_main </code> 作为 streamid，这种命名方式容易辨认且不会在您的多个应用中发生冲突。<br>【特别说明】要使用腾讯云直播 CDN，您需要先在 <a href="https://console.cloud.tencent.com/trtc/">控制台</a> 中的功能配置页开启“启动自动旁路直播”开关。<br>【参考文档】<a href="https://cloud.tencent.com/document/product/647/84721">发布音视频流到直播 CDN</a>。 |
-| userDefineRecordId | 【字段含义】云端录制开关（选填），用于指定是否要在云端将该用户的音视频流录制下来。<br>【参考文档】<a href="https://cloud.tencent.com/document/product/647/76497">云端录制</a>。<br>【推荐取值】限制长度为64字节，只允许包含大小写英文字母（a-zA-Z）、数字（0-9）及下划线和连词符。<br>方案一：手动录制方案：<br>1. 在 <a href="https://console.cloud.tencent.com/trtc">控制台</a>>应用管理>云端录制配置 中开启云端录制。<br>2. 设置 <code> 录制形式 </code> 为 <code> 手动录制 </code>。<br>3. 设置手动录制后，在一个 TRTC 房间中只有设置了 userDefineRecordId 参数的用户才会在云端录制出视频文件，不指定该参数的用户不会产生录制行为。<br>4. 云端会以 “userDefineRecordId_起始时间_结束时间” 的格式命名录制下来的文件。<br>方案二：自动录制方案：<br>1. 需要在 <a href="https://console.cloud.tencent.com/trtc">控制台</a>>应用管理>云端录制配置 中开启云端录制。<br>2. 设置<code> 录制形式 </code>为<code> 自动录制 </code>。<br>3. 设置自动录制后，在一个 TRTC 房间中的任何一个有音视频上行的用户，均会在云端录制出视频文件。<br>4. 文件会以 <code> userDefineRecordId_起始时间_结束时间 </code> 的格式命名，如果不指定 userDefineRecordId，则文件会以 <code> streamId_起始时间_结束时间 </code> 命名。 |
+| strRoomId | 【字段含义】字符串房间号，在同一个房间里的用户（userId）可以彼此看到对方并进行音视频通话。<br>【推荐取值】限制长度为 64 字节。以下为支持的字符集范围（共 89 个字符）:<br>-  大小写英文字母（a-zA-Z）；<br>-  数字（0-9）；<br>-  空格、 <code>!</code> 、 <code>#</code> 、 <code>$</code> 、 <code>%</code> 、 <code>&</code> 、 <code>(</code> 、 <code>)</code> 、 <code>+</code> 、 <code>-</code> 、 <code>:</code> 、 <code>;</code> 、 <code><</code> 、 <code>=</code> 、 <code>.</code> 、 <code>></code> 、 <code>?</code> 、 <code>@</code> 、 <code>[</code> 、 <code>]</code> 、 <code>^</code> 、 <code>_</code> 、 <code>{</code> 、 <code>}</code> 、 <code>\\|</code> 、 <code>~</code> 、 <code>,</code> 。<br>【特别说明】1. roomId 与 strRoomId 是互斥的，若您选用 strRoomId，则 roomId 需要填写为0。若两者都填，SDK 将优先选用 roomId。<br>2. 不要混用 roomId 和 strRoomId，因为它们之间是不互通的，例如数字 123 和字符串  <code>123</code>  在 TRTC 看来是两个完全不同的房间。 |
+| streamId | 【字段含义】用于指定在腾讯云直播平台上的 streamId（选填），设置之后，您可以在腾讯云直播 CDN 上通过标准拉流方案（FLV 或 HLS）播放该用户的音视频流。<br>【推荐取值】限制长度为64字节，可以不填写，一种推荐的方案是使用  <code>sdkappid_roomid_userid_main</code>  作为 streamid，这种命名方式容易辨认且不会在您的多个应用中发生冲突。<br>【特别说明】要使用腾讯云直播 CDN，您需要先在 <a href="https://console.cloud.tencent.com/trtc/">控制台</a> 中的功能配置页开启“启动自动旁路直播”开关。<br>【参考文档】<a href="https://cloud.tencent.com/document/product/647/84721">发布音视频流到直播 CDN</a>。 |
+| userDefineRecordId | 【字段含义】云端录制开关（选填），用于指定是否要在云端将该用户的音视频流录制下来。<br>【参考文档】<a href="https://cloud.tencent.com/document/product/647/76497">云端录制</a>。<br>【推荐取值】限制长度为64字节，只允许包含大小写英文字母（a-zA-Z）、数字（0-9）及下划线和连词符。<br>方案一：手动录制方案：<br>1. 在 <a href="https://console.cloud.tencent.com/trtc">控制台</a>>应用管理>云端录制配置 中开启云端录制。<br>2. 设置  <code>录制形式</code>  为  <code>手动录制</code> 。<br>3. 设置手动录制后，在一个 TRTC 房间中只有设置了 userDefineRecordId 参数的用户才会在云端录制出视频文件，不指定该参数的用户不会产生录制行为。<br>4. 云端会以 “userDefineRecordId_起始时间_结束时间” 的格式命名录制下来的文件。<br>方案二：自动录制方案：<br>1. 需要在 <a href="https://console.cloud.tencent.com/trtc">控制台</a>>应用管理>云端录制配置 中开启云端录制。<br>2. 设置 <code>录制形式</code> 为 <code>自动录制</code> 。<br>3. 设置自动录制后，在一个 TRTC 房间中的任何一个有音视频上行的用户，均会在云端录制出视频文件。<br>4. 文件会以  <code>userDefineRecordId_起始时间_结束时间</code>  的格式命名，如果不指定 userDefineRecordId，则文件会以  <code>streamId_起始时间_结束时间</code>  命名。 |
 | userId | 【字段含义】用户标识（必填），当前用户的 userId，相当于用户名，使用 UTF-8 编码。<br>【推荐取值】如果一个用户在您的账号系统中的 ID 为 “mike”，则 userId 即可设置为 “mike”。 |
 | userSig | 【字段含义】用户签名（必填），当前 userId 对应的验证签名，相当于使用云服务的登录密码。<br>【推荐取值】具体计算方法请参见 <a href="https://cloud.tencent.com/document/product/647/17275">如何计算UserSig</a>。 |
 
@@ -624,11 +624,11 @@ 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>。 |
+| 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 对视频码率的自适应调节能力。 |
 | 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，即横屏分辨率。 |
+| 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，即横屏分辨率。 |
 
 ## TRTCNetworkQosParam
 
@@ -682,8 +682,8 @@ v11.7 版本开始支持，只在 SDK 内部摄像头采集场景生效
 您可以在用户进入房间前通过 startSpeedTest 接口测试网速（注意：请不要在通话中调用）。
 | 枚举类型 | 描述 |
 | --- | --- |
-| 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]。 |
+| 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 中的相关说明。 |
@@ -830,7 +830,7 @@ TRTC 中的“音效”特指一些短暂的音频文件，通常仅有几秒钟
 
 在 7.3 版本以后，音效接口已被新的接口 startPlayMusic 所取代。
 
-您在指定 startPlayMusic 的参数 TXAudioMusicParam 时，如果将 ` isShortFile ` 设置为 YES，即为“音效”文件。
+您在指定 startPlayMusic 的参数 TXAudioMusicParam 时，如果将  `isShortFile`  设置为 YES，即为“音效”文件。
 | 枚举类型 | 描述 |
 | --- | --- |
 | effectId | 【字段含义】音效 ID<br>【特别说明】SDK 允许播放多路音效，因此需要音效 ID 进行标记，用于控制音效的开始、停止、音量等。 |
@@ -861,7 +861,7 @@ TRTC 中的“音效”特指一些短暂的音频文件，通常仅有几秒钟
 | channels | 【字段含义】声道数。<br>【推荐取值】默认值：1，代表单声道。可设定的数值只有两个数字：1-单声道，2-双声道。 |
 | mode | 【字段含义】回调数据读写模式<br>【推荐取值】TRTCAudioFrameOperationModeReadOnly：仅从回调中获取音频数据。可设定的模式有 TRTCAudioFrameOperationModeReadOnly，TRTCAudioFrameOperationModeReadWrite。 |
 | sampleRate | 【字段含义】采样率。<br>【推荐取值】默认值：48000Hz。支持 16000, 32000, 44100, 48000。 |
-| samplesPerCall | 【字段含义】采样点数。<br>【推荐取值】取值必须是 <code> sampleRate/100 </code> 的整数倍。 |
+| samplesPerCall | 【字段含义】采样点数。<br>【推荐取值】取值必须是  <code>sampleRate/100</code>  的整数倍。 |
 
 ## TRTCScreenCaptureSourceInfo
 
@@ -898,7 +898,7 @@ TRTCScreenCaptureSourceInfo 用于描述待分享目标的信息，包括 ID、
 | 枚举类型 | 描述 |
 | --- | --- |
 | intRoomId | 【字段含义】数字房间号，需要和您的进房参数 (TRTCParams) 中的房间号类型相匹配。<br>【推荐取值】取值范围：1 - 4294967294。<br>【特别说明】intRoomId 与 strRoomId 是互斥的，若您进房参数中选用 strRoomId，则 intRoomId 需要填写为0。若两者都填，SDK 将优先选用 intRoomId。 |
-| strRoomId | 【字段含义】字符串房间号，需要和您的进房参数 (TRTCParams) 中的房间号类型相匹配。<br>【特别说明】intRoomId 与 strRoomId 是互斥的，若您进房参数中选用 roomId，则 strRoomId 无需填写。若两者都填，SDK 将优先选用 intRoomId。<br>【推荐取值】限制长度为 64 字节。以下为支持的字符集范围（共 89 个字符）:<br>-  大小写英文字母（a-zA-Z）；<br>-  数字（0-9）；<br>-  空格、<code> ! </code>、<code> # </code>、<code> $ </code>、<code> % </code>、<code> & </code>、<code> ( </code>、<code> ) </code>、<code> + </code>、<code> - </code>、<code> : </code>、<code> ; </code>、<code> < </code>、<code> = </code>、<code> . </code>、<code> > </code>、<code> ? </code>、<code> @ </code>、<code> [ </code>、<code> ] </code>、<code> ^ </code>、<code> _ </code>、<code> { </code>、<code> } </code>、<code> \\| </code>、<code> ~ </code>、<code> , </code>。 |
+| strRoomId | 【字段含义】字符串房间号，需要和您的进房参数 (TRTCParams) 中的房间号类型相匹配。<br>【特别说明】intRoomId 与 strRoomId 是互斥的，若您进房参数中选用 roomId，则 strRoomId 无需填写。若两者都填，SDK 将优先选用 intRoomId。<br>【推荐取值】限制长度为 64 字节。以下为支持的字符集范围（共 89 个字符）:<br>-  大小写英文字母（a-zA-Z）；<br>-  数字（0-9）；<br>-  空格、 <code>!</code> 、 <code>#</code> 、 <code>$</code> 、 <code>%</code> 、 <code>&</code> 、 <code>(</code> 、 <code>)</code> 、 <code>+</code> 、 <code>-</code> 、 <code>:</code> 、 <code>;</code> 、 <code><</code> 、 <code>=</code> 、 <code>.</code> 、 <code>></code> 、 <code>?</code> 、 <code>@</code> 、 <code>[</code> 、 <code>]</code> 、 <code>^</code> 、 <code>_</code> 、 <code>{</code> 、 <code>}</code> 、 <code>\\|</code> 、 <code>~</code> 、 <code>,</code> 。 |
 | userId | 【字段含义】用户标识，当前用户的 userId，相当于用户名，使用 UTF-8 编码。<br>【推荐取值】如果一个用户在您的账号系统中的 ID 为“mike”，则 userId 即可设置为“mike”。 |
 
 ## TRTCPublishCdnUrl

package/server-config.js

@@ -1,4 +1,6 @@
 import { reportESClient } from './utils/report-es-client.js';
+import { isValidSDKAppID } from './utils/is-valid-sdkappid.js';
+import { getDeviceIdentifier } from './utils/get-device-identifier.js';
 class ServerConfig {
     static instance;
     config;
@@ -16,11 +18,12 @@ class ServerConfig {
         const { SDKAPPID, SECRETKEY } = process.env || {};
         if (SDKAPPID) {
             config.SDKAppID = SDKAPPID;
-            reportESClient({
-                SDKAppID: SDKAPPID,
-                method: 'mcp_config'
-            });
         }
+        const sdkappid = isValidSDKAppID(SDKAPPID) ? SDKAPPID : `${getDeviceIdentifier()}:zh`;
+        reportESClient({
+            SDKAppID: sdkappid,
+            method: 'mcp_config'
+        });
         if (SECRETKEY) {
             config.secretKey = SECRETKEY;
         }

package/server.js

@@ -17,7 +17,7 @@ You are using Tencent RTC MCP Server for SDK documentation retrieval.
 - 推送 + IM 同时涉及 → 可传 ["push","chat"]
 - 无法从 prompt 唯一判断 product → 先向用户确认，不要无 product 硬搜，也不要 web_search
 
-**Framework**：返回 needs_framework 时 MUST 先 present_framework_choice；详见 search_trtc_knowledge 工具 description 决策表。
+**Frameworks**：返回 needs_framework 时 MUST 先 present_framework_choice；详见 search_trtc_knowledge 工具 description 决策表。
 **When in doubt**：仍优先调用 search_trtc_knowledge（带最佳猜测 product）；status=empty 或 low_confidence 时再澄清或重搜。
 
 **queryID 传递规则（硬规则，违反会导致 CLS 数据断裂）**：
@@ -36,7 +36,7 @@ Workflow:
 export function createServer() {
     const server = new McpServer({
         name: "Tencent RTC MCP Server",
-        version: "1.6.1",
+        version: "1.6.5",
     }, {
         instructions: SERVER_INSTRUCTIONS,
     });

package/tools/common/finalize_answer.js

@@ -9,7 +9,7 @@ const registryFinalizeAnswerTool = (mcpServer) => {
             prompt: z.string().describe(parameter_descriptions.prompt),
             answer: z.string().describe(parameter_descriptions.answer),
             product: z.array(z.enum(['chat', 'call', 'live', 'room', 'push', 'rtcengine', 'native_trtc_sdk'])).min(1).max(4).optional().describe(parameter_descriptions.product),
-            framework: z.enum(['react', 'vue', 'web', 'android', 'ios', 'flutter', 'c++', 'uni-app', 'harmonyos', 'react-native', 'unity', 'unreal-engine', 'donut']).optional().describe(parameter_descriptions.framework),
+            framework: z.enum(['react', 'vue', 'web', 'miniprogram', 'android', 'ios', 'flutter', 'c++', 'uni-app', 'harmonyos', 'react-native', 'unity', 'unreal-engine', 'donut']).optional().describe(parameter_descriptions.framework),
             queryID: z.string().describe(parameter_descriptions.queryID),
         },
     }, (params) => {

package/tools/common/present_framework_choice.js

@@ -7,7 +7,7 @@ const PRODUCT_OPTIONS_MAP = {
     },
     call: {
         title: 'Call 音视频通话支持的平台或框架',
-        options: ['react', 'vue', 'flutter', 'android', 'ios', 'uni-app'],
+        options: ['web', 'miniprogram', 'react', 'vue', 'flutter', 'android', 'ios', 'uni-app'],
     },
     live: {
         title: 'Live 直播互动支持的平台或框架',
@@ -44,7 +44,7 @@ ${config.title}：
 ${options}
 
 请等待用户回复具体平台后（**硬规则，不可跳过**）：
-- **咨询 / 查文档 / API / 组件 / feature** → MUST 调用 \`search_trtc_knowledge\`，传入 **product + framework**
+- **咨询 / 查文档 / API / 组件 / feature** → MUST 调用 \`search_trtc_knowledge\`，传入 **product + frameworks**
 - **要写代码集成进项目** → MUST 调用对应的 \`get_*_integration\` 工具`;
 }
 const registryPresentFrameworkChoiceTool = (mcpServer) => {

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),
-            framework: z.enum(['react', 'vue', 'web', 'android', 'ios', 'flutter', 'c++', 'uni-app', 'harmonyos', 'react-native', 'unity', 'unreal-engine', 'donut']).optional().describe(parameter_descriptions.framework),
+            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),
             queryID: z.string().describe(parameter_descriptions.queryID),
             ide: z.string().describe(parameter_descriptions.ide),
             types: z.array(z.enum([
@@ -26,14 +26,14 @@ const registrySearchTRTCKnowledgeTool = (mcpServer) => {
             method: 'search_trtc_knowledge',
             queryID: qid,
             prompt: params.prompt,
-            framework: params.framework ?? '',
+            framework: params.frameworks?.join(',') ?? '',
             product: params.product ? params.product.join(',') : '',
             ide: params.ide,
         });
         const response = searchKnowledge({
             prompt: params.prompt,
             product: params.product,
-            framework: params.framework,
+            frameworks: params.frameworks,
             types: params.types,
             scenario: params.scenario,
             limit: params.limit,

package/tools/common/submit_feedback.js

@@ -7,7 +7,7 @@ const registrySubmitFeedbackTool = (mcpServer) => {
         description,
         inputSchema: {
             prompt: z.string().describe(parameter_descriptions.prompt),
-            framework: z.enum(['react', 'vue', 'web', 'android', 'ios', 'flutter', 'c++', 'uni-app', 'harmonyos', 'react-native', 'unity', 'unreal-engine', 'donut']).optional().describe(parameter_descriptions.framework),
+            framework: z.enum(['react', 'vue', 'web', 'miniprogram', 'android', 'ios', 'flutter', 'c++', 'uni-app', 'harmonyos', 'react-native', 'unity', 'unreal-engine', 'donut']).optional().describe(parameter_descriptions.framework),
             queryID: z.string().describe(parameter_descriptions.queryID),
             resolved: z.enum(['0', '1']).describe(parameter_descriptions.resolved),
         },

package/tools/definitions/get_native_live_uikit_integration_def.js

@@ -0,0 +1,60 @@
+import { INTEGRATION_BOUNDARY_SUFFIX } from './integration-boundary.js';
+const TOOL_DESCRIPTION = `
+用途：
+返回基于 TUILiveKit 预制 UI 组件的 Native 视频直播集成文档，供 AI 完成移动端（Android / iOS）视频直播的开箱即用界面接入与代码生成。覆盖直播列表页（观众入口）、主播开播页、观众观看页，均为含完整交互 UI 与业务逻辑的预制组件（如 AnchorPrepareView、直播列表瀑布流视图等）。
+
+典型适用问题（共用触发词，可能同时命中 'get_native_livekit_core_integration' Core 工具）：
+集成 LiveKit, 接入 TUILiveKit, 视频直播, 直播开播, 主播开播, 观众观看, 直播列表, 开播页, 观看页, 直播间列表, Android, iOS
+命中以上共用触发词时，请**先主动追问用户**："您希望使用默认直播界面快速集成（TUILiveKit preset），还是基于 Core SDK / AtomicXCore 自定义直播界面？" 用户选择"默认/preset"后再调用本工具；选择"自定义/Core"则调用 'get_native_livekit_core_integration'。
+
+典型适用问题（preset 专属触发词，仅命中本工具，无需追问，直接调用）：
+TUILiveKit, Native TUILiveKit, Native Live UIKit, preset, preset 集成, 预制 UI, 预制开播页, 预制观看页, 预制直播列表, 默认直播界面, 开箱即用直播界面, 现成的开播页面, 直播界面已经有了, TUILiveKit Android, TUILiveKit iOS, AnchorPrepareView
+
+输入：
+- framework: android | ios
+- goals: 功能模块列表（可多选，返回时按 直播列表→开播→观看 顺序组织）
+- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
+
+返回：
+- content: [{ type: 'text', text: 文档正文（含各平台通用的环境准备/依赖接入 + 所选功能页的集成步骤与代码）}]
+
+边界：
+- 仅面向**视频直播（live）**场景。语聊房（voice / 语聊 / 音频房 / 麦位）**不在本工具范围**，如遇该需求请改用 'get_native_livekit_core_integration' 或告知用户暂不支持预制 UI
+- framework 仅支持 android | ios（TUILiveKit 视频直播预制 UI 暂无 flutter / uni-app 端文档，如遇该需求请改用 'get_native_livekit_core_integration' 或告知用户暂不支持）
+- 当用户未明确平台时，应先调用 'present_framework_choice'
+- 当用户已明示「自定义 UI」「Core SDK」「AtomicXCore」「LiveCoreView」「自己画直播页面」等 Core 专属触发词时，直接调用 'get_native_livekit_core_integration'，不要走本工具
+- 面向主播开播 / 观众观看 / 直播列表整体页面集成，不负责连麦、PK、礼物、弹幕、美颜、音效等单功能扩展（这些请使用 'search_trtc_knowledge'）
+${INTEGRATION_BOUNDARY_SUFFIX}
+`;
+const PARAMETER_DESCRIPTIONS = {
+    framework: '目标平台。参数名固定为 framework，禁止传 platform。可选值：android | ios。',
+    goals: '功能列表（可多选）。可选值：live_list（直播列表页，观众入口）| host_streaming（主播开播页）| audience_streaming（观众观看页）。做完整移动端直播 App 通常需要 live_list + host_streaming + audience_streaming。',
+    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
+};
+export const GET_NATIVE_LIVE_UIKIT_INTEGRATION_DEFINITION = {
+    name: 'get_native_live_uikit_integration',
+    description: TOOL_DESCRIPTION,
+    parameter_descriptions: PARAMETER_DESCRIPTIONS,
+};
+// 展示给 AI 的返回文案（拼装标题/小节/缺失提示等）。
+// 工具实现（get_native_live_uikit_integration.ts）在 zh/en 保持字节级一致，靠 sync-tools.js 自动同步；
+// 这里的文案是唯一按 locale 维护的差异点，en 侧需要单独提供一份英文版 UI_TEXT。
+export const GET_NATIVE_LIVE_UIKIT_INTEGRATION_UI_TEXT = {
+    goalTitles: {
+        live_list: '直播列表页（TUILiveKit 预制 UI）',
+        host_streaming: '主播开播页（TUILiveKit 预制 UI）',
+        audience_streaming: '观众观看页（TUILiveKit 预制 UI）',
+    },
+    headerTitle: '# TUILiveKit 视频直播（Native 预制 UI）集成指南',
+    platformLabel: '平台',
+    selectedFeaturesLabel: '已选功能',
+    labelSeparator: '：',
+    listSeparator: '、',
+    headerNotes: [
+        '下方先给出所有平台通用的环境准备与依赖接入步骤，再按功能给出各页面的集成代码。',
+        '请严格按文档中的类名、包名、import 路径生成代码，禁止臆造 API。',
+    ],
+    prepareSectionTitle: (framework) => `环境准备与代码集成（${framework} 前置步骤）`,
+    prepareSectionFallback: '## 环境准备与代码集成\n\n> 未找到该平台的准备工作文档。',
+    goalNotFound: (framework) => `未找到 ${framework} 平台该功能的集成文档，请确认 goal 与平台是否受支持，或改用 search_trtc_knowledge 查询。`,
+};

package/tools/definitions/get_native_livekit_core_integration_def.js

@@ -22,7 +22,7 @@ Native LiveKit Core, AtomicXCore, 无 UI SDK, Core SDK, 视频直播, 语聊房,
 ${INTEGRATION_BOUNDARY_SUFFIX}
 `;
 const PARAMETER_DESCRIPTIONS = {
-    scenario: '场景类型。可选值：live（视频直播）| voice（语聊房）。当需求是开播、观看、房间列表时使用 integration；当需求是连麦、PK、成员列表、美颜、音效、弹幕、礼物时应使用 features。',
+    scenario: '场景类型。可选值：live（视频直播）| voice（语聊房）。当需求是开播、观看、房间列表时使用 integration；当需求是连麦、PK、成员列表、美颜、音效、弹幕、礼物时请改用 search_trtc_knowledge 检索。',
     framework: '目标平台。参数名固定为 framework，禁止传 platform。可选值：android | ios | flutter | uni-app。',
     goals: '功能列表。可选值：host_streaming（主播/房主开播）| audience_streaming（观众/听众观看）| live_list（房间列表）。',
     prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',

package/tools/definitions/present_framework_choice_def.js

@@ -3,7 +3,7 @@ const TOOL_DESCRIPTION = `
 当用户未明确平台或框架时，先引导用户从受支持选项中明确选择，再继续调用 \`search_trtc_knowledge\` 或对应的 integration 工具。
 
 典型适用问题：
-平台选择, 框架选择, 先选平台, 先选框架, 未指定平台, 未指定框架, 获取集成指南, 获取接入文档, 快速开始, 查询 API, 查询组件, 查询功能点, 怎么设置, 怎么配置, Chat UIKit 集成, Call UIKit 集成, Live UIKit 集成, Room UIKit 集成, CallKit API, LiveKit API, WebRTC SDK 集成, Native TRTC SDK 集成, react, vue, uni-app, flutter, android, ios, webrtc
+平台选择, 框架选择, 先选平台, 先选框架, 未指定平台, 未指定框架, 获取集成指南, 获取接入文档, 快速开始, 查询 API, 查询组件, 查询功能点, 怎么设置, 怎么配置, Chat UIKit 集成, Call UIKit 集成, Live UIKit 集成, Room UIKit 集成, CallKit API, LiveKit API, WebRTC SDK 集成, Native TRTC SDK 集成, react, vue, web, miniprogram, 小程序, uni-app, flutter, android, ios, webrtc
 
 触发示例：
 - 获取 Chat UIKit 集成指南（未说明 React/Vue）
@@ -19,7 +19,7 @@ const TOOL_DESCRIPTION = `
 
 边界：
 - 只负责收集平台或框架选择，不返回文档正文
-- **咨询链路（硬规则）**：用户问 API/组件/feature/客户端排障/集成查阅，但未说明平台 → MUST **先本工具**，用户选定后再 \`search_trtc_knowledge\`（**product + framework**）；**禁止**跳过
+- **咨询链路（硬规则）**：用户问 API/组件/feature/客户端排障/集成查阅，但未说明平台 → MUST **先本工具**，用户选定后再 \`search_trtc_knowledge\`（**product + frameworks**）；**禁止**跳过
 - **codegen 链路（硬规则）**：用户要集成进项目且未说明平台 → MUST **先本工具**，选定后再对应 \`get_*_integration\`
 - 跨平台通用问题（计费、服务端 REST、UserSig 原理）且与单一客户端无关 → 可直接 \`search_trtc_knowledge\`，不必经过本工具（**product 仍 MUST 从 prompt 提取**）
 `;

package/tools/definitions/search_trtc_knowledge_def.js

@@ -5,9 +5,9 @@ const TOOL_DESCRIPTION = `
 push:TIMPush/推送/厂商/FCM/华为/小米/OPPO（≠chat）| chat:会话/TUIKit/IM/主题 | call:CallKit | live:LiveKit | room:RoomKit/会议
 rtcengine:Web TRTC | native_trtc_sdk:TRTCCloud | 跨域:["push","chat"]
 
-**framework**（requires-framework.ts 顺序）：
+**frameworks**（requires-framework.ts 顺序）：
 已传→检索 | needs_framework→present_framework_choice后重搜
-chat+错误码/ERR_→先问platform | native→MUST android/ios/c++ | rtcengine→隐式web
+chat+错误码/ERR_→先问platform | native→MUST 包含 android/ios/c++ 之一 | rtcengine→隐式web
 push:厂商名≠平台(可不传);开通/接入/控制台/厂商配置可不传;含android/ios/flutter等→MUST
 计费/REST/Webhook/UserSig→可不传 | types仅server_api/webhook/product→可不传
 控制台/产品能力配置（多端登录/登录策略/消息存储时长/控制台设置）→types=["product"]，勿用feature；误传feature时runtime按跨平台产品配置处理
@@ -19,12 +19,12 @@ types含api/component/feature/plugin/sdk/integration→MUST | API/组件/enterRo
 
 **L0/L1**：本地fragments仅基于片段答；chat/urls/须fetch官网URL，禁止臆造。
 
-**返回**：status、confidence、fragments(doc_urls)、meta.references/exact_hits、top_score/second_score、queryID、message。答案须引用 references/doc_urls。最终回复前 MUST 调用 finalize_answer；明确 follow-up 反馈后调用 submit_feedback。
+**返回**：status、confidence、fragments(doc_urls)、meta.references/exact_hits、top_score/second_score、queryID、message、meta.answer_contract。答案须严格遵守 answer_contract（结论先行、用户可执行、未确认显式化）；正文不展开证据链，且禁止输出“命中片段/检索结果/置信度”等系统话术，但末尾需保留“参考文档”并列出 references/doc_urls。最终回复前 MUST 调用 finalize_answer；明确 follow-up 反馈后调用 submit_feedback。
 `;
 const PARAMETER_DESCRIPTIONS = {
     prompt: '用户原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
-    product: '产品数组：chat|call|live|room|push|rtcengine|native_trtc_sdk。能推断 MUST 传；push优先(TIMPush/推送→push，禁止误归chat)。不能确定先问用户。',
-    framework: '平台：react|vue|web|android|ios|flutter|c++|uni-app|harmonyos|react-native|unity|unreal-engine|donut。按description决策表；harmonyos/react-native/unity/unreal/donut仅push适用。',
+    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适用。',
     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）。',

package/tools/index.js

@@ -14,6 +14,7 @@ import { registryGetNativeCallKitCoreIntegrationTool } from './call/get_native_c
 // live
 import { registryGetWebLiveUIKitIntegrationTool } from './live/get_web_live_uikit_integration.js';
 import { registryGetNativeLiveKitCoreIntegrationTool } from './live/get_native_livekit_core_integration.js';
+import { registryGetNativeLiveUIKitIntegrationTool } from './live/get_native_live_uikit_integration.js';
 // room
 import { registryGetWebRoomUIKitIntegrationTool } from './room/get_web_room_uikit_integration.js';
 import { registryGetWebRoomCoreIntegrationTool } from './room/get_web_room_core_integration.js';
@@ -33,6 +34,7 @@ function registryTools(mcpServer) {
     // live
     registryGetWebLiveUIKitIntegrationTool(mcpServer);
     registryGetNativeLiveKitCoreIntegrationTool(mcpServer);
+    registryGetNativeLiveUIKitIntegrationTool(mcpServer);
     // room
     registryGetWebRoomUIKitIntegrationTool(mcpServer);
     registryGetWebRoomCoreIntegrationTool(mcpServer);

package/tools/live/get_native_live_uikit_integration.js

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+import { GET_NATIVE_LIVE_UIKIT_INTEGRATION_DEFINITION, GET_NATIVE_LIVE_UIKIT_INTEGRATION_UI_TEXT as UI_TEXT, } from '../definitions/get_native_live_uikit_integration_def.js';
+import { getIntegrationContent } from '../../utils/get-doc-content.js';
+import { reportCLSClient } from '../../utils/report-cls-client.js';
+// goal → 直播列表/开播/观看对应的 preset 文档文件名（均在 livekit/preset/live/{framework}/ 下）
+// 展示文案（title）统一从 UI_TEXT.goalTitles 取，做到 zh/en 按 locale 差异化。
+const GOAL_FILE = {
+    host_streaming: 'live-host-integration.md',
+    audience_streaming: 'live-audience-integration.md',
+    live_list: 'live-list-integration.md',
+};
+// 观众进直播间需要先有列表入口；固定的推荐阅读顺序，保证多 goal 时输出结构稳定
+const GOAL_ORDER = ['live_list', 'host_streaming', 'audience_streaming'];
+const DOC_NOT_FOUND = 'Not found relevant documents';
+function getResultText(params) {
+    const { framework = '', goals = [], prompt = '' } = params;
+    // 去重 + 稳定排序，避免同一 goal 传多次导致重复正文
+    const uniqueGoals = GOAL_ORDER.filter((goal) => goals.includes(goal));
+    reportCLSClient({
+        method: 'get_native_live_uikit_integration',
+        prompt,
+        framework,
+        info: `live:${uniqueGoals.join(',')}`,
+    });
+    const prepareContent = getIntegrationContent(['livekit', 'preset', 'live', framework, 'prepare-integration.md']);
+    const sections = uniqueGoals.map((goal) => {
+        const title = UI_TEXT.goalTitles[goal];
+        const file = GOAL_FILE[goal];
+        const content = getIntegrationContent(['livekit', 'preset', 'live', framework, file]);
+        if (!content || content === DOC_NOT_FOUND) {
+            return `## ${title}\n\n> ${UI_TEXT.goalNotFound(framework)}`;
+        }
+        return `## ${title}\n\n${content}`;
+    });
+    const header = [
+        UI_TEXT.headerTitle,
+        `- ${UI_TEXT.platformLabel}${UI_TEXT.labelSeparator}${framework}`,
+        `- ${UI_TEXT.selectedFeaturesLabel}${UI_TEXT.labelSeparator}${uniqueGoals.map((g) => UI_TEXT.goalTitles[g]).join(UI_TEXT.listSeparator)}`,
+        ...UI_TEXT.headerNotes.map((note) => `- ${note}`),
+    ].join('\n');
+    const prepareSection = (!prepareContent || prepareContent === DOC_NOT_FOUND)
+        ? UI_TEXT.prepareSectionFallback
+        : `## ${UI_TEXT.prepareSectionTitle(framework)}\n\n${prepareContent}`;
+    return [header, prepareSection, '---', ...sections].join('\n\n');
+}
+const registryGetNativeLiveUIKitIntegrationTool = (mcpServer) => {
+    const { name, description, parameter_descriptions } = GET_NATIVE_LIVE_UIKIT_INTEGRATION_DEFINITION;
+    mcpServer.registerTool(name, {
+        description,
+        inputSchema: {
+            framework: z.enum(['android', 'ios']).describe(parameter_descriptions.framework),
+            goals: z
+                .array(z.enum(['live_list', 'host_streaming', 'audience_streaming']))
+                .min(1)
+                .describe(parameter_descriptions.goals),
+            prompt: z.string().describe(parameter_descriptions.prompt),
+        },
+    }, (params) => {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: getResultText(params),
+                },
+            ],
+        };
+    });
+};
+export { registryGetNativeLiveUIKitIntegrationTool };

package/tools/live/get_native_livekit_core_integration.js

@@ -5,15 +5,15 @@ import { reportCLSClient } from '../../utils/report-cls-client.js';
 function generatePathMap(scenario, framework) {
     if (scenario === 'live') {
         return {
-            'host_streaming': ['livekit', 'core-sdk', 'live', `${framework}`, 'live-integration.md'],
-            'audience_streaming': ['livekit', 'core-sdk', 'live', `${framework}`, 'live-integration.md'],
-            'live_list': ['livekit', 'core-sdk', 'live', `${framework}`, 'live-live-list.md']
+            'host_streaming': ['livekit', 'core-sdk', 'live', `${framework}`, 'integration.md'],
+            'audience_streaming': ['livekit', 'core-sdk', 'live', `${framework}`, 'integration.md'],
+            'live_list': ['livekit', 'core-sdk', 'features', `${framework}`, 'live-list.md']
         };
     }
     return {
-        'host_streaming': ['livekit', 'core-sdk', 'voice', `${framework}`, 'voice-integration.md'],
-        'audience_streaming': ['livekit', 'core-sdk', 'voice', `${framework}`, 'voice-integration.md'],
-        'live_list': ['livekit', 'core-sdk', 'voice', `${framework}`, 'voice-room-list.md']
+        'host_streaming': ['livekit', 'core-sdk', 'voice', `${framework}`, 'integration.md'],
+        'audience_streaming': ['livekit', 'core-sdk', 'voice', `${framework}`, 'integration.md'],
+        'live_list': ['livekit', 'core-sdk', 'features', `${framework}`, 'live-list.md']
     };
 }
 async function getResultText(params) {

package/utils/is-valid-sdkappid.js

@@ -0,0 +1,4 @@
+function isValidSDKAppID(value) {
+    return !!value && /^\d+$/.test(value);
+}
+export { isValidSDKAppID };

package/utils/report-cls-client.js

@@ -32,7 +32,7 @@ function sendCLSReport(reportData) {
     const time = Date.now();
     const data = {
         platform: 'mcp',
-        verison: '1.6.3',
+        verison: '1.6.5',
         sdkappid: `${SDKAppID}`,
         method: method,
         userid: queryID || userID,

package/utils/report-es-client.js

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

package/resource/index/component-slugs.json

@@ -1 +0,0 @@
-{"chat-setting":["chat-setting","chatsetting","chat_setting"],"contact-list":["contact-list","contactlist","contact_list"],"conversation-actions":["conversation-actions","conversationactions","conversation_actions"],"conversation-list":["conversation-list","conversationlist","conversation_list"],"conversation-preview":["conversation-preview","conversationpreview","conversation_preview"],"conversation-search":["conversation-search","conversationsearch","conversation_search"],"message-input":["message-input","messageinput","message_input"],"message-list":["message-list","messagelist","message_list"],"search":["search","search","search"],"theme":["theme","theme","theme"],"chat-header":["chat-header","chatheader","chat_header"]}

package/resource/index/doc-source-urls.json

@@ -1 +0,0 @@
-{"knowledge/rtcengine/web/how_to_run_web_sdk_demo.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-10-basic-get-started-with-demo.md","knowledge/rtcengine/web/plugin/20-advanced-customized-capture-rendering.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-20-advanced-customized-capture-rendering.md","knowledge/rtcengine/web/plugin/21-advanced-auto-play-policy.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-21-advanced-auto-play-policy.md","knowledge/rtcengine/web/plugin/22-advanced-audio-mixer.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-22-advanced-audio-mixer.md","knowledge/rtcengine/web/plugin/23-advanced-support-detection.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-23-advanced-support-detection.md","knowledge/rtcengine/web/plugin/24-advanced-network-quality.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-24-advanced-network-quality.md","knowledge/rtcengine/web/plugin/25-advanced-device-change.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-25-advanced-device-change.md","knowledge/rtcengine/web/plugin/26-advanced-publish-cdn-stream.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-26-advanced-publish-cdn-stream.md","knowledge/rtcengine/web/plugin/27-advanced-small-stream.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-27-advanced-small-stream.md","knowledge/rtcengine/web/plugin/28-advanced-beauty.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-28-advanced-beauty.md","knowledge/rtcengine/web/plugin/29-advanced-water-mark.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-29-advanced-water-mark.md","knowledge/rtcengine/web/plugin/30-advanced-cross-room-link.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-30-advanced-cross-room-link.md","knowledge/rtcengine/web/plugin/31-advanced-plugins-overview.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-31-advanced-plugins-overview.md","knowledge/rtcengine/web/plugin/34-advanced-proxy.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-34-advanced-proxy.md","knowledge/rtcengine/web/plugin/35-advanced-ai-denoiser.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-35-advanced-ai-denoiser.md","knowledge/rtcengine/web/plugin/36-advanced-virtual-background.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-36-advanced-virtual-background.md","knowledge/rtcengine/web/plugin/37-advanced-voice-changer.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-37-advanced-voice-changer.md","knowledge/rtcengine/web/plugin/38-advanced-basic-beauty.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-38-advanced-basic-beauty.md","knowledge/rtcengine/web/plugin/39-advanced-video-decoder.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-39-advanced-video-decoder.md","knowledge/rtcengine/web/plugin/40-advanced-video-mixer.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-40-advanced-video-mixer.md","knowledge/rtcengine/web/plugin/41-advanced-small-stream-auto-switcher.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-41-advanced-small-stream-auto-switcher.md","knowledge/rtcengine/web/plugin/42-advanced-realtime-transcriber.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-42-advanced-realtime-transcriber.md","knowledge/rtcengine/web/plugin/43-advanced-face-detection.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-43-advanced-face-detection.md"}