{"id":4384,"date":"2015-04-28T22:27:16","date_gmt":"2015-04-29T05:27:16","guid":{"rendered":"http:\/\/multimedia.cx\/eggs\/?p=4384"},"modified":"2015-04-28T22:27:16","modified_gmt":"2015-04-29T05:27:16","slug":"emscripten-and-web-audio-api","status":"publish","type":"post","link":"https:\/\/multimedia.cx\/eggs\/emscripten-and-web-audio-api\/","title":{"rendered":"Emscripten and Web Audio API"},"content":{"rendered":"

Ha! They said it couldn’t be done!<\/strong> Well, to be fair, I said<\/strong> it couldn’t be done<\/a>. Or maybe that I just didn’t have any plans to do it. But I did it– I used Emscripten<\/a> to cross-compile a CPU-intensive C\/C++ codebase (Game Music Emu<\/a>) to JavaScript. Then I leveraged the Web Audio API<\/a> to output audio and visualize the audio using an HTML5 canvas.<\/p>\n

Want to see it in action?<\/strong> Here’s a demonstration.<\/a> Perhaps I will be able to expand the reach of my Game Music site<\/a> when I can drop the odd Native Client plugin. This JS-based player works great on Chrome, Firefox, and Safari across desktop operating systems.<\/p>\n

But this endeavor was not without its challenges.<\/em><\/p>\n

Programmatically Generating Audio<\/strong>
\nFirst, I needed to figure out the proper method for procedurally generating audio and making it available to output. Generally, there are 2 approaches for audio output:<\/p>\n

    \n
  1. Sit in a loop and generate audio, writing it out via a blocking audio call<\/li>\n
  2. Implement a callback that the audio system can invoke in order to generate more audio when needed<\/li>\n<\/ol>\n

    Option #1 is not a good idea for an event-driven language like JavaScript. So I hunted through the rather flexible Web Audio API for a method that allowed something like approach #2. Callbacks are everywhere, after all.<\/p>\n

    I eventually found what I was looking for with the ScriptProcessorNode<\/a>. It seems to be intended to apply post-processing effects to audio streams. A program registers a callback which is passed configurable chunks of audio for processing. I subverted this by simply overwriting the input buffers with the audio generated by the Emscripten-compiled library.<\/p>\n

    The ScriptProcessorNode interface is fairly well documented and works across multiple browsers. However<\/strong>, it is already marked as deprecated<\/strong>:<\/p>\n

    Note: As of the August 29 2014 Web Audio API spec publication, this feature has been marked as deprecated, and is soon to be replaced by Audio Workers.<\/p><\/blockquote>\n

    Despite being marked as deprecated for 8 months as of this writing, there exists no appreciable amount of documentation for the successor API, these so-called Audio Workers.<\/p>\n

    Vive la web standards!<\/em><\/p>\n

    Visualize This<\/strong>
    \nThe next problem was visualization. The Web Audio API provides the     AnalyzerNode<\/a> API for accessing both time and frequency domain data from a running audio stream (and fetching the data as both unsigned bytes or floating-point numbers, depending on what the application needs). This is a pretty neat idea. I just wish I could make the API work. The simple demos I could find<\/a> worked well enough. But when I wired up a prototype to fetch and visualize the time-domain wave, all I got were center-point samples (an array of values that were all 128).<\/p>\n

    Even if the API did work, I’m not sure if it would have been that useful. Per my reading of the AnalyserNode API, it only returns data as a single channel. Why would I want that? My application supports audio with 2 channels. I want 2 channels of data<\/strong> for visualization.<\/p>\n

    How To Synchronize<\/strong>
    \nSo I rolled my own visualization solution by maintaining a circular buffer of audio when samples were being generated. Then, requestAnimationFrame() provided the rendering callbacks. The next problem was audio-visual sync. But that certainly is not unique to this situation– maintaining proper A\/V sync is a perennial puzzle in real-time multimedia programming. I was able to glean enough timing information from the environment to achieve reasonable A\/V sync (verify for yourself).<\/p>\n

    Pause\/Resume<\/strong>
    \nThe next problem I encountered with the Web Audio API was pause\/resume facilities, or the lack thereof. For all its bells and whistles, the API’s omission of such facilities seems most unusual, as if the design philosophy was, “Once the user starts playing audio, they will never, ever have cause to pause the audio.”<\/p>\n

    Then again, I must understand that mine is not a use case that the design committee considered and I’m subverting the API in ways the designers didn’t intend. Typical use cases for this API seem to include such workloads as:<\/p>\n