@tencentcloud/sdk-mcp 1.7.7 → 1.7.8

package/resource/knowledge/trtc/android/TRTCCloudDef.md

@@ -126,11 +126,11 @@ TRTCVideoResolution 中仅定义了横屏分辨率（如 640 × 360），如需
 **视频流类型。**
 
 TRTC 内部有三种不同的视频流，分别是：
--  高清大画面：一般用来传输摄像头的视频数据。
+- 高清大画面：一般用来传输摄像头的视频数据。
 
--  低清小画面：小画面和大画面的内容相互，但是分辨率和码率都比大画面低，因此清晰度也更低。
+- 低清小画面：小画面和大画面的内容相互，但是分辨率和码率都比大画面低，因此清晰度也更低。
 
--  辅流画面：一般用于屏幕分享，同一时间在同一个房间中只允许一个用户发布辅流视频，其他用户必须要等该用户关闭之后才能发布自己的辅流。
+- 辅流画面：一般用于屏幕分享，同一时间在同一个房间中只允许一个用户发布辅流视频，其他用户必须要等该用户关闭之后才能发布自己的辅流。
 
 > **注意**
 >
@@ -185,9 +185,9 @@ TRTC 内置多种不同的磨皮算法，您可以选择最适合您产品定位
 **视频像素格式。**
 
 TRTC 提供针对视频的自定义采集和自定义渲染功能：
--  在自定义采集功能中，您可以用下列枚举值描述您采集的视频像素格式。
+- 在自定义采集功能中，您可以用下列枚举值描述您采集的视频像素格式。
 
--  在自定义渲染功能中，您可以指定您期望 SDK 回调出的视频像素格式。
+- 在自定义渲染功能中，您可以指定您期望 SDK 回调出的视频像素格式。
 
 |枚举|取值|描述|
 |---------|---------|---------|
@@ -203,9 +203,9 @@ TRTC 提供针对视频的自定义采集和自定义渲染功能：
 **视频数据传递方式。**
 
 在自定义采集和自定义渲染功能，您需要用到下列枚举值来指定您希望以什么方式传递视频数据：
--  方案一：使用内存 Buffer 传递视频数据，该方案在 iOS 效率尚可，但在 Android 系统上效率较差，Windows 暂时仅支持内存 Buffer 的传递方式。
+- 方案一：使用内存 Buffer 传递视频数据，该方案在 iOS 效率尚可，但在 Android 系统上效率较差，Windows 暂时仅支持内存 Buffer 的传递方式。
 
--  方案二：使用 Texture 纹理传递视频数据，该方案在 iOS 和 Android 系统下均有较高的效率，Windows 暂不支持，需要您有一定的 OpenGL 编程基础。
+- 方案二：使用 Texture 纹理传递视频数据，该方案在 iOS 和 Android 系统下均有较高的效率，Windows 暂不支持，需要您有一定的 OpenGL 编程基础。
 
 | 枚举 | 取值 | 描述 |
 | --- | --- | --- |
@@ -231,11 +231,11 @@ TRTC 提供针对视频的自定义采集和自定义渲染功能：
 **本地视频截图的数据源。**
 
 SDK 支持从如下两种数据源中截取图片并保存成本地文件：
--  视频流：从视频流中截取原生的视频内容，截取的内容不受渲染控件的显示控制。
+- 视频流：从视频流中截取原生的视频内容，截取的内容不受渲染控件的显示控制。
 
--  渲染层：从渲染控件中截取显示的视频内容，可以做到用户所见即所得的效果，但如果显示区域过小，截取出的图片也会很小。
+- 渲染层：从渲染控件中截取显示的视频内容，可以做到用户所见即所得的效果，但如果显示区域过小，截取出的图片也会很小。
 
--  采集层：从采集控件中截取采集到的视频内容，可以截取采集出来的高清截图。
+- 采集层：从采集控件中截取采集到的视频内容，可以截取采集出来的高清截图。
 
 |枚举|取值|描述|
 |---------|---------|---------|
@@ -248,10 +248,10 @@ SDK 支持从如下两种数据源中截取图片并保存成本地文件：
 **应用场景。**
 
 TRTC 针对常见的音视频应用场景都进行了定向优化，以满足各种垂直场景下的差异化要求，主要场景可以分为如下两类：
--  直播（LIVE）场景：包括 LIVE 和 VoiceChatRoom，前者是音频+视频，后者是纯音频。
+- 直播（LIVE）场景：包括 LIVE 和 VoiceChatRoom，前者是音频+视频，后者是纯音频。
 
 直播场景下，用户被分成“主播”和“观众”两种角色，单个房间中同时最多支持10万人在线，适合于观众人数众多的直播场景。
--  实时（RTC）场景：包括 VideoCall 和 AudioCall，前者是音频+视频，后者是纯音频。
+- 实时（RTC）场景：包括 VideoCall 和 AudioCall，前者是音频+视频，后者是纯音频。
 
 实时场景下，用户没有角色的差异，但单个房间中同时最多支持 300 人在线，适合于小范围实时通信的场景。
 | 枚举 | 取值 | 描述 |
@@ -266,9 +266,9 @@ TRTC 针对常见的音视频应用场景都进行了定向优化，以满足各
 **角色。**
 
 仅适用于直播类场景（即 TRTC_APP_SCENE_LIVE 和 TRTC_APP_SCENE_VOICE_CHATROOM），把用户区分成两种不同的身份：
--  主播：可以随时发布自己的音视频流，但人数有限制，同一个房间中最多只允许 50 个主播同时发布自己的音视频流。
+- 主播：可以随时发布自己的音视频流，但人数有限制，同一个房间中最多只允许 50 个主播同时发布自己的音视频流。
 
--  观众：只能观看其他用户的音视频流，要发布音视频流，需要先通过 switchRole 切换成主播，同一个房间中最多能容纳10万观众。
+- 观众：只能观看其他用户的音视频流，要发布音视频流，需要先通过 switchRole 切换成主播，同一个房间中最多能容纳10万观众。
 
 |枚举|取值|描述|
 |---------|---------|---------|
@@ -358,11 +358,11 @@ TRTC 会每隔两秒对当前的网络质量进行评估，评估结果为六个
 **声音音质。**
 
 TRTC 提供了三种精心校调好的模式，用来满足各种垂直场景下对音质的差异化追求：
--  人声模式（Speech）：适用于以人声沟通为主的应用场景，该模式下音频传输的抗性较强，TRTC 会通过各种人声处理技术保障在弱网络环境下的流畅度最佳。
+- 人声模式（Speech）：适用于以人声沟通为主的应用场景，该模式下音频传输的抗性较强，TRTC 会通过各种人声处理技术保障在弱网络环境下的流畅度最佳。
 
--  音乐模式（Music）：适用于对声乐要求很苛刻的场景，该模式下音频传输的数据量很大，TRTC 会通过各项技术确保音乐信号在各频段均能获得高保真的细节还原度。
+- 音乐模式（Music）：适用于对声乐要求很苛刻的场景，该模式下音频传输的数据量很大，TRTC 会通过各项技术确保音乐信号在各频段均能获得高保真的细节还原度。
 
--  默认模式（Default）：介于 Speech 和 Music 之间的档位，对音乐的还原度比人声模式要好，但传输数据量比音乐模式要低很多，对各种场景均有不错的适应性。
+- 默认模式（Default）：介于 Speech 和 Music 之间的档位，对音乐的还原度比人声模式要好，但传输数据量比音乐模式要低很多，对各种场景均有不错的适应性。
 
 |枚举|取值|描述|
 |---------|---------|---------|
@@ -377,15 +377,15 @@ TRTC 提供了三种精心校调好的模式，用来满足各种垂直场景下
 音频路由，即声音是从手机的扬声器还是从听筒中播放出来，因此该接口仅适用于手机等移动端设备。
 
 手机有两个扬声器：一个是位于手机顶部的听筒，一个是位于手机底部的立体声扬声器。
--  设置音频路由为听筒时，声音比较小，只有将耳朵凑近才能听清楚，隐私性较好，适合用于接听电话。
+- 设置音频路由为听筒时，声音比较小，只有将耳朵凑近才能听清楚，隐私性较好，适合用于接听电话。
 
--  设置音频路由为扬声器时，声音比较大，不用将手机贴脸也能听清，因此可以实现“免提”的功能。
+- 设置音频路由为扬声器时，声音比较大，不用将手机贴脸也能听清，因此可以实现“免提”的功能。
 
--  音频路由为有线耳机。
+- 音频路由为有线耳机。
 
--  音频路由为蓝牙耳机。
+- 音频路由为蓝牙耳机。
 
--  音频路由为USB专业声卡设备。
+- 音频路由为USB专业声卡设备。
 
 |枚举|取值|描述|
 |---------|---------|---------|
@@ -439,9 +439,9 @@ TRTC 提供了三种精心校调好的模式，用来满足各种垂直场景下
 **系统音量类型（仅适用于移动设备）。**
 
 现代智能手机中一般都具备两套系统音量类型，即“通话音量”和“媒体音量”。
--  通话音量：手机专门为接打电话所设计的音量类型，自带回声抵消（AEC）功能，并且支持通过蓝牙耳机上的麦克风进行拾音，缺点是音质比较一般。当您通过手机侧面的音量按键下调手机音量时，如果无法将其调至零（也就是无法彻底静音），说明您的手机当前处于通话音量。
+- 通话音量：手机专门为接打电话所设计的音量类型，自带回声抵消（AEC）功能，并且支持通过蓝牙耳机上的麦克风进行拾音，缺点是音质比较一般。当您通过手机侧面的音量按键下调手机音量时，如果无法将其调至零（也就是无法彻底静音），说明您的手机当前处于通话音量。
 
--  媒体音量：手机专门为音乐场景所设计的音量类型，无法使用系统的 AEC 功能，并且不支持通过蓝牙耳机的麦克风进行拾音，但具备更好的音乐播放效果。当您通过手机侧面的音量按键下调手机音量时，如果能够将手机音量调至彻底静音，说明您的手机当前处于媒体音量。
+- 媒体音量：手机专门为音乐场景所设计的音量类型，无法使用系统的 AEC 功能，并且不支持通过蓝牙耳机的麦克风进行拾音，但具备更好的音乐播放效果。当您通过手机侧面的音量按键下调手机音量时，如果能够将手机音量调至彻底静音，说明您的手机当前处于媒体音量。
 
 SDK 目前提供了三种系统音量类型的控制模式：自动切换模式、全程通话音量模式、全程媒体音量模式。
 | 枚举 | 取值 | 描述 |
@@ -474,9 +474,9 @@ SDK 目前提供了两种系统音频能力类型是否支持的查询：低延
 **音频回调数据读写模式。**
 
 TRTC 提供了两种音频回调数据的操作模式。
--  读写模式（ReadWrite）：可以获取并修改回调的音频数据，默认模式。
+- 读写模式（ReadWrite）：可以获取并修改回调的音频数据，默认模式。
 
--  只读模式（ReadOnly）：仅从回调中获取音频数据。
+- 只读模式（ReadOnly）：仅从回调中获取音频数据。
 
 |枚举|取值|描述|
 |---------|---------|---------|
@@ -518,10 +518,10 @@ TRTC 的云端混流服务能够将房间中的多路音视频流混合成一路
 | 枚举 | 取值 | 描述 |
 | --- | --- | --- |
 | TRTC_TranscodingConfigMode_Unknown | 0 | 未定义。 |
-| TRTC_TranscodingConfigMode_Manual | 1 | 全手动排版模式。<br>该模式下，您需要指定每一路画面的精确排版位置。该模式的自由度最高，但易用性也最差：<br>-  您需要填写 TRTCTranscodingConfig 中的所有参数，包括每一路画面（TRTCMixUser）的位置坐标。<br>-  您需要监听 TRTCCloudListener 中的 onUserVideoAvailable 和 onUserAudioAvailable 事件回调，并根据当前房间中各个麦上用户的音视频状态不断地调整  <code>mixUsers</code>  参数。 |
-| TRTC_TranscodingConfigMode_Template_PureAudio | 2 | 纯音频模式。<br>该模式适用于语音通话（AudioCall）和语音聊天室（VoiceChatRoom）等纯音频的应用场景。<br>-  您只需要在进入房间后，通过 setMixTranscodingConfig 接口设置一次，之后 SDK 就会自动把房间内所有上麦用户的声音混流到当前用户的直播流上。<br>-  您无需设置 TRTCTranscodingConfig 中的  <code>mixUsers</code>  参数，只需设置  <code>audioSampleRate</code> 、 <code>audioBitrate</code>  和  <code>audioChannels</code>  等参数即可。 |
-| TRTC_TranscodingConfigMode_Template_PresetLayout | 3 | 预排版模式。<br>最受欢迎的排版模式，因为该模式支持您通过占位符提前对各路画面的位置进行设定，之后 SDK 会自动根据房间中画面的路数动态进行适配调整。<br>此模式下，您依然需要设置 mixUsers 参数，但可以将 userId 设置为“占位符”，可选的占位符有：<br>-  "$PLACE_HOLDER_REMOTE$"     :  指代远程用户的画面，可以设置多个。<br>-  "$PLACE_HOLDER_LOCAL_MAIN$" ： 指代本地摄像头画面，只允许设置一个。<br>-  "$PLACE_HOLDER_LOCAL_SUB$"  :  指代本地屏幕分享画面，只允许设置一个。<br>此模式下，您不需要监听 TRTCCloudListener 中的 onUserVideoAvailable 和 onUserAudioAvailable 回调进行实时调整，只需要在进房成功后调用一次 setMixTranscodingConfig 即可，之后 SDK 会自动将真实的 userId 补位到您设置的占位符上。 |
-| TRTC_TranscodingConfigMode_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) 三种分辨率中的一种。 |
+| TRTC_TranscodingConfigMode_Manual | 1 | 全手动排版模式。<br>该模式下，您需要指定每一路画面的精确排版位置。该模式的自由度最高，但易用性也最差：<br>- 您需要填写 TRTCTranscodingConfig 中的所有参数，包括每一路画面（TRTCMixUser）的位置坐标。<br>- 您需要监听 TRTCCloudListener 中的 onUserVideoAvailable 和 onUserAudioAvailable 事件回调，并根据当前房间中各个麦上用户的音视频状态不断地调整  <code>mixUsers</code>  参数。 |
+| TRTC_TranscodingConfigMode_Template_PureAudio | 2 | 纯音频模式。<br>该模式适用于语音通话（AudioCall）和语音聊天室（VoiceChatRoom）等纯音频的应用场景。<br>- 您只需要在进入房间后，通过 setMixTranscodingConfig 接口设置一次，之后 SDK 就会自动把房间内所有上麦用户的声音混流到当前用户的直播流上。<br>- 您无需设置 TRTCTranscodingConfig 中的  <code>mixUsers</code>  参数，只需设置  <code>audioSampleRate</code> 、 <code>audioBitrate</code>  和  <code>audioChannels</code>  等参数即可。 |
+| TRTC_TranscodingConfigMode_Template_PresetLayout | 3 | 预排版模式。<br>最受欢迎的排版模式，因为该模式支持您通过占位符提前对各路画面的位置进行设定，之后 SDK 会自动根据房间中画面的路数动态进行适配调整。<br>此模式下，您依然需要设置 mixUsers 参数，但可以将 userId 设置为“占位符”，可选的占位符有：<br>- "$PLACE_HOLDER_REMOTE$"     :  指代远程用户的画面，可以设置多个。<br>- "$PLACE_HOLDER_LOCAL_MAIN$" ： 指代本地摄像头画面，只允许设置一个。<br>- "$PLACE_HOLDER_LOCAL_SUB$"  :  指代本地屏幕分享画面，只允许设置一个。<br>此模式下，您不需要监听 TRTCCloudListener 中的 onUserVideoAvailable 和 onUserAudioAvailable 回调进行实时调整，只需要在进房成功后调用一次 setMixTranscodingConfig 即可，之后 SDK 会自动将真实的 userId 补位到您设置的占位符上。 |
+| TRTC_TranscodingConfigMode_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
 
@@ -580,7 +580,7 @@ TRTC 的云端混流服务能够将房间中的多路音视频流混合成一路
 | TRTC_PublishBigStream_ToCdn | 1 | 您可以通过设置该参数将您房间内的主路流（TRTC_VIDEO_STREAM_TYPE_BIG）发布到腾讯或者第三方直播 CDN 服务商（仅支持标准 RTMP 协议）。 |
 | TRTC_PublishSubStream_ToCdn | 2 | 您可以通过设置该参数将您房间内的辅路流（TRTC_VIDEO_STREAM_TYPE_SUB）发布到腾讯或者第三方直播 CDN 服务商（仅支持标准 RTMP 协议）。 |
 | TRTC_PublishMixStream_ToCdn | 3 | 您可以通过设置该参数，配合编码输出参数 (TRTCStreamEncoderParam) 和混流转码参数 (TRTCStreamMixingConfig)，将您指定的多路音视频流进行转码并发布到腾讯或者第三方直播 CDN 服务商（仅支持标准 RTMP 协议）。 |
-| TRTC_PublishMixStream_ToRoom | 4 | 您可以通过设置该参数，配合媒体流编码输出参数 (TRTCStreamEncoderParam) 和混流转码参数 (TRTCStreamMixingConfig)，将您指定的多路音视频流进行转码并发布到您指定的房间中。<br>-  通过 TRTCPublishTarget 中的 TRTCUser 进行指定回推房间的机器人信息。 |
+| TRTC_PublishMixStream_ToRoom | 4 | 您可以通过设置该参数，配合媒体流编码输出参数 (TRTCStreamEncoderParam) 和混流转码参数 (TRTCStreamMixingConfig)，将您指定的多路音视频流进行转码并发布到您指定的房间中。<br>- 通过 TRTCPublishTarget 中的 TRTCUser 进行指定回推房间的机器人信息。 |
 
 ## TRTCEncryptionAlgorithm
 
@@ -633,7 +633,7 @@ v11.7 版本开始支持，只在 SDK 内部摄像头采集场景生效
 | role | 【字段含义】直播场景下的角色，仅适用于直播场景（TRTC_APP_SCENE_LIVE 和 TRTC_APP_SCENE_VOICE_CHATROOM），通话场景下指定该参数是无效的。<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 看来是两个完全不同的房间。 |
 | 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 看来是两个完全不同的房间。 |
+| 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”。 |
@@ -647,10 +647,10 @@ 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 对视频码率的自适应调节能力。 |
+| 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 对视频码率的自适应调节能力。 |
 | 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，即横屏分辨率。 |
+| 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，即横屏分辨率。 |
 | videoResolutionMode | 【字段含义】分辨率模式（横屏分辨率 or 竖屏分辨率）。<br>【推荐取值】手机平台（iOS、Android）建议选择 Portrait，桌面平台（Windows、Mac）建议选择 Landscape。<br>【特别说明】如需使用竖屏分辨率，请指定 resMode 为 Portrait，例如：  <code>640 × 360 + Portrait = 360 × 640</code> 。 |
 
 ## TRTCNetworkQosParam
@@ -661,7 +661,7 @@ v11.7 版本开始支持，只在 SDK 内部摄像头采集场景生效
 | 枚举类型 | 描述 |
 | --- | --- |
 | controlMode | 【字段含义】流控模式（已废弃）。<br>【推荐取值】云端控制。<br>【特别说明】请设置为云端控制模式（TRTCQosControlModeServer）。 |
-| preference | 【字段含义】清晰优先还是流畅优先。<br>【推荐取值】清晰优先。<br>【特别说明】该参数主要影响 TRTC 在较差网络环境下的音视频表现：<br>-  流畅优先：即当前网络不足以传输既清晰又流畅的画面时，优先保证画面的流畅性，代价就是画面会比较模糊且伴随有较多的马赛克。参见 TRTC_VIDEO_QOS_PREFERENCE_SMOOTH<br>-  清晰优先（默认值）：即当前网络不足以传输既清晰又流畅的画面时，优先保证画面的清晰度，代价就是画面会比较卡顿。参见 TRTC_VIDEO_QOS_PREFERENCE_CLEAR |
+| preference | 【字段含义】清晰优先还是流畅优先。<br>【推荐取值】清晰优先。<br>【特别说明】该参数主要影响 TRTC 在较差网络环境下的音视频表现：<br>- 流畅优先：即当前网络不足以传输既清晰又流畅的画面时，优先保证画面的流畅性，代价就是画面会比较模糊且伴随有较多的马赛克。参见 TRTC_VIDEO_QOS_PREFERENCE_SMOOTH<br>- 清晰优先（默认值）：即当前网络不足以传输既清晰又流畅的画面时，优先保证画面的清晰度，代价就是画面会比较卡顿。参见 TRTC_VIDEO_QOS_PREFERENCE_CLEAR |
 
 ## TRTCRenderParams
 
@@ -778,9 +778,10 @@ TRTCVideoFrame 用来描述一帧视频画面的裸数据，也就是编码前
 TRTCMixUser 用于指定云端混流中每一路视频画面的位置、大小、图层以及流类型等信息。
 | 枚举类型 | 描述 |
 | --- | --- |
+| cornerRadius | 【字段含义】视频画面圆角半径（单位：像素）。上行视频流在按照 renderMode 渲染后，对其最终画面进行圆角裁剪。<br>【默认取值】0，即不进行圆角处理。<br>【取值范围】[0, min(width, height) / 2]，即最大不超过画面短边的一半。<br>【特别说明】该参数仅在 renderMode 为 0（裁剪模式）时生效。 |
 | height | 【字段含义】指定该路画面的高度（单位：像素）。 |
-| image | 【字段含义】占位图或水印图<br>-  占位图是指当对应 userId 混流内容为纯音频时，混合后的画面中显示的是占位图片。<br>-  水印图是指一张贴在混合后画面中的半透明图片，这张图片会一直覆盖于混合后的画面上。<br>-  当指定 inputType 为 TRTC_MixInputType_PureAudio 时，image 为占位图，此时需要您指定 userId。<br>-  当指定 inputType 为 TRTCCloudDef.TRTC_MixInputType_Watermark 时，image 为水印图，此时不需要您指定 userId。<br>【推荐取值】默认值：空值，即不设置占位图或者水印图。<br>【特别说明】<br>-  您可以将 image 设置为控制台中的某一个素材 ID，这需要您事先在 “<a href="https://console.cloud.tencent.com/trtc">控制台</a> => 应用管理 => 功能配置 => 素材管理” 中单击 [新增图片] 按钮进行上传。<br>-  上传成功后可以获得对应的“图片ID”，然后将“图片ID”转换成字符串类型并设置给 image 字段即可（例如假设“图片ID” 为 63，可以设置 image = @"63"）。<br>-  您也可以将 image 设置为图片的 URL 地址，腾讯云的后台服务器会将该 URL 地址指定的图片混合到最终的画面中。<br>-  URL 链接长度限制为 512 字节。图片大小限制不超过 2MB。<br>-  图片格式支持 png、jpg、jpeg、bmp 格式，推荐使用 png 格式的半透明图片作为水印。<br>-  image 仅在 inputType 为 TRTC_MixInputType_PureAudio 或者 TRTCCloudDef.TRTC_MixInputType_Watermark 时才生效。 |
-| inputType | 【字段含义】指定该路流的混合内容（只混音频、只混视频、混合音视频、混入水印）。<br>【默认取值】默认值：TRTC_MixInputType_Undefined。<br>【特别说明】<br>-  当指定 inputType 为 TRTC_MixInputType_Undefined 并设置 pureAudio 为 YES 时，等效于设置 inputType 为 TRTC_MixInputType_PureAudio。<br>-  当指定 inputType 为 TRTC_MixInputType_Undefined 并设置 pureAudio 为 NO 时，等效于设置 inputType 为 TRTC_MixInputType_AudioVideo。<br>-  当指定 inputType 为 TRTCCloudDef.TRTC_MixInputType_Watermark 时，您可以不指定 userId 字段，但需要指定 image 字段。 |
+| image | 【字段含义】占位图或水印图<br>- 占位图是指当对应 userId 混流内容为纯音频时，混合后的画面中显示的是占位图片。<br>- 水印图是指一张贴在混合后画面中的半透明图片，这张图片会一直覆盖于混合后的画面上。<br>- 当指定 inputType 为 TRTC_MixInputType_PureAudio 时，image 为占位图，此时需要您指定 userId。<br>- 当指定 inputType 为 TRTCCloudDef.TRTC_MixInputType_Watermark 时，image 为水印图，此时不需要您指定 userId。<br>【推荐取值】默认值：空值，即不设置占位图或者水印图。<br>【特别说明】<br>- 您可以将 image 设置为控制台中的某一个素材 ID，这需要您事先在 “<a href="https://console.cloud.tencent.com/trtc">控制台</a> => 应用管理 => 功能配置 => 素材管理” 中单击 [新增图片] 按钮进行上传。<br>- 上传成功后可以获得对应的“图片ID”，然后将“图片ID”转换成字符串类型并设置给 image 字段即可（例如假设“图片ID” 为 63，可以设置 image = @"63"）。<br>- 您也可以将 image 设置为图片的 URL 地址，腾讯云的后台服务器会将该 URL 地址指定的图片混合到最终的画面中。<br>- URL 链接长度限制为 512 字节。图片大小限制不超过 2MB。<br>- 图片格式支持 png、jpg、jpeg、bmp 格式，推荐使用 png 格式的半透明图片作为水印。<br>- image 仅在 inputType 为 TRTC_MixInputType_PureAudio 或者 TRTCCloudDef.TRTC_MixInputType_Watermark 时才生效。 |
+| inputType | 【字段含义】指定该路流的混合内容（只混音频、只混视频、混合音视频、混入水印）。<br>【默认取值】默认值：TRTC_MixInputType_Undefined。<br>【特别说明】<br>- 当指定 inputType 为 TRTC_MixInputType_Undefined 并设置 pureAudio 为 YES 时，等效于设置 inputType 为 TRTC_MixInputType_PureAudio。<br>- 当指定 inputType 为 TRTC_MixInputType_Undefined 并设置 pureAudio 为 NO 时，等效于设置 inputType 为 TRTC_MixInputType_AudioVideo。<br>- 当指定 inputType 为 TRTCCloudDef.TRTC_MixInputType_Watermark 时，您可以不指定 userId 字段，但需要指定 image 字段。 |
 | pureAudio | 【字段含义】指定该路流是不是只混合声音。<br>【推荐取值】默认值：false。<br>【特别说明】已废弃，推荐使用8.5版本开始新引入的字段：inputType。 |
 | renderMode | 【字段含义】该画面在输出时的显示模式。<br>【推荐取值】默认值：视频流默认为0。0为裁剪，1为缩放，2为缩放并显示黑底。<br>【特别说明】水印图和占位图暂时不支持设置 renderMode，默认强制拉伸处理。 |
 | roomId | 【字段含义】该路音视频流所在的房间号（设置为空值代表当前用户所在的房间号）。 |
@@ -805,16 +806,16 @@ TRTCMixUser 用于指定云端混流中每一路视频画面的位置、大小
 | audioCodec | 【字段含义】指定云端转码的输出流音频编码类型。<br>【推荐取值】默认值：0，代表LC-AAC。可设定的数值只有三个数字：0 - LC-AAC，1 - HE-AAC，2 - HE-AACv2。<br>【特别说明】HE-AAC 和 HE-AACv2 支持的输出流音频采样率范围为[48000, 44100, 32000, 24000, 16000]。<br>【特别说明】当音频编码设置为 HE-AACv2 时，只支持输出流音频声道数为双声道。<br>【特别说明】HE-AAC 和 HE-AACv2 取值仅在输出流为您额外设置的 streamId 上时才生效。 |
 | audioSampleRate | 【字段含义】指定云端转码的目标音频采样率。<br>【推荐取值】默认值：48000Hz。支持12000Hz、16000Hz、22050Hz、24000Hz、32000Hz、44100Hz、48000Hz。 |
 | backgroundColor | 【字段含义】指定混合画面的底色颜色。<br>【推荐取值】默认值：0x000000 代表黑色。格式为十六进制数字，例如：“0x61B9F1” 代表 RGB 分别为(97,158,241)。 |
-| backgroundImage | 【字段含义】指定混合画面的背景图片。<br>【推荐取值】默认值：空值，即不设置背景图片。<br>【特别说明】<br>-  您可以将 image 设置为控制台中的某一个素材 ID，这需要您事先在 “<a href="https://console.cloud.tencent.com/trtc">控制台</a> => 应用管理 => 功能配置 => 素材管理” 中单击 [新增图片] 按钮进行上传。<br>-  上传成功后可以获得对应的“图片ID”，然后将“图片ID”转换成字符串类型并设置给 image 字段即可（例如假设“图片ID” 为 63，可以设置 image = @"63"）。<br>-  您也可以将 image 设置为图片的 URL 地址，腾讯云的后台服务器会将该 URL 地址指定的图片混合到最终的画面中。<br>-  URL 链接长度限制为 512 字节。图片大小限制不超过 2MB。<br>-  图片格式支持 png、jpg、jpeg、bmp 格式。 |
+| backgroundImage | 【字段含义】指定混合画面的背景图片。<br>【推荐取值】默认值：空值，即不设置背景图片。<br>【特别说明】<br>- 您可以将 image 设置为控制台中的某一个素材 ID，这需要您事先在 “<a href="https://console.cloud.tencent.com/trtc">控制台</a> => 应用管理 => 功能配置 => 素材管理” 中单击 [新增图片] 按钮进行上传。<br>- 上传成功后可以获得对应的“图片ID”，然后将“图片ID”转换成字符串类型并设置给 image 字段即可（例如假设“图片ID” 为 63，可以设置 image = @"63"）。<br>- 您也可以将 image 设置为图片的 URL 地址，腾讯云的后台服务器会将该 URL 地址指定的图片混合到最终的画面中。<br>- URL 链接长度限制为 512 字节。图片大小限制不超过 2MB。<br>- 图片格式支持 png、jpg、jpeg、bmp 格式。 |
 | bizId | 【字段含义】腾讯云直播服务的 bizid。<br>【推荐取值】请在 <a href="https://console.cloud.tencent.com/trtc">实时音视频控制台</a> 依次单击【应用管理】=>【应用信息】，并在【旁路直播信息】中获取 bizid。<br>【特别说明】2020年01月09日及此后新建的应用无需再填写该字段。 |
 | mixUsers | 【字段含义】指定云端混流中每一路视频画面的位置、大小、图层以及流类型等信息。<br>【推荐取值】该字段是一个 TRTCMixUser 类型的数组，数组中的每一个元素都用来代表每一路画面的信息。 |
 | mode | 【字段含义】排版模式。<br>【推荐取值】请根据您的业务场景要求自行选择，预排版模式是适用性较好的一种模式。 |
-| streamId | 【字段含义】输出到 CDN 上的直播流 ID。<br>【推荐取值】默认值：空值，即房间里的多路音视频流最终会混合到接口调用者的那一路音视频流上。<br>-  如不设置该参数，SDK 会执行默认逻辑，即房间里的多路音视频流会混合到该接口调用者的那一路音视频流上，也就是 A + B => A。<br>-  如您设置该参数，SDK 会将房间里的多路音视频流混合到您指定的直播流上，也就是 A + B => C（C 代表您指定的 streamId）。 |
+| streamId | 【字段含义】输出到 CDN 上的直播流 ID。<br>【推荐取值】默认值：空值，即房间里的多路音视频流最终会混合到接口调用者的那一路音视频流上。<br>- 如不设置该参数，SDK 会执行默认逻辑，即房间里的多路音视频流会混合到该接口调用者的那一路音视频流上，也就是 A + B => A。<br>- 如您设置该参数，SDK 会将房间里的多路音视频流混合到您指定的直播流上，也就是 A + B => C（C 代表您指定的 streamId）。 |
 | videoBitrate | 【字段含义】指定云端转码的目标视频码率（kbps）。<br>【推荐取值】如果填0，TRTC 会根据 videoWidth 和 videoHeight 估算出一个合理的码率值，您也可以参考视频分辨率枚举定义中所推荐的码率值（见注释部分）。 |
 | videoFramerate | 【字段含义】指定云端转码的目标视频帧率（FPS）。<br>【推荐取值】默认值：15fps，取值范围是 (0,30]。 |
 | videoGOP | 【字段含义】指定云端转码的目标视频关键帧间隔（GOP）。<br>【推荐取值】默认值：2，单位为秒，取值范围是 [1,8]。 |
 | videoHeight | 【字段含义】指定云端转码的目标分辨率（高度）。<br>【推荐取值】单位：像素值，推荐值：640，如果您只混合音频流，请将 width 和 height 均设置为 0，否则混流转码后的直播流中会有黑色背景。 |
-| videoSeiParams | 【字段含义】混流 SEI 参数，默认不填写。<br>【特别说明】参数以 json 字符串形式传入，示例如下：<br>`{`<br>`  "payLoadContent":"xxx",`<br>`  "payloadType":5,`<br>`  "payloadUuid":"1234567890abcdef1234567890abcdef",`<br>`  "interval":1000,`<br>`  "followIdr":false`<br>`}`<br>当前支持的字段及含义：<br>-  payloadContent: 必填。透传 sei 的 payload 内容，不能为空；<br>-  payloadType: 必填。sei 消息的类型，取值范围: 5 或 [100, 254] 范围内的整数（244 除外，244 是内部自定义的时间戳 sei）；<br>-  payloadUuid: 当 payloadType 为 5 时必须填写，其他情况下该值会被忽略。该值必须是长度为 32 的十六进制数字；<br>-  interval: 选填，默认 1000。sei 的发送间隔，单位毫秒；<br>-  followIdr: 选填，默认 false。该值为 true 时，发送关键帧时会确保带 sei，否则不确保。 |
+| videoSeiParams | 【字段含义】混流 SEI 参数，默认不填写。<br>【特别说明】参数以 json 字符串形式传入，示例如下：<br>`{`<br>`"payLoadContent":"xxx",`<br>`"payloadType":5,`<br>`"payloadUuid":"1234567890abcdef1234567890abcdef",`<br>`"interval":1000,`<br>`"followIdr":false`<br>`}`<br>当前支持的字段及含义：<br>- payloadContent: 必填。透传 sei 的 payload 内容，不能为空；<br>- payloadType: 必填。sei 消息的类型，取值范围: 5 或 [100, 254] 范围内的整数（244 除外，244 是内部自定义的时间戳 sei）；<br>- payloadUuid: 当 payloadType 为 5 时必须填写，其他情况下该值会被忽略。该值必须是长度为 32 的十六进制数字；<br>- interval: 选填，默认 1000。sei 的发送间隔，单位毫秒；<br>- followIdr: 选填，默认 false。该值为 true 时，发送关键帧时会确保带 sei，否则不确保。 |
 | videoWidth | 【字段含义】指定云端转码的目标分辨率（宽度）。<br>【推荐取值】单位：像素值，推荐值：360，如果您只混合音频流，请将 width 和 height 均设置为 0，否则混流转码后的直播流中会有黑色背景。 |
 
 ## TRTCPublishCDNParam
@@ -918,7 +919,7 @@ TRTC 中的“音效”特指一些短暂的音频文件，通常仅有几秒钟
 | 枚举类型 | 描述 |
 | --- | --- |
 | includeUsers | 【字段含义】指定用户必定能并发播放。<br>【特别说明】指定必定并发播放的用户 ID 列表。这些用户不参与智能选择。<br>includeUsers 的数量必须小于 maxCount，否则本次并发播放设置失效。<br>includeUsers 仅在 maxCount > 0 时有效。当 includeUsers 生效时，参与智能并发选择的最大播放数 = maxCount - 有效 includeUsers 的数量。 |
-| maxCount | 【字段含义】最大并发播放数。默认值：0。<br>-  如果 maxCount > 0，且实际人数 > maxCount，会实时智能选出 maxCount 路数据进行播放，这会极大的降低性能消耗。<br>-  如果 maxCount = 0，SDK 不限制并发播放数，在上麦人数比较多的房间可能会引发性能问题。 |
+| maxCount | 【字段含义】最大并发播放数。默认值：0。<br>- 如果 maxCount > 0，且实际人数 > maxCount，会实时智能选出 maxCount 路数据进行播放，这会极大的降低性能消耗。<br>- 如果 maxCount = 0，SDK 不限制并发播放数，在上麦人数比较多的房间可能会引发性能问题。 |
 
 ## TRTCUser
 
@@ -928,7 +929,7 @@ TRTC 中的“音效”特指一些短暂的音频文件，通常仅有几秒钟
 | 枚举类型 | 描述 |
 | --- | --- |
 | 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
@@ -962,11 +963,12 @@ TRTC 中的“音效”特指一些短暂的音频文件，通常仅有几秒钟
 | 枚举类型 | 描述 |
 | --- | --- |
 | backgroundColor | 【字段含义】指定混合画面的底色颜色。<br>【推荐取值】默认值：0x000000 代表黑色。格式为十六进制数字，例如：“0x61B9F1” 代表 RGB 分别为 (97,158,241)。 |
+| cornerRadius | 【字段含义】视频画面圆角半径（单位：像素）。上行视频流在按照 fillMode 渲染后，对其最终画面进行圆角裁剪。<br>【默认取值】0，即不进行圆角处理。<br>【取值范围】[0, min(width, height) / 2]，即最大不超过画面短边的一半。 |
 | fillMode | 【字段含义】画面填充模式。<br>【推荐取值】填充（画面可能会被拉伸裁剪）或适应（画面可能会有黑边），默认值：TRTC_VIDEO_RENDER_MODE_FILL。 |
 | fixedVideoStreamType | 【字段含义】指定该路画面是主路画面（TRTC_VIDEO_STREAM_TYPE_BIG）还是辅路画面（TRTC_VIDEO_STREAM_TYPE_SUB）。 |
 | fixedVideoUser | 【字段含义】参与转码的用户信息。<br>【特别说明】用户信息 (TRTCUser) 支持不填写（即 userId、intRoomId 和 strRoomId 均不填写）。此时当发起混流的房间中有主播上行音视频数据时，TRTC 后台服务器将自动将对应主播音视频填充到您指定的布局中。 |
 | height | 【字段含义】指定该路画面的高度（单位：像素）。 |
-| placeHolderImage | 【字段含义】占位图 URL，即当指定用户暂时仅上行音频时，腾讯云的后台服务器会将该 URL 地址指定的图片混合到最终的画面中。<br>【推荐取值】默认值：空值，即不设置占位图。<br>【特别说明】此时需要您指定用户信息 fixedVideoUser 中的 userId。<br>【特别说明】<br>-  URL 链接长度限制为 512 字节。图片大小限制不超过 2MB。<br>-  图片格式支持 png、jpg、jpeg、bmp 格式，推荐使用 png 格式的半透明图片作为占位图。 |
+| placeHolderImage | 【字段含义】占位图 URL，即当指定用户暂时仅上行音频时，腾讯云的后台服务器会将该 URL 地址指定的图片混合到最终的画面中。<br>【推荐取值】默认值：空值，即不设置占位图。<br>【特别说明】此时需要您指定用户信息 fixedVideoUser 中的 userId。<br>【特别说明】<br>- URL 链接长度限制为 512 字节。图片大小限制不超过 2MB。<br>- 图片格式支持 png、jpg、jpeg、bmp 格式，推荐使用 png 格式的半透明图片作为占位图。 |
 | width | 【字段含义】指定该路画面的宽度（单位：像素）。 |
 | x | 【字段含义】指定该路画面的 x 坐标（单位：像素）。 |
 | y | 【字段含义】指定该路画面的 y 坐标（单位：像素）。 |
@@ -980,7 +982,7 @@ TRTC 中的“音效”特指一些短暂的音频文件，通常仅有几秒钟
 | 枚举类型 | 描述 |
 | --- | --- |
 | height | 【字段含义】指定该路水印画面的高度（单位：像素）。 |
-| watermarkUrl | 【字段含义】水印 URL，腾讯云的后台服务器会将该 URL 地址指定的图片混合到最终的画面中。<br>【特别说明】<br>-  URL 链接长度限制为 512 字节。图片大小限制不超过 2MB。<br>-  图片格式支持 png、jpg、jpeg、bmp 格式，推荐使用 png 格式的半透明图片作为水印。 |
+| watermarkUrl | 【字段含义】水印 URL，腾讯云的后台服务器会将该 URL 地址指定的图片混合到最终的画面中。<br>【特别说明】<br>- URL 链接长度限制为 512 字节。图片大小限制不超过 2MB。<br>- 图片格式支持 png、jpg、jpeg、bmp 格式，推荐使用 png 格式的半透明图片作为水印。 |
 | width | 【字段含义】指定该路水印画面的宽度（单位：像素）。 |
 | x | 【字段含义】指定该路水印画面的 x 坐标（单位：像素）。 |
 | y | 【字段含义】指定该路水印画面的 y 坐标（单位：像素）。 |
@@ -1007,7 +1009,7 @@ TRTC 中的“音效”特指一些短暂的音频文件，通常仅有几秒钟
 | videoEncodedHeight | 【字段含义】指定媒体发布流的目标分辨率（高度）。<br>【推荐取值】单位：像素值，推荐值：640，如果您只混合音频流，请将 width 和 height 均设置为 0，否则混流转码后的直播流中会有黑色背景。 |
 | videoEncodedKbps | 【字段含义】指定媒体发布流的目标视频码率（kbps）。<br>【推荐取值】如果填 0，TRTC 会根据 videoEncodedWidth 和 videoEncodedHeight 估算出一个合理的码率值，您也可以参考视频分辨率枚举定义中所推荐的码率值（见注释部分）。 |
 | videoEncodedWidth | 【字段含义】指定媒体发布流的目标分辨率（宽度）。<br>【推荐取值】单位：像素值，推荐值：368，如果您只混合音频流，请将 width 和 height 均设置为 0，否则混流转码后的直播流中会有黑色背景。 |
-| videoSeiParams | 【字段含义】混流 SEI 参数，默认不填写。<br>【特别说明】参数以 json 字符串形式传入，示例如下：<br>`{`<br>`  "payLoadContent":"xxx",`<br>`  "payloadType":5,`<br>`  "payloadUuid":"1234567890abcdef1234567890abcdef",`<br>`  "interval":1000,`<br>`  "followIdr":false`<br>`}`<br>当前支持的字段及含义：<br>-  payloadContent: 必填。透传 sei 的 payload 内容，不能为空；<br>-  payloadType: 必填。sei 消息的类型，取值范围: 5 或 [100, 254] 范围内的整数（244 除外，244 是内部自定义的时间戳 sei）；<br>-  payloadUuid: 当 payloadType 为 5 时必须填写，其他情况下该值会被忽略。该值必须是长度为 32 的十六进制数字；<br>-  interval: 选填，默认 1000。sei 的发送间隔，单位毫秒；<br>-  followIdr: 选填，默认 false。该值为 true 时，发送关键帧时会确保带 sei，否则不确保。 |
+| videoSeiParams | 【字段含义】混流 SEI 参数，默认不填写。<br>【特别说明】参数以 json 字符串形式传入，示例如下：<br>`{`<br>`"payLoadContent":"xxx",`<br>`"payloadType":5,`<br>`"payloadUuid":"1234567890abcdef1234567890abcdef",`<br>`"interval":1000,`<br>`"followIdr":false`<br>`}`<br>当前支持的字段及含义：<br>- payloadContent: 必填。透传 sei 的 payload 内容，不能为空；<br>- payloadType: 必填。sei 消息的类型，取值范围: 5 或 [100, 254] 范围内的整数（244 除外，244 是内部自定义的时间戳 sei）；<br>- payloadUuid: 当 payloadType 为 5 时必须填写，其他情况下该值会被忽略。该值必须是长度为 32 的十六进制数字；<br>- interval: 选填，默认 1000。sei 的发送间隔，单位毫秒；<br>- followIdr: 选填，默认 false。该值为 true 时，发送关键帧时会确保带 sei，否则不确保。 |
 
 ## TRTCStreamMixingConfig
 
@@ -1020,7 +1022,7 @@ TRTC 中的“音效”特指一些短暂的音频文件，通常仅有几秒钟
 | --- | --- |
 | audioMixUserList | 【字段含义】指定转码流中的每一路输入音频的信息。<br>【推荐取值】该字段是一个 TRTCUser 类型的数组，数组中的每一个元素都用来代表每一路输入音频的信息。<br>【特别说明】用户信息支持不填写（即 audioMixUserList 为空）。此时若设置了 TRTCStreamEncoderParam 中音频相关编码输出参数，TRTC 后台服务器将自动将所有主播的音频混合输出（当前仅支持最高 16 路音视频输入）。 |
 | backgroundColor | 【字段含义】指定混合画面的底色颜色。<br>【推荐取值】默认值：0x000000 代表黑色。格式为十六进制数字，例如：“0x61B9F1” 代表 RGB 分别为 （97、158、241）。 |
-| backgroundImage | 【字段含义】指定混合画面的背景图 URL，腾讯云的后台服务器会将该 URL 地址指定的图片混合到最终的画面中。<br>【推荐取值】默认值：空值，即不设置背景图片。<br>【特别说明】<br>-  URL 链接长度限制为 512 字节。图片大小限制不超过 2MB。<br>-  图片格式支持 png、jpg、jpeg、bmp 格式，推荐使用 png 格式的半透明图片作为背景图。 |
+| backgroundImage | 【字段含义】指定混合画面的背景图 URL，腾讯云的后台服务器会将该 URL 地址指定的图片混合到最终的画面中。<br>【推荐取值】默认值：空值，即不设置背景图片。<br>【特别说明】<br>- URL 链接长度限制为 512 字节。图片大小限制不超过 2MB。<br>- 图片格式支持 png、jpg、jpeg、bmp 格式，推荐使用 png 格式的半透明图片作为背景图。 |
 | videoLayoutList | 【字段含义】指定混合画面中的每一路视频画面的位置、大小、图层以及流类型等信息。<br>【推荐取值】该字段是一个 TRTCVideoLayout 类型的数组，数组中的每一个元素都用来代表每一路画面的信息。 |
 | watermarkList | 【字段含义】指定混合画面中的每一路水印画面的位置、大小、图层等信息。<br>【推荐取值】该字段是一个 TRTCWatermark 类型的数组，数组中的每一个元素都用来代表每一路水印的信息。 |