Skip to content

Latest commit

 

History

History
19 lines (10 loc) · 1.7 KB

README.md

File metadata and controls

19 lines (10 loc) · 1.7 KB
Raw

Example Apps

The src directory contains three example Wax applications, each bootstrapped by the same HTML document (index.html):

  • simple.jsx - declares an oscillator, with a couple of scheduled frequency changes, whose gain and pan are altered

  • aggregation.jsx - demonstrates how one can use the <Aggregation /> component to build more complex audio graphs

  • withReact.jsx - renders a slider element using React, which updates an <AudioGraph /> whenever its value is changed. This calls renderPersistentAudioGraph()

Running the Examples

After following the setup guide in the local development documentation, run npm run dev from the root of the repository. You can specify the ENTRY environment varible to select which app to run; this is the name of the app without the .jsx extension e.g. ENTRY=withReact npm run dev. If omitted, simple will be built and started.

The example apps are built using rollup.

Mitigating Chrome's Autoplay Policy

As of December 2018, Chrome instantiates AudioContexts in the 'suspended' state, requiring an explicit user interaction before they can be resumed. To mitigate this, there is some JavaScript in the HTML bootstrapper (index.html) which will create, resume, and forward a context to the current app via a callback. This will potentially become a requirement for other browsers as they adopt similar policies in the future.