@kkcompany/player 2.9.333 → 2.25.0-anary.15

package/CHANGELOG.md

@@ -2,6 +2,107 @@
 
 All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
+## [2.25.0-anary.15](https://gitlab.kkinternal.com/playback/web-playcraft/compare/v2.25.0-canary.9...v2.25.0-anary.15) (2025-12-15)
+
+
+### Features
+
+* override track display name in language menu ([338f5cc](https://gitlab.kkinternal.com/playback/web-playcraft/commit/338f5cc232d488eb36a07cdc339402cb9bd5d886))
+
+## [2.25.0-canary.9](https://gitlab.kkinternal.com/playback/web-playcraft/compare/v2.25.0-canary.8...v2.25.0-canary.9) (2025-12-04)
+
+
+### Features
+
+* **premium:** enable audio/text track control ([41d7dd3](https://gitlab.kkinternal.com/playback/web-playcraft/commit/41d7dd3776ab1b5e82b4612605394bb98e22e3b0))
+* subtitle off option is changed to 'none' ([029a41a](https://gitlab.kkinternal.com/playback/web-playcraft/commit/029a41a6e6f69847c01665ca4bd31f9ef77073a7))
+
+## [2.25.0-canary.8](https://gitlab.kkinternal.com/playback/web-playcraft/compare/v2.25.0-canary.7...v2.25.0-canary.8) (2025-11-28)
+
+## [2.25.0-canary.7](https://gitlab.kkinternal.com/playback/web-playcraft/compare/v2.25.0-canary.6...v2.25.0-canary.7) (2025-11-28)
+
+## [2.25.0-canary.6](https://gitlab.kkinternal.com/playback/web-playcraft/compare/v2.25.0-canary.5...v2.25.0-canary.6) (2025-11-28)
+
+
+### Features
+
+* add back other sections ([a4d8961](https://gitlab.kkinternal.com/playback/web-playcraft/commit/a4d8961b2985cb0811f619529c92302dde73d9ad))
+
+## [2.25.0-canary.5](https://gitlab.kkinternal.com/playback/web-playcraft/compare/v2.25.0-canary.3...v2.25.0-canary.5) (2025-11-25)
+
+
+### Bug Fixes
+
+* playback api response handling ([dfe5a5f](https://gitlab.kkinternal.com/playback/web-playcraft/commit/dfe5a5fd60ee7dc0155e63a796df6afe337c4a3d))
+
+## [2.25.0-canary.3](https://gitlab.kkinternal.com/playback/web-playcraft/compare/v2.25.0-canary.2...v2.25.0-canary.3) (2025-11-21)
+
+
+### Features
+
+* display language menu only when options are available ([f02fbc7](https://gitlab.kkinternal.com/playback/web-playcraft/commit/f02fbc775f351dff406139f2e9f2c2451441de31))
+
+
+### Bug Fixes
+
+* undefined audio setting options ([3e4e5ab](https://gitlab.kkinternal.com/playback/web-playcraft/commit/3e4e5ab521b56ba349d7be8416cc98f70ca404ed))
+
+## [2.25.0-canary.2](https://gitlab.kkinternal.com/playback/web-playcraft/compare/v2.25.0-canary.1...v2.25.0-canary.2) (2025-11-21)
+
+
+### Features
+
+* add change setting support to new audio/subtitle menu ([97728db](https://gitlab.kkinternal.com/playback/web-playcraft/commit/97728dbdc5f223cfccc18818cb5afa3b17be36d3))
+* custom language menu item order ([6bba6dc](https://gitlab.kkinternal.com/playback/web-playcraft/commit/6bba6dc3c137c292eb890ebefcdc49cf1d155d21))
+* display audio / subtitle options even if there's only 1 ([2e23915](https://gitlab.kkinternal.com/playback/web-playcraft/commit/2e23915d7aa7d084b65c9729c8ac468690852eb3))
+* enable custom language menu ([fb2038d](https://gitlab.kkinternal.com/playback/web-playcraft/commit/fb2038da7fc3ea399bad3fbb4b7e1eb1c7bb49f0))
+* export MenuItem + styles of LanguageMenu for custom menu component ([4f37d2e](https://gitlab.kkinternal.com/playback/web-playcraft/commit/4f37d2ed793287885e69dead576ceb1cecbe3320))
+* **ui:** add close button to mobile language menu ([6704ce1](https://gitlab.kkinternal.com/playback/web-playcraft/commit/6704ce14b13e8e5f344615ca43220b3b8f79b5f8))
+* enable custom setting menu sections with slotProps ([013fb63](https://gitlab.kkinternal.com/playback/web-playcraft/commit/013fb6393d7cc17502db6ef36b8b6d9492787529))
+* integrate new audio/subtitle menu to player UI ([d0944cb](https://gitlab.kkinternal.com/playback/web-playcraft/commit/d0944cb469342ae5eb84cd212a17835559e25115))
+* **ui:** add LanguageMenu component ([3ec5456](https://gitlab.kkinternal.com/playback/web-playcraft/commit/3ec5456eb1003b9374505e53bde56d967fef0b68))
+* **ui:** add OverlayPanel for custom setting menu ([dede035](https://gitlab.kkinternal.com/playback/web-playcraft/commit/dede03515b414c7e4afe7b6cb9c687097d46e920))
+* **ui:** add subtitles icon ([e771220](https://gitlab.kkinternal.com/playback/web-playcraft/commit/e7712208a8594aaf7211d55445fb5d4519e776e3))
+
+## [2.25.0-canary.1](https://gitlab.kkinternal.com/playback/web-playcraft/compare/v2.9.20...v2.25.0-canary.1) (2025-11-21)
+
+
+### Features
+
+* add support of external text track / subtitle ([2d2aa9f](https://gitlab.kkinternal.com/playback/web-playcraft/commit/2d2aa9f8b624749795b76f80551dbeca40359a79))
+* **text:** add style for shaka player text display container ([39e62ec](https://gitlab.kkinternal.com/playback/web-playcraft/commit/39e62eccf99f394d12d682cd3b4a1a5ad1a398b3))
+* **text:** patch vertical text display style ([7725796](https://gitlab.kkinternal.com/playback/web-playcraft/commit/7725796e0d5ef77a6728c88296519eb809f090c5))
+* **text:** remove extra styles from ruby/rt to display properly ([4c77c61](https://gitlab.kkinternal.com/playback/web-playcraft/commit/4c77c61436a28fbdcc69e2bde0cd670681f7fadb))
+* add castMedia export with error handling added ([82aa0b6](https://gitlab.kkinternal.com/playback/web-playcraft/commit/82aa0b608aad2f2e5c638b20ca3254298ec77291))
+* basic HLS on MSE ([b02c6f0](https://gitlab.kkinternal.com/playback/web-playcraft/commit/b02c6f0f44a89000aed9f279c1715bb4d0d115dc))
+* enable Shaka player built-in text/subtitle display ([47375d6](https://gitlab.kkinternal.com/playback/web-playcraft/commit/47375d639a94df07e0919a79560f0202540f46fa))
+* expose audio track info ([87426d7](https://gitlab.kkinternal.com/playback/web-playcraft/commit/87426d710262baaa347e07ef7c21cd129671d834))
+* give subtitle a bottom magin while controller is hidden ([6444f6a](https://gitlab.kkinternal.com/playback/web-playcraft/commit/6444f6a5bfe9ed6a040c78e8317a67bcf136fa41))
+* select preferred text track after switching video ([e380825](https://gitlab.kkinternal.com/playback/web-playcraft/commit/e3808255ced22c7bdbe3ace169e33b1c9b9b176b))
+* **cast:** add CastSessionControl for non-context integration ([4749ec0](https://gitlab.kkinternal.com/playback/web-playcraft/commit/4749ec0d62771bc73abcf231fc6e58672508e1b5))
+* **premium:** add cast prop for non-context integration ([7a3307f](https://gitlab.kkinternal.com/playback/web-playcraft/commit/7a3307f35c691b77d83b6181670fb76f21187476))
+* upgrade shaka-player and limit version range to 4.15.x ([48c5ec8](https://gitlab.kkinternal.com/playback/web-playcraft/commit/48c5ec81bd8adec74b8415cf101e12617c1d1f07))
+
+
+### Bug Fixes
+
+* cursh while using quilty setting ([2389954](https://gitlab.kkinternal.com/playback/web-playcraft/commit/2389954551de8fc1dde4a62b70c7075bebf929dd))
+* detect Safari 18 ([981efde](https://gitlab.kkinternal.com/playback/web-playcraft/commit/981efde96791bd93b47b69ca9d4ede32be8bcc0e))
+* format subtitle label only if it exists ([c88fb03](https://gitlab.kkinternal.com/playback/web-playcraft/commit/c88fb033a84126cfc86f6a6ba3b59ab5a745bd48))
+* handle audio tracks with same language code ([d9de3fe](https://gitlab.kkinternal.com/playback/web-playcraft/commit/d9de3fefeda9fcaa7359bcc80ef94ea2dbfa65e0))
+* inconsistent subtitle size on newer MacOS + Chrome ([49008dc](https://gitlab.kkinternal.com/playback/web-playcraft/commit/49008dcde8b1df2dc54f2ea0b0de60568e70151e))
+* initial subtitle on safari ([564c9e5](https://gitlab.kkinternal.com/playback/web-playcraft/commit/564c9e59495f81829074031173e747ee056b39c1))
+* listen to visibility change only in iOS device ([01e0e18](https://gitlab.kkinternal.com/playback/web-playcraft/commit/01e0e18ea011bb10abd6af0ac20e03385171a674))
+* load sender framework only while the application id exists ([0b0caa9](https://gitlab.kkinternal.com/playback/web-playcraft/commit/0b0caa9e1546af4e2bb5ad6fbed1170dcfe460bd))
+* maintain text track / subtitle setting after Safari quality switch ([74837cc](https://gitlab.kkinternal.com/playback/web-playcraft/commit/74837cc7ec3c7ec7d93f46d37e73e00810878985))
+* match subtitle value as off while subtitle is undefined ([4f8ebd2](https://gitlab.kkinternal.com/playback/web-playcraft/commit/4f8ebd2bfbde374215ec08ff4e3594c78f382799))
+* select DASH/HLS base on DRM key system availablity ([623e1e2](https://gitlab.kkinternal.com/playback/web-playcraft/commit/623e1e2ca77b7313e1ec845b391e4c92166686b8))
+* turn off subtitles when starting playback in iOS browsers ([9afbbf1](https://gitlab.kkinternal.com/playback/web-playcraft/commit/9afbbf1516b0007435153311418c1afc2bcba3df))
+* **core:** provide audio tracks without duplicate variantTracks ([799525d](https://gitlab.kkinternal.com/playback/web-playcraft/commit/799525d8b2e7af4417849ac6517ba194644dd720))
+* should use track.label instead of .name ([249b606](https://gitlab.kkinternal.com/playback/web-playcraft/commit/249b6064d8ed444917aaa0d0465269f7610f111d))
+* use text tracks only if have valid language ([b126b7c](https://gitlab.kkinternal.com/playback/web-playcraft/commit/b126b7c545a0782e19d91fa2a72030ab5acdb7f2))
+* workaround for Safari text track on by default ([c4282d8](https://gitlab.kkinternal.com/playback/web-playcraft/commit/c4282d84dff31ad5a92ab58a195c9b77994064e7))
+
 ### [2.9.20](https://gitlab.kkinternal.com/playback/web-playcraft/compare/v2.9.19...v2.9.20) (2025-09-10)
 
 

package/dist/core.mjs

@@ -2,16 +2,8 @@ import UAParser from 'ua-parser-js';
 
 /* eslint-disable no-plusplus */
 new UAParser();
-function needNativeHls() {
-  // Don't let Android phones play HLS, even if some of them report supported
-  // This covers Samsung & OPPO special cases
-  const isAndroid = /android|X11|Linux/i.test(navigator.userAgent); // canPlayType isn't reliable across all iOS verion / device combinations, so also check user agent
 
-  const isSafari = /^((?!chrome|android|X11|Linux).)*(safari|iPad|iPhone|Version)/i.test(navigator.userAgent); // ref: https://stackoverflow.com/a/12905122/4578017
-  // none of our supported browsers other than Safari response to this
-
-  return isAndroid || /firefox/i.test(navigator.userAgent) ? '' : isSafari ? 'maybe' : document.createElement('video').canPlayType('application/vnd.apple.mpegURL');
-}
+const isSafari = () => /^((?!chrome|android|X11|Linux).)*(safari|iPad|iPhone|Version)/i.test(navigator.userAgent);
 // navigator.maxTouchPoints() is not supported in Safari 11, iOS Safari 11.0-11.2  compat/compat
 
 
@@ -45,7 +37,7 @@ const waitFor = (check, handler) => {
 function getVersion() {
   try {
     // eslint-disable-next-line no-undef
-    return "2.9.333";
+    return "2.25.0-anary.15";
   } catch (e) {
     return undefined;
   }
@@ -1675,7 +1667,7 @@ const loadShaka = async (videoElement, config = {}, options = {}) => {
       // See: https://github.com/shaka-project/shaka-player/issues/3526
       safeSeekOffset: 0,
       rebufferingGoal: 0,
-      ...(needNativeHls() && {
+      ...(isSafari() && {
         preferNativeHls: true
       }),
       ...config.streaming
@@ -1767,7 +1759,7 @@ const loadShaka = async (videoElement, config = {}, options = {}) => {
     responseHandlers: [rewriteDashManifest]
   };
 
-  if (needNativeHls()) {
+  if (isSafari()) {
     setupKKFariplay(player, extensionOptions);
   }
 
@@ -1828,11 +1820,6 @@ const loadShaka = async (videoElement, config = {}, options = {}) => {
     },
     getPlaybackSpeed: () => videoElement.playbackRate,
     getVideoElement: () => videoElement,
-    setQuality: restrictions => {
-      if (!restrictions) return; // FIXME: Setting restrictions to {} cannot enable abr.
-
-      player.configure('abr.restrictions', restrictions);
-    },
     getVideoQuality,
     getAvailableVideoQualities,
     isAlive: () => player.getLoadMode() !== shaka.Player.LoadMode.DESTROYED,
@@ -1842,38 +1829,6 @@ const loadShaka = async (videoElement, config = {}, options = {}) => {
   return player;
 };
 
-const timeoutError = () => new Error('request timeout');
-/**
- * @param {URL|RequestInfo} url 
- * @param {RequestInit} options 
- * @param {{responseType: 'json'|'text'}}
- */
-
-
-const retryRequest = (url, options = {}, {
-  responseType = 'json',
-  timeout = 6,
-  retryTimes = 6
-} = {}) => new Promise((resolve, reject) => {
-  setTimeout(() => reject(timeoutError()), timeout * 1000);
-  fetch(url, options).then(response => {
-    var _response$responseTyp;
-
-    return resolve(((_response$responseTyp = response[responseType]) === null || _response$responseTyp === void 0 ? void 0 : _response$responseTyp.call(response)) || response);
-  }).catch(reject);
-}).catch(error => {
-  console.log(error);
-
-  if (retryTimes > 0) {
-    return retryRequest(url, options, {
-      timeout,
-      retryTimes: retryTimes - 1
-    });
-  }
-
-  return error;
-});
-
 const protocolExtensions = {
   hls: 'm3u8',
   dash: 'mpd'
@@ -1912,7 +1867,7 @@ const getDrmOptions$1 = fallbackDrm => {
  * @typedef {{hls: string, dash: string}} SourceObjectAlt backward compatiable form
  *
  * @param {SourceObject[]|SourceObject|SourceObjectAlt|string} sourceOptions
- * @param {{preferManifestType?: ('dash'|'hls')}} options
+ * @param {{preferManifestType?: ('dash'|'hls'|'platform')}} options
  * @return {{src: string, type: string, drm: Object}}
  */
 
@@ -1955,7 +1910,8 @@ const getSource = (sourceOptions, {
     });
   }
 
-  const matched = sourceOptions.find(source => !preferManifestType || matchType(source, preferManifestType));
+  const targetType = preferManifestType !== 'platform' ? preferManifestType : isSafari() ? 'hls' : 'dash';
+  const matched = sourceOptions.find(source => matchType(source, targetType));
   const selected = matched || sourceOptions[0];
 
   if (!selected) {
@@ -2025,32 +1981,6 @@ const getDrmOptions = source => {
   }];
 };
 
-const matchAll = (input, pattern) => {
-  const flags = [pattern.global && 'g', pattern.ignoreCase && 'i', pattern.multiline && 'm'].filter(Boolean).join('');
-  const clone = new RegExp(pattern, flags);
-  return Array.from(function* () {
-    let matched = true;
-
-    while (1) {
-      matched = clone.exec(input);
-
-      if (!matched) {
-        return;
-      }
-
-      yield matched;
-    }
-  }());
-};
-
-const getHlsQualityOptions = manifest => {
-  const resolutionList = matchAll(manifest, /RESOLUTION=\d+x(\d+)/g);
-  return Array.from(new Set(resolutionList.map(([, height]) => ({
-    height: +height
-  })))).sort((a, b) => b.height - a.height);
-};
- // for unit test
-
 /* eslint-disable no-param-reassign */
 // when the gap is small enough, we consider it is on edge.
 // The magic number 10s comes from observation of YouTube
@@ -2064,7 +1994,7 @@ const isLiveDuration = duration => duration >= SHAKA_LIVE_DURATION;
 const isEnded = media => !isLiveDuration(media.initialDuration) && media.initialDuration - media.currentTime < 1; // When donwload bandwidth is low, Safari may report time update while buffering, ignore it.
 
 
-const isBuffered = media => needNativeHls() || Array.from({
+const isBuffered = media => isSafari() || Array.from({
   length: media.buffered.length
 }, (_, index) => ({
   start: media.buffered.start(index),
@@ -2220,22 +2150,6 @@ const subscribePlaybackState = (media, updateState, {
   return () => registered.forEach(off => off());
 };
 
-const tryPatchHlsVideoQualities = async (player, hlsUrl) => {
-  if (/(^data)|(mp4$)/.test(hlsUrl)) {
-    return;
-  } // filtered manifest comes with data URI and should be ignored
-
-
-  const manifest = await retryRequest(hlsUrl, {}, {
-    responseType: 'text'
-  }).catch(e => console.warn('Failed to get HLS video qualities', e));
-  const videoQualities = getHlsQualityOptions(manifest);
-
-  if (videoQualities) {
-    player.getAvailableVideoQualities = () => videoQualities;
-  }
-};
-
 const seek = async (media, {
   player,
   plugins = []
@@ -2291,9 +2205,8 @@ const load = async (media, {
   startTime,
   plugins = []
 }, source) => {
-  const preferManifestType = needNativeHls() ? 'dash' : 'dash';
   const preferred = getSource(source, {
-    preferManifestType
+    preferManifestType: 'platform'
   }); // There's no use case that changing DRM options without changing manifest URL, just skip
 
   if (player.lastSrc === (preferred === null || preferred === void 0 ? void 0 : preferred.src)) {
@@ -2313,7 +2226,7 @@ const load = async (media, {
       player,
       source: currentSource,
       startTime,
-      streamFormat: preferManifestType,
+      streamFormat: source.type,
       reload: async () => {
         // Bitmovin unexpectedly restores muted state, so save to restore
         const restoreMuted = player.isMuted && {
@@ -2386,10 +2299,6 @@ const load = async (media, {
     loadStartTime = merged.startTime;
   }
 
-  if (merged.type === 'application/x-mpegurl') {
-    await tryPatchHlsVideoQualities(player, merged.src);
-  }
-
   return player.unload().then(() => player.load(merged.src, loadStartTime, merged.type)).then(loadResult => {
     getSourceText(source).forEach(({
       src,
@@ -2461,7 +2370,7 @@ const loadPlayer = async (videoElement, {
   // TODO unsubscribe to release the video element
   // when resuming from background, video may play without no media events
   // on some iOS devices, pause again to workaround
-  if (!isIOS()) {
+  if (isIOS()) {
     on(document, 'visibilitychange', () => setTimeout(() => videoElement.pause(), 50));
   }
 
@@ -2491,7 +2400,8 @@ const loadPlayer = async (videoElement, {
 
   reloadOnLiveStall(videoElement, {
     reload: () => player.reload()
-  }); // TODO load built-in modules here
+  });
+  player.preferredSettings = {}; // TODO load built-in modules here
 
   player.modules = {};
   return player;