shaka-player 4.3.12 → 4.3.14

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (140) hide show
  1. package/.github/ISSUE_TEMPLATE/bug_report.md +1 -1
  2. package/.github/ISSUE_TEMPLATE/question.md +7 -0
  3. package/.github/workflows/release-please.yaml +2 -27
  4. package/AUTHORS +5 -0
  5. package/CHANGELOG.md +108 -0
  6. package/CODE_OF_CONDUCT.md +1 -1
  7. package/CONTRIBUTORS +6 -0
  8. package/README.md +2 -0
  9. package/demo/common/asset.js +5 -1
  10. package/demo/common/assets.js +16 -2
  11. package/demo/common/message_ids.js +1 -0
  12. package/demo/custom.js +2 -0
  13. package/demo/locales/en.json +1 -0
  14. package/demo/locales/source.json +4 -0
  15. package/demo/main.js +1 -1
  16. package/dist/demo.compiled.debug.js +56 -54
  17. package/dist/demo.compiled.debug.map +3 -3
  18. package/dist/demo.compiled.js +56 -54
  19. package/dist/demo.compiled.map +3 -3
  20. package/dist/deps.js +6 -6
  21. package/dist/locales.js +31 -31
  22. package/dist/receiver.compiled.debug.js +24 -22
  23. package/dist/receiver.compiled.debug.map +3 -3
  24. package/dist/receiver.compiled.js +24 -22
  25. package/dist/receiver.compiled.map +3 -3
  26. package/dist/shaka-player.compiled.d.ts +26 -6
  27. package/dist/shaka-player.compiled.debug.d.ts +26 -6
  28. package/dist/shaka-player.compiled.debug.externs.js +79 -49
  29. package/dist/shaka-player.compiled.debug.js +426 -410
  30. package/dist/shaka-player.compiled.debug.map +4 -4
  31. package/dist/shaka-player.compiled.externs.js +79 -49
  32. package/dist/shaka-player.compiled.js +912 -901
  33. package/dist/shaka-player.compiled.map +4 -4
  34. package/dist/shaka-player.ui.d.ts +38 -7
  35. package/dist/shaka-player.ui.debug.d.ts +38 -7
  36. package/dist/shaka-player.ui.debug.externs.js +80 -49
  37. package/dist/shaka-player.ui.debug.js +460 -442
  38. package/dist/shaka-player.ui.debug.map +4 -4
  39. package/dist/shaka-player.ui.externs.js +80 -49
  40. package/dist/shaka-player.ui.js +1060 -1049
  41. package/dist/shaka-player.ui.map +4 -4
  42. package/docs/tutorials/ad_monetization.md +54 -0
  43. package/docs/tutorials/fairplay.md +2 -2
  44. package/docs/tutorials/index.json +1 -0
  45. package/docs/tutorials/offline.md +1 -1
  46. package/docs/tutorials/plugins.md +4 -0
  47. package/docs/tutorials/text-displayer.md +15 -0
  48. package/docs/tutorials/ui-customization.md +29 -0
  49. package/docs/tutorials/ui.md +4 -1
  50. package/externs/lcevc.js +6 -0
  51. package/externs/shaka/manifest_parser.js +8 -0
  52. package/externs/shaka/player.js +1 -1
  53. package/externs/shaka/text.js +3 -1
  54. package/lib/abr/simple_abr_manager.js +1 -1
  55. package/lib/ads/client_side_ad.js +9 -0
  56. package/lib/ads/client_side_ad_manager.js +7 -2
  57. package/lib/ads/server_side_ad_manager.js +4 -0
  58. package/lib/cast/cast_proxy.js +18 -0
  59. package/lib/cea/cea608_memory.js +1 -1
  60. package/lib/cea/cea_decoder.js +11 -1
  61. package/lib/dash/dash_parser.js +79 -42
  62. package/lib/dash/mpd_utils.js +39 -27
  63. package/lib/hls/hls_parser.js +148 -49
  64. package/lib/hls/hls_utils.js +5 -5
  65. package/lib/media/content_workarounds.js +30 -0
  66. package/lib/media/drm_engine.js +16 -12
  67. package/lib/media/media_source_engine.js +4 -2
  68. package/lib/media/play_rate_controller.js +1 -0
  69. package/lib/media/presentation_timeline.js +11 -0
  70. package/lib/media/quality_observer.js +1 -1
  71. package/lib/media/segment_reference.js +16 -7
  72. package/lib/media/streaming_engine.js +64 -54
  73. package/lib/media/transmuxer.js +1 -1
  74. package/lib/media/video_wrapper.js +4 -3
  75. package/lib/offline/offline_manifest_parser.js +5 -0
  76. package/lib/offline/session_deleter.js +0 -8
  77. package/lib/offline/storage.js +4 -1
  78. package/lib/player.js +79 -18
  79. package/lib/polyfill/media_capabilities.js +23 -3
  80. package/lib/text/mp4_ttml_parser.js +2 -2
  81. package/lib/text/simple_text_displayer.js +7 -6
  82. package/lib/text/srt_text_parser.js +2 -2
  83. package/lib/text/text_engine.js +3 -2
  84. package/lib/text/ttml_text_parser.js +33 -5
  85. package/lib/text/ui_text_displayer.js +81 -15
  86. package/lib/text/vtt_text_parser.js +13 -0
  87. package/lib/util/buffer_utils.js +26 -4
  88. package/lib/util/cmcd_manager.js +16 -1
  89. package/lib/util/fairplay_utils.js +1 -1
  90. package/lib/util/manifest_parser_utils.js +20 -8
  91. package/lib/util/object_utils.js +1 -1
  92. package/lib/util/periods.js +91 -36
  93. package/lib/util/platform.js +39 -2
  94. package/lib/util/player_configuration.js +5 -3
  95. package/lib/util/stream_utils.js +36 -28
  96. package/lib/util/ts_parser.js +3 -3
  97. package/lib/util/xml_utils.js +5 -0
  98. package/package.json +2 -2
  99. package/test/cea/cea_decoder_unit.js +40 -0
  100. package/test/dash/dash_parser_live_unit.js +5 -8
  101. package/test/dash/dash_parser_manifest_unit.js +5 -0
  102. package/test/dash/dash_parser_segment_base_unit.js +5 -0
  103. package/test/dash/dash_parser_segment_list_unit.js +21 -17
  104. package/test/dash/dash_parser_segment_template_unit.js +5 -0
  105. package/test/hls/hls_live_unit.js +33 -0
  106. package/test/hls/hls_parser_unit.js +52 -60
  107. package/test/media/buffering_observer_unit.js +13 -0
  108. package/test/media/content_workarounds_unit.js +1 -1
  109. package/test/media/drm_engine_unit.js +30 -3
  110. package/test/media/media_source_engine_unit.js +1 -1
  111. package/test/media/transmuxer_integration.js +2 -2
  112. package/test/offline/storage_integration.js +3 -0
  113. package/test/player_integration.js +40 -40
  114. package/test/player_unit.js +31 -0
  115. package/test/polyfill/media_capabilities_unit.js +12 -6
  116. package/test/test/util/dash_parser_util.js +16 -7
  117. package/test/test/util/fake_drm_engine.js +7 -0
  118. package/test/test/util/layout_tests.js +2 -1
  119. package/test/test/util/simple_fakes.js +2 -2
  120. package/test/test/util/test_scheme.js +3 -0
  121. package/test/test/util/waiter.js +5 -0
  122. package/test/text/mp4_ttml_parser_unit.js +4 -4
  123. package/test/text/simple_text_displayer_unit.js +1 -1
  124. package/test/text/srt_text_parser_unit.js +1 -1
  125. package/test/text/text_engine_unit.js +6 -0
  126. package/test/text/ttml_text_parser_unit.js +49 -18
  127. package/test/text/ui_text_displayer_unit.js +9 -0
  128. package/test/text/vtt_text_parser_unit.js +2 -17
  129. package/test/util/buffer_utils_unit.js +1 -1
  130. package/test/util/periods_unit.js +113 -0
  131. package/test/util/ts_parser_unit.js +1 -1
  132. package/third_party/closure-uri/uri.js +1 -1
  133. package/ui/externs/ui.js +24 -0
  134. package/ui/language_utils.js +11 -5
  135. package/ui/play_button.js +20 -0
  136. package/ui/playback_rate_selection.js +4 -0
  137. package/ui/presentation_time.js +5 -5
  138. package/ui/small_play_button.js +2 -2
  139. package/ui/volume_bar.js +10 -6
  140. /package/.github/{config.yml → ISSUE_TEMPLATE/config.yml} +0 -0
@@ -42,7 +42,7 @@ describe('BufferUtils', () => {
42
42
 
43
43
  it('compares with same buffer', () => {
44
44
  const a = new Uint8Array([0, 1, 2, 3]);
45
- const b = new Uint16Array(a.buffer);
45
+ const b = BufferUtils.toUint16(a);
46
46
  expect(BufferUtils.equal(a, b)).toBe(true);
47
47
  });
48
48
 
@@ -598,6 +598,55 @@ describe('PeriodCombiner', () => {
598
598
  }
599
599
  });
600
600
 
601
+ // Regression test for #6054, where we failed on multi-period content with
602
+ // different numbers of forced-subtitle streams per period.
603
+ it('Does not combine subtitle and forced-subtitle tracks', async () => {
604
+ const videoStreams = [makeVideoStream(1280)];
605
+ const audioStreams = [makeAudioStream('en', /* channels= */ 2)];
606
+ const imageStreams = [];
607
+
608
+ const forcedSubtitle = makeTextStream('de');
609
+ forcedSubtitle.roles = ['forced-subtitle'];
610
+ forcedSubtitle.forced = true;
611
+
612
+ const subtitle = makeTextStream('de');
613
+ subtitle.roles = ['subtitle'];
614
+
615
+ /** @type {!Array.<shaka.util.PeriodCombiner.Period>} */
616
+ const periods = [
617
+ {
618
+ id: '1',
619
+ videoStreams,
620
+ audioStreams,
621
+ textStreams: [
622
+ forcedSubtitle,
623
+ subtitle,
624
+ ],
625
+ imageStreams,
626
+ },
627
+ {
628
+ id: '2',
629
+ videoStreams,
630
+ audioStreams,
631
+ textStreams: [
632
+ subtitle,
633
+ ],
634
+ imageStreams,
635
+ },
636
+ {
637
+ id: '3',
638
+ videoStreams,
639
+ audioStreams,
640
+ textStreams: [],
641
+ imageStreams,
642
+ },
643
+ ];
644
+
645
+ await combiner.combinePeriods(periods, /* isDynamic= */ true);
646
+ const textStreams = combiner.getTextStreams();
647
+ expect(textStreams.every((s) => s.roles.length === 1)).toBe(true);
648
+ });
649
+
601
650
  // Regression test for #3383, where we failed on multi-period content with
602
651
  // multiple image streams per period.
603
652
  it('Can handle multiple image streams', async () => {
@@ -1004,6 +1053,70 @@ describe('PeriodCombiner', () => {
1004
1053
  expect(audio2.originalId).toBe('2,4');
1005
1054
  });
1006
1055
 
1056
+ it('Matches streams with labels', async () => {
1057
+ const stream1 = makeAudioStream('en', /* channels= */ 2);
1058
+ stream1.originalId = '1';
1059
+ stream1.bandwidth = 129597;
1060
+ stream1.codecs = 'mp4a.40.2';
1061
+
1062
+ const stream2 = makeAudioStream('en', /* channels= */ 2);
1063
+ stream2.originalId = '2';
1064
+ stream2.bandwidth = 129637;
1065
+ stream2.codecs = 'mp4a.40.2';
1066
+ stream2.label = 'description';
1067
+
1068
+ const stream3 = makeAudioStream('en', /* channels= */ 2);
1069
+ stream3.originalId = '3';
1070
+ stream3.bandwidth = 131037;
1071
+ stream3.codecs = 'mp4a.40.2';
1072
+
1073
+ const stream4 = makeAudioStream('en', /* channels= */ 2);
1074
+ stream4.originalId = '4';
1075
+ stream4.bandwidth = 131034;
1076
+ stream4.codecs = 'mp4a.40.2';
1077
+ stream4.label = 'description';
1078
+
1079
+ /** @type {!Array.<shaka.util.PeriodCombiner.Period>} */
1080
+ const periods = [
1081
+ {
1082
+ id: '0',
1083
+ videoStreams: [
1084
+ makeVideoStream(1080),
1085
+ ],
1086
+ audioStreams: [
1087
+ stream1,
1088
+ stream2,
1089
+ ],
1090
+ textStreams: [],
1091
+ imageStreams: [],
1092
+ },
1093
+ {
1094
+ id: '1',
1095
+ videoStreams: [
1096
+ makeVideoStream(1080),
1097
+ ],
1098
+ audioStreams: [
1099
+ stream3,
1100
+ stream4,
1101
+ ],
1102
+ textStreams: [],
1103
+ imageStreams: [],
1104
+ },
1105
+ ];
1106
+
1107
+ await combiner.combinePeriods(periods, /* isDynamic= */ true);
1108
+ const variants = combiner.getVariants();
1109
+ expect(variants.length).toBe(2);
1110
+ // We can use the originalId field to see what each track is composed of.
1111
+ const audio1 = variants[0].audio;
1112
+ expect(audio1.label).toBe(null);
1113
+ expect(audio1.originalId).toBe('1,3');
1114
+
1115
+ const audio2 = variants[1].audio;
1116
+ expect(audio2.label).toBe('description');
1117
+ expect(audio2.originalId).toBe('2,4');
1118
+ });
1119
+
1007
1120
  it('Matches streams with related codecs', async () => {
1008
1121
  const stream1 = makeVideoStream(1080);
1009
1122
  stream1.originalId = '1';
@@ -72,6 +72,6 @@ describe('TsParser', () => {
72
72
  const codecs = new shaka.util.TsParser().parse(tsSegment)
73
73
  .getCodecs();
74
74
  expect(codecs.audio).toBe('aac');
75
- expect(codecs.video).toBe('');
75
+ expect(codecs.video).toBe(null);
76
76
  });
77
77
  });
@@ -8,7 +8,7 @@
8
8
  *
9
9
  * Use new goog.Uri(string) to parse a URI string.
10
10
  *
11
- * e.g: <code>var myUri = new goog.Uri(window.location);</code>
11
+ * e.g.: <code>var myUri = new goog.Uri(window.location);</code>
12
12
  *
13
13
  * Implements RFC 3986 for parsing/formatting URIs.
14
14
  * http://www.ietf.org/rfc/rfc3986.txt
package/ui/externs/ui.js CHANGED
@@ -443,3 +443,27 @@ shaka.extern.IUISeekBar.Factory = class {
443
443
  */
444
444
  create(rootElement, controls) {}
445
445
  };
446
+
447
+ /**
448
+ * @interface
449
+ * @exportDoc
450
+ */
451
+ shaka.extern.IUIPlayButton = class {
452
+ /**
453
+ * @param {!HTMLElement} parent
454
+ * @param {!shaka.ui.Controls} controls
455
+ */
456
+ constructor(parent, controls) {
457
+ /**
458
+ * @protected {!HTMLButtonElement}
459
+ * @exportDoc
460
+ */
461
+ this.button;
462
+ }
463
+
464
+ /** @return {boolean} */
465
+ isPaused() {}
466
+
467
+ /** @return {boolean} */
468
+ isEnded() {}
469
+ };
@@ -55,7 +55,11 @@ shaka.ui.LanguageUtils = class {
55
55
  }
56
56
  };
57
57
 
58
- const getCombination = (language, rolesString) => {
58
+ const getCombination = (language, rolesString, label) => {
59
+ if (label &&
60
+ trackLabelFormat == shaka.ui.Overlay.TrackLabelFormat.LABEL) {
61
+ return language + ': ' + label + ': ' + rolesString;
62
+ }
59
63
  return language + ': ' + rolesString;
60
64
  };
61
65
 
@@ -72,7 +76,8 @@ shaka.ui.LanguageUtils = class {
72
76
  /** @type {!Set.<string>} */
73
77
  const combinationsMade = new Set();
74
78
  const selectedCombination = selectedTrack ? getCombination(
75
- selectedTrack.language, getRolesString(selectedTrack)) : '';
79
+ selectedTrack.language, getRolesString(selectedTrack),
80
+ selectedTrack.label) : '';
76
81
 
77
82
  for (const track of tracks) {
78
83
  const language = track.language;
@@ -80,7 +85,8 @@ shaka.ui.LanguageUtils = class {
80
85
  const LocIds = shaka.ui.Locales.Ids;
81
86
  const forcedString = localization.resolve(LocIds.SUBTITLE_FORCED);
82
87
  const rolesString = getRolesString(track);
83
- const combinationName = getCombination(language, rolesString);
88
+ const label = track.label;
89
+ const combinationName = getCombination(language, rolesString, label);
84
90
  if (combinationsMade.has(combinationName)) {
85
91
  continue;
86
92
  }
@@ -124,8 +130,8 @@ shaka.ui.LanguageUtils = class {
124
130
  }
125
131
  break;
126
132
  case shaka.ui.Overlay.TrackLabelFormat.LABEL:
127
- if (track.label) {
128
- span.textContent = track.label;
133
+ if (label) {
134
+ span.textContent = label;
129
135
  } else {
130
136
  // Fallback behavior. This probably shouldn't happen.
131
137
  shaka.log.alwaysWarn('Track #' + track.id + ' does not have a ' +
package/ui/play_button.js CHANGED
@@ -16,6 +16,7 @@ goog.requireType('shaka.ui.Controls');
16
16
 
17
17
  /**
18
18
  * @extends {shaka.ui.Element}
19
+ * @implements {shaka.extern.IUIPlayButton}
19
20
  * @export
20
21
  */
21
22
  shaka.ui.PlayButton = class extends shaka.ui.Element {
@@ -72,6 +73,11 @@ shaka.ui.PlayButton = class extends shaka.ui.Element {
72
73
  this.updateIcon();
73
74
  });
74
75
 
76
+ this.eventManager.listen(this.adManager, AdManager.AD_STOPPED, () => {
77
+ this.updateAriaLabel();
78
+ this.updateIcon();
79
+ });
80
+
75
81
  this.eventManager.listen(this.button, 'click', () => {
76
82
  if (this.ad && this.ad.isLinear()) {
77
83
  this.controls.playPauseAd();
@@ -90,6 +96,7 @@ shaka.ui.PlayButton = class extends shaka.ui.Element {
90
96
  /**
91
97
  * @return {boolean}
92
98
  * @protected
99
+ * @override
93
100
  */
94
101
  isPaused() {
95
102
  if (this.ad && this.ad.isLinear()) {
@@ -99,6 +106,19 @@ shaka.ui.PlayButton = class extends shaka.ui.Element {
99
106
  return this.controls.presentationIsPaused();
100
107
  }
101
108
 
109
+ /**
110
+ * @return {boolean}
111
+ * @protected
112
+ * @override
113
+ */
114
+ isEnded() {
115
+ if (this.ad && this.ad.isLinear()) {
116
+ return false;
117
+ }
118
+
119
+ return this.video.ended;
120
+ }
121
+
102
122
  /**
103
123
  * Called when the button's aria label needs to change.
104
124
  * To be overridden by subclasses.
@@ -44,6 +44,10 @@ shaka.ui.PlaybackRateSelection = class extends shaka.ui.SettingsMenu {
44
44
  this.updateLocalizedStrings_();
45
45
  });
46
46
 
47
+ this.eventManager.listen(this.player, 'loaded', () => {
48
+ this.updatePlaybackRateSelection_(this.player.getPlaybackRate());
49
+ });
50
+
47
51
  this.eventManager.listen(this.player, 'ratechange', () => {
48
52
  this.updatePlaybackRateSelection_(this.player.getPlaybackRate());
49
53
  });
@@ -64,7 +64,6 @@ shaka.ui.PresentationTimeTracker = class extends shaka.ui.Element {
64
64
  updateTime_() {
65
65
  const isSeeking = this.controls.isSeeking();
66
66
  let displayTime = this.controls.getDisplayTime();
67
- const duration = this.video.duration;
68
67
  const seekRange = this.player.seekRange();
69
68
  const seekRangeSize = seekRange.end - seekRange.start;
70
69
  const Utils = shaka.ui.Utils;
@@ -89,11 +88,12 @@ shaka.ui.PresentationTimeTracker = class extends shaka.ui.Element {
89
88
  this.currentTime_.disabled = true;
90
89
  }
91
90
  } else {
92
- const showHour = duration >= 3600;
91
+ const showHour = seekRangeSize >= 3600;
93
92
 
94
- let value = Utils.buildTimeString(displayTime, showHour);
95
- if (duration) {
96
- value += ' / ' + Utils.buildTimeString(duration, showHour);
93
+ const currentTime = Math.max(0, displayTime - seekRange.start);
94
+ let value = Utils.buildTimeString(currentTime, showHour);
95
+ if (seekRangeSize) {
96
+ value += ' / ' + Utils.buildTimeString(seekRangeSize, showHour);
97
97
  }
98
98
  this.setValue_(value);
99
99
  this.currentTime_.disabled = true;
@@ -38,7 +38,7 @@ shaka.ui.SmallPlayButton = class extends shaka.ui.PlayButton {
38
38
  /** @override */
39
39
  updateIcon() {
40
40
  const Icons = shaka.ui.Enums.MaterialDesignIcons;
41
- if (this.video.ended) {
41
+ if (this.isEnded()) {
42
42
  this.button.textContent = Icons.REPLAY;
43
43
  } else {
44
44
  this.button.textContent = this.isPaused() ? Icons.PLAY : Icons.PAUSE;
@@ -48,7 +48,7 @@ shaka.ui.SmallPlayButton = class extends shaka.ui.PlayButton {
48
48
  /** @override */
49
49
  updateAriaLabel() {
50
50
  const LocIds = shaka.ui.Locales.Ids;
51
- if (this.video.ended) {
51
+ if (this.isEnded()) {
52
52
  this.button.ariaLabel = this.localization.resolve(LocIds.REPLAY);
53
53
  } else {
54
54
  const label = this.isPaused() ? LocIds.PLAY : LocIds.PAUSE;
package/ui/volume_bar.js CHANGED
@@ -32,6 +32,10 @@ shaka.ui.VolumeBar = class extends shaka.ui.RangeElement {
32
32
  /** @private {!shaka.extern.UIConfiguration} */
33
33
  this.config_ = this.controls.getConfig();
34
34
 
35
+ // We use a range of 100 to avoid problems with Firefox.
36
+ // See https://github.com/shaka-project/shaka-player/issues/3987
37
+ this.setRange(0, 100);
38
+
35
39
  this.eventManager.listen(this.video,
36
40
  'volumechange',
37
41
  () => this.onPresentationVolumeChange_());
@@ -74,9 +78,9 @@ shaka.ui.VolumeBar = class extends shaka.ui.RangeElement {
74
78
  */
75
79
  onChange() {
76
80
  if (this.ad && this.ad.isLinear()) {
77
- this.ad.setVolume(this.getValue());
81
+ this.ad.setVolume(this.getValue() / 100);
78
82
  } else {
79
- this.video.volume = this.getValue();
83
+ this.video.volume = this.getValue() / 100;
80
84
  if (this.video.volume == 0) {
81
85
  this.video.muted = true;
82
86
  } else {
@@ -90,7 +94,7 @@ shaka.ui.VolumeBar = class extends shaka.ui.RangeElement {
90
94
  if (this.video.muted) {
91
95
  this.setValue(0);
92
96
  } else {
93
- this.setValue(this.video.volume);
97
+ this.setValue(this.video.volume * 100);
94
98
  }
95
99
 
96
100
  this.updateColors_();
@@ -102,7 +106,7 @@ shaka.ui.VolumeBar = class extends shaka.ui.RangeElement {
102
106
  'This.ad should exist at this point!');
103
107
 
104
108
  const volume = this.ad.getVolume();
105
- this.setValue(volume);
109
+ this.setValue(volume * 100);
106
110
  this.updateColors_();
107
111
  }
108
112
 
@@ -110,8 +114,8 @@ shaka.ui.VolumeBar = class extends shaka.ui.RangeElement {
110
114
  updateColors_() {
111
115
  const colors = this.config_.volumeBarColors;
112
116
  const gradient = ['to right'];
113
- gradient.push(colors.level + (this.getValue() * 100) + '%');
114
- gradient.push(colors.base + (this.getValue() * 100) + '%');
117
+ gradient.push(colors.level + this.getValue() + '%');
118
+ gradient.push(colors.base + this.getValue() + '%');
115
119
  gradient.push(colors.base + '100%');
116
120
 
117
121
  this.container.style.background =