node-web-audio-api 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+## v0.4.0
+
+- Implement offline audio context
+- Update web-audio-api-rs to v0.24.0 
+- Implement `audio_node.disconnect()`
+- Properly support ESM
+- Limit number of online contexts to 1 on Linux
+- Force latencyHint to 'playback' if not manually set on RPi

package/README.md

@@ -11,7 +11,7 @@ npm install [--save] node-web-audio-api
 ## Example
 
 ```js
-const { AudioContext, OscillatorNode, GainNode } = require('node-web-audio-api');
+import { AudioContext, OscillatorNode, GainNode } from 'node-web-audio-api';
 
 const audioContext = new AudioContext();
 
@@ -30,14 +30,13 @@ setInterval(() => {
   osc.connect(env);
   osc.start(now);
   osc.stop(now + 1);
-}, 50);
+}, 80);
 ```
 
-or using with EcmaScript module syntax
+or using with old fashionned commonjs syntax
 
 ```js
-import wabaudioapi from 'node-web-audio-api';
-const { AudioContext, OscillatorNode, GainNode } = webaudioapi;
+const { AudioContext, OscillatorNode, GainNode } = require('node-web-audio-api');
 
 const audioContext = new AudioContext();
 //...
@@ -46,13 +45,17 @@ const audioContext = new AudioContext();
 ## Caveats
 
 - Currently the library does not provide any way of chosing the output interface, system default interface will be used. As the spec and web-audio-api evolve evolve, thus should change in the future see [https://github.com/orottier/web-audio-api-rs/issues/216](https://github.com/orottier/web-audio-api-rs/issues/216)
-- On Linux systems, the audio backend is Alsa, this is subject to change in the future.
+- On Linux systems, the audio backend is Alsa, which limits the number of online
+AudioContext to 1. This is subject to change in the future.
 
 ### Raspberry Pi
 
 On Raspberry Pi, the default render quantum size (128) is too small and underruns 
-occurs frequently. To prevent that you should provide a latency hint when building
-an audio context:
+occurs frequently. To prevent that, if you do not explicitely provide a latency hint
+in the AudioContext options, the value is automatically set to 'playback' which uses
+a buffer of 1024 samples. While this is not per se spec compliant, it allow usage
+of the library in a more user friendly manner. In the future, this might change according
+to the support of other audio backend, which is now alsa.
 
 ```js
 const audioContext = new AudioContext({ latencyHint: 'playback' });

package/{index.js → index.cjs}

@@ -86,9 +86,14 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding for OS: ${platform}, architecture: ${arch}`);
 }
 
-const { patchAudioContext, load } = require('./monkey-patch.js');
+const {
+  patchAudioContext,
+  patchOfflineAudioContext,
+  load,
+} = require('./monkey-patch.js');
 
 nativeBinding.AudioContext = patchAudioContext(nativeBinding.AudioContext);
+nativeBinding.OfflineAudioContext = patchOfflineAudioContext(nativeBinding.OfflineAudioContext);
 nativeBinding.load = load;
 
 module.exports = nativeBinding;

package/index.mjs

@@ -0,0 +1,39 @@
+// ---------------------------------------------------------- //
+// ---------------------------------------------------------- //
+//    - WARNING - DO NOT EDIT                               - //
+//    - This file has been generated                        - //
+// ---------------------------------------------------------- //
+// ---------------------------------------------------------- //
+
+// re-export index.js to support clean esm syntax
+// see https://github.com/nodejs/node/issues/40541#issuecomment-951609570
+
+import { createRequire } from 'module';
+const require = createRequire(import.meta.url);
+
+const nativeModule = require('./index.cjs');
+export const {
+  AudioContext,
+  OfflineAudioContext,
+  AudioBuffer,
+  PeriodicWave,
+  // generated supported nodes
+  AudioBufferSourceNode,
+  BiquadFilterNode,
+  ChannelMergerNode,
+  ChannelSplitterNode,
+  ConstantSourceNode,
+  DelayNode,
+  DynamicsCompressorNode,
+  GainNode,
+  IIRFilterNode,
+  OscillatorNode,
+  StereoPannerNode,
+  WaveShaperNode,
+  // helper methods
+  load
+} = nativeModule;
+
+export default nativeModule;
+
+  

package/monkey-patch.js

@@ -1,15 +1,34 @@
 const fs = require('fs');
 
-let contextId = 0;
-
 const isPlainObject = function(obj) {
   return Object.prototype.toString.call(obj) === '[object Object]';
 };
 
-module.exports.patchAudioContext = function(NativeAudioContext) {
+const { platform, arch } = process;
+let contextId = 0;
+
+function patchAudioContext(NativeAudioContext) {
   class AudioContext extends NativeAudioContext {
-    constructor(...args) {
-      super(...args);
+    constructor(options = {}) {
+
+      // special handling of options on linux, these are not spec compliant but are
+      // ment to be more user-friendly than what we have now (is subject to change)
+      if (platform === 'linux') {
+        // throw meaningfull error if several contexts are created on linux,
+        // because of alsa backend we currently use
+        if (contextId === 1) {
+          throw new Error(`[node-web-audio-api] node-web-audio-api currently uses alsa as backend, therefore only one context can be safely created`);
+        }
+
+        // fallback latencyHint to "playback" on RPi if not explicitely defined
+        if (arch === 'arm') {
+          if (!('latencyHint' in options)) {
+            options.latencyHint = 'playback';
+          }
+        }
+      }
+
+      super(options);
       // prevent garbage collection
       const processId = `__AudioContext_${contextId}`;
       process[processId] = this;
@@ -44,9 +63,9 @@ module.exports.patchAudioContext = function(NativeAudioContext) {
     }
 
     close() {
-       delete process[this.__processId];
-       clearTimeout(this.__keepAwakeId);
-       return Promise.resolve(super.close());
+      delete process[this.__processId];
+      clearTimeout(this.__keepAwakeId);
+      return Promise.resolve(super.close());
     }
 
     decodeAudioData(audioData) {
@@ -66,6 +85,54 @@ module.exports.patchAudioContext = function(NativeAudioContext) {
   return AudioContext;
 }
 
+function patchOfflineAudioContext(NativeOfflineAudioContext) {
+  class OfflineAudioContext extends NativeOfflineAudioContext {
+    constructor(...args) {
+      super(...args);
+      console.log(args);
+
+      // not sure this is usefull, to be tested
+      const keepAwakeId = setInterval(() => {}, 10000);
+      Object.defineProperty(this, '__keepAwakeId', {
+        value: keepAwakeId,
+        enumerable: false,
+        writable: true,
+        configurable: false,
+      });
+    }
+
+    // promisify sync APIs
+    startRendering() {
+      try {
+        const audioBuffer = super.startRendering();
+
+        clearTimeout(this.__keepAwakeId);
+        return Promise.resolve(audioBuffer);
+      } catch (err) {
+        return Promise.reject(err);
+      }
+    }
+
+    decodeAudioData(audioData) {
+      if (!isPlainObject(audioData) || !('path' in audioData)) {
+        throw new Error(`Invalid argument, please consider using the load helper`);
+      }
+
+      try {
+        const audioBuffer = super.decodeAudioData(audioData);
+        return Promise.resolve(audioBuffer);
+      } catch (err) {
+        return Promise.reject(err);
+      }
+    }
+  }
+
+  return OfflineAudioContext;
+}
+
+module.exports.patchAudioContext = patchAudioContext;
+module.exports.patchOfflineAudioContext = patchOfflineAudioContext;
+
 // dumb method provided to mock an xhr call and mimick browser's API
 // see also `AudioContext.decodeAudioData`
 module.exports.load = function(path) {

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "node-web-audio-api",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "author": "Benjamin Matuszewski",
   "description": "Node.js bindings for web-audio-api-rs using napi-rs",
-  "main": "index.js",
+  "exports": {
+    "import": "./index.mjs",
+    "require": "./index.cjs"
+  },
   "repository": "https://github.com/ircam-ismm/node-web-audio-api",
   "license": "BSD-3-Clause",
   "keywords": [

package/simple-test.mjs

@@ -1,7 +1,6 @@
-import webaudio from './index.js';
+import { AudioContext } from './index.mjs';
 
-const audioContext = new webaudio.AudioContext();
-// process.audioContext = audioContext;
+const audioContext = new AudioContext();
 
 setInterval(() => {
   const now = audioContext.currentTime;