npm - speaker-calibration - Versions diffs - 2.0.0 → 2.1.0 - Mend

speaker-calibration 2.0.0 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (126) hide show

package/.eslintignore +72 -0
package/.eslintrc.json +40 -0
package/.gitignore +78 -0
package/.prettierignore +70 -0
package/.prettierrc +15 -0
package/LICENSE +20 -20
package/README.md +133 -133
package/__mocks__/fileMock.js +1 -0
package/__mocks__/styleMock.js +1 -0
package/babel.config.js +3 -0
package/coverage/clover.xml +71 -0
package/coverage/coverage-final.json +224 -0
package/coverage/lcov-report/PythonServerInterface.js.html +265 -0
package/coverage/lcov-report/base.css +354 -0
package/coverage/lcov-report/block-navigation.js +82 -0
package/coverage/lcov-report/favicon.png +0 -0
package/coverage/lcov-report/index.html +123 -0
package/coverage/lcov-report/prettify.css +101 -0
package/coverage/lcov-report/prettify.js +937 -0
package/coverage/lcov-report/sort-arrow-sprite.png +0 -0
package/coverage/lcov-report/sorter.js +189 -0
package/coverage/lcov-report/src/index.html +121 -0
package/coverage/lcov-report/src/server/PythonServerInterface.js.html +268 -0
package/coverage/lcov-report/src/server/index.html +123 -0
package/coverage/lcov-report/src/tasks/audioCalibrator.js.html +499 -0
package/coverage/lcov-report/src/tasks/audioRecorder.js.html +412 -0
package/coverage/lcov-report/src/tasks/index.html +143 -0
package/coverage/lcov-report/src/tasks/volume/index.html +123 -0
package/coverage/lcov-report/src/tasks/volume/volume.js.html +409 -0
package/coverage/lcov-report/src/utils.js.html +172 -0
package/coverage/lcov.info +91 -0
package/dist/example/Queen-Bohemian_Rhapsody.wav +0 -0
package/dist/example/Queen-Bohemian_Rhapsody_g_filtered.wav +0 -0
package/dist/example/index.html +47 -0
package/dist/example/listener.html +89 -0
package/dist/example/server.js +49 -0
package/dist/example/speaker.html +126 -0
package/dist/example/speakerUI.js +217 -0
package/dist/example/styles.css +40 -0
package/dist/main.js +1 -1
package/dist/mlsGen.js +6814 -6814
package/dist/mlsGen.wasm +0 -0
package/doc/AudioCalibrator.html +417 -0
package/doc/AudioPeer.html +251 -0
package/doc/AudioRecorder.html +195 -0
package/doc/ImpulseResponse.html +215 -0
package/doc/Listener.html +308 -0
package/doc/MlsGenInterface.html +226 -0
package/doc/MyEventEmitter.html +274 -0
package/doc/PythonServerAPI.html +109 -0
package/doc/Speaker-Calibration-UML-Diagram.png +0 -0
package/doc/Speaker.html +276 -0
package/doc/Takes%20a%20target%20element%20where%20html%20elements%20will%20be%20appended..html +128 -0
package/doc/Takes%20the%20url%20of%20the%20current%20site%0Aand%20a%20target%20element%20where%20html%20elements%20will%20be%20appended..html +138 -0
package/doc/Takes%20the%20url%20of%20the%20current%20site%20and%20a%20target%20element%20where%20html%20elements%20will%20be%20appended..html +137 -0
package/doc/Volume.html +88 -0
package/doc/audioCalibrator.js.html +179 -0
package/doc/audioPeer.js.html +175 -0
package/doc/audioRecorder.js.html +163 -0
package/doc/creates%20a%20new%20AudioRecorder%20instance.%20%0ASets%20up%20the%20audio%20context%20and%20file%20reader..html +114 -0
package/doc/fonts/OpenSans-Bold-webfont.eot +0 -0
package/doc/fonts/OpenSans-Bold-webfont.svg +1830 -0
package/doc/fonts/OpenSans-Bold-webfont.woff +0 -0
package/doc/fonts/OpenSans-BoldItalic-webfont.eot +0 -0
package/doc/fonts/OpenSans-BoldItalic-webfont.svg +1830 -0
package/doc/fonts/OpenSans-BoldItalic-webfont.woff +0 -0
package/doc/fonts/OpenSans-Italic-webfont.eot +0 -0
package/doc/fonts/OpenSans-Italic-webfont.svg +1830 -0
package/doc/fonts/OpenSans-Italic-webfont.woff +0 -0
package/doc/fonts/OpenSans-Light-webfont.eot +0 -0
package/doc/fonts/OpenSans-Light-webfont.svg +1831 -0
package/doc/fonts/OpenSans-Light-webfont.woff +0 -0
package/doc/fonts/OpenSans-LightItalic-webfont.eot +0 -0
package/doc/fonts/OpenSans-LightItalic-webfont.svg +1835 -0
package/doc/fonts/OpenSans-LightItalic-webfont.woff +0 -0
package/doc/fonts/OpenSans-Regular-webfont.eot +0 -0
package/doc/fonts/OpenSans-Regular-webfont.svg +1831 -0
package/doc/fonts/OpenSans-Regular-webfont.woff +0 -0
package/doc/global.html +308 -0
package/doc/index.html +58 -0
package/doc/listener.js.html +170 -0
package/doc/mlsGen_mlsGenInterface.js.html +117 -0
package/doc/myEventEmitter.js.html +124 -0
package/doc/peer-connection_audioPeer.js.html +188 -0
package/doc/peer-connection_listener.js.html +311 -0
package/doc/peer-connection_speaker.js.html +381 -0
package/doc/sc-activity-diagram.png +0 -0
package/doc/scripts/linenumber.js +25 -0
package/doc/scripts/prettify/Apache-License-2.0.txt +202 -0
package/doc/scripts/prettify/lang-css.js +24 -0
package/doc/scripts/prettify/prettify.js +640 -0
package/doc/server_PythonServerAPI.js.html +160 -0
package/doc/speaker.js.html +248 -0
package/doc/styles/jsdoc-default.css +371 -0
package/doc/styles/prettify-jsdoc.css +111 -0
package/doc/styles/prettify-tomorrow.css +163 -0
package/doc/tasks_audioCalibrator.js.html +207 -0
package/doc/tasks_audioRecorder.js.html +190 -0
package/doc/tasks_impulse-response_impulseResponse.js.html +442 -0
package/doc/tasks_impulse-response_mlsGen_mlsGenInterface.js.html +175 -0
package/doc/tasks_volume_volume.js.html +185 -0
package/doc/utils.js.html +105 -0
package/jest.config.js +173 -0
package/netlify.toml +27 -0
package/package.json +67 -66
package/src/index.html +21 -0
package/src/main.js +21 -0
package/src/myEventEmitter.js +83 -0
package/src/peer-connection/audioPeer.js +151 -0
package/src/peer-connection/listener.js +251 -0
package/src/peer-connection/peerErrors.js +25 -0
package/src/peer-connection/speaker.js +346 -0
package/src/server/PythonServerAPI.js +117 -0
package/src/tasks/audioCalibrator.js +218 -0
package/src/tasks/audioRecorder.js +148 -0
package/src/tasks/impulse-response/impulseResponse.js +436 -0
package/src/tasks/impulse-response/mlsGen/mlsGen.cpp +99 -0
package/src/tasks/impulse-response/mlsGen/mlsGen.hpp +304 -0
package/src/tasks/impulse-response/mlsGen/mlsGenInterface.js +131 -0
package/src/tasks/impulse-response/mlsGen/mlsGenTest.cpp +181 -0
package/src/tasks/volume/volume.cpp +3 -0
package/src/tasks/volume/volume.hpp +23 -0
package/src/tasks/volume/volume.js +157 -0
package/src/utils.js +55 -0
package/webpack.config.js +37 -0
package/README +0 -3

package/doc/myEventEmitter.js.html ADDED Viewed

@@ -0,0 +1,124 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>JSDoc: Source: myEventEmitter.js</title>
+    <script src="scripts/prettify/prettify.js"></script>
+    <script src="scripts/prettify/lang-css.js"></script>
+    <!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+    <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css" />
+    <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css" />
+  </head>
+  <body>
+    <div id="main">
+      <h1 class="page-title">Source: myEventEmitter.js</h1>
+      <section>
+        <article>
+          <pre class="prettyprint source linenums"><code>/**
+ * A simple event emitter class. Objects that inheret this class or implement it can then bubble events up to the UI
+ * similar to existings event emitter such as 'onChange' or 'onClick'
+ */
+class MyEventEmitter {
+  #events;
+  /**
+   * Default constructor, intializes an empty object to store events
+   */
+  constructor() {
+    this.#events = {};
+  }
+  /**
+   * The external API for this class. Gets called with an event name and a callback function that is fired when the event is emitted.
+   * @param {*} name
+   * @param {*} listener
+   */
+  on(name, listener) {
+    if (!this.#events[name]) {
+      this.#events[name] = [];
+    }
+    this.#events[name].push(listener);
+  }
+  /**
+   * Function to remove a listener that was previously set
+   * @param {*} name
+   * @param {*} listenerToRemove
+   */
+  removeListener(name, listenerToRemove) {
+    if (!this.#events[name]) {
+      throw new Error(`Can't remove a listener. Event "${name}" doesn't exits.`);
+    }
+    const filterListeners = listener => listener !== listenerToRemove;
+    this.#events[name] = this.#events[name].filter(filterListeners);
+  }
+  /**
+   * The internal API for this class. Gets called with an event name and a data object.
+   * Any callbacks that have been set to listen to the matching event are dispatched.
+   * @param {*} name
+   * @param {*} data
+   */
+  emit(name, data) {
+    if (!this.#events[name]) {
+      throw new Error(`Can't emit an event. Event "${name}" doesn't exits.`);
+    }
+    const fireCallbacks = callback => {
+      callback(data);
+    };
+    this.#events[name].forEach(fireCallbacks);
+  }
+}
+export default MyEventEmitter;
+</code></pre>
+        </article>
+      </section>
+    </div>
+    <nav>
+      <h2><a href="index.html">Home</a></h2>
+      <h3>Classes</h3>
+      <ul>
+        <li><a href="AudioCalibrator.html">AudioCalibrator</a></li>
+        <li><a href="AudioPeer.html">AudioPeer</a></li>
+        <li><a href="AudioRecorder.html">AudioRecorder</a></li>
+        <li><a href="ImpulseResponse.html">ImpulseResponse</a></li>
+        <li><a href="Listener.html">Listener</a></li>
+        <li><a href="MlsGenInterface.html">MlsGenInterface</a></li>
+        <li><a href="MyEventEmitter.html">MyEventEmitter</a></li>
+        <li><a href="PythonServerAPI.html">PythonServerAPI</a></li>
+        <li><a href="Speaker.html">Speaker</a></li>
+        <li><a href="Volume.html">Volume</a></li>
+      </ul>
+      <h3>Global</h3>
+      <ul>
+        <li><a href="global.html#csvToArray">csvToArray</a></li>
+        <li><a href="global.html#saveToCSV">saveToCSV</a></li>
+        <li><a href="global.html#sleep">sleep</a></li>
+      </ul>
+    </nav>
+    <br class="clear" />
+    <footer>
+      Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.10</a> on Fri
+      Jul 29 2022 15:09:48 GMT-0400 (Eastern Daylight Time)
+    </footer>
+    <script>
+      prettyPrint();
+    </script>
+    <script src="scripts/linenumber.js"></script>
+  </body>
+</html>

package/doc/peer-connection_audioPeer.js.html ADDED Viewed

@@ -0,0 +1,188 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>JSDoc: Source: peer-connection/audioPeer.js</title>
+    <script src="scripts/prettify/prettify.js"></script>
+    <script src="scripts/prettify/lang-css.js"></script>
+    <!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+    <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css" />
+    <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css" />
+  </head>
+  <body>
+    <div id="main">
+      <h1 class="page-title">Source: peer-connection/audioPeer.js</h1>
+      <section>
+        <article>
+          <pre class="prettyprint source linenums"><code>import Peer from 'peerjs';
+// TODO: this was already here before, but appears to be unused
+const pressFeedbackURI =
+  'data:audio/mpeg;base64,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VVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVV//uSZIIP9BFGHYksMlIAAA0gAAABAAABpAAAACAAADSAAAAEVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVVQ==';
+/**
+ * @typedef initParameters - Parameters for initializing the AudioPeer
+ * @type {object}
+ * @property {string} targetElementId - target element where new elements will be appended
+ * @property {string} siteUrl: the url of the current site
+ */
+const initParameters = {
+  targetElementId: null,
+  siteUrl: null,
+};
+/**
+ * @class The first layer of abstraction on the PeerJS library.
+ * It meant to be extended by the two seperate client classes, Speaker and Listener.
+ * It implements the shared methods and properties of both classes.
+ */
+class AudioPeer {
+  /**
+   * Creates an instance of AudioPeer
+   * Takes the url of the current site and a target element where html elements will be appended.
+   * @param {initParameters} params - see type definition for initParameters
+   */
+  constructor(param = initParameters) {
+    // PeerJS
+    /* Create the Peer object for our end of the connection. */
+    this.peer = new Peer({
+      secure: true,
+      host: 'easyeyes-peer-server.herokuapp.com',
+      port: 443,
+    });
+    this.conn = null;
+    this.lastPeerId = null;
+    // Display information to HTML elem with given id
+    this.targetElement = param.targetElementId;
+    this.siteUrl = param.siteUrl;
+    // Store for all incoming data
+    this.dataStore = [];
+    // Create and play sounds using this audio context
+    this.sourceAudioContext = new (window.AudioContext ||
+      window.webkitAudioContext ||
+      window.audioContext)();
+  }
+  /**
+   * Helper method to display information to DOM element
+   * @param {string} message
+   * @param {boolean} append
+   */
+  displayUpdate = (message, append = true) => {
+    // If the specified elem exists, update that elem
+    if (document.getElementById(this.targetElement)) {
+      const displayElement = document.getElementById(this.targetElement);
+      if (append) {
+        displayElement.innerText += `\n${message}`;
+      } else {
+        displayElement.innerText = message;
+      }
+    } else {
+      console.log('MESSAGE: ', message);
+    }
+  };
+  /**
+   * Callback method for when a peer connection is lost
+   * saves the last peer id, last server id, and attempts to reconnect
+   */
+  onPeerDisconnected = () => {
+    this.displayUpdate('Connection lost. Please reconnect');
+    // Workaround for peer.reconnect deleting previous id
+    this.peer.id = this.lastPeerId;
+    // eslint-disable-next-line no-underscore-dangle
+    this.peer._lastServerId = this.lastPeerId;
+    this.peer.reconnect();
+  };
+  /**
+   * Callback method that cleans up after peer connection is closed
+   */
+  onPeerClose = () => {
+    this.displayUpdate('Connection closed');
+    this.conn = null;
+  };
+  /**
+   * Helper method for when an error occurs
+   * @param {*} err
+   */
+  onPeerError = err => {
+    this.displayUpdate(err);
+    console.log(`${err}`);
+  };
+  /**
+   * Helper method that converts url paramters to an object
+   * @returns {object}
+   */
+  parseURLSearchParams = () =>
+    // SOURCE: chickens, https://stackoverflow.com/questions/8648892/how-to-convert-url-parameters-to-a-javascript-object
+    // eslint-disable-next-line no-restricted-globals
+    Object.fromEntries(new URLSearchParams(location.search));
+  /**
+   * Helper method that converts an object to a query string
+   * @param {object} params
+   * @returns {string}
+   */
+  queryStringFromObject = params =>
+    Object.keys(params)
+      .map(key => `${key}=${params[key]}`)
+      .join('&amp;');
+  static keypressFeedbackSound = pressFeedbackURI;
+}
+export default AudioPeer;
+</code></pre>
+        </article>
+      </section>
+    </div>
+    <nav>
+      <h2><a href="index.html">Home</a></h2>
+      <h3>Classes</h3>
+      <ul>
+        <li><a href="AudioCalibrator.html">AudioCalibrator</a></li>
+        <li><a href="AudioPeer.html">AudioPeer</a></li>
+        <li><a href="AudioRecorder.html">AudioRecorder</a></li>
+        <li><a href="ImpulseResponse.html">ImpulseResponse</a></li>
+        <li><a href="Listener.html">Listener</a></li>
+        <li><a href="MlsGenInterface.html">MlsGenInterface</a></li>
+        <li><a href="MyEventEmitter.html">MyEventEmitter</a></li>
+        <li><a href="PythonServerAPI.html">PythonServerAPI</a></li>
+        <li><a href="Speaker.html">Speaker</a></li>
+        <li><a href="Volume.html">Volume</a></li>
+      </ul>
+      <h3>Global</h3>
+      <ul>
+        <li><a href="global.html#csvToArray">csvToArray</a></li>
+        <li><a href="global.html#saveToCSV">saveToCSV</a></li>
+        <li><a href="global.html#sleep">sleep</a></li>
+      </ul>
+    </nav>
+    <br class="clear" />
+    <footer>
+      Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.10</a> on Fri
+      Jul 29 2022 15:09:48 GMT-0400 (Eastern Daylight Time)
+    </footer>
+    <script>
+      prettyPrint();
+    </script>
+    <script src="scripts/linenumber.js"></script>
+  </body>
+</html>

package/doc/peer-connection_listener.js.html ADDED Viewed

@@ -0,0 +1,311 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <title>JSDoc: Source: peer-connection/listener.js</title>
+    <script src="scripts/prettify/prettify.js"></script>
+    <script src="scripts/prettify/lang-css.js"></script>
+    <!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]-->
+    <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css" />
+    <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css" />
+  </head>
+  <body>
+    <div id="main">
+      <h1 class="page-title">Source: peer-connection/listener.js</h1>
+      <section>
+        <article>
+          <pre class="prettyprint source linenums"><code>import AudioPeer from './audioPeer';
+import {UnsupportedDeviceError, MissingSpeakerIdError} from './peerErrors';
+/**
+ * @class Handles the listener's side of the connection. Responsible for getting access to user's microphone,
+ * and initiating a call to the Speaker.
+ * @extends AudioPeer
+ */
+class Listener extends AudioPeer {
+  /**
+   * Takes a target element where html elements will be appended.
+   * @param {initParameters} params - see type definition for initParameters
+   */
+  constructor(params) {
+    super(params);
+    this.startTime = Date.now();
+    this.receiverPeerId = null;
+    const urlParameters = this.parseURLSearchParams();
+    this.speakerPeerId = urlParameters.speakerPeerId;
+    this.peer.on('open', this.onPeerOpen);
+    this.peer.on('connection', this.onPeerConnection);
+    this.peer.on('disconnected', this.onPeerDisconnected);
+    this.peer.on('close', this.onPeerClose);
+    this.peer.on('error', this.onPeerError);
+  }
+  onPeerOpen = id => {
+    this.displayUpdate('Listener - onPeerOpen');
+    // Workaround for peer.reconnect deleting previous id
+    if (id === null) {
+      this.displayUpdate('Received null id from peer open');
+      this.peer.id = this.lastPeerId;
+    } else {
+      this.lastPeerId = this.peer.id;
+    }
+    this.join();
+  };
+  onPeerConnection = connection => {
+    this.displayUpdate('Listener - onPeerConnection');
+    // Disallow incoming connections
+    connection.on('open', () => {
+      connection.send('Sender does not accept incoming connections');
+      setTimeout(() => {
+        connection.close();
+      }, 500);
+    });
+  };
+  onConnData = data => {
+    this.displayUpdate('Listener - onConnData');
+    const hasSpeakerID = Object.prototype.hasOwnProperty.call(data, 'speakerPeerId');
+    if (!hasSpeakerID) {
+      this.displayUpdate('Error in parsing data received! Must set "speakerPeerId" property');
+      throw new MissingSpeakerIdError('Must set "speakerPeerId" property');
+    } else {
+      // this.conn.close();
+      this.displayUpdate(this.speakerPeerId);
+      this.speakerPeerId = data.speakerPeerId;
+      const newParams = {
+        speakerPeerId: this.speakerPeerId,
+      };
+      /*
+      FUTURE does this limit usable environments?
+      ie does this work if internet is lost after initial page load?
+      */
+      window.location.search = this.queryStringFromObject(newParams); // Redirect to correctly constructed keypad page
+    }
+  };
+  join = () => {
+    this.displayUpdate('Listener - join');
+    /**
+     * Create the connection between the two Peers.
+     *
+     * Sets up callbacks that handle any events related to the
+     * connection and data received on it.
+     */
+    // Close old connection
+    if (this.conn) {
+      this.displayUpdate('Closing old connection');
+      this.conn.close();
+    }
+    // Create connection to destination peer specified by the query param
+    this.displayUpdate(`Creating connection to: ${this.speakerPeerId}`);
+    this.conn = this.peer.connect(this.speakerPeerId, {
+      reliable: true,
+    });
+    this.displayUpdate('Created connection');
+    this.conn.on('open', async () => {
+      this.displayUpdate('Listener - conn open');
+      // this.sendSamplingRate();
+      await this.openAudioStream();
+    });
+    // Handle incoming data (messages only since this is the signal sender)
+    this.conn.on('data', this.onConnData);
+    this.conn.on('close', () => {
+      console.log('Connection closed');
+    });
+  };
+  getMobileOS = () => {
+    const ua = navigator.userAgent;
+    if (/android/i.test(ua)) {
+      return 'Android';
+    }
+    if (
+      /iPad|iPhone|iPod/.test(ua) ||
+      ((navigator?.userAgentData?.platform || navigator?.platform) === 'MacIntel' &amp;&amp;
+        navigator.maxTouchPoints > 1)
+    ) {
+      return 'iOS';
+    }
+    return 'Other';
+  };
+  sendSamplingRate = sampleRate => {
+    this.displayUpdate('Listener - sendSamplingRate');
+    this.conn.send({
+      name: 'samplingRate',
+      payload: sampleRate,
+    });
+  };
+  applyHQTrackConstraints = async stream => {
+    // Contraint the incoming audio to the sampling rate we want
+    const track = stream.getAudioTracks()[0];
+    const capabilities = track.getCapabilities();
+    this.displayUpdate(
+      `Listener Track Capabilities - ${JSON.stringify(capabilities, undefined, 2)}`
+    );
+    const constraints = track.getConstraints();
+    if (capabilities.echoCancellation) {
+      constraints.echoCancellation = false;
+    }
+    if (capabilities.sampleRate) {
+      constraints.sampleRate = 96000;
+    }
+    if (capabilities.sampleSize) {
+      constraints.sampleSize = 24;
+    }
+    if (capabilities.channelCount) {
+      constraints.channelCount = 1;
+    }
+    this.displayUpdate(`Listener Track Constraints - ${JSON.stringify(constraints, undefined, 2)}`);
+    // await the promise
+    try {
+      await track.applyConstraints(constraints);
+    } catch (err) {
+      console.error(err);
+      this.displayUpdate(`Error applying constraints to track: ${err}`);
+    }
+    const settings = track.getSettings();
+    this.displayUpdate(`Listener Track Settings - ${JSON.stringify(settings, undefined, 2)}`);
+    return settings.sampleRate;
+  };
+  getMediaDevicesAudioContraints = () => {
+    const availableConstraints = navigator.mediaDevices.getSupportedConstraints();
+    this.displayUpdate(
+      `Listener MediaDevices Available Contraints  - ${JSON.stringify(
+        availableConstraints,
+        undefined,
+        2
+      )}`
+    );
+    const contraints = {
+      // ...(availableConstraints.echoCancellation &amp;&amp; availableConstraints.echoCancellation == true
+      //   ? {echoCancellation: {exact: false}}
+      //   : {}),
+      ...(availableConstraints.sampleRate &amp;&amp; availableConstraints.sampleRate == true
+        ? {sampleRate: {ideal: 96000}}
+        : {}),
+      ...(availableConstraints.sampleSize &amp;&amp; availableConstraints.sampleSize == true
+        ? {sampleSize: {ideal: 24}}
+        : {}),
+      ...(availableConstraints.channelCount &amp;&amp; availableConstraints.channelCount == true
+        ? {channelCount: {exact: 1}}
+        : {}),
+    };
+    this.displayUpdate(
+      `Listener MediaDevices Contraints - ${JSON.stringify(contraints, undefined, 2)}`
+    );
+    return contraints;
+  };
+  openAudioStream = async () => {
+    this.displayUpdate('Listener - openAudioStream');
+    const mobileOS = this.getMobileOS();
+    if (process.env.NODE_ENV !== 'development' &amp;&amp; mobileOS !== 'iOS') {
+      const err = new UnsupportedDeviceError(`${mobileOS} is not supported`);
+      this.conn.send({
+        name: err.name,
+        payload: err,
+      });
+      return;
+    }
+    navigator.mediaDevices
+      .getUserMedia({
+        audio: this.getMediaDevicesAudioContraints(),
+        video: false,
+      })
+      .then(stream => {
+        this.applyHQTrackConstraints(stream)
+          .then(sampleRate => {
+            this.sendSamplingRate(sampleRate);
+            this.peer.call(this.speakerPeerId, stream); // one-way call
+            this.displayUpdate('Listener - openAudioStream');
+          })
+          .catch(err => {
+            console.log(err);
+            this.displayUpdate(
+              `Listener - Error in applyHQTrackConstraints - ${JSON.stringify(err, undefined, 2)}`
+            );
+          });
+      })
+      .catch(err => {
+        console.error(err);
+        this.displayUpdate(
+          `Listener - Error in getUserMedia - ${JSON.stringify(err, undefined, 2)}`
+        );
+      });
+  };
+}
+export default Listener;
+</code></pre>
+        </article>
+      </section>
+    </div>
+    <nav>
+      <h2><a href="index.html">Home</a></h2>
+      <h3>Classes</h3>
+      <ul>
+        <li><a href="AudioCalibrator.html">AudioCalibrator</a></li>
+        <li><a href="AudioPeer.html">AudioPeer</a></li>
+        <li><a href="AudioRecorder.html">AudioRecorder</a></li>
+        <li><a href="ImpulseResponse.html">ImpulseResponse</a></li>
+        <li><a href="Listener.html">Listener</a></li>
+        <li><a href="MlsGenInterface.html">MlsGenInterface</a></li>
+        <li><a href="MyEventEmitter.html">MyEventEmitter</a></li>
+        <li><a href="PythonServerAPI.html">PythonServerAPI</a></li>
+        <li><a href="Speaker.html">Speaker</a></li>
+        <li><a href="Volume.html">Volume</a></li>
+      </ul>
+      <h3>Global</h3>
+      <ul>
+        <li><a href="global.html#csvToArray">csvToArray</a></li>
+        <li><a href="global.html#saveToCSV">saveToCSV</a></li>
+        <li><a href="global.html#sleep">sleep</a></li>
+      </ul>
+    </nav>
+    <br class="clear" />
+    <footer>
+      Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.10</a> on Fri
+      Jul 29 2022 15:09:48 GMT-0400 (Eastern Daylight Time)
+    </footer>
+    <script>
+      prettyPrint();
+    </script>
+    <script src="scripts/linenumber.js"></script>
+  </body>
+</html>