senza-sdk 4.3.5 → 4.3.7-b2908c5.0

package/src/interface/remotePlayer.js

@@ -217,6 +217,21 @@ class RemotePlayer extends EventTarget {
         UNLOADING: "unloading"
     });
 
+
+    /**
+     * @typedef {Object} AccessibilityPurposeCode
+     * @property {string} NONE
+     * @property {string} VISUALLY_IMPAIRED
+     * @property {string} HARD_OF_HEARING
+     * @property {string} SPOKEN_SUBTITLES
+     */
+    AccessibilityPurposeCode = {
+        NONE: "",
+        VISUALLY_IMPAIRED: "1",
+        HARD_OF_HEARING: "2",
+        SPOKEN_SUBTITLES: "9"
+    };
+
     /** get the player configuration.
      * @returns {Config}
      * */
@@ -328,10 +343,13 @@ class RemotePlayer extends EventTarget {
         return this.LoadMode.NOT_LOADED;
     }
 
+
     /**
     * @typedef {Object} TextTrack
     * @property {string} id - A unique ID for the track
     * @property {string} lang - The track's language
+    * @property {string[]} roles - The track's roles
+    * @property {string=} accessibilityPurpose - The track's accessibilityPurpose code
     * @property {boolean} selected - Whether the track is selected
     * @property {boolean} autoTranslate - (Optional) Whether the track is an auto-translated language
     */
@@ -353,6 +371,8 @@ class RemotePlayer extends EventTarget {
     * @typedef {Object} AudioTrack
     * @property {string} id - A unique ID for the track
     * @property {string} lang - The track's language
+    * @property {string[]} roles - The track's roles
+    * @property {string=} accessibilityPurpose - The track's accessibilityPurpose code
     * @property {boolean} selected - Whether the track is selected
     */
     /** Get all the audio tracks.
@@ -377,10 +397,21 @@ class RemotePlayer extends EventTarget {
         return noop("RemotePlayer.selectAudioTrack", audioTrackId);
     }
 
-    /** Select a specific text (subtitle) track.
+    /** Selects an audio track based on given language, role and accessibility.
+     * Tf exact track match - Best track will be selected by the internal system
+     * @param {string} language - The language of the track to select.
+     * @param {string=} role - The role of the track to select.
+     * @param {AccessibilityPurposeCode=} accessibilityPurposeCode - The accessibilityPurposeCode of the track to select. Based on DASH manifest role "urn:tva:metadata:cs:AudioPurposeCS:2007"
+     * @returns {Promise<void>} A Promise that resolves once the selection process is complete.
+     **/
+    async selectAudioLanguage(language, role="", accessibilityPurposeCode=this.AccessibilityPurposeCode.NONE) {
+        return noop("RemotePlayer.selectAudioLanguage", language, role, accessibilityPurposeCode);
+    }
+
+    /** Select a text track based on given language, role and accessibility.
      * Track id should come from a call to getTextTracks.
      * If no tracks exist - this is a no-op.
-     * If the id does not match the id of any of the existing tracks - this is a no-op.
+     * Tf no tracks exist - fallback ID will be used by internal system to select best matching track.
      * @param {string} textTrackId - The ID of the text track to select.
      * @returns {Promise<void>} A Promise that resolves once the selection process is complete.
      * @throws {RemotePlayerError} If the player is not initialized or not loaded.
@@ -389,6 +420,16 @@ class RemotePlayer extends EventTarget {
         return noop("RemotePlayer.selectTextTrack", textTrackId);
     }
 
+    /** Selects a text track based on given language, role and accessibility.
+     * Tf exact track match - Best track will be selected by the internal system
+     * @param {string} language - The language of the track to select.
+     * @param {string=} role - The role of the track to select.
+     * @param {AccessibilityPurposeCode=} accessibilityPurposeCode - The accessibilityPurposeCode of the track to select. Based on DASH manifest role "urn:tva:metadata:cs:AudioPurposeCS:2007"
+     * @returns {Promise<void>} A Promise that resolves once the selection process is complete.
+     **/
+    async selectTextLanguage(language, role="", accessibilityPurposeCode=this.AccessibilityPurposeCode.NONE) {
+        return noop("RemotePlayer.selectTextLanguage", language, role, accessibilityPurposeCode);
+    }
     /**
      * Enable or disable the subtitles.
      * If the player is in an unloaded state, the request will be applied next time content is played.

package/src/interface/version.js

@@ -1 +1 @@
-export const version = "4.3.5";
+export const version = "4.3.7-b2908c5.0";