Source: lib/device/xbox.js

  1. /*! @license
  2.  * Shaka Player
  3.  * Copyright 2025 Google LLC
  4.  * SPDX-License-Identifier: Apache-2.0
  5.  */
  7. goog.provide('shaka.device.Xbox');
  9. goog.require('shaka.device.AbstractDevice');
  10. goog.require('shaka.device.DeviceFactory');
  11. goog.require('shaka.device.IDevice');
  12. goog.require('shaka.log');
  15. /**
  16.  * @final
  17.  */
  18. shaka.device.Xbox = class extends shaka.device.AbstractDevice {
  19.   constructor() {
  20.     super();
  22.     /** @private {boolean} */
  23.     this.isLegacyEdge_ = navigator.userAgent.includes('Edge/');
  25.     // Looking for something like "Edg/106.0.0.0".
  26.     const match = navigator.userAgent.match(/Edge?\/(\d+)/);
  28.     /** @private {?number} */
  29.     this.version_ = match ? parseInt(match[1], /* base= */ 10) : null;
  30.   }
  32.   /**
  33.    * @override
  34.    */
  35.   getVersion() {
  36.     return this.version_;
  37.   }
  39.   /**
  40.    * @override
  41.    */
  42.   getDeviceName() {
  43.     return 'Xbox';
  44.   }
  46.   /**
  47.    * @override
  48.    */
  49.   getDeviceType() {
  50.     return shaka.device.IDevice.DeviceType.CONSOLE;
  51.   }
  53.   /**
  54.    * @override
  55.    */
  56.   getBrowserEngine() {
  57.     return this.isLegacyEdge_ ? shaka.device.IDevice.BrowserEngine.EDGE :
  58.         shaka.device.IDevice.BrowserEngine.CHROMIUM;
  59.   }
  61.   /**
  62.    * @override
  63.    */
  64.   requiresEncryptionInfoInAllInitSegments(keySystem) {
  65.     return true;
  66.   }
  68.   /**
  69.    * @override
  70.    */
  71.   insertEncryptionDataBeforeClear() {
  72.     return true;
  73.   }
  75.   /**
  76.    * @override
  77.    */
  78.   shouldOverrideDolbyVisionCodecs() {
  79.     return this.isLegacyEdge_;
  80.   }
  82.   /**
  83.    * @override
  84.    */
  85.   detectMaxHardwareResolution() {
  86.     const maxResolution = {width: 1920, height: 1080};
  87.     const winRT = shaka.device.Xbox.getWinRT_();
  89.     if (winRT) {
  90.       try {
  91.         const protectionCapabilities =
  92.             new winRT.Media.Protection.ProtectionCapabilities();
  93.         const protectionResult =
  94.             winRT.Media.Protection.ProtectionCapabilityResult;
  95.         // isTypeSupported may return "maybe", which means the operation
  96.         // is not completed. This means we need to retry
  97.         // https://learn.microsoft.com/en-us/uwp/api/windows.media.protection.protectioncapabilityresult?view=winrt-22621
  98.         let result = null;
  99.         const type =
  100.             'video/mp4;codecs="hvc1,mp4a";features="decode-res-x=3840,' +
  101.             'decode-res-y=2160,decode-bitrate=20000,decode-fps=30,' +
  102.             'decode-bpc=10,display-res-x=3840,display-res-y=2160,' +
  103.             'display-bpc=8"';
  104.         const keySystem = 'com.microsoft.playready.recommendation';
  105.         do {
  106.           result = protectionCapabilities.isTypeSupported(type, keySystem);
  107.         } while (result === protectionResult.maybe);
  108.         if (result === protectionResult.probably) {
  109.           maxResolution.width = 3840;
  110.           maxResolution.height = 2160;
  111.         }
  112.       } catch (e) {
  113.         shaka.log.alwaysWarn('Xbox: Error detecting screen size, default ' +
  114.             'screen size 1920x1080.');
  115.       }
  116.     }
  118.     return Promise.resolve(maxResolution);
  119.   }
  121.   /**
  122.    * @override
  123.    */
  124.   adjustConfig(config) {
  125.     super.adjustConfig(config);
  127.     // The Xbox One browser does not detect DRM key changes signalled by a
  128.     // change in the PSSH in media segments. We need to parse PSSH from media
  129.     // segments to detect key changes.
  130.     config.drm.parseInbandPsshEnabled = this.isLegacyEdge_;
  131.     // The Xbox only supports the Playready DRM, so it should
  132.     // prefer that key system by default to improve startup performance.
  133.     config.drm.preferredKeySystems.push('com.microsoft.playready');
  134.     if (this.isLegacyEdge_) {
  135.       config.streaming.gapPadding = 0.01;
  136.     }
  137.     return config;
  138.   }
  140.   /**
  141.    * @override
  142.    */
  143.   supportsOfflineStorage() {
  144.     return false;
  145.   }
  148.   /**
  149.    * @return {?WinRT}
  150.    * @private
  151.    */
  152.   static getWinRT_() {
  153.     let winRT = null;
  154.     try {
  155.       // Try to access to WinRT for WebView, if it's not defined,
  156.       // try to access to WinRT for WebView2, if it's not defined either,
  157.       // let it throw.
  158.       if (typeof Windows !== 'undefined') {
  159.         winRT = Windows;
  160.       } else {
  161.         winRT = chrome.webview.hostObjects.sync.Windows;
  162.       }
  163.     } catch (e) {}
  164.     return winRT;
  165.   }
  167.   /**
  168.    * Check if the current platform is an Xbox One.
  169.    *
  170.    * @return {boolean}
  171.    * @private
  172.    */
  173.   static isXbox_() {
  174.     return navigator.userAgent.includes('Xbox One') ||
  175.         shaka.device.Xbox.getWinRT_() !== null;
  176.   }
  177. };
  179. if (shaka.device.Xbox.isXbox_()) {
  180.   shaka.device.DeviceFactory.registerDeviceFactory(
  181.       () => new shaka.device.Xbox());
  182. }