@tencentcloud/sdk-mcp 1.6.3 → 1.6.5

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

@@ -110,12 +110,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
 
@@ -130,7 +130,6 @@ TRTC 内部有三种不同的视频流，分别是：
 
 > **注意**
 >
-
 > 不支持单独开启低清小画面，小画面必须依附于大画面而存在，SDK 会自动设定低清小画面的分辨率和码率。
 >
 
@@ -437,10 +436,10 @@ TRTC 的云端混流服务能够将房间中的多路音视频流混合成一路
 | 枚举 | 取值 | 描述 |
 | --- | --- | --- |
 | TRTCTranscodingConfigMode_Unknown | 0 | 未定义。 |
-| TRTCTranscodingConfigMode_Manual | 1 | 全手动排版模式。<br>该模式下，您需要指定每一路画面的精确排版位置。该模式的自由度最高，但易用性也最差：<br>-  您需要填写 TRTCTranscodingConfig 中的所有参数，包括每一路画面（TRTCMixUser）的位置坐标。<br>-  您需要监听 ITRTCCloudCallback 中的 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>-  您需要监听 ITRTCCloudCallback 中的 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>此模式下，您不需要监听 ITRTCCloudCallback 中的 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
 
@@ -550,11 +549,11 @@ v11.7 版本开始支持，只在 SDK 内部摄像头采集场景生效
 | businessInfo | 【字段含义】业务数据字段（选填），部分高级特性才需要用到此字段。<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>。 |
 
@@ -566,11 +565,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
 
@@ -625,8 +624,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 中的相关说明。 |
@@ -787,7 +786,7 @@ TRTC 中的“音效”特指一些短暂的音频文件，通常仅有几秒钟
 
 在 7.3 版本以后，音效接口已被新的接口 startPlayMusic 所取代。
 
-您在指定 startPlayMusic 的参数 TXAudioMusicParam 时，如果将 ` isShortFile ` 设置为 true，即为“音效”文件。
+您在指定 startPlayMusic 的参数 TXAudioMusicParam 时，如果将  `isShortFile`  设置为 true，即为“音效”文件。
 | 枚举类型 | 描述 |
 | --- | --- |
 | effectId | 【字段含义】音效 ID<br>【特别说明】SDK 允许播放多路音效，因此需要音效 ID 进行标记，用于控制音效的开始、停止、音量等。 |
@@ -818,7 +817,7 @@ TRTC 中的“音效”特指一些短暂的音频文件，通常仅有几秒钟
 | channel | 【字段含义】声道数。<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
 
@@ -876,7 +875,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/resource/knowledge/trtc/c++/TXLiteAVCode.md

@@ -77,7 +77,7 @@ Function: 用于通知客户 TRTC 在使用过程中出现的警告和错误
 | ERR_TRTC_CONNECT_OTHER_ROOM_TIMEOUT | -3326 | 请求连麦超时 |
 | ERR_TRTC_DISCONNECT_OTHER_ROOM_TIMEOUT | -3327 | 请求退出连麦超时 |
 | ERR_TRTC_CONNECT_OTHER_ROOM_INVALID_PARAMETER | -3328 | 无效参数 |
-| ERR_TRTC_CONNECT_OTHER_ROOM_AS_AUDIENCE | -3330 | 当前是观众角色，不能请求或断开跨房连麦，需要先 <code> switchRole </code> 到主播 |
+| ERR_TRTC_CONNECT_OTHER_ROOM_AS_AUDIENCE | -3330 | 当前是观众角色，不能请求或断开跨房连麦，需要先  <code>switchRole</code>  到主播 |
 | ERR_BGM_OPEN_FAILED | -4001 | 打开文件失败，如音频数据无效，FFMPEG 协议未找到等 |
 | ERR_BGM_DECODE_FAILED | -4002 | 音频文件解码失败 |
 | ERR_BGM_OVER_LIMIT | -4003 | 数量超过限定值，如同时预加载两首背景音乐 |