shaka-player 4.11.13 → 4.12.1

package/lib/player.js

@@ -556,6 +556,18 @@ goog.requireType('shaka.media.PresentationTimeline');
  */
 
 
+/**
+ * @event shaka.Player.ProducerReferenceTimeEvent
+ * @description Fired when the content includes ProducerReferenceTime (PRFT)
+ *   info.
+ * @property {string} type
+ *   'prft'
+ * @property {shaka.extern.ProducerReferenceTime} detail
+ *   An object which contains the content of the PRFT box.
+ * @exportDoc
+ */
+
+
 /**
  * @summary The main player object for Shaka Player.
  *
@@ -786,7 +798,6 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
             this.config_.preferredAudioLabel,
             this.config_.preferredVideoLabel,
             this.config_.mediaSource.codecSwitchingStrategy,
-            this.config_.manifest.dash.enableAudioGroups,
             /* audioCodec= */ '');
 
     /** @private {string} */
@@ -1447,16 +1458,17 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
       if (this.video_) {
         // Remove all track nodes
         shaka.util.Dom.removeAllChildren(this.video_);
-      }
 
-      // In order to unload a media element, we need to remove the src attribute
-      // and then load again. When we destroy media source engine, this will be
-      // done for us, but for src=, we need to do it here.
-      //
-      // DrmEngine requires this to be done before we destroy DrmEngine itself.
-      if (this.video_ && this.video_.src) {
-        this.video_.removeAttribute('src');
-        this.video_.load();
+        // In order to unload a media element, we need to remove the src
+        // attribute and then load again. When we destroy media source engine,
+        // this will be done for us, but for src=, we need to do it here.
+        //
+        // DrmEngine requires this to be done before we destroy DrmEngine
+        // itself.
+        if (this.video_.src) {
+          this.video_.removeAttribute('src');
+          this.video_.load();
+        }
       }
 
       if (this.drmEngine_) {
@@ -1780,6 +1792,12 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
               startTimeOfLoad, prefetchedVariant, segmentPrefetchById);
         }, 'loadInner_');
         preloadManager.stopQueuingLatePhaseQueuedOperations();
+
+        if (this.mimeType_ && shaka.util.Platform.isSafari() &&
+            shaka.util.MimeUtils.isHlsType(this.mimeType_)) {
+          this.mediaSourceEngine_.addSecondarySource(
+              this.assetUri_, this.mimeType_);
+        }
       }
       this.dispatchEvent(shaka.Player.makeEvent_(
           shaka.util.FakeEvent.EventName.Loaded));
@@ -2059,7 +2077,8 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
     // Avoid having to detect the resolution again if it has already been
     // detected or set
     if (this.maxHwRes_.width == Infinity &&
-        this.maxHwRes_.height == Infinity) {
+        this.maxHwRes_.height == Infinity &&
+        !this.config_.ignoreHardwareResolution) {
       const maxResolution =
           await shaka.util.Platform.detectMaxHardwareResolution();
       this.maxHwRes_.width = maxResolution.width;
@@ -2395,6 +2414,10 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
 
     this.makeStateChangeEvent_('media-source');
 
+    // Remove children if we had any, i.e. from previously used src= mode.
+    this.video_.removeAttribute('src');
+    shaka.util.Dom.removeAllChildren(this.video_);
+
     this.createTextDisplayer_();
     goog.asserts.assert(this.textDisplayer_,
         'Text displayer should be created already');
@@ -2406,6 +2429,8 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
           onMetadata: (metadata, offset, endTime) => {
             this.processTimedMetadataMediaSrc_(metadata, offset, endTime);
           },
+          onEvent: (event) => this.dispatchEvent(event),
+          onManifestUpdate: () => this.onManifestUpdate_(),
         },
         this.lcevcDec_);
     mediaSourceEngine.configure(this.config_.mediaSource);
@@ -2690,6 +2715,7 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
       // text.
       if (initialTextStream && this.shouldStreamText_()) {
         this.streamingEngine_.switchTextStream(initialTextStream);
+        this.setTextDisplayerLanguage_();
       }
     }
 
@@ -2866,6 +2892,7 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
       external: false,
       fastSwitching: false,
       fullMimeTypes: new Set(),
+      isAudioMuxedInVideo: false,
     };
     stream.fullMimeTypes.add(shaka.util.MimeUtils.getFullType(
         stream.mimeType, stream.codecs));
@@ -2991,12 +3018,14 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
         playbackUri += ',' + this.config_.playRangeEnd;
       }
     }
-    mediaElement.src = playbackUri;
-    // If ManagedMediaSource exists, we've disabled remote playback on our own.
-    // Reenable it so AirPlay can be used via RemotePlayback API.
-    if (this.mediaSourceEngine_ && window.ManagedMediaSource) {
-      mediaElement.disableRemotePlayback = false;
+
+    if (this.mediaSourceEngine_ ) {
+      await this.mediaSourceEngine_.destroy();
+      this.mediaSourceEngine_ = null;
     }
+    shaka.util.Dom.removeAllChildren(mediaElement);
+
+    mediaElement.src = playbackUri;
 
     // Tizen 3 / WebOS won't load anything unless you call load() explicitly,
     // no matter the value of the preload attribute.  This is harmful on some
@@ -3740,7 +3769,6 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
       netEngine: this.networkingEngine_,
       onError: (error) => this.onError_(error),
       onEvent: (event) => this.dispatchEvent(event),
-      onManifestUpdate: () => this.onManifestUpdate_(),
       onSegmentAppended: (reference, stream) => {
         this.onSegmentAppended_(
             reference.startTime, reference.endTime, stream.type,
@@ -3755,9 +3783,6 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
       beforeAppendSegment: (contentType, segment) => {
         return this.drmEngine_.parseInbandPssh(contentType, segment);
       },
-      onMetadata: (metadata, offset, endTime) => {
-        this.processTimedMetadataMediaSrc_(metadata, offset, endTime);
-      },
       disableStream: (stream, time) => this.disableStream(stream, time),
     };
 
@@ -3970,6 +3995,33 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
       delete config['manifest']['hls']['useSafariBehaviorForLive'];
     }
 
+    // Deprecate 'streaming.parsePrftBox' configuration.
+    if (config['streaming'] && 'parsePrftBox' in config['streaming']) {
+      shaka.Deprecate.deprecateFeature(5,
+          'streaming.parsePrftBox configuration',
+          'Now fired without needing a configuration.');
+      delete config['streaming']['parsePrftBox'];
+    }
+
+    // Deprecate 'manifest.dash.enableAudioGroups' configuration.
+    if (config['manifest'] && config['manifest']['dash'] &&
+        'enableAudioGroups' in config['manifest']['dash']) {
+      shaka.Deprecate.deprecateFeature(5,
+          'manifest.dash.enableAudioGroups configuration',
+          'It is now enabled by default and cannot be disabled.');
+      delete config['manifest']['dash']['enableAudioGroups'];
+    }
+
+    // Deprecate 'streaming.dispatchAllEmsgBoxes' configuration.
+    if (config['streaming'] && 'dispatchAllEmsgBoxes' in config['streaming']) {
+      shaka.Deprecate.deprecateFeature(5,
+          'streaming.dispatchAllEmsgBoxes configuration',
+          'Please Use mediaSource.dispatchAllEmsgBoxes instead.');
+      config['mediaSource']['dispatchAllEmsgBoxes'] =
+          config['streaming']['dispatchAllEmsgBoxes'];
+      delete config['streaming']['dispatchAllEmsgBoxes'];
+    }
+
     // If lowLatencyMode is enabled, and inaccurateManifestTolerance and
     // rebufferingGoal and segmentPrefetchLimit and baseDelay and
     // autoCorrectDrift and maxDisabledTime are not specified, set
@@ -4107,6 +4159,11 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
               'Text displayer w/ configure',
               'Text displayer should have a "configure" method!');
         }
+        if (!this.textDisplayer_.setTextLanguage) {
+          shaka.Deprecate.deprecateFeature(5,
+              'Text displayer w/ setTextLanguage',
+              'Text displayer should have a "setTextLanguage" method!');
+        }
         this.textDisplayer_.setTextVisibility(oldDisplayer.isTextVisible());
         oldDisplayer.destroy();
         if (this.mediaSourceEngine_) {
@@ -4946,12 +5003,14 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
    * @export
    */
   selectTextTrack(track) {
-    if (this.manifest_ && this.streamingEngine_&& !this.isRemotePlayback()) {
+    const selectMediaSourceMode = () => {
       const stream = this.manifest_.textStreams.find(
           (stream) => stream.id == track.id);
 
       if (!stream) {
-        shaka.log.error('No stream with id', track.id);
+        if (!this.isRemotePlayback()) {
+          shaka.log.error('No stream with id', track.id);
+        }
         return;
       }
 
@@ -4964,30 +5023,48 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
       this.addTextStreamToSwitchHistory_(stream, /* fromAdaptation= */ false);
       this.streamingEngine_.switchTextStream(stream);
       this.onTextChanged_();
+      this.setTextDisplayerLanguage_();
 
       // Workaround for
       // https://github.com/shaka-project/shaka-player/issues/1299
       // When track is selected, back-propagate the language to
       // currentTextLanguage_.
       this.currentTextLanguage_ = stream.language;
-    } else if (this.video_ && this.video_.src && this.video_.textTracks) {
-      const textTracks = this.getFilteredTextTracks_();
-      const oldTrack = textTracks.find((textTrack) =>
-        textTrack.mode !== 'disabled');
-      const newTrack = textTracks.find((textTrack) =>
-        shaka.util.StreamUtils.html5TrackId(textTrack) === track.id);
-      if (oldTrack !== newTrack) {
-        if (oldTrack) {
-          oldTrack.mode = 'disabled';
-          this.loadEventManager_.unlisten(oldTrack, 'cuechange');
-          this.textDisplayer_.remove(0, Infinity);
+    };
+    const selectSrcEqualsMode = () => {
+      if (this.video_ && this.video_.textTracks) {
+        const textTracks = this.getFilteredTextTracks_();
+        const oldTrack = textTracks.find((textTrack) =>
+          textTrack.mode !== 'disabled');
+        const newTrack = textTracks.find((textTrack) =>
+          shaka.util.StreamUtils.html5TrackId(textTrack) === track.id);
+        if (!newTrack) {
+          shaka.log.error('No track with id', track.id);
+          return;
         }
-        if (newTrack) {
-          this.enableNativeTrack_(newTrack);
+        if (oldTrack !== newTrack) {
+          if (oldTrack) {
+            oldTrack.mode = 'disabled';
+            this.loadEventManager_.unlisten(oldTrack, 'cuechange');
+            this.textDisplayer_.remove(0, Infinity);
+          }
+          if (newTrack) {
+            this.enableNativeTrack_(newTrack);
+          }
         }
+        this.onTextChanged_();
+        this.setTextDisplayerLanguage_();
+      }
+    };
+    if (this.manifest_ && this.playhead_) {
+      selectMediaSourceMode();
+      // When using MSE + remote we need to set tracks for both MSE and native
+      // apis so that synchronization is maintained.
+      if (!this.isRemotePlayback()) {
+        return;
       }
-      this.onTextChanged_();
     }
+    selectSrcEqualsMode();
   }
 
   /**
@@ -5037,11 +5114,13 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
    * @export
    */
   selectVariantTrack(track, clearBuffer = false, safeMargin = 0) {
-    if (this.manifest_ && this.streamingEngine_&& !this.isRemotePlayback()) {
+    const selectMediaSourceMode = () => {
       const variant = this.manifest_.variants.find(
           (variant) => variant.id == track.id);
       if (!variant) {
-        shaka.log.error('No variant with id', track.id);
+        if (!this.isRemotePlayback()) {
+          shaka.log.error('No variant with id', track.id);
+        }
         return;
       }
 
@@ -5065,8 +5144,15 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
                              'calling selectVariantTrack().');
       }
 
-      this.switchVariant_(
-          variant, /* fromAdaptation= */ false, clearBuffer, safeMargin);
+      if (this.isRemotePlayback()) {
+        this.switchVariant_(
+            variant, /* fromAdaptation= */ false,
+            /* clearBuffer= */ false, /* safeMargin= */ 0);
+      } else {
+        this.switchVariant_(
+            variant, /* fromAdaptation= */ false,
+            clearBuffer || false, safeMargin || 0);
+      }
 
       // Workaround for
       // https://github.com/shaka-project/shaka-player/issues/1299
@@ -5074,23 +5160,34 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
       // currentAudioLanguage_.
       this.currentAdaptationSetCriteria_ = new shaka.media.ExampleBasedCriteria(
           variant,
-          this.config_.mediaSource.codecSwitchingStrategy,
-          this.config_.manifest.dash.enableAudioGroups);
+          this.config_.mediaSource.codecSwitchingStrategy);
 
       // Update AbrManager variants to match these new settings.
       this.updateAbrManagerVariants_();
-    } else if (this.video_ && this.video_.audioTracks) {
-      // Safari's native HLS won't let you choose an explicit variant, though
-      // you can choose audio languages this way.
-      const audioTracks = Array.from(this.video_.audioTracks);
-      for (const audioTrack of audioTracks) {
-        if (shaka.util.StreamUtils.html5TrackId(audioTrack) == track.id) {
-          // This will reset the "enabled" of other tracks to false.
-          this.switchHtml5Track_(audioTrack);
-          return;
+    };
+    const selectSrcEqualsMode = () => {
+      if (this.video_ && this.video_.audioTracks) {
+        // Safari's native HLS won't let you choose an explicit variant, though
+        // you can choose audio languages this way.
+        const audioTracks = Array.from(this.video_.audioTracks);
+        for (const audioTrack of audioTracks) {
+          if (shaka.util.StreamUtils.html5TrackId(audioTrack) == track.id) {
+            // This will reset the "enabled" of other tracks to false.
+            this.switchHtml5Track_(audioTrack);
+            return;
+          }
         }
       }
+    };
+    if (this.manifest_ && this.playhead_) {
+      selectMediaSourceMode();
+      // When using MSE + remote we need to set tracks for both MSE and native
+      // apis so that synchronization is maintained.
+      if (!this.isRemotePlayback()) {
+        return;
+      }
     }
+    selectSrcEqualsMode();
   }
 
   /**
@@ -5151,20 +5248,19 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
    */
   selectAudioLanguage(language, role, channelsCount = 0, safeMargin = 0,
       codec = '') {
-    if (this.manifest_ && this.playhead_&& !this.isRemotePlayback()) {
+    const selectMediaSourceMode = () => {
       this.currentAdaptationSetCriteria_ =
           new shaka.media.PreferenceBasedCriteria(
               language,
               role || '',
-              channelsCount,
+              channelsCount || 0,
               /* hdrLevel= */ '',
               /* spatialAudio= */ false,
               /* videoLayout= */ '',
               /* audioLabel= */ '',
               /* videoLabel= */ '',
               this.config_.mediaSource.codecSwitchingStrategy,
-              this.config_.manifest.dash.enableAudioGroups,
-              codec);
+              codec || '');
 
       const diff = (a, b) => {
         if (!a.video && !b.video) {
@@ -5198,19 +5294,32 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
       }
       if (bestVariant) {
         const track = shaka.util.StreamUtils.variantToTrack(bestVariant);
-        this.selectVariantTrack(track, /* clearBuffer= */ true, safeMargin);
+        this.selectVariantTrack(
+            track, /* clearBuffer= */ true, safeMargin || 0);
         return;
       }
 
       // If we haven't switched yet, just use ABR to find a new track.
       this.chooseVariantAndSwitch_();
-    } else if (this.video_ && this.video_.audioTracks) {
-      const track = shaka.util.StreamUtils.filterStreamsByLanguageAndRole(
-          this.getVariantTracks(), language, role || '', false)[0];
-      if (track) {
-        this.selectVariantTrack(track);
+    };
+    const selectSrcEqualsMode = () => {
+      if (this.video_ && this.video_.audioTracks) {
+        const track = shaka.util.StreamUtils.filterStreamsByLanguageAndRole(
+            this.getVariantTracks(), language, role || '', false)[0];
+        if (track) {
+          this.selectVariantTrack(track);
+        }
+      }
+    };
+    if (this.manifest_ && this.playhead_) {
+      selectMediaSourceMode();
+      // When using MSE + remote we need to set tracks for both MSE and native
+      // apis so that synchronization is maintained.
+      if (!this.isRemotePlayback()) {
+        return;
       }
     }
+    selectSrcEqualsMode();
   }
 
   /**
@@ -5224,10 +5333,10 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
    * @export
    */
   selectTextLanguage(language, role, forced = false) {
-    if (this.manifest_ && this.playhead_ && !this.isRemotePlayback()) {
+    const selectMediaSourceMode = () => {
       this.currentTextLanguage_ = language;
       this.currentTextRole_ = role || '';
-      this.currentTextForced_ = forced;
+      this.currentTextForced_ = forced || false;
 
       const chosenText = this.chooseTextStream_();
       if (chosenText) {
@@ -5241,15 +5350,26 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
         if (this.shouldStreamText_()) {
           this.streamingEngine_.switchTextStream(chosenText);
           this.onTextChanged_();
+          this.setTextDisplayerLanguage_();
         }
       }
-    } else {
+    };
+    const selectSrcEqualsMode = () => {
       const track = shaka.util.StreamUtils.filterStreamsByLanguageAndRole(
-          this.getTextTracks(), language, role || '', forced)[0];
+          this.getTextTracks(), language, role || '', forced || false)[0];
       if (track) {
         this.selectTextTrack(track);
       }
+    };
+    if (this.manifest_ && this.playhead_) {
+      selectMediaSourceMode();
+      // When using MSE + remote we need to set tracks for both MSE and native
+      // apis so that synchronization is maintained.
+      if (!this.isRemotePlayback()) {
+        return;
+      }
     }
+    selectSrcEqualsMode();
   }
 
   /**
@@ -5267,7 +5387,7 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
    * @export
    */
   selectVariantsByLabel(label, clearBuffer = true, safeMargin = 0) {
-    if (this.manifest_ && this.playhead_ && !this.isRemotePlayback()) {
+    const selectMediaSourceMode = () => {
       let firstVariantWithLabel = null;
       for (const variant of this.manifest_.variants) {
         if (variant.audio.label == label) {
@@ -5297,24 +5417,35 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
               label,
               /* videoLabel= */ '',
               this.config_.mediaSource.codecSwitchingStrategy,
-              this.config_.manifest.dash.enableAudioGroups,
               /* audioCodec= */ '');
 
       this.chooseVariantAndSwitch_(clearBuffer, safeMargin);
-    } else if (this.video_ && this.video_.audioTracks) {
-      const audioTracks = Array.from(this.video_.audioTracks);
+    };
+    const selectSrcEqualsMode = () => {
+      if (this.video_ && this.video_.audioTracks) {
+        const audioTracks = Array.from(this.video_.audioTracks);
 
-      let trackMatch = null;
+        let trackMatch = null;
 
-      for (const audioTrack of audioTracks) {
-        if (audioTrack.label == label) {
-          trackMatch = audioTrack;
+        for (const audioTrack of audioTracks) {
+          if (audioTrack.label == label) {
+            trackMatch = audioTrack;
+          }
+        }
+        if (trackMatch) {
+          this.switchHtml5Track_(trackMatch);
         }
       }
-      if (trackMatch) {
-        this.switchHtml5Track_(trackMatch);
+    };
+    if (this.manifest_ && this.playhead_) {
+      selectMediaSourceMode();
+      // When using MSE + remote we need to set tracks for both MSE and native
+      // apis so that synchronization is maintained.
+      if (!this.isRemotePlayback()) {
+        return;
       }
     }
+    selectSrcEqualsMode();
   }
 
   /**
@@ -5345,7 +5476,7 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
    * @export
    */
   getChaptersTracks() {
-    if (this.video_ && this.video_.src && this.video_.textTracks) {
+    if (this.video_ && this.video_.currentSrc && this.video_.textTracks) {
       const textTracks = this.getChaptersTracks_();
       const StreamUtils = shaka.util.StreamUtils;
       return textTracks.map((text) => StreamUtils.html5TextTrackToTrack(text));
@@ -5362,7 +5493,7 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
    * @export
    */
   getChapters(language) {
-    if (!this.video_ || !this.video_.src || !this.video_.textTracks) {
+    if (!this.video_ || !this.video_.currentSrc || !this.video_.textTracks) {
       return [];
     }
     const LanguageUtils = shaka.util.LanguageUtils;
@@ -5484,6 +5615,7 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
             if (streams.length > 0) {
               this.streamingEngine_.switchTextStream(streams[0]);
               this.onTextChanged_();
+              this.setTextDisplayerLanguage_();
             }
           }
         } else {
@@ -5857,6 +5989,7 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
       fastSwitching: false,
       fullMimeTypes: new Set([shaka.util.MimeUtils.getFullType(
           mimeType || '', codec || '')]),
+      isAudioMuxedInVideo: false,
     };
 
     const fullMimeType = shaka.util.MimeUtils.getFullType(
@@ -6022,6 +6155,7 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
       fastSwitching: false,
       fullMimeTypes: new Set([shaka.util.MimeUtils.getFullType(
           segmentMimeType || '', '')]),
+      isAudioMuxedInVideo: false,
     };
 
     if (this.loadMode_ == shaka.Player.LoadMode.SRC_EQUALS) {
@@ -6507,6 +6641,7 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
               fastSwitching: false,
               fullMimeTypes: new Set([shaka.util.MimeUtils.getFullType(
                   mimeType, '')]),
+              isAudioMuxedInVideo: false,
             };
             manifest.textStreams.push(textStream);
             closedCaptionsSet.add(id);
@@ -7415,6 +7550,17 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
         shaka.util.FakeEvent.EventName.AbrStatusChanged, data));
   }
 
+  /**
+   * @private
+   */
+  setTextDisplayerLanguage_() {
+    const activeTextTrack = this.getTextTracks().find((t) => t.active);
+    if (activeTextTrack &&
+        this.textDisplayer_ && this.textDisplayer_.setTextLanguage) {
+      this.textDisplayer_.setTextLanguage(activeTextTrack.language);
+    }
+  }
+
   /**
    * @param {boolean} updateAbrManager
    * @private
@@ -8123,7 +8269,7 @@ shaka.Player.TYPICAL_BUFFERING_THRESHOLD_ = 0.5;
  * @export
  */
 // eslint-disable-next-line no-useless-concat, max-len
-shaka.Player.version = 'v4.11.13' + '-uncompiled';  // x-release-please-version
+shaka.Player.version = 'v4.12.1' + '-uncompiled';  // x-release-please-version
 
 // Initialize the deprecation system using the version string we just set
 // on the player.

package/lib/text/simple_text_displayer.js

@@ -189,6 +189,13 @@ shaka.text.SimpleTextDisplayer = class {
     this.textTrack_.mode = on ? 'showing' : 'hidden';
   }
 
+  /**
+   * @override
+   * @export
+   */
+  setTextLanguage(language) {
+  }
+
   /**
    * Iterate over all the cues in a text track and remove all those for which
    * |predicate(cue)| returns true.

package/lib/text/stub_text_displayer.js

@@ -55,4 +55,11 @@ shaka.text.StubTextDisplayer = class {
    */
   setTextVisibility(on) {
   }
+
+  /**
+   * @override
+   * @export
+   */
+  setTextLanguage(language) {
+  }
 };

package/lib/text/ui_text_displayer.js

@@ -258,6 +258,18 @@ shaka.text.UITextDisplayer = class {
     this.updateCaptions_(/* forceUpdate= */ true);
   }
 
+  /**
+   * @override
+   * @export
+   */
+  setTextLanguage(language) {
+    if (language && language != 'und') {
+      this.textContainer_.setAttribute('lang', language);
+    } else {
+      this.textContainer_.setAttribute('lang', '');
+    }
+  }
+
   /**
    * @private
    */

package/lib/util/dom_utils.js

@@ -42,6 +42,20 @@ shaka.util.Dom = class {
   }
 
 
+  /**
+   * @param {string} url
+   * @param {string=} mimeType
+   * @return {!HTMLSourceElement}
+   */
+  static createSourceElement(url, mimeType = '') {
+    const source =
+      /** @type {HTMLSourceElement} */ (document.createElement('source'));
+    source.src = url;
+    source.type = mimeType;
+    return source;
+  }
+
+
   /**
    * Cast a Node/Element to an HTMLElement
    *

package/lib/util/error.js

@@ -784,6 +784,11 @@ shaka.util.Error.Code = {
    */
   'HLS_EMPTY_MEDIA_PLAYLIST': 4053,
 
+  /**
+   * We do not support playing encrypted content with MSE
+   * and legacy Apple MediaKeys API.
+   */
+  'DASH_MSE_ENCRYPTED_LEGACY_APPLE_MEDIA_KEYS_NOT_SUPPORTED': 4054,
 
   // RETIRED: 'INCONSISTENT_BUFFER_STATE': 5000,
   // RETIRED: 'INVALID_SEGMENT_INDEX': 5001,