Google Cloud Video Transcoder V1beta1 Client - Class VideoStream (0.7.1)

Reference documentation and code samples for the Google Cloud Video Transcoder V1beta1 Client class VideoStream.

Video stream resource.

Generated from protobuf message google.cloud.video.transcoder.v1beta1.VideoStream

Methods

__construct

Constructor.

Parameters
NameDescription
data array

Optional. Data for populating the Message object.

↳ codec string

Codec type. The following codecs are supported: * h264 (default) * h265 * vp9

↳ profile string

Enforces the specified codec profile. The following profiles are supported: * baseline * main * high (default) The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the VideoStream message.

↳ tune string

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

↳ preset string

Enforces the specified codec preset. The default is veryfast. The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the VideoStream message.

↳ height_pixels int

The height of the video in pixels. Must be an even integer. When not specified, the height is adjusted to match the specified width and input aspect ratio. If both are omitted, the input height is used.

↳ width_pixels int

The width of the video in pixels. Must be an even integer. When not specified, the width is adjusted to match the specified height and input aspect ratio. If both are omitted, the input width is used.

↳ pixel_format string

Pixel format to use. The default is "yuv420p". Supported pixel formats: - 'yuv420p' pixel format. - 'yuv422p' pixel format. - 'yuv444p' pixel format. - 'yuv420p10' 10-bit HDR pixel format. - 'yuv422p10' 10-bit HDR pixel format. - 'yuv444p10' 10-bit HDR pixel format. - 'yuv420p12' 12-bit HDR pixel format. - 'yuv422p12' 12-bit HDR pixel format. - 'yuv444p12' 12-bit HDR pixel format.

↳ bitrate_bps int

Required. The video bitrate in bits per second. The minimum value is 1,000. The maximum value for H264/H265 is 800,000,000. The maximum value for VP9 is 480,000,000.

↳ rate_control_mode string

Specify the rate_control_mode. The default is "vbr". Supported rate control modes: - 'vbr' - variable bitrate - 'crf' - constant rate factor

↳ enable_two_pass bool

Use two-pass encoding strategy to achieve better video quality. VideoStream.rate_control_mode must be "vbr". The default is false.

↳ crf_level int

Target CRF level. Must be between 10 and 36, where 10 is the highest quality and 36 is the most efficient compression. The default is 21.

↳ vbv_size_bits int

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

↳ vbv_fullness_bits int

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

↳ allow_open_gop bool

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

↳ gop_frame_count int

Select the GOP size based on the specified frame count. Must be greater than zero.

↳ gop_duration Google\Protobuf\Duration

Select the GOP size based on the specified duration. The default is "3s". Note that gopDuration must be less than or equal to segmentDuration, and segmentDuration must be divisible by gopDuration.

↳ entropy_coder string

The entropy coder to use. The default is "cabac". Supported entropy coders: - 'cavlc' - 'cabac'

↳ b_pyramid bool

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

↳ b_frame_count int

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

↳ frame_rate float

Required. The target video frame rate in frames per second (FPS). Must be less than or equal to 120. 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 Calculate frame rate for more information.

↳ aq_strength float

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.

getCodec

Codec type. The following codecs are supported:

  • h264 (default)
  • h265
  • vp9
Returns
TypeDescription
string

setCodec

Codec type. The following codecs are supported:

  • h264 (default)
  • h265
  • vp9
Parameter
NameDescription
var string
Returns
TypeDescription
$this

getProfile

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

  • baseline
  • main
  • high (default) The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the VideoStream message.
Returns
TypeDescription
string

setProfile

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

  • baseline
  • main
  • high (default) The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the VideoStream message.
Parameter
NameDescription
var string
Returns
TypeDescription
$this

getTune

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

Returns
TypeDescription
string

setTune

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

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getPreset

Enforces the specified codec preset. The default is veryfast. The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the VideoStream message.

Returns
TypeDescription
string

setPreset

Enforces the specified codec preset. The default is veryfast. The available options are FFmpeg-compatible. Note that certain values for this field may cause the transcoder to override other fields you set in the VideoStream message.

Parameter
NameDescription
var string
Returns
TypeDescription
$this

getHeightPixels

The height of the video in pixels. Must be an even integer.

When not specified, the height is adjusted to match the specified width and input aspect ratio. If both are omitted, the input height is used.

Returns
TypeDescription
int

setHeightPixels

The height of the video in pixels. Must be an even integer.

When not specified, the height is adjusted to match the specified width and input aspect ratio. If both are omitted, the input height is used.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getWidthPixels

The width of the video in pixels. Must be an even integer.

When not specified, the width is adjusted to match the specified height and input aspect ratio. If both are omitted, the input width is used.

Returns
TypeDescription
int

setWidthPixels

The width of the video in pixels. Must be an even integer.

When not specified, the width is adjusted to match the specified height and input aspect ratio. If both are omitted, the input width is used.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getPixelFormat

Pixel format to use. The default is "yuv420p".

Supported pixel formats:

  • 'yuv420p' pixel format.
  • 'yuv422p' pixel format.
  • 'yuv444p' pixel format.
  • 'yuv420p10' 10-bit HDR pixel format.
  • 'yuv422p10' 10-bit HDR pixel format.
  • 'yuv444p10' 10-bit HDR pixel format.
  • 'yuv420p12' 12-bit HDR pixel format.
  • 'yuv422p12' 12-bit HDR pixel format.
  • 'yuv444p12' 12-bit HDR pixel format.
Returns
TypeDescription
string

setPixelFormat

Pixel format to use. The default is "yuv420p".

Supported pixel formats:

  • 'yuv420p' pixel format.
  • 'yuv422p' pixel format.
  • 'yuv444p' pixel format.
  • 'yuv420p10' 10-bit HDR pixel format.
  • 'yuv422p10' 10-bit HDR pixel format.
  • 'yuv444p10' 10-bit HDR pixel format.
  • 'yuv420p12' 12-bit HDR pixel format.
  • 'yuv422p12' 12-bit HDR pixel format.
  • 'yuv444p12' 12-bit HDR pixel format.
Parameter
NameDescription
var string
Returns
TypeDescription
$this

getBitrateBps

Required. The video bitrate in bits per second. The minimum value is 1,000.

The maximum value for H264/H265 is 800,000,000. The maximum value for VP9 is 480,000,000.

Returns
TypeDescription
int

setBitrateBps

Required. The video bitrate in bits per second. The minimum value is 1,000.

The maximum value for H264/H265 is 800,000,000. The maximum value for VP9 is 480,000,000.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getRateControlMode

Specify the rate_control_mode. The default is "vbr".

Supported rate control modes:

  • 'vbr' - variable bitrate
  • 'crf' - constant rate factor
Returns
TypeDescription
string

setRateControlMode

Specify the rate_control_mode. The default is "vbr".

Supported rate control modes:

  • 'vbr' - variable bitrate
  • 'crf' - constant rate factor
Parameter
NameDescription
var string
Returns
TypeDescription
$this

getEnableTwoPass

Use two-pass encoding strategy to achieve better video quality.

VideoStream.rate_control_mode must be "vbr". The default is false.

Returns
TypeDescription
bool

setEnableTwoPass

Use two-pass encoding strategy to achieve better video quality.

VideoStream.rate_control_mode must be "vbr". The default is false.

Parameter
NameDescription
var bool
Returns
TypeDescription
$this

getCrfLevel

Target CRF level. Must be between 10 and 36, where 10 is the highest quality and 36 is the most efficient compression. The default is 21.

Returns
TypeDescription
int

setCrfLevel

Target CRF level. Must be between 10 and 36, where 10 is the highest quality and 36 is the most efficient compression. The default is 21.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getVbvSizeBits

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

Returns
TypeDescription
int

setVbvSizeBits

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

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getVbvFullnessBits

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

Returns
TypeDescription
int

setVbvFullnessBits

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

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getAllowOpenGop

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

Returns
TypeDescription
bool

setAllowOpenGop

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

Parameter
NameDescription
var bool
Returns
TypeDescription
$this

getGopFrameCount

Select the GOP size based on the specified frame count. Must be greater than zero.

Returns
TypeDescription
int

hasGopFrameCount

setGopFrameCount

Select the GOP size based on the specified frame count. Must be greater than zero.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getGopDuration

Select the GOP size based on the specified duration. The default is "3s". Note that gopDuration must be less than or equal to segmentDuration, and segmentDuration must be divisible by gopDuration.

Returns
TypeDescription
Google\Protobuf\Duration|null

hasGopDuration

setGopDuration

Select the GOP size based on the specified duration. The default is "3s". Note that gopDuration must be less than or equal to segmentDuration, and segmentDuration must be divisible by gopDuration.

Parameter
NameDescription
var Google\Protobuf\Duration
Returns
TypeDescription
$this

getEntropyCoder

The entropy coder to use. The default is "cabac".

Supported entropy coders:

  • 'cavlc'
  • 'cabac'
Returns
TypeDescription
string

setEntropyCoder

The entropy coder to use. The default is "cabac".

Supported entropy coders:

  • 'cavlc'
  • 'cabac'
Parameter
NameDescription
var string
Returns
TypeDescription
$this

getBPyramid

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

Returns
TypeDescription
bool

setBPyramid

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

Parameter
NameDescription
var bool
Returns
TypeDescription
$this

getBFrameCount

The number of consecutive B-frames. Must be greater than or equal to zero.

Must be less than VideoStream.gop_frame_count if set. The default is 0.

Returns
TypeDescription
int

setBFrameCount

The number of consecutive B-frames. Must be greater than or equal to zero.

Must be less than VideoStream.gop_frame_count if set. The default is 0.

Parameter
NameDescription
var int
Returns
TypeDescription
$this

getFrameRate

Required. The target video frame rate in frames per second (FPS). Must be less than or equal to 120. 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 Calculate frame rate for more information.

Returns
TypeDescription
float

setFrameRate

Required. The target video frame rate in frames per second (FPS). Must be less than or equal to 120. 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 Calculate frame rate for more information.

Parameter
NameDescription
var float
Returns
TypeDescription
$this

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.

Returns
TypeDescription
float

setAqStrength

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.

Parameter
NameDescription
var float
Returns
TypeDescription
$this

getGopMode

Returns
TypeDescription
string