@castlabs/prestoplay 6.31.0 → 6.32.0-beta.2

package/typings.d.ts

@@ -201,7 +201,7 @@ export namespace clpp {
      * The default bandwidth estimate to use if there is not enough data, in
      * bit/sec. This value is used for initial video track selection when there
      * is no bandwidth estimation from previous playbacks. If the player instance
-     * is destroyed, any new load() call will use this value. Otherwise
+     * is destroyed, any new open() call will use this value. Otherwise
      * bandwidth estimation from current playback is transferred to the next
      * playback.
      */
@@ -662,11 +662,16 @@ export namespace clpp {
      * Body of the message.
      */
     messageData: Uint8Array;
+    /**
+     * The absolute event presentation time (in units of timescale).
+     * Available for EMSG v1.
+     */
+    presentationTime?: number;
     /**
      * The offset that the event starts, relative to the start of the segment
-     * this is contained in (in units of timescale).
+     * this is contained in (in units of timescale). Available for EMSG v0.
      */
-    presentationTimeDelta: number;
+    presentationTimeDelta?: number;
     /**
      * Identifies the message scheme.
      */
@@ -683,6 +688,10 @@ export namespace clpp {
      * Specifies the value for the event.
      */
     value: string;
+    /**
+     * Version of the EMSG box (0 or 1).
+     */
+    version: number;
   }
   
   /**
@@ -1151,6 +1160,31 @@ export namespace clpp {
     debug?: boolean;
   }
   
+  /**
+   * Configuration section for NPAW analytics. In addition to the listed
+   * options, all options defined by NPAW are available and will be
+   * passed over to the NPAW SDK. Minimum configuration must include at least
+   * `accountCode`. Please remember to include the NPAW SDK in order to use NPAW
+   * analytics. For more information please visit the
+   * {@link https://documentation.npaw.com/integration-docs/docs/setting-options-and-metadata|NPAW Developer Site}.
+   */
+  export type NpawConfiguration = {
+    /**
+     * Obligatory account code for NPAW analytics.
+     */
+    accountCode: string;
+    /**
+     * This label is used to identify disabled subtitles.
+     * Default is "off".
+     */
+    disabledSubtitlesLabel?: string;
+    /**
+     * A custom function that converts a {@link clpp.Error} to a payload for
+     * NPAW. If it returns `null`, the error will not be sent.
+     */
+    errorFilter?: clpp.YouboraErrorFilter;
+  }
+  
   /**
    * The DRMtoday Onboard configuration.
    */
@@ -1335,10 +1369,10 @@ export namespace clpp {
      * 
      * Some native players, such as the Safari native player, respond with a
      * loadedmetadata event before the track model is initialized. This causes
-     * the 'Player.load()' method to resolve before the tracks are fully
+     * the 'Player.open()' method to resolve before the tracks are fully
      * available. This can be acceptable, for instance if the track model is
      * queried dynamically or of the Application listens for track change events.
-     * However, if the load promise should wait until data is loaded and the
+     * However, if the open promise should wait until data is loaded and the
      * tracks are initialized, this flag can be set to true. Note though, if
      * preload is set and for instance configured to only load metadata, the
      * load promise will only resolve once actual media data are loaded.
@@ -1402,6 +1436,10 @@ export namespace clpp {
      * Mux Data Analytics configuration.
      */
     muxdata?: Partial<clpp.MuxDataConfiguration>;
+    /**
+     * NPAW analytics plugin configuration.
+     */
+    npaw?: Partial<clpp.NpawConfiguration>;
     /**
      * Defaults to false. 
      * 
@@ -1567,7 +1605,7 @@ export namespace clpp {
      */
     yospace?: Partial<clpp.YospaceConfiguration>;
     /**
-     * Youbora plugin configuration.
+     * Use `npaw` instead. Youbora v6 plugin configuration.
      */
     youbora?: Partial<clpp.YouboraConfiguration>;
   }
@@ -1723,6 +1761,19 @@ export namespace clpp {
     step: number;
   }
   
+  /**
+   * Cast receiver configuration.
+   */
+  export type ReceiverConfiguration = {
+    /**
+     * If true, Shaka player is used for HLS.
+     * If false, MPL player is used for HLS.
+     * If undefined the default is selected by Chromecast Receiver SDK, for more information see
+     * {@link https://developers.google.com/cast/docs/reference/web_receiver/cast.framework.CastReceiverOptions#useShakaForHls|cast.framework.CastReceiverOptions#useShakaForHls}.
+     */
+    useShakaForHls?: boolean;
+  }
+  
   /**
    * Definition of track that can be loaded remotely.
    */
@@ -2033,7 +2084,7 @@ export namespace clpp {
   /**
    * Contains statistics and information about the current state of the player.
    * This is meant for applications that want to log quality-of-experience (QoE)
-   * or other stats.  These values will reset when load() is called again.
+   * or other stats.  These values will reset when open() is called again.
    */
   export type Stats = {
     /**
@@ -2065,7 +2116,7 @@ export namespace clpp {
     height: number;
     /**
      * This is the number of seconds it took for the video element to have enough
-     * data to begin playback.  This is measured from the time load() is called to
+     * data to begin playback. This is measured from the time open() is called to
      * the time the 'loadeddata' event is fired by the media element.
      */
     loadLatency: number;
@@ -3071,10 +3122,6 @@ export namespace clpp {
      * Youbora. If it returns `null`, the error will not be sent.
      */
     errorFilter?: clpp.YouboraErrorFilter;
-    /**
-     * Enable integration for NPAW Plugin SDK v7
-     */
-    v7?: boolean;
   }
   
   /**
@@ -3247,7 +3294,7 @@ export namespace clpp {
      * is changed. It is triggered when a video track is selected to be downloaded
      * and appended to the buffer either manually or via the ABR algorithm. If you
      * are interested in the currently playing rendition, the one that is on screen,
-     * listen to the {@link clpp.events#CLPP_BITRATE_CHANGED|CLPP_BITRATE_CHANGED}
+     * listen to the {@link clpp.events.BITRATE_CHANGED}
      * event instead.
      */
     VIDEO_TRACK_CHANGED = "videotrackchanged",
@@ -3310,7 +3357,7 @@ export namespace clpp {
      */
     DRM_RENEWAL_STARTED = "drmrenewalstarted",
     /**
-     * Triggered when the DRM license expiration time is updated.
+     * Triggered when the DRM session expiration time is updated.
      */
     DRM_EXPIRATION_UPDATE = "drmexpirationupdate",
     /**
@@ -3580,7 +3627,7 @@ export namespace clpp {
    * 
    * // The player now has the capability to play HLS and DASH content.
    * const player = new clpp.Player(...);
-   * player.load(...);
+   * player.open(...);
    */
   function install(component: Function): void;
   /**
@@ -3603,7 +3650,7 @@ export namespace clpp {
    * 
    * // player2 no longer has the capability to play HLS content.
    * const player2 = new clpp.Player(...);
-   * player2.load(...);
+   * player2.open(...);
    */
   function uninstall(component: Function): void;
   /**
@@ -3753,7 +3800,7 @@ export namespace clpp {
     destroy(): Promise<void>;
     /**
      * Returns the ads manager or null if not available.
-     * The ads manager is available when {@link clpp.Player.load} is resolved.
+     * The ads manager is available when {@link clpp.Player.open} is resolved.
      */
     getAdsManager(): clpp.ads.IAdsManager|null;
     /**
@@ -3774,6 +3821,10 @@ export namespace clpp {
      * Returns the player configuration.
      */
     getConfiguration(): clpp.PlayerConfiguration;
+    /**
+     * Returns source loaded by player.
+     */
+    getCurrentSource(): clpp.Source|null;
     /**
      * Returns DRM info for the currently loaded source.
      */
@@ -3790,9 +3841,6 @@ export namespace clpp {
      * Get the network engine instance.
      */
     getNetworkEngine(): clpp.net.NetworkEngine;
-    /**
-     * Get speed of the playback, where 1 means "normal" speed.
-     */
     getPlaybackRate(): number;
     /**
      * Access registered player plugins.
@@ -3819,6 +3867,10 @@ export namespace clpp {
      * information can be found on {@link https://en.wikipedia.org/wiki/Unix_time | Unix time - Wikipedia}.
      */
     getPresentationStartTime(): number|null;
+    /**
+     * Get speed of the playback, where 1 means "normal" speed.
+     */
+    getRate(): number;
     /**
      * Gets the time range (in seconds) where it is allowed to seek.
      * If the player has not loaded content, this will return a range from 0 to 0.
@@ -3880,60 +3932,12 @@ export namespace clpp {
      * Returns true if playback is paused, false otherwise.
      */
     isPaused(): boolean;
+    /**
+     * Returns true if the current content being displayed is an ad.
+     */
+    isPlayingAd(): boolean;
     /**
      * Tell the player to load given content.
-     * You may load content by passing a `string`, a {@link clpp.Source}, an array
-     * of sources or player configuration. In case of player configuration it
-     * must not contain the `license` attribute.
-     * If multiple sources are passed to the `load` method, the player will play
-     * the first source which is playable on that platform. Please refer to
-     * the examples below for more details.
-     * If the player is already playing another source, it will release itself
-     * first before loading the new source.
-     *
-     * @example // Passing a string
-     *
-     * player.load('http://example.com/manifest.mpd');
-     *
-     * @example // Passing a clpp.Source object
-     *
-     * player.load({
-     *   url: 'http://example.com/manifest.mpd',
-     *   type: clpp.Type.DASH
-     * });
-     *
-     * @example // Passing an array
-     *
-     * player.load([
-     *   // By passing an array, player will load first content that it is able
-     *   // to load on given platform (i.e. we cannot load protected DASH on
-     *   // Safari). You can mix strings and clpp.Source objects here.
-     *   {
-     *     url: 'http://example.com/manifest.mpd',
-     *     type: clpp.Type.DASH,
-     *     drmProtected: true
-     *   },
-     *   {
-     *     url: 'http://example.com/manifest.m3u8',
-     *     type: clpp.Type.HLS,
-     *     drmProtected: true
-     *   },
-     *   'http://example.com/other.mp4'
-     * ]);
-     *
-     * @example // Passing configuration
-     *
-     * player.load({
-     *   // under source prop you may pass your manifest URL in all possible ways
-     *   // as before: string, clpp.Source object or array of strings /
-     *   // clpp.Source objects.
-     *   source: 'http://example.com/manifest.mpd',
-     * 
-     *   // Other configuration options. Passing them allows to extend/modify
-     *   // initial configuration passed during player's initialization.
-     *   startTime: 4,
-     *   preferredTextLanguage: 'en'
-     * });
      */
     load(configuration: string|clpp.Source|Array<(string|clpp.Source)>|clpp.PlayerConfiguration): Promise<void>;
     /**
@@ -3958,7 +3962,7 @@ export namespace clpp {
      * Optionally, scope can be passed in, in which case the callback function
      * will be bound/executed in the given scope.
      * This method returns a reference to the callback for
-     * convenient removal of the listener via {@link clpp.Player.off}.
+     * convenient removal of the listener via {@link clpp.Player#off|player.off()}.
      *
      * @param name The event name
      * @param callback The callback function
@@ -3986,7 +3990,7 @@ export namespace clpp {
     /**
      * Adds a one time event listener for the given event.
      * The listener will be removed once the event was triggered.
-     * Otherwise at works the same as {@link clpp.Player.on}.
+     * Otherwise it works the same as {@link clpp.Player#on|player.on()}.
      *
      * @param name The event name
      * @param callback The callback function
@@ -3999,6 +4003,62 @@ export namespace clpp {
      *   });
      */
     one(name: string, callback: clpp.EventCallback, opt_callbackScope?: Record<string, any>): clpp.EventCallback;
+    /**
+     * Load a stream.
+     * You may load content by passing a `string`, a {@link clpp.Source}, an array
+     * of sources or player configuration. In case of player configuration it
+     * must not contain the `license` attribute.
+     * If multiple sources are passed to the `open` method, the player will play
+     * the first source which is playable on that platform. Please refer to
+     * the examples below for more details.
+     * If the player is already playing another source, it will release itself
+     * first before loading the new source.
+     *
+     * @example // Passing a string
+     *
+     * player.open('http://example.com/manifest.mpd');
+     *
+     * @example // Passing a clpp.Source object
+     *
+     * player.open({
+     *   url: 'http://example.com/manifest.mpd',
+     *   type: clpp.Type.DASH
+     * });
+     *
+     * @example // Passing an array
+     *
+     * player.open([
+     *   // By passing an array, player will load first content that it is able
+     *   // to load on given platform (i.e. we cannot load protected DASH on
+     *   // Safari). You can mix strings and clpp.Source objects here.
+     *   {
+     *     url: 'http://example.com/manifest.mpd',
+     *     type: clpp.Type.DASH,
+     *     drmProtected: true
+     *   },
+     *   {
+     *     url: 'http://example.com/manifest.m3u8',
+     *     type: clpp.Type.HLS,
+     *     drmProtected: true
+     *   },
+     *   'http://example.com/other.mp4'
+     * ]);
+     *
+     * @example // Passing configuration
+     *
+     * player.open({
+     *   // under source prop you may pass your manifest URL in all possible ways
+     *   // as before: string, clpp.Source object or array of strings /
+     *   // clpp.Source objects.
+     *   source: 'http://example.com/manifest.mpd',
+     * 
+     *   // Other configuration options. Passing them allows to extend/modify
+     *   // initial configuration passed during player's initialization.
+     *   startTime: 4,
+     *   preferredTextLanguage: 'en'
+     * });
+     */
+    open(configuration: string|clpp.Source|Array<(string|clpp.Source)>|clpp.PlayerConfiguration): Promise<void>;
     /**
      * Pauses playback.
      */
@@ -4023,18 +4083,25 @@ export namespace clpp {
      */
     release(): Promise<void>;
     /**
+     * Removes a specified component from the player.
+     * Please note that this operation will only run if the player has been
+     * released or is in IDLE state.
+     * Note that this method may not work correctly in combination with multiple
+     * instances of {@link clpp.Player}. For that scenario please use
+     * {@link clpp.uninstall} instead.
+     *
      * @param component Component constructor
      *
      * @example 
      *
      * const player = new clpp.Player(...);
      * player.use(clpp.smooth.SmoothComponent);
-     * player.load('https://example.com/smooth/Manifest');
+     * player.open('https://example.com/smooth/Manifest');
      * ...
      * player.release().then(function () {
      *   player.remove(clpp.smooth.SmoothComponent);
      *   player.use(clpp.dash.DashComponent);
-     *   player.load('https://example/dash/manifest.mpd');
+     *   player.open('https://example/dash/manifest.mpd');
      * });
      */
     remove(component: Function): boolean;
@@ -4107,6 +4174,19 @@ export namespace clpp {
      * @param engine The network engine
      */
     setNetworkEngine(engine: clpp.net.NetworkEngine): void;
+    /**
+     * @param rate The rate
+     * @param opt_mode The speedUpMode
+     *   to use during trick play
+     */
+    setPlaybackRate(rate: number, opt_mode?: clpp.SpeedUpMode): void;
+    /**
+     * Set player position in seconds.
+     * To get seekable range, call {@link clpp.Player#getSeekRange}.
+     *
+     * @param time The time in seconds to seek to.
+     */
+    setPosition(time: number): Promise<void>;
     /**
      * Set speed of the playback, where 1 means "normal" speed.
      * For MSE playback, optional `speedUpMode` can be passed.
@@ -4118,25 +4198,25 @@ export namespace clpp {
      *
      * @example // Play at double speed.
      *
-     *   player.setPlaybackRate(2);
+     *   player.setRate(2);
      *
      * @example // Play at half speed.
      *
-     *   player.setPlaybackRate(0.5);
+     *   player.setRate(0.5);
      *
      * @example // Play at normal speed.
      *
-     *   player.setPlaybackRate(1);
+     *   player.setRate(1);
      *
      * @example // Play at double speed backwards.
      *
-     *   player.setPlaybackRate(-2);
+     *   player.setRate(-2);
      *
      * @example // Play at double speed, using seek mode.
      *
-     *   player.setPlaybackRate(2, 'seek');
+     *   player.setRate(2, 'seek');
      */
-    setPlaybackRate(rate: number, opt_mode?: clpp.SpeedUpMode): void;
+    setRate(rate: number, opt_mode?: clpp.SpeedUpMode): void;
     /**
      * Use this to set the volume of the video as a value between 0 and 1. Please
      * note that on some platforms setting the volume is not permitted. For
@@ -4151,6 +4231,16 @@ export namespace clpp {
      */
     setVolume(volume: number): void;
     /**
+     * Stop the player.
+     */
+    stop(): Promise<void>;
+    /**
+     * Registers specified component to player in order to extend its
+     * capabilities.
+     * Note that this method may not work correctly in combination with multiple
+     * instances of {@link clpp.Player}. For that scenario please use
+     * {@link clpp.install} instead.
+     *
      * @param component component constructor.
      *
      * @example 
@@ -4278,7 +4368,7 @@ export namespace clpp {
      * Optionally, scope can be passed in, in which case the callback function
      * will be bound/executed in the given scope.
      * This method returns a reference to the callback for
-     * convenient removal of the listener via {@link clpp.Playlist.off}.
+     * convenient removal of the listener via {@link clpp.Playlist#off|playlist.off()}.
      *
      * @param name The event name
      * @param callback The callback function
@@ -4309,7 +4399,7 @@ export namespace clpp {
     /**
      * Adds a one time event listener for the given event.
      * The listener will be removed once the event was triggered.
-     * Otherwise at works the same as {@link clpp.Player.on}.
+     * Otherwise it works the same as {@link clpp.Playlist#on|playlist.on()}.
      *
      * @param name The event name
      * @param callback The callback function
@@ -4471,13 +4561,19 @@ export namespace clpp {
   
   export class TrackManager {
     /**
-     * @param track sideload track to load.
+     * Side-loads an external text track from a remote URL.
+     * Loads a text track from a URL and makes it available for selection
+     * alongside any tracks embedded in the manifest. The returned
+     * promise resolves once the track has been successfully added.
+     *
+     * @param track The remote text track descriptor to
+     *   load.
      */
     addTextTrack(track: clpp.RemoteTextTrack): Promise<void>;
     /**
-     * True if this platform supports selection of video tracks.
-     * If false, any attempts to select video tracks or renditions
-     * will be ignored.
+     * Returns whether this platform supports manual video track selection.
+     * When false, any calls to {@link clpp.TrackManager#setVideoTrack|setVideoTrack()}
+     * or {@link clpp.TrackManager#setVideoRendition|setVideoRendition()} will have no effect.
      */
     canSelectVideoTracks(): boolean;
     /**
@@ -4486,7 +4582,13 @@ export namespace clpp {
      */
     findAudioRendition(filter: Record<string, any>): clpp.Rendition|undefined;
     /**
-     * @param filter filter object containing desired track properties.
+     * Searches the audio tracks for the first one matching the filter.
+     * Returns the audio track whose properties match all key-value pairs in
+     * the filter object. Useful for selecting a track by language, codec,
+     * or any other {@link clpp.Track} property.
+     *
+     * @param filter An object whose keys and values must all match
+     *   the corresponding properties of the returned track.
      */
     findAudioTrack(filter: Record<string, any>): clpp.Track|undefined;
     /**
@@ -4495,30 +4597,102 @@ export namespace clpp {
      */
     findTextRendition(filter: Record<string, any>): clpp.Rendition|undefined;
     /**
-     * @param filter filter object containing desired track properties.
+     * Searches the text tracks for the first one matching the filter.
+     * Returns a text track whose properties match all key-value pairs in
+     * the filter object. Useful for selecting a track by language, kind,
+     * or any other {@link clpp.Track} property.
+     *
+     * @param filter An object whose keys and values must all match
+     *   the corresponding properties of the returned track.
      */
     findTextTrack(filter: Record<string, any>): clpp.Track|undefined;
     /**
-     * @param filter filter object containing desired rendition
-     *   properties.
+     * Searches across all video renditions for the first one matching the filter.
+     * Returns the video rendition whose properties match all key-value
+     * pairs in the filter object. Useful for finding a rendition by bitrate,
+     * resolution, or codec.
+     *
+     * @param filter An object whose keys and values must all match
+     *   the corresponding properties of the returned rendition.
      */
     findVideoRendition(filter: Record<string, any>): clpp.Rendition|undefined;
     /**
-     * @param filter filter object containing desired track properties.
+     * Searches video tracks for the first one matching the filter.
+     * Returns the video track whose properties match all key-value pairs in
+     * the filter object. Useful for selecting a track by codec, or any
+     * other {@link clpp.Track} property.
+     *
+     * @param filter An object whose keys and values must all match
+     *   the corresponding properties of the returned track.
      */
     findVideoTrack(filter: Record<string, any>): clpp.Track|undefined;
+    /**
+     * Returns the audio rendition that is currently being played.
+     * Each audio track typically contains exactly one audio rendition.
+     */
     getAudioRendition(): clpp.Rendition|null;
+    /**
+     * Returns the currently selected audio track.
+     */
     getAudioTrack(): clpp.Track|null;
+    /**
+     * Returns all audio tracks available for the currently loaded content.
+     * Tracks typically represent different languages or audio descriptions.
+     */
     getAudioTracks(): Array<clpp.Track>;
+    /**
+     * Returns the audio rendition that has been selected but not yet fully switched to.
+     * When player switches to the selected rendition this returns `null`.
+     */
     getLoadingAudioRendition(): clpp.Rendition|null;
+    /**
+     * Returns the text rendition that has been selected but not yet fully switched to.
+     * When player switches to the selected rendition this returns `null`.
+     */
     getLoadingTextRendition(): clpp.Rendition|null;
+    /**
+     * Returns the video rendition that has been selected but not yet fully switched to.
+     * When player switches to the selected rendition this returns `null`.
+     */
     getLoadingVideoRendition(): clpp.Rendition|null;
+    /**
+     * Returns the text rendition that is currently being displayed.
+     * When no text rendition is selected it returns `null`.
+     */
     getTextRendition(): clpp.Rendition|null;
+    /**
+     * Returns the currently selected text track.
+     * If no text track is selected this returns `null`.
+     */
     getTextTrack(): clpp.Track|null;
+    /**
+     * Returns all text tracks available for the currently loaded content.
+     * Text tracks can be subtitles or closed captions, typically they represent
+     * different languages.
+     */
     getTextTracks(): Array<clpp.Track>;
+    /**
+     * Returns the video rendition that is currently being played.
+     */
     getVideoRendition(): clpp.Rendition|null;
+    /**
+     * Returns the currently selected video track.
+     */
     getVideoTrack(): clpp.Track|null;
+    /**
+     * Returns all video tracks available for the currently loaded content.
+     * Each track may contain multiple {@link clpp.Rendition} objects representing
+     * different quality levels.
+     */
     getVideoTracks(): Array<clpp.Track>;
+    /**
+     * Returns whether Adaptive Bitrate (ABR) selection is currently active.
+     * When enabled, the player automatically picks the optimal rendition based
+     * on available bandwidth and buffer health. When disabled, the rendition
+     * locked via {@link clpp.TrackManager#setVideoRendition|setVideoRendition()}
+     * or {@link clpp.TrackManager#setAudioRendition|setAudioRendition()} is used.
+     * By default ABR is enabled.
+     */
     isAbrEnabled(): boolean;
     /**
      * @param rendition The rendition
@@ -4526,7 +4700,11 @@ export namespace clpp {
      */
     setAudioRendition(rendition: clpp.Rendition|null, clearBuffer?: boolean): void;
     /**
-     * @param track The track
+     * Selects the given audio track as the active track.
+     * Call this for example to switch to a different audio language. Pass `null`
+     * to let the player choose automatically.
+     *
+     * @param track The audio track to activate, or null.
      */
     setAudioTrack(track: clpp.Track|null): void;
     /**
@@ -4535,16 +4713,30 @@ export namespace clpp {
      */
     setTextRendition(rendition: clpp.Rendition|null, clearBuffer?: boolean): void;
     /**
-     * @param track The track
+     * Selects the given text track as the active track, enabling subtitles or captions.
+     * Pass `null` to disable text track rendering.
+     *
+     * @param track The text track to activate, or null to disable.
      */
     setTextTrack(track: clpp.Track|null): void;
     /**
-     * @param rendition The rendition
-     * @param clearBuffer clear buffer
+     * Locks playback to a specific video rendition (quality level), bypassing ABR.
+     * Pass `null` to re-enable automatic ABR selection.
+     * When clearBuffer is true, the current buffer is flushed to apply the switch
+     * immediately. Otherwise, already buffered video stays at the quality it was
+     * buffered at and only newly buffered media has the newly selected quality level.
+     *
+     * @param rendition The video rendition to lock to, or null
+     *   to re-enable ABR.
+     * @param clearBuffer Whether to flush the buffer on switch.
      */
     setVideoRendition(rendition: clpp.Rendition|null, clearBuffer?: boolean): void;
     /**
-     * @param track The track
+     * Selects the given video track as the active track.
+     * Pass `null` to let the player choose automatically. Has no effect if
+     * {@link clpp.TrackManager#canSelectVideoTracks | canSelectVideoTracks()} returns false.
+     *
+     * @param track The video track to activate, or null.
      */
     setVideoTrack(track: clpp.Track|null): void;
   }
@@ -4838,7 +5030,7 @@ export namespace clpp {
        * or MIME type. To fix, try one of the following:
        * 
        *   Set an explicit type in the {@link clpp.Source} when calling
-       *       {@link clpp.Player#load}.
+       *       {@link clpp.Player#open}.
        *   Rename the manifest so that the URI ends in a well-known extension.
        *   Configure the server to send a recognizable Content-Type header.
        *   Configure the server to accept a HEAD request for the manifest.
@@ -5255,8 +5447,8 @@ export namespace clpp {
        */
       INVALID_SESSION_STORAGE_IMPLEMENTATION = 6202,
       /**
-       * The call to Player.load() was interrupted by a call to Player.release()
-       * or another call to Player.load().
+       * The call to Player.open() was interrupted by a call to Player.release()
+       * or another call to Player.open().
        */
       LOAD_INTERRUPTED = 7000,
       /**
@@ -5880,7 +6072,7 @@ export namespace clpp {
        * Start casting.
        * If the player has some loaded content, it will be casted. Otherwise,
        * the casting session will start empty and wait for a call to
-       * {@link clpp.Player#load}.
+       * {@link clpp.Player#open}.
        *
        * @param opt_playerConfig optional
        *   configuration to cast. If omitted, player will try to cast current
@@ -5960,7 +6152,7 @@ export namespace clpp {
        * Set Cast content metadata to one of the `chrome.cast.media.*Metadata`
        * objects (See {@link https://developers.google.com/cast/docs/reference/web_sender/chrome.cast.media#.MetadataType}),
        * or clear it by passing `null`.
-       * Note: You must set content metadata before calling cast/load, otherwise
+       * Note: You must set content metadata before calling cast/open, otherwise
        * it will have no effect. Correctly setting metadata is crucial for some
        * functionalities, especially for live streams, to work correctly.
        *
@@ -6155,8 +6347,10 @@ export namespace clpp {
       setQueue(queue: any): void;
       /**
        * Starts listening to commands coming in from the sender.
+       *
+       * @param configuration configuration
        */
-      start(): void;
+      start(configuration?: clpp.ReceiverConfiguration): void;
       /**
        * Shuts down the Cast Receiver.
        * Stops listening to cast session requests and releases resources.
@@ -6303,6 +6497,12 @@ export namespace clpp {
     }
   }
   
+  namespace cdn {
+    export class CdnChallengeComponent {
+      
+    }
+  }
+  
   namespace contentSteering {
     /**
      * Represents a Content Steering Location.
@@ -6570,7 +6770,21 @@ export namespace clpp {
     }
     
     export class DrmToday {
-      
+      /**
+       * Registers a custom DRMtoday environment with an arbitrary base URL.
+       * Uses the same license request/response modifiers as standard DRMtoday
+       * environments, so auth tokens, session tokens, and CSL all work
+       * identically. This is useful for local testing against a DRMtoday
+       * instance running on a custom host/port.
+       *
+       * @param name The environment name, e.g. 'DRMtoday_LOCAL'
+       * @param baseUrl The base URL, e.g. 'http://localhost:8090/v4/orgId/'
+       * @param opt_urls Optional per-key-system URL
+       *   overrides (keys: widevineUrl, playreadyUrl, fairplayUrl). Relative
+       *   paths are resolved against baseUrl; absolute URLs are used as-is.
+       *   Defaults to the standard DRMtoday suffixes.
+       */
+      static registerCustom(name: string, baseUrl: string, opt_urls?: Record<string, string>): void;
     }
     
     export class HeaderDrm {
@@ -7911,7 +8125,7 @@ export namespace clpp {
        * });
        * const player = new clpp.Player('video', {
        *   license: '...',
-       *   youbora: {
+       *   npaw: {
        *     accountCode: 'account_code',
        *   },
        * });
@@ -7919,7 +8133,7 @@ export namespace clpp {
        * player.getPlugin(clpp.npaw.NpawPlugin.Id).setNpawPlugin(plugin);
        * 
        * // Now you can start playback.
-       * player.load('http://example.com/Manifest.mpd');
+       * player.open('http://example.com/Manifest.mpd');
        */
       setNpawPlugin(plugin: NpawPlugin|null): void;
     }
@@ -7967,7 +8181,7 @@ export namespace clpp {
        * player.getPlugin(clpp.npaw.YouboraPlugin.Id).setYouboraPlugin(plugin);
        * 
        * // Now you can start playback.
-       * player.load('http://example.com/Manifest.mpd');
+       * player.open('http://example.com/Manifest.mpd');
        */
       setYouboraPlugin(plugin: any|null): void;
     }
@@ -7989,7 +8203,7 @@ export namespace clpp {
      * let player = new clpp.Player(...);
      * 
      * // Acquire license
-     * player.load({
+     * player.open({
      *   source: 'https://demo.castlabs.com/media/onboard-test/Manifest.mpd',
      *   drm: {
      *     env: 'DRMtodayOnboard'
@@ -8210,7 +8424,7 @@ export namespace clpp {
      * {@link clpp.Player} so all methods defined there can also be called on
      * the playlist instance (e.g. {@link clpp.Player#on|on()},
      * {@link clpp.Player#off|off()}, {@link clpp.Player#getPosition|getPosition()},
-     * {@link clpp.Player#seek|seek()}, etc).
+     * {@link clpp.Player#setPosition|setPosition()}, etc).
      * Limitations: Plugins are disabled and the method. Encryption
      * is supported only if all the items are encrypted with the same method
      * and key.
@@ -8222,7 +8436,7 @@ export namespace clpp {
        * {@link clpp.Player} so all methods defined there can also be called on
        * the playlist instance (e.g. {@link clpp.Player#on|on()},
        * {@link clpp.Player#off|off()}, {@link clpp.Player#getPosition|getPosition()},
-       * {@link clpp.Player#seek|seek()}, etc).
+       * {@link clpp.Player#setPosition|setPosition()}, etc).
        * Limitations: Plugins are disabled and the method. Encryption
        * is supported only if all the items are encrypted with the same method
        * and key.
@@ -8237,7 +8451,7 @@ export namespace clpp {
       /**
        * Append an item to the end of the playlist.
        * This method cannot be called before
-       * {@link clpp.playlist.ScPlaylist#open|open()}.
+       * {@link clpp.playlist.ScPlaylist#openPlaylist|openPlaylist()}.
        *
        * @param config an item which must contain
        *   at least an `id` and a `source`.
@@ -8316,7 +8530,7 @@ export namespace clpp {
        *
        * @example // Open a playlist of two items, start from the position of 2 minutes and automatically start playback.
        *
-       * await playlist.open(0, [
+       * await playlist.openPlaylist(0, [
        *   {
        *     id: 'ASSET1',
        *     source: { url: '...' },
@@ -8331,7 +8545,7 @@ export namespace clpp {
        *   }
        * ]);
        */
-      open(index: number, configs: Array<clpp.PlayerConfiguration>): Promise<void>;
+      openPlaylist(index: number, configs: Array<clpp.PlayerConfiguration>): Promise<void>;
       /**
        * Release the playlist instance resources.
        * The playlist can load another source after it was released.