Struct TRTCVideoEncParam
6.2 视频编码参数
该设置决定了远端用户看到的画面质量(同时也是云端录制出的视频文件的画面质量)。
Inherited Members
Namespace: trtc
Assembly: cs.temp.dll.dll
Syntax
public struct TRTCVideoEncParam
Fields
enableAdjustRes
【字段含义】是否允许调整分辨率
【推荐取值】
- 手机直播建议选择 NO。
- 视频通话模式,若更关注流畅性,建议选择 YES,此时若遇到带宽有限的弱网,SDK 会自动降低分辨率以保障更好的流畅度(仅针对 TRTCVideoStreamTypeBig 生效)。
- 默认值:NO。
【特别说明】若有录制需求,选择 YES 时,请确保通话过程中,调整分辨率不会影响您的录制效果。
Declaration
public bool enableAdjustRes
Field Value
Type | Description |
---|---|
System.Boolean |
minVideoBitrate
【字段含义】最低视频码率,SDK 会在网络不佳的情况下主动降低视频码率,最低会降至 minVideoBitrate 所设定的数值。
【推荐取值】
- 如果您追求“允许卡顿但要保持清晰”的效果,可以设置 minVideoBitrate 为 videoBitrate 的 60%;
- 如果您追求“允许模糊但要保持流畅”的效果,可以设置 minVideoBitrate 为 200kbps;
- 如果您将 videoBitrate 和 minVideoBitrate 设置为同一个值,等价于关闭 SDK 的自适应调节能力;
- 默认值:0,此时最低码率由 SDK 根据分辨率情况,自动设置合适的数值。
【特别说明】
- 当您把分辨率设置的比较高时,minVideoBitrate 不适合设置的太低,否则会出现画面模糊和大范围的马赛克宏块。
比如把分辨率设置为 720p,把码率设置为 200kbps,那么编码出的画面将会出现大范围区域性马赛克。
Declaration
public UInt32 minVideoBitrate
Field Value
Type | Description |
---|---|
UInt32 |
resMode
【字段含义】分辨率模式(横屏分辨率 - 竖屏分辨率)
【推荐取值】手机直播建议选择 Portrait,Window 和 Mac 建议选择 Landscape。
【特别说明】如果 videoResolution 指定分辨率 640 × 360,resMode 指定模式为 Portrait,则最终编码出的分辨率为360 × 640。
Declaration
public TRTCVideoResolutionMode resMode
Field Value
Type | Description |
---|---|
TRTCVideoResolutionMode |
videoBitrate
【字段含义】目标视频码率,SDK 会按照目标码率进行编码,只有在网络不佳的情况下才会主动降低视频码率。
【推荐取值】请参考本 TRTCVideoResolution 在各档位注释的最佳码率,也可以在此基础上适当调高。
比如 TRTCVideoResolution_1280_720 对应 1200kbps 的目标码率,您也可以设置为 1500kbps 用来获得更好的清晰度观感。
【特别说明】SDK 会努力按照 videoBitrate 指定的码率进行编码,只有在网络不佳的情况下才会主动降低视频码率,最低会降至 minVideoBitrate 所设定的数值。
如果您追求“允许卡顿但要保持清晰”的效果,可以设置 minVideoBitrate 为 videoBitrate 的 60%;
如果您追求“允许模糊但要保持流畅”的效果,可以设置 minVideoBitrate 为 200kbps;
如果您将 videoBitrate 和 minVideoBitrate 设置为同一个值,等价于关闭 SDK 的自适应调节能力。
Declaration
public UInt32 videoBitrate
Field Value
Type | Description |
---|---|
UInt32 |
videoFps
【字段含义】视频采集帧率
【推荐取值】15fps 或 20fps。5fps以下,卡顿感明显。10fps以下,会有轻微卡顿感。20fps以上,则过于浪费(电影的帧率为24fps)。
【特别说明】很多 Android 手机的前置摄像头并不支持15fps以上的采集帧率,部分过于突出美颜功能的 Android 手机前置摄像头的采集帧率可能低于10fps。
Declaration
public UInt32 videoFps
Field Value
Type | Description |
---|---|
UInt32 |
videoResolution
【字段含义】 视频分辨率
【推荐取值】
- 视频通话建议选择360 × 640及以下分辨率,resMode 选择 Portrait。
- 手机直播建议选择540 × 960,resMode 选择 Portrait。
- Window 和 iMac 建议选择640 × 360 及以上分辨率,resMode 选择 Landscape。
【特别说明】 TRTCVideoResolution 默认只有横屏模式的分辨率,例如640 × 360。
如需使用竖屏分辨率,请指定 resMode 为 Portrait,例如640 × 360结合 Portrait 则为360 × 640。
Declaration
public TRTCVideoResolution videoResolution
Field Value
Type | Description |
---|---|
TRTCVideoResolution |