Global

[C] 建议码率80kbps

[C] 建议码率100kbps

[C] 建议码率200kbps

[C] 建议码率350kbps

[C] 建议码率100kbps

[C] 建议码率150kbps

[C] 建议码率200kbps

[C] 建议码率250kbps

[C] 建议码率300kbps

[C] 建议码率400kbps

[C] 建议码率600kbps

[C] 建议码率1000kbps

[C] 建议码率150kbps

[C] 建议码率200kbps

[C] 建议码率250kbps

[C] 建议码率350kbps

[C] 建议码率550kbps

[C] 建议码率850kbps

[C] 摄像头采集 - 建议码率1200kbps
[S] 屏幕分享 - 建议码率 低清：1000kbps 高清：1600kbps

[S] 屏幕分享 - 建议码率2000kbps

横屏分辨率

竖屏分辨率

大画面视频流

小画面视频流

辅流（屏幕分享）

未定义

最好

好

一般

差

很差

不可用

图像铺满屏幕，超出显示视窗的视频部分将被截掉

图像长边填满屏幕，短边区域会被填充黑色

顺时针旋转0度

顺时针旋转90度

顺时针旋转180度

顺时针旋转270度

光滑，适用于美女秀场，效果比较明显。

自然，磨皮算法更多地保留了面部细节，主观感受上会更加自然。

未定义

I420

OpenGL 2D 纹理

BGRA32

RGBA32

未知类型

二进制Buffer类型

纹理类型

只适用于移动端， 本地预览时，前置摄像头镜像，后置摄像头不镜像

所有画面均镜像

所有画面均不镜像

仅录制音频

仅录制视频

同时录制音频、视频

视频通话场景，支持720P、1080P高清画质，单个房间最多支持300人同时在线，最高支持50人同时发言。
适合：[视频低延时直播]、[十万人互动课堂]、[视频直播 PK]、[视频相亲房]、[互动课堂]、[远程培训]、[超大型会议]等。
注意：此场景下，您必须通过 TRTCParams 中的 role 字段指定当前用户的角色。

视频互动直播，支持平滑上下麦，切换过程无需等待，主播延时小于300ms；支持十万级别观众同时播放，播放延时低至1000ms。
在线直播场景，内部编码器和网络协议优化侧重性能和兼容性，性能和清晰度表现更佳。

语音通话场景，支持 48kHz，支持双声道。单个房间最多支持300人同时在线，最高支持50人同时发言。
适合：[1对1语音通话]、[300人语音会议]、[语音聊天]、[语音会议]、[在线狼人杀]等。

语音互动直播，支持平滑上下麦，切换过程无需等待，主播延时小于300ms；支持十万级别观众同时播放，播放延时低至1000ms。
适合：[语音低延时直播]、[语音直播连麦]、[语聊房]、[K 歌房]、[FM 电台]等。
注意：此场景下，您必须通过 TRTCParams 中的 role 字段指定当前用户的角色。

主播

观众

客户端控制（用于 SDK 开发内部调试，客户请勿使用）

云端控制（默认）

弱网下保流畅

弱网下保清晰

未指定

PCM，每个采样点占16bit数据量。

未知类型

该分享目标是某一个 Windows 或 Mac 窗口

该分享目标是整个 Windows 桌面或 Mac 桌面

该分享目标是自定义窗口（保留字段，暂无用法）

语音模式：采样率：16k；单声道；音频裸码率：16kbps；适合语音通话为主的场景，比如在线会议，语音通话。

标准模式（或者默认模式）：采样率：48k；单声道；音频裸码率：50kbps；SDK 默认的音频质量，如无特殊需求推荐选择之。

音乐模式：采样率：48k；双声道 + 全频带；音频裸码率：128kbps；适合需要高保真传输音乐的场景，比如K歌、音乐直播等。

输出所有级别的 Log

输出 DEBUG，INFO，WARNING，ERROR 和 FATAL 级别的 Log

输出 INFO，WARNNING，ERROR 和 FATAL 级别的 Log

只输出WARNNING，ERROR 和 FATAL 级别的 Log

只输出ERROR 和 FATAL 级别的 Log

只输出 FATAL 级别的 Log

不输出任何 SDK Log

添加设备

移除设备

设备已启用

系统默认设备变更

未知类型

麦克风

扬声器

摄像头

自动调整采集参数。SDK 根据实际的采集设备性能及网络情况，选择合适的摄像头输出参数，在设备性能及视频预览质量之间，维持平衡。

优先保证设备性能。SDK 根据用户设置编码器的分辨率和帧率，选择最接近的摄像头输出参数，从而保证设备性能。

优先保证视频预览质量。SDK选择较高的摄像头输出参数，从而提高预览视频的质量。在这种情况下，会消耗更多的 CPU 及内存做视频前处理。

允许用户设置本地摄像头采集的视频宽高。

图片文件路径，支持 BMP、GIF、JPEG、PNG、TIFF、Exif、WMF 和 EMF 文件格式

BGRA32格式内存块

RGBA32格式内存块

非法值

全手动模式，灵活性最高，可以自由组合出各种混流方案，但易用性最差。 此模式下，您需要填写 TRTCTranscodingConfig 中的所有参数，并需要监听 TRTCCloudDelegate 中的 onUserVideoAvailable() 和 onUserAudioAvailable() 回调， 以便根据当前房间中各个上麦用户的音视频状态不断地调整 mixUsers 参数，否则会导致混流失败。

纯音频模式，适用于语音通话（AudioCall）和语音聊天室（VoiceChatRoom）等纯音频场景。 只需要在进房后通过 setMixTranscodingConfig() 接口设置一次，之后 SDK 就会自动把房间内所有上麦用户的声音混流到当前用户的直播流上。 此模式下，您无需设置 TRTCTranscodingConfig 中的 mixUsers 参数，只需设置 audioSampleRate、audioBitrate 和 audioChannels 等参数。

预排版模式，通过占位符提前对各路画面进行排布 此模式下，您依然需要设置 mixUsers 参数，但可以将 userId 设置为占位符，可选的占位符有：

• "$PLACE_HOLDER_REMOTE$" : 指代远程用户的画面，可以设置多个。
• "$PLACE_HOLDER_LOCAL_MAIN$" ： 指代本地摄像头画面，只允许设置一个。
• "$PLACE_HOLDER_LOCAL_SUB$" : 指代本地屏幕分享画面，只允许设置一个。 但是您可以不需要监听 TRTCCloudDelegate 中的 onUserVideoAvailable() 和 onUserAudioAvailable() 回调进行实时调整， 只需要在进房成功后调用一次 setMixTranscodingConfig() 即可，之后 SDK 会自动将真实的 userId 补位到您设置的占位符上。

屏幕分享模式，适用于在线教育场景等以屏幕分享为主的应用场景，仅支持 Windows 和 Mac 两个平台的 SDK。 SDK 会先根据您（通过 videoWidth 和 videoHeight 参数）设置的目标分辨率构建一张画布， 当老师未开启屏幕分享时，SDK 会将摄像头画面等比例拉伸绘制到该画布上；当老师开启屏幕分享之后，SDK 会将屏幕分享画面绘制到同样的画布上。 这样操作的目的是为了确保混流模块的输出分辨率一致，避免课程回放和网页观看的花屏问题（网页播放器不支持可变分辨率）。

由于教学模式下的视频内容以屏幕分享为主，因此同时传输摄像头画面和屏幕分享画面是非常浪费带宽的。 推荐的做法是直接将摄像头画面通过 setLocalVideoRenderCallback 接口自定义绘制到当前屏幕上。 在该模式下，您无需设置 TRTCTranscodingConfig 中的 mixUsers 参数，SDK 不会混合学生的画面，以免干扰屏幕分享的效果。

您可以将 TRTCTranscodingConfig 中的 width × height 设为 0px × 0px，SDK 会自动根据用户当前屏幕的宽高比计算出一个合适的分辨率：

• 如果老师当前屏幕宽度 <= 1920px，SDK 会使用老师当前屏幕的实际分辨率。
• 如果老师当前屏幕宽度 > 1920px，SDK 会根据当前屏幕宽高比，选择 1920x1080(16:9)、1920x1200(16:10)、1920x1440(4:3) 三种分辨率中的一种。

不指定，SDK 会根据另一个参数 pureAudio 的数值决定混流输入类型

混入音频和视频

只混入视频

只混入音频

混入水印，此时您无需指定 userId 字段，但需要指定 image 字段，推荐使用 png 格式的图片

录制本地和远端所有音频

仅录制本地音频

仅录制远端音频

未定义。

您可以通过设置该参数将您房间内的主路流（TRTCVideoStreamTypeBig）发布到腾讯或者第三方直播 CDN 服务商（仅支持标准 RTMP 协议）。

您可以通过设置该参数将您房间内的辅路流（TRTCVideoStreamTypeSub）发布到腾讯或者第三方直播 CDN 服务商（仅支持标准 RTMP 协议）。

您可以通过设置该参数，配合编码输出参数 (TRTCStreamEncoderParam) 和混流转码参数 (TRTCStreamMixingConfig)，将您指定的多路音视频流进行转码并发布到腾讯或者第三方直播 CDN 服务商（仅支持标准 RTMP 协议）。

您可以通过设置该参数，配合媒体流编码输出参数 (TRTCStreamEncoderParam) 和混流转码参数 (TRTCStreamMixingConfig)，将您指定的多路音视频流进行转码并发布到您指定的房间中。通过 TRTCPublishTarget 中的 TRTCUser 进行指定回推房间的机器人信息。

关闭特效

KTV

小房间

大会堂

低沉

洪亮

金属声

磁性

空灵

录音棚

悠扬

录音棚2

关闭特效

熊孩子

萝莉

大叔

重金属

感冒

外语腔

困兽

肥宅

强电流

重机械

空灵

视频处理，可以实现自定义美颜

音视频加解密，可以实现自定义加解密

音频处理，可以实现自定义音频处理

【字段含义】最大并发播放数。默认值：0。

• 如果 maxCount > 0，且实际人数 > maxCount，会实时智能选出 maxCount 路数据进行播放，这会极大的降低性能消耗。
• 如果 maxCount = 0，SDK 不限制并发播放数，在上麦人数比较多的房间可能会引发性能问题。

【字段含义】指定用户必定能并发播放。
【特殊说明】指定必定并发播放的用户 ID 列表。这些用户不参与智能选择。

• includeUsers 的数量必须小于 maxCount，否则本次并发播放设置失效。
• includeUsers 仅在 maxCount > 0 时有效。当 includeUsers 生效时，参与智能并发选择的最大播放数 = maxCount - 有效 includeUsers 的数量。

摄像头采集偏好

采集图像宽度

采集图像高度

插件 ID，用户需要自己保证 ID 的唯一性

设备 ID，开启多摄像头美颜时，为对应摄像头 ID，默认为空字符串 ""

启用该插件，返回值：0 成功，其他值表示失败

禁用该插件，返回值：0 成功，其他值表示失败

设置该插件的参数，返回值：0 成功，其他值表示失败，入参必须是序列化的 JSON 串，会透传到 C++ 插件层

是否开启

视频格式

是否开启

是否开启

【字段含义】指定该路音视频流在腾讯或者第三方直播服务商的推流地址（RTMP 格式）。
【推荐取值】各家服务商的推流地址规则差异较大，请根据目标服务商的要求填写合法的推流 URL，TRTC 的后台服务器会按照您填写的 URL 向第三方服务商推送标准格式音视频流。
【特别说明】推流 URL 必须为 RTMP 格式，必须符合您的目标直播服务商的规范要求，否则目标服务商会拒绝来自 TRTC 后台服务的推流请求。

【字段含义】指定该路音视频流是否发布至腾讯云。
【推荐取值】默认值：true。
【特别说明】若您的目标直播服务商为腾讯，请将此参数设置为 true，此时后台计费系统不会对此计算转推服务费。

【字段含义】用户标识，当前用户的 userId，相当于用户名，使用 UTF-8 编码。
【推荐取值】如果一个用户在您的账号系统中的 ID 为“mike”，则 userId 即可设置为“mike”。

【字段含义】数字房间号，需要和您的进房参数 (TRTCParams) 中的房间号类型相匹配。
【推荐取值】取值范围：1 - 4294967294。
【特别说明】intRoomId 与 strRoomId 是互斥的，若您进房参数中选用 strRoomId，则 intRoomId 需要填写为0。若两者都填，SDK 将优先选用 intRoomId。

【字段含义】字符串房间号，需要和您的进房参数 (TRTCParams) 中的房间号类型相匹配。
【特别说明】intRoomId 与 strRoomId 是互斥的，若您进房参数中选用 roomId，则 strRoomId 无需填写。若两者都填，SDK 将优先选用 intRoomId。
【推荐取值】限制长度为 64 字节。以下为支持的字符集范围（共 89 个字符）:

• 大小写英文字母（a-zA-Z）；
  
• 数字（0-9）；
  
• 空格、!、#、$、%、&、(、)、+、-、:、;、<、=、.、>、?、@、[、]、^、_、{、}、|、~、,。

【字段含义】媒体流发布模式。
【推荐取值】请根据您的业务场景要求自行选择，TRTC 支持转推、转码和回推到 RTC 房间的模式。
【特别说明】若您的业务场景需要多个发布模式，您可以通过多次调用媒体流发布接口 (startPublishMediaStream) 并分别设置不同的 TRTCPublishTarget。
【特别说明】同一个 mode 请对应一个媒体流发布接口 (startPublishMediaStream)，并在后续需要调整时，使用 updatePublishMediaStream 进行更新。

【字段含义】发布至腾讯或者第三方直播服务商的推流地址（RTMP 格式）。
【特别说明】若您的 mode 选择为 TRTCPublishMixStreamToRoom，此时您不需要设置该参数。

【字段含义】回推房间机器人信息。
【特别说明】仅当您的 mode 选择为 TRTCPublishMixStreamToRoom 时，您需要设置该参数。
【特别说明】设置后，该路转码音视频数据将回推到您指定的房间中。建议设置为特殊的 userId，以避免难以区分回推机器人和您通过 TRTC SDK 进房的主播。
【特别说明】参与混流的用户不支持订阅该转码流。
【特别说明】当您进房前设置的订阅模式(setDefaultStreamRecvMode) 均为手动时，您需要自行管理您想要拉取的音视频流（通常当您拉取回推房间的转码流时，您应该取消订阅参与转码的对应音视频单流）。
【特别说明】当您进房前设置的订阅模式(setDefaultStreamRecvMode) 均为自动时，不参与转码的用户将自动收到后台下发的转码流并不再继续接收参与转码的音视频单流。除非您明确进行取消订阅（muteRemoteVideoStream 和 muteRemoteAudio），否则转码流数据将持续下发。

【字段含义】指定媒体发布流的目标分辨率（宽度）。
【推荐取值】单位：像素值，推荐值：368，如果你只混合音频流，请将 width 和 height 均设置为 0，否则混流转码后的直播流中会有黑色背景。

【字段含义】指定媒体发布流的目标分辨率（高度）。
【推荐取值】单位：像素值，推荐值：640，如果你只混合音频流，请将 width 和 height 均设置为 0，否则混流转码后的直播流中会有黑色背景。

【字段含义】指定媒体发布流的目标视频帧率（FPS）。
【推荐取值】推荐值：20fps，取值范围是 (0,30]。

【字段含义】指定媒体发布流的目标视频关键帧间隔（GOP）。
【推荐取值】推荐值：3，单位为秒，取值范围是 [1,5]。

【字段含义】指定媒体发布流的目标视频码率（kbps）。
【推荐取值】如果填 0，TRTC 会根据 videoEncodedWidth 和 videoEncodedHeight 估算出一个合理的码率值，您也可以参考视频分辨率枚举定义中所推荐的码率值（见注释部分）。

【字段含义】指定媒体发布流的目标音频采样率。
【推荐取值】默认值：48000Hz。取值为 [48000, 44100, 32000, 24000, 16000, 8000]，单位是 Hz。

【字段含义】指定媒体发布流的目标音频声道数。
【推荐取值】默认值：1，代表单声道。可设定的数值只有两个数字：1-单声道，2-双声道。

【字段含义】指定媒体发布流的目标音频码率（kbps）。
【推荐取值】默认值：50kbps，取值范围是 [32，192]。

【字段含义】指定媒体发布流的目标音频编码类型。
【推荐取值】默认值：0，代表 LC-AAC。可设定的数值只有三个数字：0 - LC-AAC，1 - HE-AAC，2 - HE-AACv2。
【特别说明】HE-AAC 和 HE-AACv2 支持的输出流音频采样率范围为[48000, 44100, 32000, 24000, 16000]。
【特别说明】当音频编码设置为 HE-AACv2 时，只支持输出流音频声道数为双声道。

【字段含义】指定媒体发布流的目标视频编码类型。
【推荐取值】默认值：0，代表 H264。可设定的数值只有两个数字：0 - H264，1 - H265。

【字段含义】混流 SEI 参数，默认不填写。
【特别说明】参数以 json 字符串形式传入，示例如下：

{
  "payLoadContent":"xxx",
  "payloadType":5,
  "payloadUuid":"1234567890abcdef1234567890abcdef",
  "interval":1000,
  "followIdr":false
}

当前支持的字段及含义：

• payloadContent: 必填。透传 sei 的 payload 内容，不能为空；
• payloadType: 必填。sei 消息的类型，取值范围: 5 或 [100, 254] 范围内的整数（244 除外，244 是内部自定义的时间戳 sei）；
• payloadUuid: 当 payloadType 为 5 时必须填写，其他情况下该值会被忽略。该值必须是长度为 32 的十六进制数字；
• interval: 选填，默认 1000。sei 的发送间隔，单位毫秒；
• followIdr: 选填，默认 false。该值为 true 时，发送关键帧时会确保带 sei，否则不确保。

【字段含义】指定该路画面的坐标区域（单位：像素）。

【字段含义】指定该路画面的层级（取值范围：0 - 15，不可重复）。

【字段含义】画面填充模式。
【推荐取值】填充（画面可能会被拉伸裁剪）或适应（画面可能会有黑边），默认值：TRTCVideoFillMode_Fill。

【字段含义】指定混合画面的底色颜色。
【推荐取值】默认值：0x000000 代表黑色。格式为十六进制数字，比如：“0x61B9F1” 代表 RGB 分别为 (97,158,241)。

【字段含义】占位图 URL，即当指定用户暂时仅上行音频时，腾讯云的后台服务器会将该 URL 地址指定的图片混合到最终的画面中。
【推荐取值】默认值：空值，即不设置占位图。
【特别说明】此时需要您指定用户信息 fixedVideoUser 中的 userId。
【特别说明】

• URL 链接长度限制为 512 字节。图片大小限制不超过 2MB。
• 图片格式支持 png、jpg、jpeg、bmp 格式，推荐使用 png 格式的半透明图片作为占位图。

【字段含义】参与转码的用户信息。
【特别说明】用户信息 (TRTCUser) 支持不填写（即 userId、intRoomId 和 strRoomId 均不填写）。此时当发起混流的房间中有主播上行音视频数据时，TRTC 后台服务器将自动将对应主播音视频填充到您指定的布局中。

【字段含义】指定该路画面是主路画面（TRTCVideoStreamTypeBig）还是辅路画面（TRTCVideoStreamTypeSub）。

【字段含义】水印 URL，腾讯云的后台服务器会将该 URL 地址指定的图片混合到最终的画面中。
【特别说明】

• URL 链接长度限制为 512 字节。图片大小限制不超过 2MB。
• 图片格式支持 png、jpg、jpeg、bmp 格式，推荐使用 png 格式的半透明图片作为水印。

【字段含义】指定该路水印画面的坐标区域（单位：像素）。

【字段含义】指定该路水印画面的层级（取值范围：0 - 15，不可重复）。

【字段含义】指定混合画面的底色颜色。
【推荐取值】默认值：0x000000 代表黑色。格式为十六进制数字，比如：“0x61B9F1” 代表 RGB 分别为 （97、158、241）。

【字段含义】指定混合画面的背景图 URL，腾讯云的后台服务器会将该 URL 地址指定的图片混合到最终的画面中。
【推荐取值】默认值：空值，即不设置背景图片。
【特别说明】

• URL 链接长度限制为 512 字节。图片大小限制不超过 2MB。
• 图片格式支持 png、jpg、jpeg、bmp 格式，推荐使用 png 格式的半透明图片作为背景图。

【字段含义】指定混合画面中的每一路视频画面的位置、大小、图层以及流类型等信息。
【推荐取值】该字段是一个 TRTCVideoLayout 类型的数组，数组中的每一个元素都用来代表每一路画面的信息。

【字段含义】指定转码流中的每一路输入音频的信息。
【推荐取值】该字段是一个 TRTCUser 类型的数组，数组中的每一个元素都用来代表每一路输入音频的信息。
【特别说明】用户信息支持不填写（即 audioMixUserList 为空）。此时若设置了 TRTCStreamEncoderParam 中音频相关编码输出参数，TRTC 后台服务器将自动将所有主播的音频混合输出（当前仅支持最高 16 路音视频输入）。

【字段含义】指定混合画面中的每一路水印画面的位置、大小、图层等信息。
【推荐取值】该字段是一个 TRTCWatermark 类型的数组，数组中的每一个元素都用来代表每一路水印的信息。

背景音乐开始播放事件。

背景音乐的播放进度事件。

背景音乐播放完毕事件。

背景音乐预加载进度

背景音乐预加载出错

本地采集并经过音频模块前处理后的音频数据回调。

本地采集并经过音频模块前处理、音效处理和混 BGM 后的音频数据回调。

混音前的每一路远程用户的音频数据。

将各路待播放音频混合之后并在最终提交系统播放之前的数据回调。

SDK 所有音频混合后的音频数据（包括采集到的和待播放的）。