Source: lib/device/abstract_device.js

  1. /*! @license
  2.  * Shaka Player
  3.  * Copyright 2025 Google LLC
  4.  * SPDX-License-Identifier: Apache-2.0
  5.  */
  7. goog.provide('shaka.device.AbstractDevice');
  9. goog.require('shaka.device.IDevice');
  10. goog.require('shaka.util.Dom');
  11. goog.require('shaka.util.Lazy');
  14. /**
  15.  * @abstract
  16.  * @implements {shaka.device.IDevice}
  17.  */
  18. shaka.device.AbstractDevice = class {
  19.   constructor() {
  20.     /** @private {!shaka.util.Lazy<!shaka.device.IDevice.DeviceType>} */
  21.     this.abstractDeviceType_ = new shaka.util.Lazy(() => {
  22.       if (navigator.userAgent.match(/Smart( ?|_)TV/i) ||
  23.           navigator.userAgent.match(/Android ?TV/i)) {
  24.         return shaka.device.IDevice.DeviceType.TV;
  25.       }
  26.       if (navigator.userAgentData) {
  27.         if (navigator.userAgentData.mobile) {
  28.           return shaka.device.IDevice.DeviceType.MOBILE;
  29.         } else {
  30.           return shaka.device.IDevice.DeviceType.DESKTOP;
  31.         }
  32.       }
  33.       if (/(?:iPhone|iPad|iPod)/.test(navigator.userAgent)) {
  34.         return shaka.device.IDevice.DeviceType.MOBILE;
  35.       }
  36.       if (navigator.userAgentData && navigator.userAgentData.platform) {
  37.         if (navigator.userAgentData.platform.toLowerCase() == 'android') {
  38.           return shaka.device.IDevice.DeviceType.MOBILE;
  39.         } else {
  40.           return shaka.device.IDevice.DeviceType.DESKTOP;
  41.         }
  42.       }
  43.       if (navigator.userAgent.includes('Android')) {
  44.         return shaka.device.IDevice.DeviceType.MOBILE;
  45.       }
  46.       return shaka.device.IDevice.DeviceType.DESKTOP;
  47.     });
  49.     /** @private {!shaka.util.Lazy<shaka.device.IDevice.BrowserEngine>} */
  50.     this.browserEngine_ = new shaka.util.Lazy(() => {
  51.       if (navigator.vendor.includes('Apple') &&
  52.           (navigator.userAgent.includes('Version/') ||
  53.           navigator.userAgent.includes('OS/'))) {
  54.         return shaka.device.IDevice.BrowserEngine.WEBKIT;
  55.       }
  56.       if (navigator.userAgent.includes('Edge/')) {
  57.         return shaka.device.IDevice.BrowserEngine.EDGE;
  58.       }
  59.       if (navigator.userAgent.includes('Chrome/')) {
  60.         return shaka.device.IDevice.BrowserEngine.CHROMIUM;
  61.       }
  62.       if (navigator.userAgent.includes('Firefox/')) {
  63.         return shaka.device.IDevice.BrowserEngine.GECKO;
  64.       }
  65.       return shaka.device.IDevice.BrowserEngine.UNKNOWN;
  66.     });
  67.   }
  69.   /**
  70.    * @override
  71.    */
  72.   supportsMediaSource() {
  73.     const mediaSource = window.ManagedMediaSource || window.MediaSource;
  74.     // Browsers that lack a media source implementation will have no reference
  75.     // to |window.MediaSource|. Platforms that we see having problematic media
  76.     // source implementations will have this reference removed via a polyfill.
  77.     if (!mediaSource) {
  78.       return false;
  79.     }
  81.     // Some very old MediaSource implementations didn't have isTypeSupported.
  82.     if (!mediaSource.isTypeSupported) {
  83.       return false;
  84.     }
  86.     return true;
  87.   }
  89.   /**
  90.    * @override
  91.    */
  92.   supportsMediaType(mimeType) {
  93.     const video = shaka.util.Dom.anyMediaElement();
  94.     return video.canPlayType(mimeType) != '';
  95.   }
  97.   /**
  98.    * @override
  99.    */
  100.   supportsMediaCapabilities() {
  101.     return !!navigator.mediaCapabilities;
  102.   }
  104.   /**
  105.    * @override
  106.    */
  107.   getDeviceType() {
  108.     return this.abstractDeviceType_.value();
  109.   }
  111.   /**
  112.    * @override
  113.    */
  114.   getBrowserEngine() {
  115.     return this.browserEngine_.value();
  116.   }
  118.   /**
  119.    * @override
  120.    */
  121.   requiresEncryptionInfoInAllInitSegments(keySystem, contentType) {
  122.     return false;
  123.   }
  125.   /**
  126.    * @override
  127.    */
  128.   requiresClearAndEncryptedInitSegments() {
  129.     return false;
  130.   }
  132.   /**
  133.    * @override
  134.    */
  135.   insertEncryptionDataBeforeClear() {
  136.     return false;
  137.   }
  139.   /**
  140.    * @override
  141.    */
  142.   requiresTfhdFix(contentType) {
  143.     return false;
  144.   }
  146.   /**
  147.    * @override
  148.    */
  149.   requiresEC3InitSegments() {
  150.     return false;
  151.   }
  153.   /**
  154.    * @override
  155.    */
  156.   supportsSequenceMode() {
  157.     return true;
  158.   }
  160.   /**
  161.    * @override
  162.    */
  163.   supportsSmoothCodecSwitching() {
  164.     return true;
  165.   }
  167.   /**
  168.    * @override
  169.    */
  170.   supportsServerCertificate() {
  171.     return true;
  172.   }
  174.   /**
  175.    * @override
  176.    */
  177.   seekDelay() {
  178.     return 0;
  179.   }
  181.   /**
  182.    * @override
  183.    */
  184.   detectMaxHardwareResolution() {
  185.     return Promise.resolve({width: Infinity, height: Infinity});
  186.   }
  188.   /**
  189.    * @override
  190.    */
  191.   shouldOverrideDolbyVisionCodecs() {
  192.     return false;
  193.   }
  195.   /**
  196.    * @override
  197.    */
  198.   shouldAvoidUseTextDecoderEncoder() {
  199.     return false;
  200.   }
  202.   /**
  203.    * @override
  204.    */
  205.   adjustConfig(config) {
  206.     const deviceType = this.getDeviceType();
  207.     if (deviceType === shaka.device.IDevice.DeviceType.TV ||
  208.         deviceType === shaka.device.IDevice.DeviceType.CONSOLE ||
  209.         deviceType === shaka.device.IDevice.DeviceType.CAST) {
  210.       config.ads.customPlayheadTracker = true;
  211.       config.ads.skipPlayDetection = true;
  212.       config.ads.supportsMultipleMediaElements = false;
  213.     }
  214.     return config;
  215.   }
  217.   /**
  218.    * @override
  219.    */
  220.   supportsOfflineStorage() {
  221.     return !!window.indexedDB;
  222.   }
  224.   /**
  225.    * @override
  226.    */
  227.   rejectCodecs() {
  228.     return [];
  229.   }
  231.   /**
  232.    * @override
  233.    */
  234.   getHdrLevel(preferHLG) {
  235.     if (window.matchMedia !== undefined &&
  236.         window.matchMedia('(color-gamut: p3)').matches) {
  237.       return preferHLG ? 'HLG' : 'PQ';
  238.     }
  239.     return 'SDR';
  240.   }
  242.   /**
  243.    * @override
  244.    */
  245.   supportsAirPlay() {
  246.     return false;
  247.   }
  249.   /**
  250.    * @override
  251.    */
  252.   misreportAC3UsingDrm() {
  253.     return false;
  254.   }
  256.   /**
  257.    * @override
  258.    */
  259.   returnLittleEndianUsingPlayReady() {
  260.     return false;
  261.   }
  263.   /**
  264.    * @override
  265.    */
  266.   supportsEncryptionSchemePolyfill() {
  267.     return true;
  268.   }
  270.   /**
  271.    * @override
  272.    */
  273.   misreportsSupportForPersistentLicenses() {
  274.     return false;
  275.   }
  277.   /**
  278.    * @override
  279.    */
  280.   supportStandardVP9Checking() {
  281.     return true;
  282.   }
  284.   /**
  285.    * @override
  286.    */
  287.   createMediaKeysWhenCheckingSupport() {
  288.     return true;
  289.   }
  291.   /**
  292.    * @override
  293.    */
  294.   disableHEVCSupport() {
  295.     return false;
  296.   }
  298.   /**
  299.    * @override
  300.    */
  301.   toString() {
  302.     return `Device: ${this.getDeviceName()} v${this.getVersion()}; ` +
  303.         `Type: ${this.getDeviceType()}`;
  304.   }
  305. };