speaker-calibration 2.0.0 → 2.1.1

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
  1. package/.eslintignore +72 -0
  2. package/.eslintrc.json +40 -0
  3. package/.gitignore +78 -0
  4. package/.prettierignore +70 -0
  5. package/.prettierrc +15 -0
  6. package/LICENSE +20 -20
  7. package/README.md +133 -133
  8. package/__mocks__/fileMock.js +1 -0
  9. package/__mocks__/styleMock.js +1 -0
  10. package/babel.config.js +3 -0
  11. package/coverage/clover.xml +71 -0
  12. package/coverage/coverage-final.json +224 -0
  13. package/coverage/lcov-report/PythonServerInterface.js.html +265 -0
  14. package/coverage/lcov-report/base.css +354 -0
  15. package/coverage/lcov-report/block-navigation.js +82 -0
  16. package/coverage/lcov-report/favicon.png +0 -0
  17. package/coverage/lcov-report/index.html +123 -0
  18. package/coverage/lcov-report/prettify.css +101 -0
  19. package/coverage/lcov-report/prettify.js +937 -0
  20. package/coverage/lcov-report/sort-arrow-sprite.png +0 -0
  21. package/coverage/lcov-report/sorter.js +189 -0
  22. package/coverage/lcov-report/src/index.html +121 -0
  23. package/coverage/lcov-report/src/server/PythonServerInterface.js.html +268 -0
  24. package/coverage/lcov-report/src/server/index.html +123 -0
  25. package/coverage/lcov-report/src/tasks/audioCalibrator.js.html +499 -0
  26. package/coverage/lcov-report/src/tasks/audioRecorder.js.html +412 -0
  27. package/coverage/lcov-report/src/tasks/index.html +143 -0
  28. package/coverage/lcov-report/src/tasks/volume/index.html +123 -0
  29. package/coverage/lcov-report/src/tasks/volume/volume.js.html +409 -0
  30. package/coverage/lcov-report/src/utils.js.html +172 -0
  31. package/coverage/lcov.info +91 -0
  32. package/dist/example/Queen-Bohemian_Rhapsody.wav +0 -0
  33. package/dist/example/Queen-Bohemian_Rhapsody_g_filtered.wav +0 -0
  34. package/dist/example/index.html +47 -0
  35. package/dist/example/listener.html +89 -0
  36. package/dist/example/server.js +49 -0
  37. package/dist/example/speaker.html +126 -0
  38. package/dist/example/speakerUI.js +217 -0
  39. package/dist/example/styles.css +40 -0
  40. package/dist/main.js +913 -1
  41. package/dist/mlsGen.js +6814 -6814
  42. package/dist/mlsGen.wasm +0 -0
  43. package/doc/AudioCalibrator.html +417 -0
  44. package/doc/AudioPeer.html +251 -0
  45. package/doc/AudioRecorder.html +195 -0
  46. package/doc/ImpulseResponse.html +215 -0
  47. package/doc/Listener.html +308 -0
  48. package/doc/MlsGenInterface.html +226 -0
  49. package/doc/MyEventEmitter.html +274 -0
  50. package/doc/PythonServerAPI.html +109 -0
  51. package/doc/Speaker-Calibration-UML-Diagram.png +0 -0
  52. package/doc/Speaker.html +276 -0
  53. package/doc/Takes%20a%20target%20element%20where%20html%20elements%20will%20be%20appended..html +128 -0
  54. package/doc/Takes%20the%20url%20of%20the%20current%20site%0Aand%20a%20target%20element%20where%20html%20elements%20will%20be%20appended..html +138 -0
  55. package/doc/Takes%20the%20url%20of%20the%20current%20site%20and%20a%20target%20element%20where%20html%20elements%20will%20be%20appended..html +137 -0
  56. package/doc/Volume.html +88 -0
  57. package/doc/audioCalibrator.js.html +179 -0
  58. package/doc/audioPeer.js.html +175 -0
  59. package/doc/audioRecorder.js.html +163 -0
  60. package/doc/creates%20a%20new%20AudioRecorder%20instance.%20%0ASets%20up%20the%20audio%20context%20and%20file%20reader..html +114 -0
  61. package/doc/fonts/OpenSans-Bold-webfont.eot +0 -0
  62. package/doc/fonts/OpenSans-Bold-webfont.svg +1830 -0
  63. package/doc/fonts/OpenSans-Bold-webfont.woff +0 -0
  64. package/doc/fonts/OpenSans-BoldItalic-webfont.eot +0 -0
  65. package/doc/fonts/OpenSans-BoldItalic-webfont.svg +1830 -0
  66. package/doc/fonts/OpenSans-BoldItalic-webfont.woff +0 -0
  67. package/doc/fonts/OpenSans-Italic-webfont.eot +0 -0
  68. package/doc/fonts/OpenSans-Italic-webfont.svg +1830 -0
  69. package/doc/fonts/OpenSans-Italic-webfont.woff +0 -0
  70. package/doc/fonts/OpenSans-Light-webfont.eot +0 -0
  71. package/doc/fonts/OpenSans-Light-webfont.svg +1831 -0
  72. package/doc/fonts/OpenSans-Light-webfont.woff +0 -0
  73. package/doc/fonts/OpenSans-LightItalic-webfont.eot +0 -0
  74. package/doc/fonts/OpenSans-LightItalic-webfont.svg +1835 -0
  75. package/doc/fonts/OpenSans-LightItalic-webfont.woff +0 -0
  76. package/doc/fonts/OpenSans-Regular-webfont.eot +0 -0
  77. package/doc/fonts/OpenSans-Regular-webfont.svg +1831 -0
  78. package/doc/fonts/OpenSans-Regular-webfont.woff +0 -0
  79. package/doc/global.html +308 -0
  80. package/doc/index.html +58 -0
  81. package/doc/listener.js.html +170 -0
  82. package/doc/mlsGen_mlsGenInterface.js.html +117 -0
  83. package/doc/myEventEmitter.js.html +124 -0
  84. package/doc/peer-connection_audioPeer.js.html +188 -0
  85. package/doc/peer-connection_listener.js.html +311 -0
  86. package/doc/peer-connection_speaker.js.html +381 -0
  87. package/doc/sc-activity-diagram.png +0 -0
  88. package/doc/scripts/linenumber.js +25 -0
  89. package/doc/scripts/prettify/Apache-License-2.0.txt +202 -0
  90. package/doc/scripts/prettify/lang-css.js +24 -0
  91. package/doc/scripts/prettify/prettify.js +640 -0
  92. package/doc/server_PythonServerAPI.js.html +160 -0
  93. package/doc/speaker.js.html +248 -0
  94. package/doc/styles/jsdoc-default.css +371 -0
  95. package/doc/styles/prettify-jsdoc.css +111 -0
  96. package/doc/styles/prettify-tomorrow.css +163 -0
  97. package/doc/tasks_audioCalibrator.js.html +207 -0
  98. package/doc/tasks_audioRecorder.js.html +190 -0
  99. package/doc/tasks_impulse-response_impulseResponse.js.html +442 -0
  100. package/doc/tasks_impulse-response_mlsGen_mlsGenInterface.js.html +175 -0
  101. package/doc/tasks_volume_volume.js.html +185 -0
  102. package/doc/utils.js.html +105 -0
  103. package/jest.config.js +173 -0
  104. package/netlify.toml +27 -0
  105. package/package.json +67 -66
  106. package/src/index.html +21 -0
  107. package/src/main.js +21 -0
  108. package/src/myEventEmitter.js +83 -0
  109. package/src/peer-connection/audioPeer.js +151 -0
  110. package/src/peer-connection/listener.js +251 -0
  111. package/src/peer-connection/peerErrors.js +25 -0
  112. package/src/peer-connection/speaker.js +346 -0
  113. package/src/server/PythonServerAPI.js +155 -0
  114. package/src/tasks/audioCalibrator.js +218 -0
  115. package/src/tasks/audioRecorder.js +148 -0
  116. package/src/tasks/impulse-response/impulseResponse.js +436 -0
  117. package/src/tasks/impulse-response/mlsGen/mlsGen.cpp +99 -0
  118. package/src/tasks/impulse-response/mlsGen/mlsGen.hpp +304 -0
  119. package/src/tasks/impulse-response/mlsGen/mlsGenInterface.js +131 -0
  120. package/src/tasks/impulse-response/mlsGen/mlsGenTest.cpp +181 -0
  121. package/src/tasks/volume/volume.cpp +3 -0
  122. package/src/tasks/volume/volume.hpp +23 -0
  123. package/src/tasks/volume/volume.js +174 -0
  124. package/src/utils.js +55 -0
  125. package/webpack.config.js +37 -0
  126. package/README +0 -3
@@ -0,0 +1,160 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="utf-8" />
5
+ <title>JSDoc: Source: server/PythonServerAPI.js</title>
6
+
7
+ <script src="scripts/prettify/prettify.js"></script>
8
+ <script src="scripts/prettify/lang-css.js"></script>
9
+ <!--[if lt IE 9]>
10
+ <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
11
+ <![endif]-->
12
+ <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css" />
13
+ <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css" />
14
+ </head>
15
+
16
+ <body>
17
+ <div id="main">
18
+ <h1 class="page-title">Source: server/PythonServerAPI.js</h1>
19
+
20
+ <section>
21
+ <article>
22
+ <pre class="prettyprint source linenums"><code>import axios from 'axios';
23
+ /**
24
+ *
25
+ */
26
+ class PythonServerAPI {
27
+ static PYTHON_SERVER_URL = 'https://easyeyes-python-flask-server.herokuapp.com';
28
+
29
+ static TEST_SERVER_URL = 'http://127.0.0.1:5000';
30
+
31
+ /**
32
+ * @param {array} data
33
+ * g = inverted impulse response, when convolved with the impulse
34
+ * reponse, they cancel out.
35
+ * @returns {Float&lt;array>}
36
+ */
37
+ getImpulseResponse = async ({payload, sampleRate, P}) => {
38
+ const task = 'impulse-response';
39
+ let res = null;
40
+
41
+ console.log({payload});
42
+
43
+ const data = JSON.stringify({
44
+ task,
45
+ payload,
46
+ 'sample-rate': sampleRate,
47
+ P,
48
+ });
49
+
50
+ await axios({
51
+ method: 'post',
52
+ baseURL: PythonServerAPI.PYTHON_SERVER_URL,
53
+ url: `/task/${task}`,
54
+ headers: {
55
+ 'Content-Type': 'application/json',
56
+ },
57
+ data,
58
+ })
59
+ .then(response => {
60
+ res = response;
61
+ })
62
+ .catch(error => {
63
+ throw error;
64
+ });
65
+
66
+ return res.data[task];
67
+ };
68
+
69
+ getInverseImpulseResponse = async ({payload}) => {
70
+ const task = 'inverse-impulse-response';
71
+ let res = null;
72
+
73
+ console.log({payload});
74
+
75
+ const data = JSON.stringify({
76
+ task,
77
+ payload,
78
+ });
79
+
80
+ await axios({
81
+ method: 'post',
82
+ baseURL: PythonServerAPI.PYTHON_SERVER_URL,
83
+ url: `/task/${task}`,
84
+ headers: {
85
+ 'Content-Type': 'application/json',
86
+ },
87
+ data,
88
+ })
89
+ .then(response => {
90
+ res = response;
91
+ })
92
+ .catch(error => {
93
+ throw error;
94
+ });
95
+
96
+ return res.data[task];
97
+ };
98
+
99
+ getVolumeCalibration = async data => {
100
+ let serverRep;
101
+ let res;
102
+ try {
103
+ serverRep = await this.asyncEmit('data', {
104
+ task: 'volume-calibration',
105
+ data,
106
+ });
107
+ const [soundGainDbSPL, P, L, vectorDb] = serverRep.data
108
+ .trim()
109
+ .split(',')
110
+ .map(resp => parseFloat(resp.split(':')[1]));
111
+ res = soundGainDbSPL;
112
+ } catch (e) {
113
+ throw new Error(e);
114
+ }
115
+ return res;
116
+ };
117
+ }
118
+
119
+ export default PythonServerAPI;
120
+ </code></pre>
121
+ </article>
122
+ </section>
123
+ </div>
124
+
125
+ <nav>
126
+ <h2><a href="index.html">Home</a></h2>
127
+ <h3>Classes</h3>
128
+ <ul>
129
+ <li><a href="AudioCalibrator.html">AudioCalibrator</a></li>
130
+ <li><a href="AudioPeer.html">AudioPeer</a></li>
131
+ <li><a href="AudioRecorder.html">AudioRecorder</a></li>
132
+ <li><a href="ImpulseResponse.html">ImpulseResponse</a></li>
133
+ <li><a href="Listener.html">Listener</a></li>
134
+ <li><a href="MlsGenInterface.html">MlsGenInterface</a></li>
135
+ <li><a href="MyEventEmitter.html">MyEventEmitter</a></li>
136
+ <li><a href="PythonServerAPI.html">PythonServerAPI</a></li>
137
+ <li><a href="Speaker.html">Speaker</a></li>
138
+ <li><a href="Volume.html">Volume</a></li>
139
+ </ul>
140
+ <h3>Global</h3>
141
+ <ul>
142
+ <li><a href="global.html#csvToArray">csvToArray</a></li>
143
+ <li><a href="global.html#saveToCSV">saveToCSV</a></li>
144
+ <li><a href="global.html#sleep">sleep</a></li>
145
+ </ul>
146
+ </nav>
147
+
148
+ <br class="clear" />
149
+
150
+ <footer>
151
+ Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.10</a> on Fri
152
+ Jul 29 2022 15:09:48 GMT-0400 (Eastern Daylight Time)
153
+ </footer>
154
+
155
+ <script>
156
+ prettyPrint();
157
+ </script>
158
+ <script src="scripts/linenumber.js"></script>
159
+ </body>
160
+ </html>
@@ -0,0 +1,248 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta charset="utf-8" />
5
+ <title>JSDoc: Source: speaker.js</title>
6
+
7
+ <script src="scripts/prettify/prettify.js"></script>
8
+ <script src="scripts/prettify/lang-css.js"></script>
9
+ <!--[if lt IE 9]>
10
+ <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
11
+ <![endif]-->
12
+ <link type="text/css" rel="stylesheet" href="styles/prettify-tomorrow.css" />
13
+ <link type="text/css" rel="stylesheet" href="styles/jsdoc-default.css" />
14
+ </head>
15
+
16
+ <body>
17
+ <div id="main">
18
+ <h1 class="page-title">Source: speaker.js</h1>
19
+
20
+ <section>
21
+ <article>
22
+ <pre class="prettyprint source linenums"><code>import './speaker.css';
23
+ import AudioPeer from './audioPeer';
24
+ import AudioCalibrator from './audioCalibrator';
25
+
26
+ const QRCode = require('qrcode');
27
+
28
+ // TODO: some of these methods were preimplmented, but appear to be unused, cleanup
29
+ /**
30
+ * @class Handles the speaker's side of the connection. Responsible for initiating the connection,
31
+ * rendering the QRCode, and answering the call.
32
+ * @extends AudioPeer
33
+ */
34
+ class Speaker extends AudioPeer {
35
+ /**
36
+ * Takes the url of the current site and a target element where html elements will be appended.
37
+ * @param {initParameters} params - see type definition for initParameters
38
+ */
39
+ constructor(params) {
40
+ super(params);
41
+
42
+ this.siteUrl += '/listener?';
43
+ this.ac = new AudioCalibrator();
44
+
45
+ /* Set up callbacks that handle any events related to our peer object. */
46
+ this.peer.on('open', this.onPeerOpen);
47
+ this.peer.on('connection', this.onPeerConnection);
48
+ this.peer.on('call', this.onPeerCall);
49
+ this.peer.on('close', this.onPeerClose);
50
+ this.peer.on('disconnected', this.onPeerDisconnected);
51
+ this.peer.on('error', this.onPeerError);
52
+ }
53
+
54
+ /**
55
+ * Called after the peer conncection has been opened.
56
+ * Generates a QR code for the connection and displays it.
57
+ */
58
+ showQRCode = () => {
59
+ // this.ac.test();
60
+ // Get query string, the URL parameters to specify a Listener
61
+ const queryStringParameters = {
62
+ speakerPeerId: this.peer.id,
63
+ };
64
+ const queryString = this.queryStringFromObject(queryStringParameters);
65
+ const uri = this.siteUrl + queryString;
66
+
67
+ // Display QR code for the participant to scan
68
+ const qrCanvas = document.createElement('canvas');
69
+ qrCanvas.setAttribute('id', 'qrCanvas');
70
+ console.log(uri);
71
+ QRCode.toCanvas(qrCanvas, uri, error => {
72
+ if (error) console.error(error);
73
+ });
74
+
75
+ // If specified HTML Id is available, show QR code there
76
+ if (document.getElementById(this.targetElement)) {
77
+ document.getElementById(this.targetElement).appendChild(qrCanvas);
78
+ } else {
79
+ // or just print it to console
80
+ console.log('TEST: Peer reachable at: ', uri);
81
+ }
82
+ };
83
+
84
+ /**
85
+ * Called when the peer connection is opened.
86
+ * Saves the peer id and calls the QR code generator.
87
+ * @param {object} peerId - The peer id of the peer connection
88
+ */
89
+ onPeerOpen = id => {
90
+ // Workaround for peer.reconnect deleting previous id
91
+ if (id === null) {
92
+ console.error('Received null id from peer open');
93
+ this.peer.id = this.lastPeerId;
94
+ } else {
95
+ this.lastPeerId = this.peer.id;
96
+ }
97
+
98
+ if (id !== this.peer.id) {
99
+ console.warn('DEBUG Check you assumption that id === this.peer.id');
100
+ }
101
+
102
+ this.showQRCode();
103
+ };
104
+
105
+ /**
106
+ * Called when the peer connection is established.
107
+ * Enforces a single connection.
108
+ * @param {*} connection - The connection object
109
+ */
110
+ onPeerConnection = connection => {
111
+ console.log('Speaker - onPeerConnection');
112
+
113
+ // Allow only a single connection
114
+ if (this.conn &amp;&amp; this.conn.open) {
115
+ connection.on('open', () => {
116
+ connection.send('Already connected to another client');
117
+ setTimeout(() => {
118
+ connection.close();
119
+ }, 500);
120
+ });
121
+ return;
122
+ }
123
+
124
+ this.conn = connection;
125
+ console.log('Connected to: ', this.conn.peer);
126
+ this.ready();
127
+ };
128
+
129
+ /**
130
+ * Called after a call is established and data is flowing.
131
+ * Sets up the local audio stream and starts the calibration process.
132
+ * @param {MediaStream} stream - The stream of audio from the Listener.
133
+ */
134
+ onReceiveStream = stream => {
135
+ window.localStream = stream;
136
+ window.localAudio.srcObject = stream;
137
+ window.localAudio.autoplay = true;
138
+
139
+ // Start calibration
140
+ if (!this.ac.getCalibrationStatus()) {
141
+ this.ac.startCalibration(stream);
142
+ }
143
+ };
144
+
145
+ /**
146
+ * Called when a call is made by the Listener.
147
+ * Answers the call in a one-way manner, and sets up a stream listener.
148
+ * @param {*} call
149
+ */
150
+ onPeerCall = call => {
151
+ call.answer(); // Answer the call (one way)
152
+ this.ac.createLocalAudio(document.getElementById(this.targetElement));
153
+ call.on('stream', this.onReceiveStream);
154
+ };
155
+
156
+ /**
157
+ * Called when the peer connection is closed.
158
+ */
159
+ onPeerClose = () => {
160
+ this.conn = null;
161
+ console.log('Connection destroyed');
162
+ };
163
+
164
+ /**
165
+ * Called when the peer connection is disconnected.
166
+ * Attempts to reconnect.
167
+ */
168
+ onPeerDisconnected = () => {
169
+ console.log('Connection lost. Please reconnect');
170
+
171
+ // Workaround for peer.reconnect deleting previous id
172
+ this.peer.id = this.lastPeerId;
173
+ // eslint-disable-next-line no-underscore-dangle
174
+ this.peer._lastServerId = this.lastPeerId;
175
+ this.peer.reconnect();
176
+ };
177
+
178
+ /**
179
+ * Called when the peer connection encounters an error.
180
+ * @param {*} error
181
+ */
182
+ onPeerError = error => {
183
+ // TODO: check if this function is needed or not
184
+ console.error(error);
185
+ };
186
+
187
+ /**
188
+ * Called when data is received from the peer connection.
189
+ * @param {*} data
190
+ */
191
+ onIncomingData = data => {
192
+ // TODO: check if this function is needed or not
193
+ console.log({data});
194
+ };
195
+
196
+ /**
197
+ * Called when the peer connection is ready.
198
+ */
199
+ ready = () => {
200
+ // Perform callback with data
201
+ this.conn.on('data', this.onIncomingData);
202
+ this.conn.on('close', () => {
203
+ console.log('Connection reset&lt;br>Awaiting connection...');
204
+ this.conn = null;
205
+ });
206
+ };
207
+ }
208
+
209
+ /*
210
+ Referenced links:
211
+ https://stackoverflow.com/questions/28016664/when-you-pass-this-as-an-argument/28016676#28016676
212
+ https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Classes
213
+ https://stackoverflow.com/questions/879152/how-do-i-make-javascript-beep [3]
214
+ */
215
+
216
+ export default Speaker;
217
+ </code></pre>
218
+ </article>
219
+ </section>
220
+ </div>
221
+
222
+ <nav>
223
+ <h2><a href="index.html">Home</a></h2>
224
+ <h3>Classes</h3>
225
+ <ul>
226
+ <li><a href="AudioCalibrator.html">AudioCalibrator</a></li>
227
+ <li><a href="AudioPeer.html">AudioPeer</a></li>
228
+ <li><a href="AudioRecorder.html">AudioRecorder</a></li>
229
+ <li><a href="Listener.html">Listener</a></li>
230
+ <li><a href="MlsGenInterface.html">MlsGenInterface</a></li>
231
+ <li><a href="Speaker.html">Speaker</a></li>
232
+ </ul>
233
+ <h3><a href="global.html">Global</a></h3>
234
+ </nav>
235
+
236
+ <br class="clear" />
237
+
238
+ <footer>
239
+ Documentation generated by <a href="https://github.com/jsdoc/jsdoc">JSDoc 3.6.10</a> on Tue
240
+ Mar 01 2022 12:39:42 GMT-0500 (Eastern Standard Time)
241
+ </footer>
242
+
243
+ <script>
244
+ prettyPrint();
245
+ </script>
246
+ <script src="scripts/linenumber.js"></script>
247
+ </body>
248
+ </html>