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.
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
string
setCodec
Codec type. The following codecs are supported:
-
h264
(default) -
h265
-
vp9
var
string
$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 theVideoStream
message.
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 theVideoStream
message.
var
string
$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.
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.
var
string
$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.
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.
var
string
$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.
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.
var
int
$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.
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.
var
int
$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.
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.
var
string
$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.
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.
var
int
$this
getRateControlMode
Specify the rate_control_mode
. The default is "vbr"
.
Supported rate control modes:
- 'vbr' - variable bitrate
- 'crf' - constant rate factor
string
setRateControlMode
Specify the rate_control_mode
. The default is "vbr"
.
Supported rate control modes:
- 'vbr' - variable bitrate
- 'crf' - constant rate factor
var
string
$this
getEnableTwoPass
Use two-pass encoding strategy to achieve better video quality.
VideoStream.rate_control_mode
must be "vbr"
. The default is false
.
bool
setEnableTwoPass
Use two-pass encoding strategy to achieve better video quality.
VideoStream.rate_control_mode
must be "vbr"
. The default is false
.
var
bool
$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.
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.
var
int
$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
.
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
.
var
int
$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
.
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
.
var
int
$this
getAllowOpenGop
Specifies whether an open Group of Pictures (GOP) structure should be
allowed or not. The default is false
.
bool
setAllowOpenGop
Specifies whether an open Group of Pictures (GOP) structure should be
allowed or not. The default is false
.
var
bool
$this
getGopFrameCount
Select the GOP size based on the specified frame count. Must be greater than zero.
int
hasGopFrameCount
setGopFrameCount
Select the GOP size based on the specified frame count. Must be greater than zero.
var
int
$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
.
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
.
$this
getEntropyCoder
The entropy coder to use. The default is "cabac"
.
Supported entropy coders:
- 'cavlc'
- 'cabac'
string
setEntropyCoder
The entropy coder to use. The default is "cabac"
.
Supported entropy coders:
- 'cavlc'
- 'cabac'
var
string
$this
getBPyramid
Allow B-pyramid for reference frame selection. This may not be supported
on all decoders. The default is false
.
bool
setBPyramid
Allow B-pyramid for reference frame selection. This may not be supported
on all decoders. The default is false
.
var
bool
$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.
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.
var
int
$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.
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.
var
float
$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.
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.
var
float
$this
getGopMode
string