Native interop

AudioBits API · 0.2.0 · Available on npm.

Native access requires startup. The engine already connects master output to the destination; keep a tap's output unconnected to avoid duplicate audible routing.

import { createAudio } from "audiobits";
const audio = createAudio();
let detach: (() => void) | undefined;
let analyser: AnalyserNode | undefined;
export async function attachFromGesture() {
  await audio.start();
  const native = audio.native;
  analyser = native.context.createAnalyser();
  detach = native.connect(analyser);
  const samples = new Float32Array(analyser.fftSize);
  analyser.getFloatTimeDomainData(samples);
  return samples;
}
export async function dispose() {
  detach?.();
  analyser?.disconnect();
  await audio.dispose();
}

Call this single attachment helper once per engine. The tap helper rejects foreign contexts, duplicate taps, the output itself, and destination connections. Detach is idempotent. A continuous host visualizer must also cancel its animation frame and pause updates when hidden or reduced motion is requested.

Caller-created nodes, sources, and events remain caller-owned. Stop unmanaged sources explicitly; stopAll() covers only managed voices. Dispose or disconnect your nodes before engine teardown. Native graphs are not serializable recipes. Closing the engine context invalidates retained native handles without transferring their ownership. The vanilla workspace demonstrates a continuous analyser readout. The catalog and homepage draw measured output from a caller-owned analyser tap without an additional visualization library.