Variant Selection (Video)

When playing back streams that contain multiple/adaptive video variants, for example HLS and DASH (Android Only), you can specifically select a video variant to play. When selecting a specific variant, other variants in the stream will no longer be automatically chosen.

Currently this feature is only available on the following platforms:

  • Android
  • iOS
  • macOS
  • tvOS
  • visionOS

NOTE: This feature on Apple platforms is currently marked as 'experimental'.


You can obtain a list of available for the currently playing video:

mediaPlayer.Variants

...and loop over them:

foreach( Variant variant in mediaPlayer.Variants )
{
    Debug.Log( "Variant: ID = " + variant.Id + " | " + variant.Width + " x " + variant.Height + " @ " + variant.PeakDataRate + "bps" );
}


You can select a specific variant:

mediaPlayer.Variants.SelectVariant( variant );

where:

  • variant is the variant object found in the variant list


...or you can select a specific variant by index:

mediaPlayer.Variants.SelectVariant( mediaPlayer.Variants[ variantIndex ] );

where:

  • variantIndex is the index of the variant object in the variant list



To get the currently selected variant:

Variant currentVariant = mediaPlayer.Variants.GetSelectedVariant();


To return to 'auto' variant selection:

mediaPlayer.Variants.SelectVariant( Variant.Auto );