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.       const vrKeywords = [
  23.         // General Oculus devices
  24.         'Oculus',
  25.         // Quest devices
  26.         'Quest',
  27.       ];
  28.       const isVr = vrKeywords.some((keyword) => {
  29.         return navigator.userAgent.includes(keyword.toLowerCase());
  30.       });
  31.       if (isVr) {
  32.         return shaka.device.IDevice.DeviceType.VR;
  33.       }
  34.       if (navigator.userAgent.match(/Smart( ?|_)TV/i) ||
  35.           navigator.userAgent.match(/Android ?TV/i)) {
  36.         return shaka.device.IDevice.DeviceType.TV;
  37.       }
  38.       if (navigator.userAgentData) {
  39.         if (navigator.userAgentData.mobile) {
  40.           return shaka.device.IDevice.DeviceType.MOBILE;
  41.         } else {
  42.           return shaka.device.IDevice.DeviceType.DESKTOP;
  43.         }
  44.       }
  45.       if (/(?:iPhone|iPad|iPod)/.test(navigator.userAgent)) {
  46.         return shaka.device.IDevice.DeviceType.MOBILE;
  47.       }
  48.       if (navigator.userAgentData && navigator.userAgentData.platform) {
  49.         if (navigator.userAgentData.platform.toLowerCase() == 'android') {
  50.           return shaka.device.IDevice.DeviceType.MOBILE;
  51.         } else {
  52.           return shaka.device.IDevice.DeviceType.DESKTOP;
  53.         }
  54.       }
  55.       if (navigator.userAgent.includes('Android')) {
  56.         return shaka.device.IDevice.DeviceType.MOBILE;
  57.       }
  58.       return shaka.device.IDevice.DeviceType.DESKTOP;
  59.     });
  61.     /** @private {!shaka.util.Lazy<shaka.device.IDevice.BrowserEngine>} */
  62.     this.browserEngine_ = new shaka.util.Lazy(() => {
  63.       if (navigator.vendor.includes('Apple') &&
  64.           (navigator.userAgent.includes('Version/') ||
  65.           navigator.userAgent.includes('OS/'))) {
  66.         return shaka.device.IDevice.BrowserEngine.WEBKIT;
  67.       }
  68.       if (navigator.userAgent.includes('Edge/')) {
  69.         return shaka.device.IDevice.BrowserEngine.EDGE;
  70.       }
  71.       if (navigator.userAgent.includes('Chrome/')) {
  72.         return shaka.device.IDevice.BrowserEngine.CHROMIUM;
  73.       }
  74.       if (navigator.userAgent.includes('Firefox/')) {
  75.         return shaka.device.IDevice.BrowserEngine.GECKO;
  76.       }
  77.       return shaka.device.IDevice.BrowserEngine.UNKNOWN;
  78.     });
  79.   }
  81.   /**
  82.    * @override
  83.    */
  84.   supportsMediaSource() {
  85.     const mediaSource = window.ManagedMediaSource || window.MediaSource;
  86.     // Browsers that lack a media source implementation will have no reference
  87.     // to |window.MediaSource|. Platforms that we see having problematic media
  88.     // source implementations will have this reference removed via a polyfill.
  89.     if (!mediaSource) {
  90.       return false;
  91.     }
  93.     // Some very old MediaSource implementations didn't have isTypeSupported.
  94.     if (!mediaSource.isTypeSupported) {
  95.       return false;
  96.     }
  98.     return true;
  99.   }
  101.   /**
  102.    * @override
  103.    */
  104.   supportsMediaType(mimeType) {
  105.     const video = shaka.util.Dom.anyMediaElement();
  106.     return video.canPlayType(mimeType) != '';
  107.   }
  109.   /**
  110.    * @override
  111.    */
  112.   supportsMediaCapabilities() {
  113.     return !!navigator.mediaCapabilities;
  114.   }
  116.   /**
  117.    * @override
  118.    */
  119.   getDeviceType() {
  120.     return this.abstractDeviceType_.value();
  121.   }
  123.   /**
  124.    * @override
  125.    */
  126.   getBrowserEngine() {
  127.     return this.browserEngine_.value();
  128.   }
  130.   /**
  131.    * @override
  132.    */
  133.   requiresEncryptionInfoInAllInitSegments(keySystem, contentType) {
  134.     return false;
  135.   }
  137.   /**
  138.    * @override
  139.    */
  140.   requiresClearAndEncryptedInitSegments() {
  141.     return false;
  142.   }
  144.   /**
  145.    * @override
  146.    */
  147.   insertEncryptionDataBeforeClear() {
  148.     return false;
  149.   }
  151.   /**
  152.    * @override
  153.    */
  154.   requiresTfhdFix(contentType) {
  155.     return false;
  156.   }
  158.   /**
  159.    * @override
  160.    */
  161.   requiresEC3InitSegments() {
  162.     return false;
  163.   }
  165.   /**
  166.    * @override
  167.    */
  168.   supportsSequenceMode() {
  169.     return true;
  170.   }
  172.   /**
  173.    * @override
  174.    */
  175.   supportsSmoothCodecSwitching() {
  176.     return true;
  177.   }
  179.   /**
  180.    * @override
  181.    */
  182.   supportsServerCertificate() {
  183.     return true;
  184.   }
  186.   /**
  187.    * @override
  188.    */
  189.   seekDelay() {
  190.     return 0;
  191.   }
  193.   /**
  194.    * @override
  195.    */
  196.   detectMaxHardwareResolution() {
  197.     return Promise.resolve({width: Infinity, height: Infinity});
  198.   }
  200.   /**
  201.    * @override
  202.    */
  203.   shouldOverrideDolbyVisionCodecs() {
  204.     return false;
  205.   }
  207.   /**
  208.    * @override
  209.    */
  210.   shouldAvoidUseTextDecoderEncoder() {
  211.     return false;
  212.   }
  214.   /**
  215.    * @override
  216.    */
  217.   adjustConfig(config) {
  218.     const deviceType = this.getDeviceType();
  219.     if (deviceType === shaka.device.IDevice.DeviceType.TV ||
  220.         deviceType === shaka.device.IDevice.DeviceType.CONSOLE ||
  221.         deviceType === shaka.device.IDevice.DeviceType.CAST) {
  222.       config.ads.customPlayheadTracker = true;
  223.       config.ads.skipPlayDetection = true;
  224.       config.ads.supportsMultipleMediaElements = false;
  225.     }
  226.     return config;
  227.   }
  229.   /**
  230.    * @override
  231.    */
  232.   supportsOfflineStorage() {
  233.     return !!window.indexedDB;
  234.   }
  236.   /**
  237.    * @override
  238.    */
  239.   rejectCodecs() {
  240.     return [];
  241.   }
  243.   /**
  244.    * @override
  245.    */
  246.   getHdrLevel(preferHLG) {
  247.     if (window.matchMedia !== undefined &&
  248.         window.matchMedia('(color-gamut: p3)').matches) {
  249.       return preferHLG ? 'HLG' : 'PQ';
  250.     }
  251.     return 'SDR';
  252.   }
  254.   /**
  255.    * @override
  256.    */
  257.   supportsAirPlay() {
  258.     return false;
  259.   }
  261.   /**
  262.    * @override
  263.    */
  264.   misreportAC3UsingDrm() {
  265.     return false;
  266.   }
  268.   /**
  269.    * @override
  270.    */
  271.   returnLittleEndianUsingPlayReady() {
  272.     return false;
  273.   }
  275.   /**
  276.    * @override
  277.    */
  278.   supportsEncryptionSchemePolyfill() {
  279.     return true;
  280.   }
  282.   /**
  283.    * @override
  284.    */
  285.   misreportsSupportForPersistentLicenses() {
  286.     return false;
  287.   }
  289.   /**
  290.    * @override
  291.    */
  292.   supportStandardVP9Checking() {
  293.     return true;
  294.   }
  296.   /**
  297.    * @override
  298.    */
  299.   createMediaKeysWhenCheckingSupport() {
  300.     return true;
  301.   }
  303.   /**
  304.    * @override
  305.    */
  306.   disableHEVCSupport() {
  307.     return false;
  308.   }
  310.   /**
  311.    * @override
  312.    */
  313.   toString() {
  314.     return `Device: ${this.getDeviceName()} v${this.getVersion()}; ` +
  315.         `Type: ${this.getDeviceType()}`;
  316.   }
  317. };