Class VideoStream.H264CodecSettings (0.44.0)

public static final class VideoStream.H264CodecSettings extends GeneratedMessageV3 implements VideoStream.H264CodecSettingsOrBuilder

H264 codec settings.

Protobuf type google.cloud.video.livestream.v1.VideoStream.H264CodecSettings

Static Fields

ALLOW_OPEN_GOP_FIELD_NUMBER

public static final int ALLOW_OPEN_GOP_FIELD_NUMBER
Field Value
Type Description
int

AQ_STRENGTH_FIELD_NUMBER

public static final int AQ_STRENGTH_FIELD_NUMBER
Field Value
Type Description
int

BITRATE_BPS_FIELD_NUMBER

public static final int BITRATE_BPS_FIELD_NUMBER
Field Value
Type Description
int

B_FRAME_COUNT_FIELD_NUMBER

public static final int B_FRAME_COUNT_FIELD_NUMBER
Field Value
Type Description
int

B_PYRAMID_FIELD_NUMBER

public static final int B_PYRAMID_FIELD_NUMBER
Field Value
Type Description
int

ENTROPY_CODER_FIELD_NUMBER

public static final int ENTROPY_CODER_FIELD_NUMBER
Field Value
Type Description
int

FRAME_RATE_FIELD_NUMBER

public static final int FRAME_RATE_FIELD_NUMBER
Field Value
Type Description
int

GOP_DURATION_FIELD_NUMBER

public static final int GOP_DURATION_FIELD_NUMBER
Field Value
Type Description
int

GOP_FRAME_COUNT_FIELD_NUMBER

public static final int GOP_FRAME_COUNT_FIELD_NUMBER
Field Value
Type Description
int

HEIGHT_PIXELS_FIELD_NUMBER

public static final int HEIGHT_PIXELS_FIELD_NUMBER
Field Value
Type Description
int

PROFILE_FIELD_NUMBER

public static final int PROFILE_FIELD_NUMBER
Field Value
Type Description
int

TUNE_FIELD_NUMBER

public static final int TUNE_FIELD_NUMBER
Field Value
Type Description
int

VBV_FULLNESS_BITS_FIELD_NUMBER

public static final int VBV_FULLNESS_BITS_FIELD_NUMBER
Field Value
Type Description
int

VBV_SIZE_BITS_FIELD_NUMBER

public static final int VBV_SIZE_BITS_FIELD_NUMBER
Field Value
Type Description
int

WIDTH_PIXELS_FIELD_NUMBER

public static final int WIDTH_PIXELS_FIELD_NUMBER
Field Value
Type Description
int

Static Methods

getDefaultInstance()

public static VideoStream.H264CodecSettings getDefaultInstance()
Returns
Type Description
VideoStream.H264CodecSettings

getDescriptor()

public static final Descriptors.Descriptor getDescriptor()
Returns
Type Description
Descriptor

newBuilder()

public static VideoStream.H264CodecSettings.Builder newBuilder()
Returns
Type Description
VideoStream.H264CodecSettings.Builder

newBuilder(VideoStream.H264CodecSettings prototype)

public static VideoStream.H264CodecSettings.Builder newBuilder(VideoStream.H264CodecSettings prototype)
Parameter
Name Description
prototype VideoStream.H264CodecSettings
Returns
Type Description
VideoStream.H264CodecSettings.Builder

parseDelimitedFrom(InputStream input)

public static VideoStream.H264CodecSettings parseDelimitedFrom(InputStream input)
Parameter
Name Description
input InputStream
Returns
Type Description
VideoStream.H264CodecSettings
Exceptions
Type Description
IOException

parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static VideoStream.H264CodecSettings parseDelimitedFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input InputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
VideoStream.H264CodecSettings
Exceptions
Type Description
IOException

parseFrom(byte[] data)

public static VideoStream.H264CodecSettings parseFrom(byte[] data)
Parameter
Name Description
data byte[]
Returns
Type Description
VideoStream.H264CodecSettings
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)

public static VideoStream.H264CodecSettings parseFrom(byte[] data, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
data byte[]
extensionRegistry ExtensionRegistryLite
Returns
Type Description
VideoStream.H264CodecSettings
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(ByteString data)

public static VideoStream.H264CodecSettings parseFrom(ByteString data)
Parameter
Name Description
data ByteString
Returns
Type Description
VideoStream.H264CodecSettings
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)

public static VideoStream.H264CodecSettings parseFrom(ByteString data, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
data ByteString
extensionRegistry ExtensionRegistryLite
Returns
Type Description
VideoStream.H264CodecSettings
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(CodedInputStream input)

public static VideoStream.H264CodecSettings parseFrom(CodedInputStream input)
Parameter
Name Description
input CodedInputStream
Returns
Type Description
VideoStream.H264CodecSettings
Exceptions
Type Description
IOException

parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)

public static VideoStream.H264CodecSettings parseFrom(CodedInputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input CodedInputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
VideoStream.H264CodecSettings
Exceptions
Type Description
IOException

parseFrom(InputStream input)

public static VideoStream.H264CodecSettings parseFrom(InputStream input)
Parameter
Name Description
input InputStream
Returns
Type Description
VideoStream.H264CodecSettings
Exceptions
Type Description
IOException

parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)

public static VideoStream.H264CodecSettings parseFrom(InputStream input, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
input InputStream
extensionRegistry ExtensionRegistryLite
Returns
Type Description
VideoStream.H264CodecSettings
Exceptions
Type Description
IOException

parseFrom(ByteBuffer data)

public static VideoStream.H264CodecSettings parseFrom(ByteBuffer data)
Parameter
Name Description
data ByteBuffer
Returns
Type Description
VideoStream.H264CodecSettings
Exceptions
Type Description
InvalidProtocolBufferException

parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)

public static VideoStream.H264CodecSettings parseFrom(ByteBuffer data, ExtensionRegistryLite extensionRegistry)
Parameters
Name Description
data ByteBuffer
extensionRegistry ExtensionRegistryLite
Returns
Type Description
VideoStream.H264CodecSettings
Exceptions
Type Description
InvalidProtocolBufferException

parser()

public static Parser<VideoStream.H264CodecSettings> parser()
Returns
Type Description
Parser<H264CodecSettings>

Methods

equals(Object obj)

public boolean equals(Object obj)
Parameter
Name Description
obj Object
Returns
Type Description
boolean
Overrides

getAllowOpenGop()

public boolean getAllowOpenGop()

Specifies whether an open Group of Pictures (GOP) structure should be allowed or not. The default is false.

bool allow_open_gop = 6;

Returns
Type Description
boolean

The allowOpenGop.

getAqStrength()

public double getAqStrength()

Specify the intensity of the adaptive quantizer (AQ). Must be between 0 and 1, where 0 disables the quantizer and 1 maximizes the quantizer. A higher value equals a lower bitrate but smoother image. The default is 0.

double aq_strength = 14;

Returns
Type Description
double

The aqStrength.

getBFrameCount()

public int getBFrameCount()

The number of consecutive B-frames. Must be greater than or equal to zero. Must be less than gop_frame_count if set. The default is 0.

int32 b_frame_count = 13;

Returns
Type Description
int

The bFrameCount.

getBPyramid()

public boolean getBPyramid()

Allow B-pyramid for reference frame selection. This may not be supported on all decoders. The default is false.

bool b_pyramid = 12;

Returns
Type Description
boolean

The bPyramid.

getBitrateBps()

public int getBitrateBps()

Required. The video bitrate in bits per second. Minimum value is 10,000.

  • For SD resolution (< 720p), must be <= 3,000,000 (3 Mbps).
  • For HD resolution (<= 1080p), must be <= 15,000,000 (15 Mbps).

int32 bitrate_bps = 4 [(.google.api.field_behavior) = REQUIRED];

Returns
Type Description
int

The bitrateBps.

getDefaultInstanceForType()

public VideoStream.H264CodecSettings getDefaultInstanceForType()
Returns
Type Description
VideoStream.H264CodecSettings

getEntropyCoder()

public String getEntropyCoder()

The entropy coder to use. The default is cabac.

Supported entropy coders:

  • cavlc
  • cabac

string entropy_coder = 11;

Returns
Type Description
String

The entropyCoder.

getEntropyCoderBytes()

public ByteString getEntropyCoderBytes()

The entropy coder to use. The default is cabac.

Supported entropy coders:

  • cavlc
  • cabac

string entropy_coder = 11;

Returns
Type Description
ByteString

The bytes for entropyCoder.

getFrameRate()

public double getFrameRate()

Required. The target video frame rate in frames per second (FPS). Must be less than or equal to 60. Will default to the input frame rate if larger than the input frame rate. The API will generate an output FPS that is divisible by the input FPS, and smaller or equal to the target FPS. See Calculating frame rate for more information.

double frame_rate = 3 [(.google.api.field_behavior) = REQUIRED];

Returns
Type Description
double

The frameRate.

getGopDuration()

public Duration getGopDuration()

Select the GOP size based on the specified duration. The default is 2s. Note that gopDuration must be less than or equal to segment_duration, and segment_duration must be divisible by gopDuration. Valid range is [2s, 20s].

All video streams in the same channel must have the same GOP size.

.google.protobuf.Duration gop_duration = 8;

Returns
Type Description
Duration

The gopDuration.

getGopDurationOrBuilder()

public DurationOrBuilder getGopDurationOrBuilder()

Select the GOP size based on the specified duration. The default is 2s. Note that gopDuration must be less than or equal to segment_duration, and segment_duration must be divisible by gopDuration. Valid range is [2s, 20s].

All video streams in the same channel must have the same GOP size.

.google.protobuf.Duration gop_duration = 8;

Returns
Type Description
DurationOrBuilder

getGopFrameCount()

public int getGopFrameCount()

Select the GOP size based on the specified frame count. If GOP frame count is set instead of GOP duration, GOP duration will be calculated by gopFrameCount/frameRate. The calculated GOP duration must satisfy the limitations on gopDuration as well. Valid range is [60, 600].

int32 gop_frame_count = 7;

Returns
Type Description
int

The gopFrameCount.

getGopModeCase()

public VideoStream.H264CodecSettings.GopModeCase getGopModeCase()
Returns
Type Description
VideoStream.H264CodecSettings.GopModeCase

getHeightPixels()

public int getHeightPixels()

Required. The height of the video in pixels. Must be an even integer. Valid range is [180, 1080].

int32 height_pixels = 2;

Returns
Type Description
int

The heightPixels.

getParserForType()

public Parser<VideoStream.H264CodecSettings> getParserForType()
Returns
Type Description
Parser<H264CodecSettings>
Overrides

getProfile()

public String getProfile()

Enforces the specified codec profile. The following profiles are supported:

  • baseline
  • main (default)
  • high

    The available options are FFmpeg-compatible Profile Options. Note that certain values for this field may cause the transcoder to override other fields you set in the H264CodecSettings message.

string profile = 15;

Returns
Type Description
String

The profile.

getProfileBytes()

public ByteString getProfileBytes()

Enforces the specified codec profile. The following profiles are supported:

  • baseline
  • main (default)
  • high

    The available options are FFmpeg-compatible Profile Options. Note that certain values for this field may cause the transcoder to override other fields you set in the H264CodecSettings message.

string profile = 15;

Returns
Type Description
ByteString

The bytes for profile.

getSerializedSize()

public int getSerializedSize()
Returns
Type Description
int
Overrides

getTune()

public String getTune()

Enforces the specified codec tune. The available options are FFmpeg-compatible Encode Options Note that certain values for this field may cause the transcoder to override other fields you set in the H264CodecSettings message.

string tune = 16;

Returns
Type Description
String

The tune.

getTuneBytes()

public ByteString getTuneBytes()

Enforces the specified codec tune. The available options are FFmpeg-compatible Encode Options Note that certain values for this field may cause the transcoder to override other fields you set in the H264CodecSettings message.

string tune = 16;

Returns
Type Description
ByteString

The bytes for tune.

getVbvFullnessBits()

public int getVbvFullnessBits()

Initial fullness of the Video Buffering Verifier (VBV) buffer in bits. Must be greater than zero. The default is equal to 90% of vbv_size_bits.

int32 vbv_fullness_bits = 10;

Returns
Type Description
int

The vbvFullnessBits.

getVbvSizeBits()

public int getVbvSizeBits()

Size of the Video Buffering Verifier (VBV) buffer in bits. Must be greater than zero. The default is equal to bitrate_bps.

int32 vbv_size_bits = 9;

Returns
Type Description
int

The vbvSizeBits.

getWidthPixels()

public int getWidthPixels()

Required. The width of the video in pixels. Must be an even integer. Valid range is [320, 1920].

int32 width_pixels = 1;

Returns
Type Description
int

The widthPixels.

hasGopDuration()

public boolean hasGopDuration()

Select the GOP size based on the specified duration. The default is 2s. Note that gopDuration must be less than or equal to segment_duration, and segment_duration must be divisible by gopDuration. Valid range is [2s, 20s].

All video streams in the same channel must have the same GOP size.

.google.protobuf.Duration gop_duration = 8;

Returns
Type Description
boolean

Whether the gopDuration field is set.

hasGopFrameCount()

public boolean hasGopFrameCount()

Select the GOP size based on the specified frame count. If GOP frame count is set instead of GOP duration, GOP duration will be calculated by gopFrameCount/frameRate. The calculated GOP duration must satisfy the limitations on gopDuration as well. Valid range is [60, 600].

int32 gop_frame_count = 7;

Returns
Type Description
boolean

Whether the gopFrameCount field is set.

hashCode()

public int hashCode()
Returns
Type Description
int
Overrides

internalGetFieldAccessorTable()

protected GeneratedMessageV3.FieldAccessorTable internalGetFieldAccessorTable()
Returns
Type Description
FieldAccessorTable
Overrides

isInitialized()

public final boolean isInitialized()
Returns
Type Description
boolean
Overrides

newBuilderForType()

public VideoStream.H264CodecSettings.Builder newBuilderForType()
Returns
Type Description
VideoStream.H264CodecSettings.Builder

newBuilderForType(GeneratedMessageV3.BuilderParent parent)

protected VideoStream.H264CodecSettings.Builder newBuilderForType(GeneratedMessageV3.BuilderParent parent)
Parameter
Name Description
parent BuilderParent
Returns
Type Description
VideoStream.H264CodecSettings.Builder
Overrides

newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)

protected Object newInstance(GeneratedMessageV3.UnusedPrivateParameter unused)
Parameter
Name Description
unused UnusedPrivateParameter
Returns
Type Description
Object
Overrides

toBuilder()

public VideoStream.H264CodecSettings.Builder toBuilder()
Returns
Type Description
VideoStream.H264CodecSettings.Builder

writeTo(CodedOutputStream output)

public void writeTo(CodedOutputStream output)
Parameter
Name Description
output CodedOutputStream
Overrides
Exceptions
Type Description
IOException