# Introduction

Stream conditions allow you to add conditional logic in your encoding configuration. They ensure that your workflow can automatically adapt to different types of input files and streams.

This page lists the attributes and values available when attaching stream conditions to [`Stream` resources](πŸ”—ο»Ώ) through its `conditions` parameter.

Use the [tutorial](πŸ”—ο»Ώ) for more information on how to use stream conditions.

# Condition object

A `Condition` has three parameters:

**`attribute`**

Indicates what aspect of the input is being checked

**`operator`**

Indicates the logical operation to perform between source value and expected value. Possible operators are

ο»Ώ

Note that if you use our SDKs, the operators are exposed through a ConditionOperator enumeration:

ο»Ώ

**`value`**

Allows you to state what value to compare against the value extracted from the input file or stream.

All values (including numbers and booleans) should be provided as strings, and will be cast automatically into the appropriate type when the encoder performs the condition check.

# Extracted values

At times, you may find that the condition you configure does not seem to work. It may be that the file you are using does not conform to your expectations.

To troubleshoot this, you can verify the result of the analysis stage, by looking at the `analysisDetails` property of the `Stream` (or `inputStreams.analysisDetails` depending on your input configuration), which will be populated during the encoding.

We state below, for each attribute, which property in the `analysisDetails` object will reflect the value extracted from the source during analysis.

_Note that the `analysisDetails` property is only available when you call the REST API directly, and is not currently exposed through the SDKs. You can for example use the REST client embedded in our API reference._

# Input file

The following attributes are used to check the input file:

AttributeDescriptionExtracted ValueWorks for VoDWorks for LIVE
INPUTSTREAMchecks whether there is a stream to be found in the input file, at the position defined by the `selectionMode` parameter of the `StreamInput` resource attached to the `Stream`. You must use the `EQUAL` condition operator to test this condition`true` or `false`βœ…βœ…
STREAMCOUNTchecks the number of streams (or tracks) present in the input file`analysisDetails.numberOfStreams`βœ…βœ…
VIDEOSTREAMCOUNTchecks specifically the number of video streams available in the input filesize of `analysisDetails.videoStreams` arrayβœ…βœ…
AUDIOSTREAMCOUNTchecks specifically the number of audio streams available in the input filesize of `analysisDetails.audioStreams` arrayβœ…βœ…
DURATIONchecks the duration of the input stream, and is expressed as a decimal representation in seconds`analysisDetails.videoStreams[0].duration` or `analysisDetails.duration`βœ…βœ–οΈ

ο»Ώ

# Video Stream

In addition to the above, the following attributes are only available when evaluating conditions against video streams. Extracted values are compared against the property of the appropriate item in the `analysisDetails.videoStreams` array

AttributeDescriptionExtracted ValueWorks for VoDWorks for LIVE
HEIGHTin pixels`height`βœ…βœ…
WIDTHin pixels`width`βœ…βœ…
BITRATEexpressed as an integer in bits per second (bps)`bitrate`βœ…βœ–οΈ
FPSframe rate expressed as a number of frames per second and parsed to a decimal representation (ie. you can also express it as fraction such as "3000/1001"`fps`βœ…βœ…
ASPECTRATIOas a decimal value. Therefore a value larger than 1 is therefore landscape, and lower than 1 portraitcalculated as `width` / `height` \* `par`βœ…βœ…
ROTATIONin degrees`rotation`βœ…βœ…

# Audio Stream

The following attributes apply to audio input streams only. Extracted values are compared against the property of the appropriate item in the `analysisDetails.audioStreams` array

AttributeDescriptionExtracted ValueWorks for VoDWorks for LIVE
BITRATEexpressed as an integer in bits per second (bps)`bitrate`βœ…βœ–οΈ
LANGUAGEaudio language. If none is set in the input stream, the value will be "und"`language`βœ…βœ…
CHANNELFORMATused to check on the number of channels in the audio stream. For example, a stereo input track would have a value of 2, a input track with dolby digital would have 6`channelFormat`βœ…βœ…
CHANNELLAYOUTA tag describing the channel layout. See <https://ffmpeg.org/ffprobe-all.html#Channel-Layout> for a list of possible values`channelLayout`βœ…βœ…