feat: Add safeMargin as a parameter of the player selectAudioLanguage…

… method (#5316)

Adding `safeMargin` as a parameter of the player `selectAudioLanguage`
method so it is possible to customize the buffer value when changing
tracks.

AUTHORS

@@ -29,6 +29,7 @@ Code It <*@code-it.fr>
 Damien Deis <[email protected]>
 Dany L'Hébreux <[email protected]>
 Dave Nicholas <[email protected]>
+Davide Zordan <[email protected]>
 Dl Dador <[email protected]>
 Edgeware AB <*@edgeware.tv>
 Enson Choy <[email protected]>

CONTRIBUTORS

@@ -45,6 +45,7 @@ Costel Madalin Grecu <[email protected]>
 Damien Deis <[email protected]>
 Dany L'Hébreux <[email protected]>
 Dave Nicholas <[email protected]>
+Davide Zordan <[email protected]>
 Dl Dador <[email protected]>
 Donato Borrello <[email protected]>
 Duc Pham <[email protected]>

lib/player.js

@@ -4173,9 +4173,10 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
    * @param {string} language
    * @param {string=} role
    * @param {number=} channelsCount
+   * @param {number=} safeMargin
    * @export
    */
-  selectAudioLanguage(language, role, channelsCount = 0) {
+  selectAudioLanguage(language, role, channelsCount = 0, safeMargin = 0) {
     const LanguageUtils = shaka.util.LanguageUtils;
 
     if (this.manifest_ && this.playhead_) {
@@ -4208,7 +4209,7 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
       }
       if (bestVariant) {
         const track = shaka.util.StreamUtils.variantToTrack(bestVariant);
-        this.selectVariantTrack(track, /* clearBuffer= */ true);
+        this.selectVariantTrack(track, /* clearBuffer= */ true, safeMargin);
         return;
       }