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
@@ -944,6 +944,18 @@ shaka.util.BufferUtils = class {
944
944
  * @return {!Uint8Array}
945
945
  */
946
946
  static toUint8(data, offset, length) {}
947
+ /**
948
+ * Creates a new Uint16Array view on the same buffer. This clamps the values
949
+ * to be within the same view (i.e. you can't use this to move past the end
950
+ * of the view, even if the underlying buffer is larger). However, you can
951
+ * pass a negative offset to access the data before the view.
952
+ * @param {BufferSource} data
953
+ * @param {number=} offset The offset from the beginning of this data's view
954
+ * to start the new view at.
955
+ * @param {number=} length The byte length of the new view.
956
+ * @return {!Uint16Array}
957
+ */
958
+ static toUint16(data, offset, length) {}
947
959
  /**
948
960
  * Creates a DataView over the given buffer.
949
961
  * @see toUint8
@@ -1771,11 +1783,13 @@ shaka.media.InitSegmentReference = class {
1771
1783
  * @param {?number} endByte The offset from the start of the resource
1772
1784
  * to the end of the segment, inclusive. A value of null indicates that the
1773
1785
  * segment extends to the end of the resource.
1774
- * @param {null|shaka.extern.MediaQualityInfo=} mediaQuality Information about
1775
- * the quality of the media associated with this init segment.
1776
- * @param {number=} timescale
1786
+ * @param {(null|shaka.extern.MediaQualityInfo)=} mediaQuality Information
1787
+ * about the quality of the media associated with this init segment.
1788
+ * @param {(null|number)=} timescale
1789
+ * @param {?shaka.extern.HlsAes128Key=} aes128Key
1790
+ * The segment's AES-128-CBC full segment encryption key and iv.
1777
1791
  */
1778
- constructor(uris, startByte, endByte, mediaQuality, timescale) {}
1792
+ constructor(uris, startByte, endByte, mediaQuality, timescale, aes128Key) {}
1779
1793
  /**
1780
1794
  * Returns the offset from the start of the resource to the
1781
1795
  * start of the segment.
@@ -2089,6 +2103,11 @@ shaka.media.PresentationTimeline = class {
2089
2103
  * windows to jump around on updates.
2090
2104
  */
2091
2105
  lockStartTime() {}
2106
+ /**
2107
+ * Returns if the presentation timeline's start time is locked.
2108
+ * @return {boolean}
2109
+ */
2110
+ isStartTimeLocked() {}
2092
2111
  /**
2093
2112
  * Gives PresentationTimeline a Stream's minimum segment start time.
2094
2113
  * @param {number} startTime
@@ -2353,13 +2372,56 @@ shaka.media.MetaSegmentIndex = class extends shaka.media.SegmentIndex {
2353
2372
  */
2354
2373
  updateEvery(interval, updateCallback) {}
2355
2374
  };
2375
+ /**
2376
+ * @typedef {{
2377
+ * type: string,
2378
+ * init: boolean,
2379
+ * duration: number,
2380
+ * mimeType: string,
2381
+ * codecs: string,
2382
+ * bandwidth: (number|undefined)
2383
+ * }}
2384
+ * @property {string} type
2385
+ * The media type
2386
+ * @property {boolean} init
2387
+ * Flag indicating whether the segment is an init segment
2388
+ * @property {number} duration
2389
+ * The duration of the segment in seconds
2390
+ * @property {string} mimeType
2391
+ * The segment's mime type
2392
+ * @property {string} codecs
2393
+ * The segment's codecs
2394
+ * @property {(number|undefined)} bandwidth
2395
+ * The segment's variation bandwidth
2396
+ */
2397
+ shaka.util.CmcdManager.SegmentInfo;
2398
+ /**
2399
+ * @typedef {{
2400
+ * format: shaka.util.CmcdManager.StreamingFormat
2401
+ * }}
2402
+ * @property {shaka.util.CmcdManager.StreamingFormat} format
2403
+ * The manifest's stream format
2404
+ */
2405
+ shaka.util.CmcdManager.ManifestInfo;
2406
+ /**
2407
+ * @enum {string}
2408
+ */
2409
+ shaka.util.CmcdManager.StreamingFormat = {
2410
+ DASH: 'd',
2411
+ HLS: 'h',
2412
+ SMOOTH: 's',
2413
+ OTHER: 'o'
2414
+ };
2356
2415
  /**
2357
2416
  * A text displayer plugin using the browser's native VTTCue interface.
2358
2417
  * @implements {shaka.extern.TextDisplayer}
2359
2418
  */
2360
2419
  shaka.text.SimpleTextDisplayer = class {
2361
- /** @param {HTMLMediaElement} video */
2362
- constructor(video) {}
2420
+ /**
2421
+ * @param {HTMLMediaElement} video
2422
+ * @param {string} label
2423
+ */
2424
+ constructor(video, label) {}
2363
2425
  /**
2364
2426
  * @override
2365
2427
  */
@@ -2428,46 +2490,6 @@ shaka.text.UITextDisplayer = class {
2428
2490
  */
2429
2491
  shaka.text.WebVttGenerator = class {
2430
2492
  };
2431
- /**
2432
- * @typedef {{
2433
- * type: string,
2434
- * init: boolean,
2435
- * duration: number,
2436
- * mimeType: string,
2437
- * codecs: string,
2438
- * bandwidth: (number|undefined)
2439
- * }}
2440
- * @property {string} type
2441
- * The media type
2442
- * @property {boolean} init
2443
- * Flag indicating whether the segment is an init segment
2444
- * @property {number} duration
2445
- * The duration of the segment in seconds
2446
- * @property {string} mimeType
2447
- * The segment's mime type
2448
- * @property {string} codecs
2449
- * The segment's codecs
2450
- * @property {(number|undefined)} bandwidth
2451
- * The segment's variation bandwidth
2452
- */
2453
- shaka.util.CmcdManager.SegmentInfo;
2454
- /**
2455
- * @typedef {{
2456
- * format: shaka.util.CmcdManager.StreamingFormat
2457
- * }}
2458
- * @property {shaka.util.CmcdManager.StreamingFormat} format
2459
- * The manifest's stream format
2460
- */
2461
- shaka.util.CmcdManager.ManifestInfo;
2462
- /**
2463
- * @enum {string}
2464
- */
2465
- shaka.util.CmcdManager.StreamingFormat = {
2466
- DASH: 'd',
2467
- HLS: 'h',
2468
- SMOOTH: 's',
2469
- OTHER: 'o'
2470
- };
2471
2493
  /** */
2472
2494
  shaka.util.ConfigUtils = class {
2473
2495
  /**
@@ -3735,6 +3757,10 @@ shaka.dash.DashParser = class {
3735
3757
  * @override
3736
3758
  */
3737
3759
  onExpirationUpdated(sessionId, expiration) {}
3760
+ /**
3761
+ * @override
3762
+ */
3763
+ onInitialVariantChosen(variant) {}
3738
3764
  };
3739
3765
  /**
3740
3766
  * @summary A networking plugin to handle data URIs.
@@ -3780,6 +3806,10 @@ shaka.hls.HlsParser = class {
3780
3806
  * @override
3781
3807
  */
3782
3808
  onExpirationUpdated(sessionId, expiration) {}
3809
+ /**
3810
+ * @override
3811
+ */
3812
+ onInitialVariantChosen(variant) {}
3783
3813
  };
3784
3814
  /**
3785
3815
  * @summary A networking plugin to handle http and https URIs via the Fetch API.
@@ -4235,7 +4265,7 @@ shaka.text.TtmlTextParser = class {
4235
4265
  /**
4236
4266
  * @override
4237
4267
  */
4238
- parseMedia(data, time) {}
4268
+ parseMedia(data, time, uri) {}
4239
4269
  };
4240
4270
  /**
4241
4271
  * @implements {shaka.extern.TextParser}
@@ -4254,7 +4284,7 @@ shaka.text.Mp4TtmlParser = class {
4254
4284
  /**
4255
4285
  * @override
4256
4286
  */
4257
- parseMedia(data, time) {}
4287
+ parseMedia(data, time, uri) {}
4258
4288
  };
4259
4289
  /**
4260
4290
  * @implements {shaka.extern.TextParser}
@@ -4328,7 +4358,7 @@ shaka.text.SrtTextParser = class {
4328
4358
  /**
4329
4359
  * @override
4330
4360
  */
4331
- parseMedia(data, time) {}
4361
+ parseMedia(data, time, uri) {}
4332
4362
  /**
4333
4363
  * Convert a SRT format to WebVTT
4334
4364
  * @param {string} data
@@ -4426,6 +4456,7 @@ shaka.ui.AdPosition = class extends shaka.ui.Element {
4426
4456
  };
4427
4457
  /**
4428
4458
  * @extends {shaka.ui.Element}
4459
+ * @implements {shaka.extern.IUIPlayButton}
4429
4460
  */
4430
4461
  shaka.ui.PlayButton = class extends shaka.ui.Element {
4431
4462
  /**