@theoplayer/extended 3.6.0 → 4.0.0

package/THEOplayer.d.ts

@@ -2,7 +2,7 @@
  * THEOplayer
  * https://www.theoplayer.com
  *
- * Version: 2022.3.0 (3.6.0)
+ * Version: 2022.3.2 (4.0.0)
  */
 
 /**
@@ -41,6 +41,15 @@ export declare interface ABRConfiguration {
      * @defaultValue `30`
      */
     bufferLookbackWindow?: number;
+    /**
+     * The maximum length of the player's buffer, in seconds.
+     *
+     * The player will initially buffer up to {@link ABRConfiguration.targetBuffer} seconds of media data.
+     * If the player detects that the decoder is unable to hold so much data,
+     * it will reduce `maxBufferLength` and restrict `targetBuffer` to be less than
+     * this maximum.
+     */
+    readonly maxBufferLength: number;
 }
 
 /**
@@ -435,6 +444,13 @@ export declare interface Ads extends EventDispatcher<AdsEventMap> {
      * @deprecated Superseded by {@link Ads.scheduledAdBreaks}.
      */
     readonly scheduledAds: Ad[];
+    /**
+     * The Google DAI API.
+     *
+     * @remarks
+     * <br/> - Only available with the feature `'google-dai'`.
+     */
+    readonly dai?: GoogleDAI;
     /**
      * Add an ad break request.
      *
@@ -3164,13 +3180,6 @@ export declare interface DRMConfiguration {
     preferredKeySystems?: Array<KeySystemId | string>;
 }
 
-/**
- * A function which processes DRM data.
- *
- * @public
- */
-export declare type DRMProcessor = (arrayBuffer: ArrayBuffer) => ArrayBuffer;
-
 /**
  * Describes the configuration of the DRM Today DRM integration.
  *
@@ -3909,6 +3918,33 @@ export declare interface GlobalChromecast {
     endSession(): void;
 }
 
+/**
+ * The Google DAI API.
+ *
+ * @remarks
+ * <br/> - Available since v3.7.0.
+ *
+ * @public
+ */
+export declare interface GoogleDAI {
+    /**
+     * Returns the content time without ads for a given stream time. Returns the given stream time for live streams.
+     *
+     * @param time - The stream time with inserted ads (in seconds).
+     */
+    contentTimeForStreamTime(time: number): number;
+    /**
+     * Returns the stream time with ads for a given content time. Returns the given content time for live streams.
+     *
+     * @param time - The content time without any ads (in seconds).
+     */
+    streamTimeForContentTime(time: number): number;
+    /**
+     * Whether snapback is enabled. When enabled and the user seeks over multiple ad breaks, the last ad break that was seeked past will be played.
+     */
+    snapback: boolean;
+}
+
 /**
  * Represents a configuration for server-side ad insertion with the Google DAI pre-integration.
  *
@@ -4367,7 +4403,7 @@ export declare interface HistogramTrackLabeledMetric extends Metric {
 export declare type HlsDiscontinuityAlignment = 'auto' | 'playlist' | 'media';
 
 /**
- * Represents a configuration for controlling playback of an MPEG-DASH stream.
+ * Represents a configuration for controlling playback of an HLS stream.
  *
  * @remarks
  * <br/> - Available since v2.82.0.
@@ -4381,6 +4417,19 @@ export declare interface HlsPlaybackConfiguration {
      * @defaultValue `'auto'`
      */
     discontinuityAlignment?: HlsDiscontinuityAlignment;
+    /**
+     * Whether this source should be played using the legacy HLS pipeline.
+     *
+     * <br/> - If set to `true`, always use the legacy HLS pipeline.
+     * <br/> - If set to `false`, never use the legacy HLS pipeline.
+     * <br/> - If set to `undefined` (default), use the modern HLS pipeline if available, otherwise fall back to the legacy HLS pipeline.
+     *
+     * @defaultValue `undefined`
+     *
+     * @remarks
+     * <br/> - Available since v4.0.0.
+     */
+    useLegacy?: boolean;
 }
 
 /**
@@ -5377,30 +5426,6 @@ export declare interface KeySystemConfiguration {
      * The certificate for the key system. This can be either an ArrayBuffer or Uint8Array containing the raw certificate bytes or a base64-encoded variant of this.
      */
     certificate?: BufferSource_2 | string;
-    /**
-     * Process the certificate's request.
-     *
-     * @deprecated Please use {@link registerContentProtectionIntegration} and {@link ContentProtectionIntegration.onCertificateRequest} instead.
-     */
-    certificateRequestProcessor?: DRMProcessor;
-    /**
-     * Process the certificate's response.
-     *
-     * @deprecated Please use {@link registerContentProtectionIntegration} and {@link ContentProtectionIntegration.onCertificateResponse} instead.
-     */
-    certificateResponseProcessor?: DRMProcessor;
-    /**
-     * Process the license's request.
-     *
-     * @deprecated Please use {@link registerContentProtectionIntegration} and {@link ContentProtectionIntegration.onLicenseRequest} instead.
-     */
-    licenseRequestProcessor?: DRMProcessor;
-    /**
-     * Process the license's response.
-     *
-     * @deprecated Please use {@link registerContentProtectionIntegration} and {@link ContentProtectionIntegration.onLicenseResponse} instead.
-     */
-    licenseResponseProcessor?: DRMProcessor;
 }
 
 /**