shaka-player 4.6.4 → 4.7.0

package/CODE_OF_CONDUCT.md

@@ -1,93 +0,0 @@
-# Code of Conduct
-
-## Our Pledge
-
-In the interest of fostering an open and welcoming environment, we as
-contributors and maintainers pledge to making participation in our project and
-our community a harassment-free experience for everyone, regardless of age, body
-size, disability, ethnicity, gender identity and expression, level of
-experience, education, socio-economic status, nationality, personal appearance,
-race, religion, or sexual identity and orientation.
-
-## Our Standards
-
-Examples of behavior that contributes to creating a positive environment
-include:
-
-*   Using welcoming and inclusive language
-*   Being respectful of differing viewpoints and experiences
-*   Gracefully accepting constructive criticism
-*   Focusing on what is best for the community
-*   Showing empathy towards other community members
-
-Examples of unacceptable behavior by participants include:
-
-*   The use of sexualized language or imagery and unwelcome sexual attention or
-    advances
-*   Trolling, insulting/derogatory comments, and personal or political attacks
-*   Public or private harassment
-*   Publishing others' private information, such as a physical or electronic
-    address, without explicit permission
-*   Other conduct which could reasonably be considered inappropriate in a
-    professional setting
-
-## Our Responsibilities
-
-Project maintainers are responsible for clarifying the standards of acceptable
-behavior and are expected to take appropriate and fair corrective action in
-response to any instances of unacceptable behavior.
-
-Project maintainers have the right and responsibility to remove, edit, or reject
-comments, commits, code, wiki edits, issues, and other contributions that are
-not aligned to this Code of Conduct, or to ban temporarily or permanently any
-contributor for other behaviors that they deem inappropriate, threatening,
-offensive, or harmful.
-
-## Scope
-
-This Code of Conduct applies both within project spaces and in public spaces
-when an individual is representing the project or its community. Examples of
-representing a project or community include using an official project e-mail
-address, posting via an official social media account, or acting as an appointed
-representative at an online or offline event. Representation of a project may be
-further defined and clarified by project maintainers.
-
-This Code of Conduct also applies outside the project spaces when the Project
-Steward has a reasonable belief that an individual's behavior may have a
-negative impact on the project or its community.
-
-## Conflict Resolution
-
-We do not believe that all conflict is bad; healthy debate and disagreement
-often yield positive results. However, it is never okay to be disrespectful or
-to engage in behavior that violates the project’s code of conduct.
-
-If you see someone violating the code of conduct, you are encouraged to address
-the behavior directly with those involved. Many issues can be resolved quickly
-and easily, and this gives people more control over the outcome of their
-dispute. If you are unable to resolve the matter for any reason, or if the
-behavior is threatening or harassing, report it. We are dedicated to providing
-an environment where participants feel welcome and safe.
-
-Reports should be directed to *shaka-player-maintainers@googlegroups.com*, the
-Project Steward(s) for *Shaka Player*. It is the Project Steward’s duty to
-receive and address reported violations of the code of conduct. They will then
-work with a committee consisting of representatives from the Open Source
-Programs Office and the Google Open Source Strategy team. If for any reason you
-are uncomfortable reaching out to the Project Steward, please email
-opensource@google.com.
-
-We will investigate every complaint, but you may not receive a direct response.
-We will use our discretion in determining when and how to follow up on reported
-incidents, which may range from not taking action to permanent expulsion from
-the project and project-sponsored spaces. We will notify the accused of the
-report and provide them an opportunity to discuss it before any action is taken.
-The identity of the reporter will be omitted from the details of the report
-supplied to the accused. In potentially harmful situations, such as ongoing
-harassment or threats to anyone's safety, we may take action without notice.
-
-## Attribution
-
-This Code of Conduct is adapted from the Contributor Covenant, version 1.4,
-available at
-https://www.contributor-covenant.org/version/1/4/code-of-conduct.html

package/CONTRIBUTING.md

@@ -1,76 +0,0 @@
-# How to contribute #
-
-We'd love to accept your patches and contributions to this project.  There are
-just a few small guidelines you need to follow.
-
-1. File a bug at https://github.com/shaka-project/shaka-player/issues (if there
-   isn't one already).  If your patch is going to be large, you should start a
-   discussion on GitHub first.
-
-   Leave a comment to let us know that you are working on a PR for the issue.
-   We'll assign the issue to you.
-
-2. For legal reasons, all contributors must sign a Contributor License
-   Agreement, either for an individual or corporation, before a patch can be
-   accepted.  (See below.)
-
-3. Follow the normal process of [forking][] the project, and setup a new
-   branch to work in.  It's important that each group of changes be done in
-   separate branches in order to ensure that a pull request only includes the
-   commits related to that bug or feature.
-
-4. Add an entry to the [AUTHORS][] and [CONTRIBUTORS][] files with your name
-   and email.  For corporate contributions, AUTHORS should contain an entry
-   for your company.
-
-5. Do your best to have [well-formed commit messages][] for each change.
-   This provides consistency throughout the project, and ensures that commit
-   messages are able to be formatted properly by various git tools.
-
-6. Add or modify unit or integration tests for any new or modified
-   functionality in your patch.  For bug fixes, try to write a regression test
-   that fails without your patch and passes with it. Our tests are written with
-   [Jasmine](https://jasmine.github.io/).
-
-7. Test all changes in both the compiler and linter with:
-```sh
-   python build/all.py
-```
-   Patches that do not compile or pass linter checks will not be accepted.
-
-8. Test all changes in the unit and integration tests with:
-```sh
-   python build/test.py
-```
-   Patches that do not pass unit and integration tests will not be accepted.
-
-9. Finally, push the commits to your fork and submit a [pull request][].
-
-[forking]: https://help.github.com/articles/fork-a-repo
-[AUTHORS]: AUTHORS
-[CONTRIBUTORS]: CONTRIBUTORS
-[well-formed commit messages]: http://tbaggery.com/2008/04/19/a-note-about-git-commit-messages.html
-[pull request]: https://help.github.com/articles/creating-a-pull-request
-
-
-## Contributor License Agreement ##
-
-Contributions to any Google project must be accompanied by a Contributor
-License Agreement.  This is not a copyright **assignment**, it simply gives
-Google permission to use and redistribute your contributions as part of the
-project.
-
-  * If you are an individual writing original source code and you're sure you
-    own the intellectual property, then you'll need to sign an [individual
-    CLA][].
-
-  * If you work for a company that wants to allow you to contribute your work,
-    then you'll need to sign a [corporate CLA][].
-
-You generally only need to submit a CLA once, so if you've already submitted
-one (even if it was for a different project), you probably don't need to do it
-again.
-
-[individual CLA]: https://developers.google.com/open-source/cla/individual
-[corporate CLA]: https://developers.google.com/open-source/cla/corporate
-

package/demo/app_manifest.json

@@ -1,29 +0,0 @@
-{
-  "name": "Shaka Player Demo",
-  "short_name": "Shaka Player",
-  "icons": [{
-      "src": "app_logo_144.png",
-      "sizes": "144x144",
-      "type": "image/png"
-    }, {
-      "src": "app_logo_192.png",
-      "sizes": "192x192",
-      "type": "image/png"
-    }, {
-      "src": "app_logo_256.png",
-      "sizes": "256x256",
-      "type": "image/png"
-    }, {
-      "src": "app_logo_384.png",
-      "sizes": "384x384",
-      "type": "image/png"
-    }, {
-      "src": "app_logo_512.png",
-      "sizes": "512x512",
-      "type": "image/png"
-    }],
-  "start_url": "./#build=compiled",
-  "display": "standalone",
-  "background_color": "#FFFFFF",
-  "theme_color": "#2F3BA2"
-}

package/demo/asset_card.js

@@ -1,410 +0,0 @@
-/*! @license
- * Shaka Player
- * Copyright 2016 Google LLC
- * SPDX-License-Identifier: Apache-2.0
- */
-
-goog.provide('shakaDemo.AssetCard');
-
-goog.require('goog.asserts');
-goog.require('shakaAssets');
-goog.require('shakaDemo.Tooltips');
-goog.requireType('ShakaDemoAssetInfo');
-
-/**
- * Creates and contains an MDL card that presents info about the given asset.
- * @final
- */
-shakaDemo.AssetCard = class {
-  /**
-   * @param {!Element} parentDiv
-   * @param {!ShakaDemoAssetInfo} asset
-   * @param {boolean} isFeatured True if this card should use the "featured"
-   *   style, which use the asset's short name and have descriptions.
-   * @param {function(!shakaDemo.AssetCard)} remakeButtonsFn
-   */
-  constructor(parentDiv, asset, isFeatured, remakeButtonsFn) {
-    /** @private {!Element} */
-    this.card_ = document.createElement('div');
-    /** @private {!ShakaDemoAssetInfo} */
-    this.asset_ = asset;
-    /** @private {!Element} */
-    this.actions_ = document.createElement('div');
-    /** @private {!Element} */
-    this.featureIconsContainer_ = document.createElement('div');
-    /** @private {!Element} */
-    this.progressCircle_ = document.createElement('div');
-    const svgns = 'http://www.w3.org/2000/svg';
-    /** @private {!Element} */
-    this.progressCircleSvg_ = document.createElementNS(svgns, 'svg');
-    /** @private {!Element} */
-    this.progressCircleBack_ = document.createElementNS(svgns, 'circle');
-    /** @private {!Element} */
-    this.progressCircleBar_ = document.createElementNS(svgns, 'circle');
-    /** @private {function(!shakaDemo.AssetCard)} */
-    this.remakeButtonsFn_ = remakeButtonsFn;
-
-    // Lay out the card.
-    this.card_.classList.add('mdl-card-wide');
-    this.card_.classList.add('mdl-card');
-    this.card_.classList.add('mdl-shadow--2dp');
-    this.card_.classList.add('asset-card');
-
-    const titleDiv = document.createElement('div');
-    titleDiv.classList.add('mdl-card__title');
-    this.card_.appendChild(titleDiv);
-    const titleText = document.createElement('h2');
-    titleText.classList.add('mdl-card__title-text');
-    titleText.textContent =
-        isFeatured ? (asset.shortName || asset.name) : asset.name;
-    titleDiv.appendChild(titleText);
-
-    if (asset.iconUri) {
-      const picture = document.createElement('picture');
-
-      const webpSource =
-        /** @type {!HTMLSourceElement} */(document.createElement('source'));
-      webpSource.srcset = asset.iconUri.replace(/.png$/, '.webp');
-      webpSource.type = 'image/webp';
-
-      const pngSource =
-        /** @type {!HTMLSourceElement} */(document.createElement('source'));
-      pngSource.srcset = asset.iconUri;
-      pngSource.type = 'image/png';
-
-      const img =
-        /** @type {!HTMLImageElement} */(document.createElement('img'));
-      img.src = asset.iconUri;
-      img.alt = '';  // Not necessary to understand the page
-
-      picture.appendChild(webpSource);
-      picture.appendChild(pngSource);
-      picture.appendChild(img);
-
-      this.card_.appendChild(picture);
-    }
-
-    if (asset.description && isFeatured) {
-      const supportingText = document.createElement('div');
-      supportingText.classList.add('mdl-card__supporting-text');
-      supportingText.textContent = asset.description;
-      this.card_.appendChild(supportingText);
-    }
-
-    this.card_.appendChild(this.featureIconsContainer_);
-    this.addFeatureIcons_(asset);
-
-    this.actions_.classList.add('mdl-card__actions');
-    this.actions_.classList.add('mdl-card--border');
-    this.card_.appendChild(this.actions_);
-
-    this.progressCircle_.classList.add('hidden');
-    this.progressCircle_.classList.add('progress-circle');
-    this.card_.appendChild(this.progressCircle_);
-    this.progressCircleSvg_.appendChild(this.progressCircleBack_);
-    this.progressCircleSvg_.appendChild(this.progressCircleBar_);
-    this.progressCircle_.appendChild(this.progressCircleSvg_);
-    this.progressCircleSvg_.classList.add('progress-circle-svg');
-    this.progressCircleBack_.classList.add('progress-circle-back');
-    this.progressCircleBar_.classList.add('progress-circle-bar');
-
-    parentDiv.appendChild(this.card_);
-    // Remake buttons AFTER appending to parent div, so that any tooltips can
-    // be placed.
-    this.remakeButtons();
-  }
-
-  /**
-   * @param {number} progress
-   * @private
-   */
-  styleProgressCircle_(progress) {
-    const svg = this.progressCircleSvg_;
-    const bar = this.progressCircleBar_;
-    const circleSize = 45;
-    const circleThickness = 5;
-    const circleRadius = (circleSize - circleThickness) / 2;
-    const circumference = 2 * Math.PI * circleRadius;
-
-    svg.setAttribute('viewBox', '0 0 ' + circleSize + ' ' + circleSize);
-    bar.setAttribute('stroke-dasharray', circumference);
-    bar.setAttribute('stroke-dashoffset', (circumference * (1 - progress)));
-  }
-
-  /**
-   * @param {string} icon
-   * @param {string} title
-   * @private
-   */
-  addFeatureIcon_(icon, title) {
-    const iconDiv = document.createElement('div');
-    iconDiv.classList.add('feature-icon');
-    iconDiv.setAttribute('icon', icon);
-    this.featureIconsContainer_.appendChild(iconDiv);
-
-    shakaDemo.Tooltips.make(iconDiv, title);
-  }
-
-  /**
-   * @param {!ShakaDemoAssetInfo} asset
-   * @private
-   */
-  addFeatureIcons_(asset) {
-    const Feature = shakaAssets.Feature;
-    const KeySystem = shakaAssets.KeySystem;
-
-    const icons = new Map()
-        .set(Feature.SUBTITLES, 'subtitles')
-        .set(Feature.CAPTIONS, 'closed_caption')
-        .set(Feature.LIVE, 'live')
-        .set(Feature.TRICK_MODE, 'trick_mode')
-        .set(Feature.HIGH_DEFINITION, 'high_definition')
-        .set(Feature.ULTRA_HIGH_DEFINITION, 'ultra_high_definition')
-        .set(Feature.SURROUND, 'surround_sound')
-        .set(Feature.MULTIPLE_LANGUAGES, 'multiple_languages')
-        .set(Feature.ADS, 'ad')
-        .set(Feature.AUDIO_ONLY, 'audio_only');
-
-    for (const feature of asset.features) {
-      const icon = icons.get(feature);
-      if (icon) {
-        this.addFeatureIcon_(icon, feature);
-      }
-    }
-
-    for (const drm of asset.drm) {
-      switch (drm) {
-        case KeySystem.WIDEVINE:
-          this.addFeatureIcon_('widevine', drm);
-          break;
-        case KeySystem.CLEAR_KEY:
-          this.addFeatureIcon_('clear_key', drm);
-          break;
-        case KeySystem.PLAYREADY:
-          this.addFeatureIcon_('playready', drm);
-          break;
-      }
-    }
-  }
-
-  /**
-   * Modify an asset to make it clear that it is unsupported.
-   * @param {string} unsupportedReason
-   */
-  markAsUnsupported(unsupportedReason) {
-    this.card_.classList.add('asset-card-unsupported');
-    this.makeUnsupportedButton_('Not Available', unsupportedReason);
-  }
-
-  /**
-   * Make a button that represents the lack of a working button.
-   * @param {?string} buttonName
-   * @param {string} unsupportedReason
-   * @return {!Element}
-   * @private
-   */
-  makeUnsupportedButton_(buttonName, unsupportedReason) {
-    const button = this.addButton(buttonName, () => {});
-    button.setAttribute('disabled', '');
-
-    // Tooltips don't work on disabled buttons (on some platforms), so
-    // the button itself has to be "uprooted" and placed in a synthetic div
-    // specifically to attach the tooltip to.
-    const attachPoint = document.createElement('div');
-    if (button.parentElement) {
-      button.parentElement.removeChild(button);
-    }
-    attachPoint.classList.add('tooltip-attach-point');
-    attachPoint.appendChild(button);
-    this.actions_.appendChild(attachPoint);
-    shakaDemo.Tooltips.make(attachPoint, unsupportedReason);
-
-    return button;
-  }
-
-  /**
-   * Select this card if the card's asset matches |asset|.
-   * Used to simplify the implementation of "shaka-main-selected-asset-changed"
-   * handlers.
-   * @param {ShakaDemoAssetInfo} asset
-   */
-  selectByAsset(asset) {
-    this.card_.classList.remove('selected');
-    if (this.asset_ == asset) {
-      this.card_.classList.add('selected');
-    }
-  }
-
-  /** Remake the buttons of the card. */
-  remakeButtons() {
-    shaka.util.Dom.removeAllChildren(this.actions_);
-    this.remakeButtonsFn_(this);
-  }
-
-  /**
-   * Adds a button to the bottom of the card that controls storage behavior.
-   * This is a separate function because it involves a significant amount of
-   * custom behavior, such as the download bar.
-   */
-  addStoreButton() {
-    /**
-     * Makes the contents of the button into an MDL icon, and moves it into the
-     * upper-righthand corner with CSS styles.
-     * @param {!Element} button
-     * @param {!Element} attachPoint If there is no attach point, just pass the
-     *  button in here.
-     * @param {string} iconText
-     */
-    const styleAsDownloadButton = (button, attachPoint, iconText) => {
-      attachPoint.classList.add('asset-card-corner-button');
-      const icon = document.createElement('i');
-      icon.textContent = iconText;
-      icon.classList.add('material-icons-round');
-      button.appendChild(icon);
-    };
-
-    const unsupportedReason = shakaDemoMain.getAssetUnsupportedReason(
-        this.asset_, /* needOffline= */ true);
-    if (!unsupportedReason) {
-      goog.asserts.assert(this.asset_.storeCallback,
-          'A storage callback is expected for all supported assets!');
-    }
-    if (unsupportedReason) {
-      // This can't be stored.
-      const button = this.makeUnsupportedButton_(null, unsupportedReason);
-      // As this is a unsupported button, it is wrapped in an "attach point";
-      // that is the element this has to move with CSS, otherwise the tooltip
-      // will end up coming out of the wrong place.
-      const attachPoint = button.parentElement || button;
-      styleAsDownloadButton(button, attachPoint, 'get_app');
-      return;
-    }
-    if (this.asset_.isStored()) {
-      const deleteButton = this.addButton(null, () => {
-        this.attachDeleteDialog_(deleteButton);
-      });
-      styleAsDownloadButton(deleteButton, deleteButton, 'offline_pin');
-    } else {
-      const downloadButton = this.addButton(null, async () => {
-        downloadButton.disabled = true;
-        await this.asset_.storeCallback();
-        this.remakeButtons();
-      });
-      styleAsDownloadButton(downloadButton, downloadButton, 'get_app');
-    }
-  }
-
-  /**
-   * @param {!HTMLButtonElement} deleteButton
-   * @private
-   */
-  attachDeleteDialog_(deleteButton) {
-    const parentDiv = this.card_.parentElement;
-    if (!parentDiv) {
-      return;
-    }
-
-    this.makeYesNoDialogue_(parentDiv, 'Delete the offline copy?', async () => {
-      deleteButton.disabled = true;
-      await this.asset_.unstoreCallback();
-    });
-  }
-
-  /**
-   * @param {!Element} parentDiv
-   * @param {string} text
-   * @param {function():Promise} callback
-   * @private
-   */
-  makeYesNoDialogue_(parentDiv, text, callback) {
-    const dialog =
-      /** @type {!HTMLDialogElement} */(document.createElement('dialog'));
-    dialog.classList.add('mdl-dialog');
-    parentDiv.appendChild(dialog);
-    if (!dialog.showModal) {
-      dialogPolyfill.registerDialog(dialog);
-    }
-
-    const textElement = document.createElement('h2');
-    textElement.classList.add('mdl-typography--title');
-    textElement.textContent = text;
-    dialog.appendChild(textElement);
-
-    const buttonsDiv = document.createElement('div');
-    dialog.appendChild(buttonsDiv);
-    const makeButton = (text, fn) => {
-      const button = document.createElement('button');
-      button.textContent = text;
-      button.classList.add('mdl-button');
-      button.classList.add('mdl-button--colored');
-      button.classList.add('mdl-js-button');
-      button.classList.add('mdl-js-ripple-effect');
-      button.addEventListener('click', () => {
-        fn();
-      });
-      buttonsDiv.appendChild(button);
-      button.blur();
-    };
-    makeButton('Yes', async () => {
-      dialog.close();
-      await callback();
-      this.remakeButtons();
-    });
-    makeButton('No', () => {
-      dialog.close();
-    });
-
-    dialog.showModal();
-  }
-
-  /**
-   * Updates the progress bar on the card.
-   */
-  updateProgress() {
-    if (this.asset_.storedProgress < 1) {
-      this.progressCircle_.classList.remove('hidden');
-      for (const button of this.actions_.childNodes) {
-        if (button instanceof HTMLButtonElement) {
-          button.disabled = true;
-        }
-      }
-    } else {
-      this.progressCircle_.classList.add('hidden');
-      for (const button of this.actions_.childNodes) {
-        if (button instanceof HTMLButtonElement) {
-          button.disabled = false;
-        }
-      }
-    }
-    this.styleProgressCircle_(this.asset_.storedProgress);
-  }
-
-  /**
-   * Adds a button to the bottom of the card that will call |onClick| when
-   * clicked. For example, a play or delete button.
-   * @param {?string} name
-   * @param {function()} onclick
-   * @param {string=} yesNoDialogText
-   * @return {!HTMLButtonElement}
-   */
-  addButton(name, onclick, yesNoDialogText) {
-    const button =
-      /** @type {!HTMLButtonElement} */(document.createElement('button'));
-    button.classList.add('mdl-button');
-    button.classList.add('mdl-button--colored');
-    button.classList.add('mdl-js-button');
-    button.classList.add('mdl-js-ripple-effect');
-    button.textContent = name || '';
-    button.addEventListener('click', () => {
-      if (!button.hasAttribute('disabled')) {
-        if (yesNoDialogText) {
-          this.makeYesNoDialogue_(this.actions_, yesNoDialogText, onclick);
-        } else {
-          onclick();
-        }
-      }
-    });
-    this.actions_.appendChild(button);
-    return button;
-  }
-};

package/demo/autoTemplate.txt

@@ -1,61 +0,0 @@
-**Have you read the [FAQ](https://bit.ly/ShakaFAQ) and checked for duplicate open issues?**
-
-
-**If the problem is related to FairPlay, have you read the tutorial?**
-<!-- NOTE: https://shaka-player-demo.appspot.com/docs/api/tutorial-fairplay.html -->
-
-
-**What version of Shaka Player are you using?**
-`RE:player`
-<!-- NOTE:
-  Only some versions of the application are maintained, if your version
-  is older, first update to a newer one. See:
-  https://github.com/shaka-project/shaka-player/blob/main/maintained-branches.md
---->
-
-
-**Can you reproduce the issue with our latest release version?**
-
-
-**Can you reproduce the issue with the latest code from `main`?**
-
-
-**Are you using the demo app or your own custom app?**
-The demo
-
-
-**If custom app, can you reproduce the issue using our demo app?**
-N/A
-
-
-**What browser and OS are you using?**
-`RE:browser`
-
-
-**For embedded devices (smart TVs, etc.), what model and firmware version are you using?**
-N/A
-
-
-**What are the manifest and license server URIs?**
-RE:customwarning
-RE:uris
-
-
-**What configuration are you using?  What is the output of `player.getConfiguration()`?**
-<!-- NOTE:
-  You can censor URLs to keep them private, but include them in the email.  You
-  can also use JSON.stringify(obj, null, 2) to print nicely on platforms that
-  don't print objects well in the console.  DON'T SEND '[object Object]'!
--->
-
-
-**What did you do?**
-<!-- Steps to reproduce the bug -->
-
-
-**What did you expect to happen?**
-
-
-**What actually happened?**
-<!-- A clear and concise description of what the bug is -->
-<!-- If applicable, you may add screenshots to help explain your problem. -->