VideoEncodeConfig

width

int

Width of the encoded video frame data. The default value is 1920. The value must be the same as the width (original_width) of the image to be encoded.

• Atlas 200/300/500 inference product: The value range is [128, 1920]. The input video width must be a multiple of 16.
• Atlas 200I/500 A2 inference product: The value range is [114, 8192]. The input video width must be a multiple of 2.
• Atlas inference product: The value range is [128, 4096]. The input video width must be a multiple of 2. The maximum resolution (width × height) for video encoding cannot exceed 4096 × 2304.

height

int

Height of the encoded video frame data. The default value is 1080. The value must be the same as the height (original_height) of the image to be encoded.

• Atlas 200/300/500 inference product: The value range is [128, 1920]. The input video height must be a multiple of 2.
• Atlas 200I/500 A2 inference product: The value range is [114, 8192]. The input video height must be a multiple of 2.
• Atlas inference product: The value range is [128, 4096]. The input video height must be a multiple of 2. The maximum resolution (width × height) for video encoding cannot exceed 4096 × 2304.

outputVideoFormat

StreamFormat enumeration

Encoded output video format. H.264 videos support base.h264_baseline_level, base.h264_main_level (default), and base.h264_high_level. H.265 videos support only base.h265_main_level.

inputImageFormat

image_format enumeration

Input image format. Only base.nv12 (default) and base.nv21 are supported.

keyFrameInterval

int

I-frame interval. The default value is 30.

• Atlas 200/300/500 inference product: [1, 2000]
• Atlas 200I/500 A2 inference product: [1, 65536]
• Atlas inference product: [1, 65536]

srcRate

int

Frame rate of input streams, in fps. The default value is 30.

• Atlas 200/300/500 inference product: The value range is [1, 120].
• Atlas 200I/500 A2 inference product: The value range is [1, 240].
• Atlas inference product: The value range is [1, 240].

rcMode

int

• Atlas 200/300/500 inference products
  • 0: CBR mode (default)
  • 1: VBR mode
  • 2: CBR mode
• Atlas 200I/500 A2 inference products
  • 0: VBR mode (default)
  • 1: VBR mode
  • 2: CBR mode
• Atlas inference product
  • 0 or 1: CBR mode
  • 2: VBR mode
  • 3: AVBR mode
  • 4: QVBR mode
  • 5: CVBR mode

shortTermStatsTime

int

Short-term statistical time of the bit rate, in seconds. The value range is [1, 120]. The default value is 60.

This parameter takes effect only when rcMode is set to 5 on Atlas inference product.

longTermStatsTime

int

Long-term statistical time of the bit rate, in minutes. The value range is [1, 1440]. The default value is 120.

This parameter takes effect only when rcMode is set to 5 on Atlas inference product.

longTermMaxBitRate

int

Maximum long-term output bit rate of the encoder, in kbps. The default value is 300. Value range: [2, maxBitRate].

This parameter takes effect only when rcMode is set to 5 on Atlas inference product.

longTermMinBitRate

int

Minimum long-term output bit rate of the encoder, in kbps. The default value is 0. Value range: [0, longTermMaxBitRate].

This parameter takes effect only when rcMode is set to 5 on Atlas inference product.

maxBitRate

int

Output bit rate, in kbps. The default value is 300.

• Atlas 200/300/500 inference product: The value range is [10, 30000].
• Atlas 200I/500 A2 inference product: The value range is [2, 614400].
• Atlas inference product: The value range is [2, 614400].

ipProp

int

I-frame to P-frame bit allocation ratio within a GOP. The value range is [1, 100]. The default value is 70.

sceneMode

int

Scene mode.

• 0 (default): scene where the camera does not move or moves periodically and continuously. H.264 and H.265 are supported.
• 1: motion scenario where the bit rate is high. H.265 is supported.

This parameter takes effect only on Atlas inference product.

displayRate

int

Frame rate for playing the output video. The value range is [1, 120]. The default value is 30.

This parameter takes effect only on Atlas inference product.

statsTime

int

Bit rate statistical time, in seconds. The value range is [1, 60]. The default value is 1.

This parameter takes effect only on Atlas inference product.

firstFrameStartQp

int

Start QP value of the first frame. The value range is [0, 47]. The default value is 32.

This parameter takes effect only on Atlas inference product.

SetThresholdI

func

MADi threshold for the macroblock-level bit rate of I-frames, used to measure the spatial texture complexity of the current frame.

For details about the parameters, see SetThresholdI Description.

This parameter takes effect only on Atlas inference product.

SetThresholdP

func

MADi threshold for the macroblock-level bit rate of P-frames, used to measure the spatial texture complexity of the current frame.

For details about the parameters, see SetThresholdP Description.

This parameter takes effect only on Atlas inference product.

SetThresholdB

func

MADi threshold for the macroblock-level bit rate of B-frames, used to measure the spatial texture complexity of the current frame.

For details about the parameters, see SetThresholdB Description.

This parameter takes effect only on Atlas inference product.

direction

int

Addition or subtraction direction control during texture-based macroblock-level bit rate control The value range is [0, 16]. The default value is 8.

This parameter takes effect only on Atlas inference product.

rowQpDelta

int

Maximum row-level adjustment range within one frame. The unit is the macroblock row. A larger adjustment amplitude indicates that the allowed QP row-level adjustment range is larger and the bit rate is more stable.

In the scenarios where the image complexity is unevenly distributed, the image quality may be uneven if the value of this parameter is too large.

The value range is [0, 10]. The default value is 1. If the value is set to 0, row-based macroblock-level bit rate control is disabled.

This parameter takes effect only on Atlas inference product.