bitmovin-player-react-native 0.42.0 → 0.43.0

package/RNBitmovinPlayer.podspec

@@ -20,7 +20,7 @@ Pod::Spec.new do |s|
 
   s.swift_version = "5.10"
   s.dependency "React-Core"
-  s.dependency "BitmovinPlayer", "3.90.0"
+  s.dependency "BitmovinPlayer", "3.92.0"
   s.ios.dependency "GoogleAds-IMA-iOS-SDK", "3.23.0"
   s.tvos.dependency "GoogleAds-IMA-tvOS-SDK", "4.13.0"
 end

package/android/build.gradle

@@ -105,6 +105,6 @@ dependencies {
     // Bitmovin
     implementation 'com.google.ads.interactivemedia.v3:interactivemedia:3.35.1'
     implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'
-    implementation 'com.bitmovin.player:player:3.112.0+jason'
-    implementation 'com.bitmovin.player:player-media-session:3.112.0+jason'
+    implementation 'com.bitmovin.player:player:3.115.0+jason'
+    implementation 'com.bitmovin.player:player-media-session:3.115.0+jason'
 }

package/android/gradle.properties

@@ -1,4 +1,5 @@
 android.useAndroidX=true
+# Also update example/android/gradle.properties and integration_test/android/gradle.properties when updating kotlin version.
 BitmovinPlayerReactNative_kotlinVersion=1.9.21
 BitmovinPlayerReactNative_minSdkVersion=21
 BitmovinPlayerReactNative_targetSdkVersion=35

package/android/src/main/java/com/bitmovin/player/reactnative/converter/JsonConverter.kt

@@ -37,6 +37,7 @@ import com.bitmovin.player.api.media.AdaptationConfig
 import com.bitmovin.player.api.media.MediaTrackRole
 import com.bitmovin.player.api.media.MediaType
 import com.bitmovin.player.api.media.audio.AudioTrack
+import com.bitmovin.player.api.media.audio.quality.AudioQuality
 import com.bitmovin.player.api.media.subtitle.SubtitleTrack
 import com.bitmovin.player.api.media.thumbnail.Thumbnail
 import com.bitmovin.player.api.media.thumbnail.ThumbnailTrack
@@ -561,6 +562,19 @@ fun AudioTrack.toJson(): WritableMap = Arguments.createMap().apply {
     putString("identifier", id)
     putString("language", language)
     putArray("roles", roles.mapToReactArray { it.toJson() })
+    putArray("qualities", qualities.mapToReactArray { it.toJson() })
+}
+
+/**
+ * Converts any `AudioQuality` into its json representation.
+ */
+fun AudioQuality.toJson(): WritableMap = Arguments.createMap().apply {
+    putString("id", id)
+    putString("label", label)
+    putInt("bitrate", bitrate)
+    putInt("averageBitrate", averageBitrate)
+    putInt("peakBitrate", peakBitrate)
+    putString("codec", codec)
 }
 
 /**

package/lib/index.d.mts

@@ -585,6 +585,57 @@ interface VideoQuality {
      */
     width?: number;
 }
+/**
+ * Quality definition of an audio representation.
+ *
+ * @platform Android
+ */
+interface AudioQuality {
+    /**
+     * The id of the media quality.
+     */
+    id: string;
+    /**
+     * The label of the media quality that should be exposed to the user.
+     */
+    label?: string;
+    /**
+     * The bitrate in bits per second. This is the peak bitrate if known, or else the average bitrate
+     * if known, or else -1.
+     */
+    bitrate?: number;
+    /**
+     * The average bitrate in bits per second, or -1 if unknown or not applicable. The
+     * way in which this field is populated depends on the type of media to which the format
+     * corresponds:
+     *
+     * - DASH representations: Always -1.
+     * - HLS variants: The `AVERAGE-BANDWIDTH` attribute defined on the corresponding
+     *   `EXT-X-STREAM-INF` tag in the multivariant playlist, or -1 if not present.
+     * - SmoothStreaming track elements: The `Bitrate` attribute defined on the
+     *   corresponding `TrackElement` in the manifest, or -1 if not present.
+     * - Progressive container formats: Often -1, but may be populated with
+     *   the average bitrate of the container if known.
+     */
+    averageBitrate?: number;
+    /**
+     * The peak bitrate in bits per second, or -1 if unknown or not applicable. The way
+     * in which this field is populated depends on the type of media to which the format corresponds:
+     *
+     *  - DASH representations: The `@bandwidth` attribute of the corresponding
+     *    `Representation` element in the manifest.
+     *  - HLS variants: The `BANDWIDTH` attribute defined on the corresponding
+     *    `EXT-X-STREAM-INF` tag.
+     *  - SmoothStreaming track elements: Always -1.
+     *  - Progressive container formats: Often -1, but may be populated with
+     *    the peak bitrate of the container if known.
+     */
+    peakBitrate?: number;
+    /**
+     * The codec of the media quality.
+     */
+    codec?: string;
+}
 
 /**
  * Represents an audio track for a video.
@@ -615,6 +666,12 @@ interface AudioTrack {
      * This property provides a unified way to understand track purposes (e.g., for accessibility) across platforms.
      */
     roles?: MediaTrackRole[];
+    /**
+     * A list of AudioQuality associated with this AudioTrack.
+     *
+     * @platform Android
+     */
+    qualities?: AudioQuality[];
 }
 
 interface NativeInstanceConfig {
@@ -4250,4 +4307,4 @@ declare class DebugConfig {
     static setDebugLoggingEnabled(value: boolean): Promise<void>;
 }
 
-export { Ad, AdBreak, AdBreakFinishedEvent, AdBreakStartedEvent, AdClickedEvent, AdConfig, AdData, AdErrorEvent, AdFinishedEvent, AdItem, AdManifestLoadEvent, AdManifestLoadedEvent, AdQuartile, AdQuartileEvent, AdScheduledEvent, AdSkippedEvent, AdSource, AdSourceType, AdStartedEvent, AdaptationConfig, AdvertisingConfig, AnalyticsApi, AnalyticsConfig, AudioAddedEvent, AudioChangedEvent, AudioRemovedEvent, AudioSession, AudioSessionCategory, AudioTrack, BasePlayerViewProps, BitmovinCastManager, BitmovinCastManagerOptions, BitmovinNativeOfflineEventData, BufferApi, BufferConfig, BufferLevel, BufferLevels, BufferMediaTypeConfig, BufferType, CastAvailableEvent, CastPausedEvent, CastPayload, CastPlaybackFinishedEvent, CastPlayingEvent, CastStartEvent, CastStartedEvent, CastStoppedEvent, CastTimeUpdatedEvent, CastWaitingForDeviceEvent, CueEnterEvent, CueExitEvent, CustomDataConfig, CustomMessageHandler, CustomMessageHandlerProps, CustomUi, DebugConfig, DecoderConfig, DecoderContext, DecoderContextMediaType, DecoderPriorityProvider, DefaultMetadata, DestroyEvent, DownloadFinishedEvent, Drm, DrmConfig, ErrorEvent, Event, EventSource, FairplayConfig, ForceReuseVideoCodecReason, FullscreenDisabledEvent, FullscreenEnabledEvent, FullscreenEnterEvent, FullscreenExitEvent, FullscreenHandler, HttpRequest, HttpRequestType, HttpResponse, LiveConfig, LoadingState, MediaCodecInfo, MediaControlConfig, MediaTrackRole, MediaType, MutedEvent, Network, NetworkConfig, OfflineContentConfig, OfflineContentManager, OfflineContentManagerListener, OfflineContentOptionEntry, OfflineContentOptions, OfflineDownloadRequest, OfflineEvent, OfflineEventType, OfflineSourceOptions, OfflineState, OnCanceledEvent, OnCompletedEvent, OnDrmLicenseExpiredEvent, OnDrmLicenseUpdatedEvent, OnErrorEvent, OnOptionsAvailableEvent, OnProgressEvent, OnResumedEvent, OnSuspendedEvent, PausedEvent, PictureInPictureAvailabilityChangedEvent, PictureInPictureConfig, PictureInPictureEnterEvent, PictureInPictureEnteredEvent, PictureInPictureExitEvent, PictureInPictureExitedEvent, PlayEvent, PlaybackConfig, PlaybackFinishedEvent, PlaybackSpeedChangedEvent, Player, PlayerActiveEvent, PlayerConfig, PlayerErrorEvent, PlayerView, PlayerViewConfig, PlayerViewProps, PlayerWarningEvent, PlayingEvent, ReadyEvent, RemoteControlConfig, ScalingMode, SeekEvent, SeekPosition, SeekedEvent, SideLoadedSubtitleTrack, SmallScreenUi, Source, SourceConfig, SourceErrorEvent, SourceLoadEvent, SourceLoadedEvent, SourceMetadata, SourceOptions, SourceRemoteControlConfig, SourceType, SourceUnloadedEvent, SourceWarningEvent, StallEndedEvent, StallStartedEvent, StyleConfig, SubtitleAddedEvent, SubtitleChangedEvent, SubtitleFormat, SubtitleRemovedEvent, SubtitleTrack, SurfaceType, Thumbnail, TimeChangedEvent, TimeShiftEvent, TimeShiftedEvent, TimelineReferencePoint, TvUi, TweaksConfig, UiConfig, UnmutedEvent, UserInterfaceType, Variant, VideoDownloadQualityChangedEvent, VideoPlaybackQualityChangedEvent, VideoQuality, WebUiConfig, WidevineConfig, usePlayer };
+export { Ad, AdBreak, AdBreakFinishedEvent, AdBreakStartedEvent, AdClickedEvent, AdConfig, AdData, AdErrorEvent, AdFinishedEvent, AdItem, AdManifestLoadEvent, AdManifestLoadedEvent, AdQuartile, AdQuartileEvent, AdScheduledEvent, AdSkippedEvent, AdSource, AdSourceType, AdStartedEvent, AdaptationConfig, AdvertisingConfig, AnalyticsApi, AnalyticsConfig, AudioAddedEvent, AudioChangedEvent, AudioQuality, AudioRemovedEvent, AudioSession, AudioSessionCategory, AudioTrack, BasePlayerViewProps, BitmovinCastManager, BitmovinCastManagerOptions, BitmovinNativeOfflineEventData, BufferApi, BufferConfig, BufferLevel, BufferLevels, BufferMediaTypeConfig, BufferType, CastAvailableEvent, CastPausedEvent, CastPayload, CastPlaybackFinishedEvent, CastPlayingEvent, CastStartEvent, CastStartedEvent, CastStoppedEvent, CastTimeUpdatedEvent, CastWaitingForDeviceEvent, CueEnterEvent, CueExitEvent, CustomDataConfig, CustomMessageHandler, CustomMessageHandlerProps, CustomUi, DebugConfig, DecoderConfig, DecoderContext, DecoderContextMediaType, DecoderPriorityProvider, DefaultMetadata, DestroyEvent, DownloadFinishedEvent, Drm, DrmConfig, ErrorEvent, Event, EventSource, FairplayConfig, ForceReuseVideoCodecReason, FullscreenDisabledEvent, FullscreenEnabledEvent, FullscreenEnterEvent, FullscreenExitEvent, FullscreenHandler, HttpRequest, HttpRequestType, HttpResponse, LiveConfig, LoadingState, MediaCodecInfo, MediaControlConfig, MediaTrackRole, MediaType, MutedEvent, Network, NetworkConfig, OfflineContentConfig, OfflineContentManager, OfflineContentManagerListener, OfflineContentOptionEntry, OfflineContentOptions, OfflineDownloadRequest, OfflineEvent, OfflineEventType, OfflineSourceOptions, OfflineState, OnCanceledEvent, OnCompletedEvent, OnDrmLicenseExpiredEvent, OnDrmLicenseUpdatedEvent, OnErrorEvent, OnOptionsAvailableEvent, OnProgressEvent, OnResumedEvent, OnSuspendedEvent, PausedEvent, PictureInPictureAvailabilityChangedEvent, PictureInPictureConfig, PictureInPictureEnterEvent, PictureInPictureEnteredEvent, PictureInPictureExitEvent, PictureInPictureExitedEvent, PlayEvent, PlaybackConfig, PlaybackFinishedEvent, PlaybackSpeedChangedEvent, Player, PlayerActiveEvent, PlayerConfig, PlayerErrorEvent, PlayerView, PlayerViewConfig, PlayerViewProps, PlayerWarningEvent, PlayingEvent, ReadyEvent, RemoteControlConfig, ScalingMode, SeekEvent, SeekPosition, SeekedEvent, SideLoadedSubtitleTrack, SmallScreenUi, Source, SourceConfig, SourceErrorEvent, SourceLoadEvent, SourceLoadedEvent, SourceMetadata, SourceOptions, SourceRemoteControlConfig, SourceType, SourceUnloadedEvent, SourceWarningEvent, StallEndedEvent, StallStartedEvent, StyleConfig, SubtitleAddedEvent, SubtitleChangedEvent, SubtitleFormat, SubtitleRemovedEvent, SubtitleTrack, SurfaceType, Thumbnail, TimeChangedEvent, TimeShiftEvent, TimeShiftedEvent, TimelineReferencePoint, TvUi, TweaksConfig, UiConfig, UnmutedEvent, UserInterfaceType, Variant, VideoDownloadQualityChangedEvent, VideoPlaybackQualityChangedEvent, VideoQuality, WebUiConfig, WidevineConfig, usePlayer };

package/lib/index.d.ts

@@ -585,6 +585,57 @@ interface VideoQuality {
      */
     width?: number;
 }
+/**
+ * Quality definition of an audio representation.
+ *
+ * @platform Android
+ */
+interface AudioQuality {
+    /**
+     * The id of the media quality.
+     */
+    id: string;
+    /**
+     * The label of the media quality that should be exposed to the user.
+     */
+    label?: string;
+    /**
+     * The bitrate in bits per second. This is the peak bitrate if known, or else the average bitrate
+     * if known, or else -1.
+     */
+    bitrate?: number;
+    /**
+     * The average bitrate in bits per second, or -1 if unknown or not applicable. The
+     * way in which this field is populated depends on the type of media to which the format
+     * corresponds:
+     *
+     * - DASH representations: Always -1.
+     * - HLS variants: The `AVERAGE-BANDWIDTH` attribute defined on the corresponding
+     *   `EXT-X-STREAM-INF` tag in the multivariant playlist, or -1 if not present.
+     * - SmoothStreaming track elements: The `Bitrate` attribute defined on the
+     *   corresponding `TrackElement` in the manifest, or -1 if not present.
+     * - Progressive container formats: Often -1, but may be populated with
+     *   the average bitrate of the container if known.
+     */
+    averageBitrate?: number;
+    /**
+     * The peak bitrate in bits per second, or -1 if unknown or not applicable. The way
+     * in which this field is populated depends on the type of media to which the format corresponds:
+     *
+     *  - DASH representations: The `@bandwidth` attribute of the corresponding
+     *    `Representation` element in the manifest.
+     *  - HLS variants: The `BANDWIDTH` attribute defined on the corresponding
+     *    `EXT-X-STREAM-INF` tag.
+     *  - SmoothStreaming track elements: Always -1.
+     *  - Progressive container formats: Often -1, but may be populated with
+     *    the peak bitrate of the container if known.
+     */
+    peakBitrate?: number;
+    /**
+     * The codec of the media quality.
+     */
+    codec?: string;
+}
 
 /**
  * Represents an audio track for a video.
@@ -615,6 +666,12 @@ interface AudioTrack {
      * This property provides a unified way to understand track purposes (e.g., for accessibility) across platforms.
      */
     roles?: MediaTrackRole[];
+    /**
+     * A list of AudioQuality associated with this AudioTrack.
+     *
+     * @platform Android
+     */
+    qualities?: AudioQuality[];
 }
 
 interface NativeInstanceConfig {
@@ -4250,4 +4307,4 @@ declare class DebugConfig {
     static setDebugLoggingEnabled(value: boolean): Promise<void>;
 }
 
-export { Ad, AdBreak, AdBreakFinishedEvent, AdBreakStartedEvent, AdClickedEvent, AdConfig, AdData, AdErrorEvent, AdFinishedEvent, AdItem, AdManifestLoadEvent, AdManifestLoadedEvent, AdQuartile, AdQuartileEvent, AdScheduledEvent, AdSkippedEvent, AdSource, AdSourceType, AdStartedEvent, AdaptationConfig, AdvertisingConfig, AnalyticsApi, AnalyticsConfig, AudioAddedEvent, AudioChangedEvent, AudioRemovedEvent, AudioSession, AudioSessionCategory, AudioTrack, BasePlayerViewProps, BitmovinCastManager, BitmovinCastManagerOptions, BitmovinNativeOfflineEventData, BufferApi, BufferConfig, BufferLevel, BufferLevels, BufferMediaTypeConfig, BufferType, CastAvailableEvent, CastPausedEvent, CastPayload, CastPlaybackFinishedEvent, CastPlayingEvent, CastStartEvent, CastStartedEvent, CastStoppedEvent, CastTimeUpdatedEvent, CastWaitingForDeviceEvent, CueEnterEvent, CueExitEvent, CustomDataConfig, CustomMessageHandler, CustomMessageHandlerProps, CustomUi, DebugConfig, DecoderConfig, DecoderContext, DecoderContextMediaType, DecoderPriorityProvider, DefaultMetadata, DestroyEvent, DownloadFinishedEvent, Drm, DrmConfig, ErrorEvent, Event, EventSource, FairplayConfig, ForceReuseVideoCodecReason, FullscreenDisabledEvent, FullscreenEnabledEvent, FullscreenEnterEvent, FullscreenExitEvent, FullscreenHandler, HttpRequest, HttpRequestType, HttpResponse, LiveConfig, LoadingState, MediaCodecInfo, MediaControlConfig, MediaTrackRole, MediaType, MutedEvent, Network, NetworkConfig, OfflineContentConfig, OfflineContentManager, OfflineContentManagerListener, OfflineContentOptionEntry, OfflineContentOptions, OfflineDownloadRequest, OfflineEvent, OfflineEventType, OfflineSourceOptions, OfflineState, OnCanceledEvent, OnCompletedEvent, OnDrmLicenseExpiredEvent, OnDrmLicenseUpdatedEvent, OnErrorEvent, OnOptionsAvailableEvent, OnProgressEvent, OnResumedEvent, OnSuspendedEvent, PausedEvent, PictureInPictureAvailabilityChangedEvent, PictureInPictureConfig, PictureInPictureEnterEvent, PictureInPictureEnteredEvent, PictureInPictureExitEvent, PictureInPictureExitedEvent, PlayEvent, PlaybackConfig, PlaybackFinishedEvent, PlaybackSpeedChangedEvent, Player, PlayerActiveEvent, PlayerConfig, PlayerErrorEvent, PlayerView, PlayerViewConfig, PlayerViewProps, PlayerWarningEvent, PlayingEvent, ReadyEvent, RemoteControlConfig, ScalingMode, SeekEvent, SeekPosition, SeekedEvent, SideLoadedSubtitleTrack, SmallScreenUi, Source, SourceConfig, SourceErrorEvent, SourceLoadEvent, SourceLoadedEvent, SourceMetadata, SourceOptions, SourceRemoteControlConfig, SourceType, SourceUnloadedEvent, SourceWarningEvent, StallEndedEvent, StallStartedEvent, StyleConfig, SubtitleAddedEvent, SubtitleChangedEvent, SubtitleFormat, SubtitleRemovedEvent, SubtitleTrack, SurfaceType, Thumbnail, TimeChangedEvent, TimeShiftEvent, TimeShiftedEvent, TimelineReferencePoint, TvUi, TweaksConfig, UiConfig, UnmutedEvent, UserInterfaceType, Variant, VideoDownloadQualityChangedEvent, VideoPlaybackQualityChangedEvent, VideoQuality, WebUiConfig, WidevineConfig, usePlayer };
+export { Ad, AdBreak, AdBreakFinishedEvent, AdBreakStartedEvent, AdClickedEvent, AdConfig, AdData, AdErrorEvent, AdFinishedEvent, AdItem, AdManifestLoadEvent, AdManifestLoadedEvent, AdQuartile, AdQuartileEvent, AdScheduledEvent, AdSkippedEvent, AdSource, AdSourceType, AdStartedEvent, AdaptationConfig, AdvertisingConfig, AnalyticsApi, AnalyticsConfig, AudioAddedEvent, AudioChangedEvent, AudioQuality, AudioRemovedEvent, AudioSession, AudioSessionCategory, AudioTrack, BasePlayerViewProps, BitmovinCastManager, BitmovinCastManagerOptions, BitmovinNativeOfflineEventData, BufferApi, BufferConfig, BufferLevel, BufferLevels, BufferMediaTypeConfig, BufferType, CastAvailableEvent, CastPausedEvent, CastPayload, CastPlaybackFinishedEvent, CastPlayingEvent, CastStartEvent, CastStartedEvent, CastStoppedEvent, CastTimeUpdatedEvent, CastWaitingForDeviceEvent, CueEnterEvent, CueExitEvent, CustomDataConfig, CustomMessageHandler, CustomMessageHandlerProps, CustomUi, DebugConfig, DecoderConfig, DecoderContext, DecoderContextMediaType, DecoderPriorityProvider, DefaultMetadata, DestroyEvent, DownloadFinishedEvent, Drm, DrmConfig, ErrorEvent, Event, EventSource, FairplayConfig, ForceReuseVideoCodecReason, FullscreenDisabledEvent, FullscreenEnabledEvent, FullscreenEnterEvent, FullscreenExitEvent, FullscreenHandler, HttpRequest, HttpRequestType, HttpResponse, LiveConfig, LoadingState, MediaCodecInfo, MediaControlConfig, MediaTrackRole, MediaType, MutedEvent, Network, NetworkConfig, OfflineContentConfig, OfflineContentManager, OfflineContentManagerListener, OfflineContentOptionEntry, OfflineContentOptions, OfflineDownloadRequest, OfflineEvent, OfflineEventType, OfflineSourceOptions, OfflineState, OnCanceledEvent, OnCompletedEvent, OnDrmLicenseExpiredEvent, OnDrmLicenseUpdatedEvent, OnErrorEvent, OnOptionsAvailableEvent, OnProgressEvent, OnResumedEvent, OnSuspendedEvent, PausedEvent, PictureInPictureAvailabilityChangedEvent, PictureInPictureConfig, PictureInPictureEnterEvent, PictureInPictureEnteredEvent, PictureInPictureExitEvent, PictureInPictureExitedEvent, PlayEvent, PlaybackConfig, PlaybackFinishedEvent, PlaybackSpeedChangedEvent, Player, PlayerActiveEvent, PlayerConfig, PlayerErrorEvent, PlayerView, PlayerViewConfig, PlayerViewProps, PlayerWarningEvent, PlayingEvent, ReadyEvent, RemoteControlConfig, ScalingMode, SeekEvent, SeekPosition, SeekedEvent, SideLoadedSubtitleTrack, SmallScreenUi, Source, SourceConfig, SourceErrorEvent, SourceLoadEvent, SourceLoadedEvent, SourceMetadata, SourceOptions, SourceRemoteControlConfig, SourceType, SourceUnloadedEvent, SourceWarningEvent, StallEndedEvent, StallStartedEvent, StyleConfig, SubtitleAddedEvent, SubtitleChangedEvent, SubtitleFormat, SubtitleRemovedEvent, SubtitleTrack, SurfaceType, Thumbnail, TimeChangedEvent, TimeShiftEvent, TimeShiftedEvent, TimelineReferencePoint, TvUi, TweaksConfig, UiConfig, UnmutedEvent, UserInterfaceType, Variant, VideoDownloadQualityChangedEvent, VideoPlaybackQualityChangedEvent, VideoQuality, WebUiConfig, WidevineConfig, usePlayer };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "bitmovin-player-react-native",
-  "version": "0.42.0",
+  "version": "0.43.0",
   "description": "Official React Native bindings for Bitmovin's mobile Player SDKs.",
   "main": "lib/index.js",
   "module": "lib/index.mjs",

package/src/audioTrack.ts

@@ -1,4 +1,5 @@
 import { MediaTrackRole } from './mediaTrackRole';
+import { AudioQuality } from './media';
 
 /**
  * Represents an audio track for a video.
@@ -29,4 +30,10 @@ export interface AudioTrack {
    * This property provides a unified way to understand track purposes (e.g., for accessibility) across platforms.
    */
   roles?: MediaTrackRole[];
+  /**
+   * A list of AudioQuality associated with this AudioTrack.
+   *
+   * @platform Android
+   */
+  qualities?: AudioQuality[];
 }

package/src/media.ts

@@ -31,3 +31,55 @@ export interface VideoQuality {
    */
   width?: number;
 }
+
+/**
+ * Quality definition of an audio representation.
+ *
+ * @platform Android
+ */
+export interface AudioQuality {
+  /**
+   * The id of the media quality.
+   */
+  id: string;
+  /**
+   * The label of the media quality that should be exposed to the user.
+   */
+  label?: string;
+  /**
+   * The bitrate in bits per second. This is the peak bitrate if known, or else the average bitrate
+   * if known, or else -1.
+   */
+  bitrate?: number;
+  /**
+   * The average bitrate in bits per second, or -1 if unknown or not applicable. The
+   * way in which this field is populated depends on the type of media to which the format
+   * corresponds:
+   *
+   * - DASH representations: Always -1.
+   * - HLS variants: The `AVERAGE-BANDWIDTH` attribute defined on the corresponding
+   *   `EXT-X-STREAM-INF` tag in the multivariant playlist, or -1 if not present.
+   * - SmoothStreaming track elements: The `Bitrate` attribute defined on the
+   *   corresponding `TrackElement` in the manifest, or -1 if not present.
+   * - Progressive container formats: Often -1, but may be populated with
+   *   the average bitrate of the container if known.
+   */
+  averageBitrate?: number;
+  /**
+   * The peak bitrate in bits per second, or -1 if unknown or not applicable. The way
+   * in which this field is populated depends on the type of media to which the format corresponds:
+   *
+   *  - DASH representations: The `@bandwidth` attribute of the corresponding
+   *    `Representation` element in the manifest.
+   *  - HLS variants: The `BANDWIDTH` attribute defined on the corresponding
+   *    `EXT-X-STREAM-INF` tag.
+   *  - SmoothStreaming track elements: Always -1.
+   *  - Progressive container formats: Often -1, but may be populated with
+   *    the peak bitrate of the container if known.
+   */
+  peakBitrate?: number;
+  /**
+   * The codec of the media quality.
+   */
+  codec?: string;
+}