@theoplayer/extended 2.89.1 → 2.91.1

package/THEOplayer.d.ts

@@ -2,7 +2,7 @@
  * THEOplayer
  * https://www.theoplayer.com
  *
- * Version: 2021.3.2 (2.89.1)
+ * Version: 2021.4.1 (2.91.1)
  */
 
 /**
@@ -1655,8 +1655,14 @@ export declare interface Chromecast extends VendorCast, EventDispatcher<Chromeca
     receiverName: string | undefined;
     /**
      * The source of the active casting session, if any.
+     *
+     * @deprecated Superseded by {@link Chromecast.connectionCallback}.
      */
     source: SourceDescription | undefined;
+    /**
+     * The callback for the Chromecast connection changes.
+     */
+    connectionCallback: ChromecastConnectionCallback | undefined;
     /**
      * Join an active casting session.
      */
@@ -1693,6 +1699,58 @@ export declare interface ChromecastConfiguration {
     appID?: string;
 }
 
+/**
+ * The ChromecastConnectionCallback.
+ *
+ * @public
+ */
+export declare interface ChromecastConnectionCallback {
+    /**
+     * Called after the player has started the connection to the receiver.
+     *
+     * @remarks
+     * <br/> - At this point we are trying to load the media from the sender to the receiver.
+     * <br/> - Returning null will behave same as returning the provided SourceDescription.
+     *
+     * @param sourceDescription - The current SourceDescription on the sender device.
+     * @returns The SourceDescription to be loaded on the receiver device.
+     */
+    onStart(sourceDescription: SourceDescription | undefined): SourceDescription | undefined;
+    /**
+     * Called after the player has stopped the connection to the receiver.
+     *
+     * @remarks
+     * <br/> - At this point we are trying to load the media from the receiver to the sender.
+     * <br/> - Returning null will behave same as returning the provided SourceDescription.
+     *
+     * @param sourceDescription - The current SourceDescription on the receiver device.
+     * @returns The SourceDescription to be loaded on the sender device.
+     */
+    onStop(sourceDescription: SourceDescription | undefined): SourceDescription | undefined;
+    /**
+     * Called after the player has joined an already existing connection to the receiver.
+     *
+     * @remarks
+     * <br/> - At this point it's possible to load a new media from the sender to the receiver.
+     * <br/> - Returning null will not change the source on the receiver.
+     *
+     * @param sourceDescription - The current SourceDescription on the current sender device.
+     * @returns The SourceDescription to be loaded on the receiver device.
+     */
+    onJoin(sourceDescription: SourceDescription | undefined): SourceDescription | undefined;
+    /**
+     * Called after the player has left the connection to the receiver.
+     *
+     * @remarks
+     * <br/> - At this point we are trying to load the media from the receiver to the sender.
+     * <br/> - Returning null will behave same as returning the provided SourceDescription.
+     *
+     * @param sourceDescription - The current SourceDescription on the receiver device.
+     * @returns The SourceDescription to be loaded on the sender device.
+     */
+    onLeave(sourceDescription: SourceDescription | undefined): SourceDescription | undefined;
+}
+
 /**
  * An error that occurred while casting or attempting to cast to Chromecast.
  *
@@ -3747,6 +3805,29 @@ export declare interface FreeWheelCue {
     timeOffset: number;
 }
 
+/**
+ * @public
+ */
+declare interface FullscreenOptions_2 {
+    /**
+     * Whether or not to show navigation UI while in fullscreen.
+     *
+     * @remarks
+     * <p>On mobile devices, the platform may want to show a native on-screen navigation UI (such as a back button or home button)
+     * while the player is in fullscreen mode. This setting controls whether or not this should be shown:
+     * <br/> - If set to "show", then the native navigation UI is preferred.
+     * <br/> - If set to "hide", then more screen space for the player is preferred.
+     * <br/> - If set to "auto", then the choice is left to the platform.
+     * <p>By default, the player prefers to hide the on-screen navigation UI, since it already provides its own "exit fullscreen" button
+     * on its control bar.
+     *
+     * @defaultValue `"hide"`
+     * @public
+     */
+    navigationUI?: 'auto' | 'show' | 'hide';
+}
+export { FullscreenOptions_2 as FullscreenOptions }
+
 /**
  * Represents a geographical location.
  *
@@ -8646,6 +8727,13 @@ export declare interface UIConfiguration {
      * Each entry contains a language code with associated {@link UILanguage | language map}.
      */
     languages?: Record<string, UILanguage>;
+    /**
+     * Options to control transitions to fullscreen mode.
+     *
+     * @remarks
+     * <br/> - Available since v2.90.0.
+     */
+    fullscreenOptions?: FullscreenOptions_2;
 }
 
 /**
@@ -10808,6 +10896,15 @@ export declare interface VRConfiguration {
      * @defaultValue `''`
      */
     stereoMode?: VRStereoMode;
+    /**
+     * Whether the source plays using native VR.
+     *
+     * @remarks
+     * <br/> - This property is only available for iOS.
+     *
+     * @defaultValue `false`
+     */
+    nativeVR?: boolean;
 }
 
 /**