ネイティブバインディング

Name: libsonare
Author: libraz

libsonare には 3 つのバインディングがあります。ブラウザ向けの WASM、Python、そして Node.js ネイティブアドオン です。このページでは 3 つすべてを比較して選べるようにし、さらに Node ネイティブアドオンを詳しく解説します。各言語の詳細は個別の API ページを参照してください。

Python API — ctypes ベースのバインディング、PyPI でホイールを配布
Node.js（N-API） — C++ の性能を直接活用するネイティブアドオン（以下に記載）

初学者向けには、選び方は単純です。スクリプトやノートブックなら Python、ブラウザアプリなら WASM、Node.js からネイティブのファイルデコードや実行性能が必要な場合だけ Node ネイティブを選びます。

作りたいもの	使う	パッケージ
ブラウザアプリ	WASM	`@libraz/libsonare`
Python スクリプトやノートブック	Python	`pip install libsonare`
ネイティブデコードや性能が必要な Node.js アプリ	Node ネイティブ	`@libraz/libsonare-native`

このページで身につくこと

このページを読むと、次のことを判断・実行できるようになります。

ブラウザ WASM、Python、Node ネイティブを、同じものとしてではなく用途で選べる。
ネイティブデコードや実行性能が必要なときに、Node N-API アドオンをビルドして import できる。
どの例が @libraz/libsonare を使い、どの例が @libraz/libsonare-native を使うかを区別できる。
ネイティブアドオンの関数を、JavaScript、Python、マスタリング、ミキシングの広いドキュメントへ対応づけられる。

比較

	WebAssembly	Python	Node.js（N-API）
プラットフォーム	ブラウザ	デスクトップ	デスクトップ
配布	npm (`@libraz/libsonare`)	PyPI (`pip install libsonare`)	ソース (`bindings/node`)
ビルド	Emscripten	ビルド済みホイール（または CMake + pip）	CMake + cmake-js
パフォーマンス	ネイティブに近い	ネイティブ	ネイティブ
ストリーミング	対応	対応	対応
ファイル I/O	サンプルベース API。`Audio.fromMemory(...)` は WAV/MP3 バイト列をデコードでき、ブラウザフォールバックで対応形式も読めます	標準は WAV/MP3。FFmpeg 有効ビルドでは FFmpeg 対応形式	標準は WAV/MP3。FFmpeg 有効ビルドでは FFmpeg 対応形式
エフェクト	対応	対応	対応
特徴抽出	対応	対応	対応
逆再構成	対応	対応	対応
単位変換	対応	対応	対応
マスタリング	対応	対応	対応
ミキシング	対応	対応	対応

Node.js（N-API）

Node.js バインディングは N-API を使用したネイティブアドオンで、WebAssembly のオーバーヘッドなしに C++ の性能を直接活用できます。

N-API と「ネイティブアドオン」とは？

ネイティブアドオン は、Node が通常のパッケージのように読み込むコンパイル済み C/C++ モジュールで、JavaScript や WebAssembly ではなく実際の機械語で動きます。

N-API（Node-API）は、こうしたアドオンを作るために Node が提供する安定したインターフェースで、V8 エンジンの内部実装からアドオンを隔離します。そのため、コンパイル済みバイナリ 1 つが再ビルドなしで Node の各バージョンで動き続けます。

利点はネイティブ速度と Node からの直接ファイルデコードです。一方で、WASM パッケージのようにどこでも同じバイナリが動くわけではないため、プラットフォームごとにビルド／インストールが必要です。

Node パッケージの選び方

パッケージ	初期化	使いどころ
`@libraz/libsonare`	使う前に `await init()` を呼ぶ	ブラウザ互換の WASM パッケージ、またはブラウザデモと同じ API が必要な場合
`@libraz/libsonare-native`	WASM 初期化は不要。import して直接呼び出す	ネイティブのファイルデコード、ネイティブ実行性能、ソースツリー内アドオン開発が必要な場合

JavaScript API の例は WASM パッケージを使います。以下の例は、import パスが明示的に @libraz/libsonare でない限りネイティブアドオンの例です。

要件

Node.js 22 以上
CMake 3.16 以上
C++17 対応コンパイラ
Yarn 4 以上

インストール

bash

git clone https://github.com/libraz/libsonare.git
cd libsonare/bindings/node
yarn install
yarn build

マスタリング API

Node.js では WASM npm パッケージとネイティブアドオンの 2 経路があります。

パッケージ	使いどころ
`@libraz/libsonare`	ブラウザデモと同じ API を使いたい、または Web 互換の WASM が必要な場合。
`@libraz/libsonare-native`	Node.js でネイティブのファイルデコードやネイティブ実行性能が必要な場合。

typescript

import {
  masterAudioStereo,
  masteringChainStereo,
  masteringAssistantSuggest,
  masteringAudioProfile,
  masteringPresetNames,
  masteringPairAnalyze,
  masteringProcessorNames,
  masteringStreamingPreview,
} from '@libraz/libsonare-native'

console.log(masteringProcessorNames())
console.log(masteringPresetNames())

const mastered = masteringChainStereo(left, right, sampleRate, {
  dynamics: {
    compressor: {
      thresholdDb: -18,
      ratio: 2.2,
      autoMakeup: true,
    },
  },
  loudness: {
    targetLufs: -14,
    ceilingDb: -1,
    truePeakOversample: 4,
  },
})
console.log(mastered.outputLufs, mastered.stages)

const presetMaster = masterAudioStereo(left, right, sampleRate, 'pop', {
  'loudness.targetLufs': -14,
})
console.log(presetMaster.outputLufs, presetMaster.stages)

const matchReport = JSON.parse(
  masteringPairAnalyze('match.referenceLoudness', source, reference, sampleRate),
)

const masteredWithProgress = masteringChainStereo(left, right, sampleRate, {
  loudness: { targetLufs: -14, ceilingDb: -1, truePeakOversample: 4 },
}, (progress, stage) => {
  console.log(`render ${(progress * 100).toFixed(0)}%: ${stage}`)
})
console.log(masteredWithProgress.outputLufs)

const profile = JSON.parse(masteringAudioProfile(samples, sampleRate, {
  nFft: 2048,
  hopLength: 512,
  truePeakOversample: 4,
}))
const suggestions = JSON.parse(masteringAssistantSuggest(samples, sampleRate, {
  targetLufs: -14,
  ceilingDb: -1,
  preferStreamingSafe: true,
}))
const deliveryPreview = JSON.parse(masteringStreamingPreview(samples, sampleRate, [
  { name: 'Streaming', targetLufs: -14, ceilingDb: -1 },
]))
console.log(profile, suggestions, deliveryPreview)

アシスタント／プロファイル系ヘルパーは、WASM 入口と同じオプション名を受け取ります。プロファイル設定は nFft、hopLength、truePeakOversample、アシスタント設定は targetLufs、ceilingDb、enableRepair、preferStreamingSafe、speechMonoAmount です。共有ネイティブパーサーを通るため、snake_case の別名も受け付けます。

長尺のオフラインレンダリングでは、masteringChain(...)、masteringChainStereo(...)、masterAudio(...)、masterAudioStereo(...) の最後に進捗コールバックを渡し、そこから Node UI を更新します。

WASM パッケージは、ブラウザデモと同じ camelCase のマスタリング API を公開しています。主なグループは次の通りです。

グループ	API 名
プリセットと簡易入口	`mastering()`、`masteringPresetNames()`、`masterAudio()`、`masterAudioStereo()`、`masterAudioWithProgress()`、`masterAudioStereoWithProgress()`
フルチェーン	`masteringChain()`、`masteringChainStereo()`、`masteringChainWithProgress()`、`masteringChainStereoWithProgress()`
オフラインのダイナミクス（単発）	`masteringDynamicsCompressor()`、`masteringDynamicsGate()`、`masteringDynamicsTransientShaper()`
オフラインのリペア（単発）	`masteringRepairDeclick()`、`masteringRepairDeclip()`、`masteringRepairDecrackle()`、`masteringRepairDehum()`、`masteringRepairDenoiseClassical()`、`masteringRepairDereverbClassical()`、`masteringRepairTrimSilence()`
アシスタントとプロファイル	`masteringAudioProfile()`、`masteringAssistantSuggest()`、`masteringStreamingPreview()`
名前付きプロセッサ	`masteringProcessorNames()`、`masteringProcessorCatalog()`、`masteringInsertNames()`、`masteringInsertParamNames(name)`、`masteringInsertParamInfo(name)`、`masteringProcess()`、`masteringProcessStereo()`
ペア処理とステレオ解析	`masteringPairProcessorNames()`、`masteringPairProcess()`、`masteringPairAnalysisNames()`、`masteringPairAnalyze()`、`masteringStereoAnalysisNames()`、`masteringStereoAnalyze()`
ストリーミングレンダー	`StreamingMasteringChain`

Node ネイティブは同じ基本名を使いますが、進捗は個別の *WithProgress ラッパー関数ではなく、最後のオプション引数に渡すコールバックとして受け取ります。

ミキシング API

ネイティブアドオンと WASM パッケージのどちらからも、ミキシング API を使えます。入口は mixStereo(...)、mixingScenePresetNames()、mixingScenePresetJson()、保持して使う Mixer クラスです。

チャンネルストリップ処理、シーンプリセット、センド、バス、オートメーション、メーター、オフラインのステムレンダーに使います。

ランタイム横断の説明はミキシングエンジンを参照してください。

永続ミキサーでは、Node ネイティブは多くのストリップ制御メソッドで StripRef（number | string）を受け取ります。WASM メソッドは数値のストリップインデックスを使い、ID からは stripById(id) で引きます。

Node の stripMeter(strip) はポストフェーダーメーターを読みます。タップを明示したい場合は meterTap(strip, 'preFader' | 'postFader') を使います。シーン JSON の読み込み後は、mixer.sceneWarnings() がどのプロセッサも消費しなかった insert パラメータ(典型的にはタイプミス)を非致命的な警告として一覧します。

プロジェクト・インストゥルメント・ライブ MIDI

Node ネイティブアドオンは、WASM や Python と同じヘッドレス DAW サーフェスを公開しています。Project クラス（トラック、クリップ、テンポ、undo/redo、SMF／MIDI 2.0 入出力）、インストゥルメント付きバウンス（bounceWithSynthInstrument(s) と SoundFont のロード）、NativeSynth プリセットカタログ（synthPresetNames()／synthPresetPatch()／SynthPatch）、chordFunctionalAnalysis(...)、そしてライブ MIDI 入力付きの RealtimeEngine が使えます。エンジンには他のバインディングと同じレーンミキサーと MIDI クリップスケジュールが載っています — setTrackLanes / setTrackBuses、トラック／マスター／バスのストリップ JSON セッター、キュー可能な setSoloMute、トラックのパン／パンロー／パンモード／デュアルパン／チャンネルディレイ設定、名前指定インサートパラメータ設定、ワイド／スコープテレメトリ、setMidiClips、sampleAtPpq を、WASM と同じ camelCase 名で使えます（リアルタイムとストリーミングを参照）。ブラウザ専用のグルー（bindWebMidi、bindMicrophoneInput）は WASM 固有で、ネイティブアドオンには含まれません。

詳細は各ガイドを参照してください: プロジェクト編集、プロジェクトのバウンス、内蔵シンセサイザー、SoundFont プレイヤー、MIDI 入力。

エラーハンドリング

WASM パッケージと同じく、ネイティブアドオンもネイティブ側の失敗をすべて構造化された SonareError としてスローします。Error のサブクラスで、C ABI のエラー enum を映した数値の code と正準名 codeName を持ちます。両パッケージとも ErrorCode・SonareError・型ガード isSonareError(value) をエクスポートし、同じ失敗はどのバインディングでも同じ数値コードを報告します。コード表と使用例はエラーハンドリングを参照してください。

Audio ラッパーの違い

WASM の Audio クラスは、よく使う単発ヘルパー向けの便利なラッパーです。BPM／キー／ビート／コードなどの基本解析、HPSS／編集、マスタリング、特徴量抽出、ラウドネス、リサンプリングをメソッドとして持ちます。

analyzeSections(...)、analyzeMelody(...)、analyzeDynamics(...)、analyzeTimbre(...)、ルーム音響解析・推定・RIR 合成・ルームモーフィングのような個別ヘルパーは、WASM ラッパーではスタンドアロンのままです。

Node ネイティブの Audio ラッパーは、ネイティブアドオンへ直接委譲できるため範囲が広くなっています。

共通メソッドに加えて、次のような focused helper も Audio メソッドとして持ちます: analyzeBpm(...)、analyzeImpulseResponse(...)、detectAcoustic(...)、analyzeRhythm(...)、analyzeDynamics(...)、analyzeTimbre(...)、detectChords(...)。ルーム系ヘルパーの estimateRoom(...)、synthesizeRir(...)、roomMorph(...) はスタンドアロン関数のままです。

読み込み入口も異なります。Node ネイティブは Audio.fromFile(...) と Audio.fromMemory(...) に対応します。WASM は Audio.fromBuffer(...)、Audio.fromMemory(...)、Audio.fromMemoryWithBrowserFallback(...) に対応します。

StreamingMasteringChain

ネイティブアドオン（および WASM パッケージ）は、ブロック単位でレンダリングする StreamingMasteringChain クラスも公開しています。Electron アプリやワーカー、音声入力パイプラインなどから、masteringChain() と同じネスト構造の設定を使ってブロックごとに処理を進められます。

typescript

import { StreamingMasteringChain } from '@libraz/libsonare-native';

const chain = new StreamingMasteringChain({
  eq: { tilt: { tiltDb: 0.5 } },
  dynamics: { compressor: { thresholdDb: -20 } },
  maximizer: { truePeakLimiter: { ceilingDb: -1, oversampleFactor: 4 } },
});

chain.prepare(48000, /*maxBlockSize=*/512, /*numChannels=*/2);

const monoOut = chain.processMono(monoBlock);
const { left, right } = chain.processStereo(leftBlock, rightBlock);

console.log(chain.stageNames(), chain.latencySamples());
chain.reset();   // 状態だけクリア（prepare し直さない）

numChannels === 1 のときはステレオ専用ステージはスキップされます。ストリーミングチェーンはオフライン専用の repair 段と、ファイル全体が必要な loudness 段を拒否します。これらが必要な場合は masteringChain* または masterAudio* を使ってください。WASM ビルドは追加で chain.delete() を公開しておりハンドルを解放できます。ネイティブアドオンは GC で自動的に解放します。

関連するマスタリングガイド: ブラウザ内ローカル処理、リファレンスマッチ、品質チェックリスト。

StreamingEqualizer

StreamingEqualizer は Node ネイティブ、Python、WASM で使えます。

processMono / processStereo の呼び出しをまたいで EQ の状態を保持し、スペクトラムスナップショットを出せます。リファレンスマッチからバンドを設定することもできます。

Node ネイティブと WASM は同じフェーズモード値を受け取ります。Python はさらにコンテキストマネージャ構文もサポートします。

ランタイム	フェーズモード
Node ネイティブ	`'zero'`, `'natural'`, `'linear'`, または `1`/`2`/`3`
WASM ラッパー	`'zero'`, `'natural'`, `'linear'`, または `1`/`2`/`3`（Node ネイティブと同じ）
Python	文字列または数値モード

Python では with StreamingEqualizer(...) as eq: / eq.close() で解放できます。

typescript

import { StreamingEqualizer } from '@libraz/libsonare-native';

const eq = new StreamingEqualizer({ sampleRate: 48000, maxBlockSize: 512 });
eq.setBand(0, { type: 'HighShelf', frequencyHz: 8000, gainDb: 4, enabled: true });
eq.setPhaseMode('natural');
eq.setAutoGain(true);

const { left, right } = eq.processStereo(leftBlock, rightBlock);
console.log(eq.spectrum(), eq.latencySamples(), left, right);

@libraz/libsonare-native は現在、ソースツリー内の bindings/node でビルドして使う前提です。別プロジェクトから使う場合は、ビルド済みのローカルパッケージをワークスペースや file: 依存として参照してください。

ネイティブビルドは pkg-config で FFmpeg 開発ライブラリを自動検出します。 FFmpeg がない場合は WAV/MP3 のみをデコードします。明示的に指定する場合は次の環境変数を使います。

bash

SONARE_FFMPEG=1 yarn build  # FFmpeg デコードを必須にする
SONARE_FFMPEG=0 yarn build  # WAV/MP3 のみに固定する

使用例

typescript

import {
  Audio, analyze, detectBpm, detectKey, detectBeats, version
} from '@libraz/libsonare-native';

// 音声を読み込み
const audio = Audio.fromFile('music.mp3');
const samples = audio.getData();
const sampleRate = audio.getSampleRate();

// 個別の解析
const bpm = detectBpm(samples, sampleRate);
const key = detectKey(samples, sampleRate);
const beats = detectBeats(samples, sampleRate);

// フル解析
const result = analyze(samples, sampleRate);
console.log(`BPM: ${result.bpm}`);
console.log(`キー: ${result.key.name}`);     // "C major" など
console.log(`ビート数: ${result.beatTimes.length}`);

API リファレンス

Audio

メソッド	説明
`Audio.fromFile(path)`	WAV/MP3 ファイルを読み込み。FFmpeg 有効ビルドでは FFmpeg 対応形式も読み込めます
`Audio.fromBuffer(samples, sampleRate?)`	`Float32Array` から作成
`Audio.fromMemory(data)`	`fromFile` と同じ形式対応で、`Buffer` / `Uint8Array` をデコード
`audio.getData()`	サンプルの `Float32Array`
`audio.getSampleRate()`	サンプルレート（Hz）
`audio.getDuration()`	長さ（秒）
`audio.getLength()`	サンプル数
`audio.destroy()`	ネイティブハンドルを解放。GC でも回収されますが、長時間動くプロセスで確実に解放したい場合に呼び出します

Audio インスタンスは、以下の解析・エフェクト・特徴量関数を同じデフォルト値でメソッドとしても呼び出せます（例: audio.detectBpm()、audio.masteringChain(config)）。

`using` によるクリーンアップ（Node 22 以上）

ネイティブハンドルを持つクラス（Audio、RealtimeEngine、Project、Mixer、 ClipPageProvider）はすべて [Symbol.dispose] を実装しています。そのため Node 22 以上では using キーワードを使うと、スコープを抜けるときに例外発生時でも安全に自動でクリーンアップできます。

typescript

import { RealtimeEngine } from '@libraz/libsonare-native';

function render() {
  using engine = new RealtimeEngine(48000, 128);
  engine.setTempo(120);
  // 例外が起きても、このスコープを抜けるときにハンドルが解放されます。
}

Node 22 未満では、これまでどおり try/finally で明示的に解放するパターンを使ってください。すべてのハンドルクラスでネイティブの正規の解放メソッドは destroy() です。Project と Mixer は WASM 互換のエイリアスとして delete() も公開します。ハンドルは最終的に GC でも回収されますが、using や明示的な解放のほうが決定的なクリーンアップになるため、長時間動くプロセスではそちらを推奨します。

解析関数

関数	戻り値	説明
`detectBpm(samples, sampleRate?)`	`number`	テンポ（BPM）
`detectKey(samples, sampleRate?)`	`Key`	ルート、モード、確信度
`detectBeats(samples, sampleRate?)`	`Float32Array`	ビート位置
`detectOnsets(samples, sampleRate?)`	`Float32Array`	オンセット位置
`detectChords(samples, sampleRate?, minDuration?, smoothingWindow?, threshold?, useTriadsOnly?, nFft?, hopLength?, useBeatSync?, useHmm?, hmmBeamWidth?, useKeyContext?, keyRoot?, keyMode?, detectInversions?, chromaMethod?)`	`ChordAnalysisResult`	コード進行（開始／終了時刻付き）。末尾の引数で HMM 平滑化・キーコンテキスト・転回形・クロマ手法（既定 `'stft'`）を制御
`detectDownbeats(samples, sampleRate?)`	`Float32Array`	小節頭（ダウンビート）の位置
`detectKeyCandidates(samples, sampleRate?, options?)`	`KeyCandidate[]`	相関スコア付きのキー候補ランキング
`analyze(samples, sampleRate?)`	`AnalysisResult`	1 回の呼び出しでフル解析: `bpm`、`bpmConfidence`、`key`、`timeSignature`、`beatTimes`、`beats` に加えて `chords`、`sections`、`timbre`、`dynamics`、`rhythm`、`melody`、`form`。以下の専用 `detect`／`analyze` 関数は、個別解析やパラメータ指定の解析向けに引き続き利用できます
`analyzeWithProgress(samples, sampleRate?, onProgress?)`	`AnalysisResult`	`analyze` と同じ。長尺入力向けに `(progress, stage)` コールバックを受け取ります
`analyzeBpm(samples, sampleRate?, options?)`	`BpmAnalysisResult`	確信度と候補付きテンポ。`options`: `bpmMin`、`bpmMax`、`startBpm`、`nFft`、`hopLength`、`maxCandidates`
`analyzeRhythm(samples, sampleRate?, options?)`	`RhythmResult`	拍子・グルーブ・シンコペーション。`options`: `bpmMin`、`bpmMax`、`startBpm`、`nFft`、`hopLength`
`analyzeDynamics(samples, sampleRate?, options?)`	`DynamicsResult`	ダイナミックレンジ・ラウドネスレンジ・クレストファクター。`options`: `windowSec`、`hopLength`、`compressionThreshold`
`analyzeTimbre(samples, sampleRate?, options?)`	`TimbreResult`	明るさ・暖かさ・密度・粗さ・複雑さと、窓ごとの `timbreOverTime`。`options`: `nFft`、`hopLength`、`nMels`、`nMfcc`、`windowSec`
`analyzeSections(samples, sampleRate?, options?)`	`Section[]`	構造セクション（イントロ／ヴァース／コーラスなど）と時刻。`options`: `nFft`、`hopLength`、`minSectionSec`。長尺入力では境界グリッドがプーリングされる場合があるため、配置には各セクションの `start` / `end` を使います
`analyzeMelody(samples, sampleRate?, options?)`	`MelodyResult`	主旋律の輪郭（フレームごとの F0）。`options`: `fmin`、`fmax`、`frameLength`、`hopLength`、`threshold`、`usePyin`、`center`
`detectAcoustic(samples, sampleRate?, options?)`	`AcousticResult`	録音からの室内音響（RT60 など）。`options`: `nOctaveBands`、`nThirdOctaveSubbands`、`minDecayDb`、`noiseFloorMarginDb`
`analyzeImpulseResponse(samples, sampleRate?, nOctaveBands?)`	`AcousticResult`	測定済みインパルス応答からの室内音響
`estimateRoom(samples, sampleRate?, options?)`	`RoomEstimateResult`	体積、寸法、DRR、吸音率バンド、RT60 バンド、信頼度を含む等価ルーム推定
`synthesizeRir(options?)`	`RirResult`	シューボックス形状からのモノラル RIR
`roomMorph(samples, sampleRate, options?)`	`Float32Array`	目標ルームへ寄せるオフラインのルームモーフィング
`lufs(samples, sampleRate?)`	`LufsResult`	統合・モーメンタリー・ショートタームラウドネスとラウドネスレンジ（ITU-R BS.1770）
`lufsInterleaved(samples, channels, sampleRate?)`	`LufsResult`	インターリーブサンプルからチャンネル重み付きマルチチャンネルラウドネスを測定
`ebur128LoudnessRange(samples, sampleRate?)`	`number`	EBU R128 loudness range（LRA、LU 単位）
`momentaryLufs(samples, sampleRate?)`	`Float32Array`	モーメンタリーラウドネス（400ms）の時系列
`shortTermLufs(samples, sampleRate?)`	`Float32Array`	ショートタームラウドネス（3s）の時系列
`version()`	`string`	ライブラリバージョン
`voiceChangerAbiVersion()`	`number`	リアルタイムボイスチェンジャー POD 設定の ABI バージョン。プリセット JSON の `schemaVersion` とは別
`voiceCharacterPresetId(preset)`	`VoicePresetId \| null`	序数または ID から正規の voice-character プリセット ID を返す
`realtimeVoiceChangerPresetConfig(preset)`	`RealtimeVoiceChangerConfig`	JSON 解析なしで、組み込みボイスプリセットの解決済みフラット POD 設定を返す。未知のプリセット名や範囲外の序数では例外を投げる
`hasFfmpegSupport()`	`boolean`	読み込まれたネイティブアドオンが FFmpeg デコードに対応しているか

デフォルトの sampleRate は、ヘルパーの種類によって異なります。

ヘルパー	デフォルト `sampleRate`
楽曲解析、エフェクト、特徴量、ラウドネス系ヘルパー	`22050`
ネイティブラッパーの `analyzeImpulseResponse`、`detectAcoustic`、`estimateRoom`、`synthesizeRir`	`48000`

主要なヘルパーは Audio インスタンスメソッドとしても利用できます。ただし、analyzeSections(...)、analyzeMelody(...)、cqt(...)、vqt(...) など一部の詳細ヘルパーは、スタンドアロン関数として audio.getData() と audio.getSampleRate() を渡します。

下の表は Node ネイティブラッパーのシグネチャです。WASM パッケージも同じ camelCase 名を使いますが、sampleRate の後ろに必須引数がある関数では、その sampleRate 位置も渡す必要があります。ブラウザ向けの正確なシグネチャは JavaScript API を参照してください。

非同期版（Node 専用）

Node アドオンは、Promise 返却版も公開しています。これらは DSP パイプラインを libuv のワーカースレッドで実行するため、JS イベントループをブロックしません。

戻り値の形は同期版と同じです。ただし Node ネイティブ専用で、WASM ビルドにワーカースレッド相当はありません。

非同期版では進捗コールバックを使えません。進捗が必要な場合は onProgress 付きの同期版を使います。並行実行だけが目的なら、複数の非同期呼び出しを同時に走らせます。

関数	戻り値	説明
`analyzeAsync(samples, sampleRate?)`	`Promise<AnalysisResult>`	`analyze(...)` の非同期版
`masterAudioAsync(samples, sampleRate?, presetName?, overrides?)`	`Promise<MasteringChainResult>`	`masterAudio(...)` の非同期版
`masterAudioStereoAsync(left, right, sampleRate?, presetName?, overrides?)`	`Promise<MasteringChainStereoResult>`	`masterAudioStereo(...)` の非同期版

エフェクト関数

関数	戻り値	説明
`hpss(samples, sr?, kernelHarmonic?, kernelPercussive?)`	`HpssResult`	倍音成分／打撃成分の分離（HPSS）
`hpssWithResidual(samples, sr?, kernelHarmonic?, kernelPercussive?)`	`HpssWithResidualResult`	倍音、打撃、残差を返す HPSS
`harmonic(samples, sr?)`	`Float32Array`	倍音成分の抽出
`percussive(samples, sr?)`	`Float32Array`	打撃成分の抽出
`timeStretch(samples, rate, sr?)`	`Float32Array`	ピッチを変えずにテンポを変更
`phaseVocoder(samples, rate, sr?, nFft?, hopLength?)`	`Float32Array`	直接のフェーズボコーダー時間伸縮
`pitchShift(samples, semitones, sr?)`	`Float32Array`	長さを変えずにピッチを変更
`remix(samples, intervals, sr?, alignZeros?)`	`Float32Array`	サンプル区間の並べ替え／連結
`normalize(samples, sr?, targetDb?)`	`Float32Array`	目標 dB にノーマライズ（デフォルト: 0.0）
`trim(samples, sr?, thresholdDb?)`	`Float32Array`	無音区間をトリム（デフォルト: -60.0 dB）
`resample(samples, srcSr, targetSr)`	`Float32Array`	目標サンプルレートへリサンプリング
`pitchCorrectToMidi(samples, sr, currentMidi, targetMidi)`	`Float32Array`	保持された音を MIDI ピッチ間で補正
`noteStretch(samples, sr?, options?)`	`Float32Array`	1 つの音の区間をその場でタイムストレッチ。`options` は `{ onsetSample, offsetSample, stretchRatio }`
`voiceChange(samples, sr?, options?)`	`Float32Array`	ボイス変換のためのピッチ＋フォルマントシフト。`options` は `{ pitchSemitones, formantFactor }`

trim(...) は単純なしきい値ベースの編集ヘルパーです。下の trimSilence(...) は librosa 互換のフレーム RMS ベースのヘルパーで、元音源上のサンプル範囲も返します。

特徴抽出関数

関数	戻り値	説明
`stft(samples, sr?, nFft?, hopLength?)`	`StftResult`	短時間フーリエ変換
`stftDb(samples, sr?, nFft?, hopLength?)`	`StftDbResult`	dB 単位の STFT
`melSpectrogram(samples, sr?, nFft?, hopLength?, nMels?)`	`MelSpectrogramResult`	メルスペクトログラム
`mfcc(samples, sr?, nFft?, hopLength?, nMels?, nMfcc?)`	`MfccResult`	メル周波数ケプストラム係数
`chroma(samples, sr?, nFft?, hopLength?)`	`ChromaResult`	クロマ特徴量
`spectralCentroid(samples, sr?, nFft?, hopLength?)`	`Float32Array`	フレームごとのスペクトル重心
`spectralBandwidth(samples, sr?, nFft?, hopLength?)`	`Float32Array`	フレームごとのスペクトル帯域幅
`spectralRolloff(samples, sr?, nFft?, hopLength?, rollPercent?)`	`Float32Array`	フレームごとのスペクトルロールオフ
`spectralFlatness(samples, sr?, nFft?, hopLength?)`	`Float32Array`	フレームごとのスペクトル平坦度
`spectralContrast(samples, sr?, nFft?, hopLength?, nBands?, fmin?, quantile?)`	`Matrix2dResult`	スペクトルコントラスト。形状は `(nBands + 1) x nFrames`
`spectralEdit(samples, sr, ops?, options?)`	`Float32Array`	`gain`、`attenuate`、`mute`、`heal` を使う領域指定 STFT 編集
`polyFeatures(samples, sr?, nFft?, hopLength?, order?)`	`Matrix2dResult`	フレームごとの多項式スペクトル係数
`zeroCrossingRate(samples, sr?, frameLength?, hopLength?)`	`Float32Array`	フレームごとのゼロ交差率
`zeroCrossings(samples, threshold?, refMagnitude?, pad?, zeroPos?)`	`Int32Array`	ゼロ交差サンプル位置
`rmsEnergy(samples, sr?, frameLength?, hopLength?)`	`Float32Array`	フレームごとの RMS エネルギー
`pitchYin(samples, sr?, frameLength?, hopLength?, fmin?, fmax?, threshold?, fillNa?)`	`PitchResult`	YIN ピッチ推定。無声音の `f0` は `fillNa` が true でない限り `NaN`
`pitchPyin(samples, sr?, frameLength?, hopLength?, fmin?, fmax?, threshold?, fillNa?)`	`PitchResult`	pYIN ピッチ推定。無声音の `f0` は `fillNa` が true でない限り `NaN`
`pitchTuning(frequencies, resolution?, binsPerOctave?)`	`number`	周波数列からチューニングずれを推定
`estimateTuning(samples, sr?, nFft?, hopLength?, resolution?, binsPerOctave?)`	`number`	音声からチューニングずれを推定
`cqt(samples, sr?, hopLength?, fmin?, nBins?, binsPerOctave?)`	`CqtResult`	定 Q 変換の振幅
`vqt(samples, sr?, hopLength?, fmin?, nBins?, binsPerOctave?, gamma?)`	`CqtResult`	可変 Q 変換の振幅（`gamma` で Q を制御）
`nnlsChroma(samples, sr?)`	`{ nChroma, nFrames, data }`	NNLS クロマグラム（音符活性化クロマ）
`decompose(s, nFeatures, nFrames, nComponents, nIter?, beta?)`	`DecomposeResult`	行優先スペクトログラムから NMF 分解行列を返す
`hybridCqt(samples, sr?, hopLength?, fmin?, nBins?, binsPerOctave?)`	`CqtResult`	ハイブリッド CQT 振幅（低域は真の CQT、高域は擬似 CQT）
`pseudoCqt(samples, sr?, hopLength?, fmin?, nBins?, binsPerOctave?)`	`CqtResult`	近似（擬似）CQT 振幅（単一 FFT）
`bassChroma(samples, sr?, hopLength?, nChroma?)`	`ChromaResult`	低域重視クロマ（低音域のピッチクラス分布）
`chromaCens(samples, sr?, hopLength?, nChroma?)`	`ChromaResult`	CENS エネルギー正規化・平滑化クロマ
`onsetStrengthMulti(samples, sr?, nFft?, hopLength?, nMels?, nBands?)`	`{ nBands, nFrames, data }`	マルチバンドオンセット強度（`nBands` 既定 3、`data` は行優先 `[nBands x nFrames]`）
`decomposeWithInit(s, nFeatures, nFrames, nComponents, nIter?, beta?, init?)`	`DecomposeResult`	`init` を選択できる NMF 分解行列（`'random'` 既定、`'nndsvd'`）
`nnFilter(s, nFeatures, nFrames, aggregate?, k?, width?)`	`Matrix2dResult`	近傍フィルタ
`onsetEnvelope(samples, sr?, nFft?, hopLength?, nMels?)`	`Float32Array`	オンセット強度包絡（テンポグラム系の入力）

デフォルトパラメータ: nFft=2048、hopLength=512、nMels=128、nMfcc=20、ピッチ検出の fmin=65.0、fmax=2093.0、threshold=0.3、rollPercent=0.85。CQT/VQT は fmin=32.70319566 Hz（C1）、nBins=84、binsPerOctave=12 を使います。bassChroma／chromaCens は nChroma=12、onsetStrengthMulti は nBands=3、decomposeWithInit は nIter=50・beta=2・init='random' が既定です。

逆再構成関数

メルスペクトログラムや MFCC 行列から、スペクトルや音声を再構成します。位相は Griffin-Lim で推定するため往復はロスを伴います。詳細は逆変換特徴量を参照してください。

関数	戻り値	説明
`melToStft(mel, nMels, nFrames, sampleRate?, nFft?, fmin?, fmax?, htk?)`	`InverseStftResult`	メルスペクトログラムから線形 STFT パワーへ
`melToAudio(mel, nMels, nFrames, sr?, nFft?, hopLength?, nIter?, fmin?, fmax?)`	`Float32Array`	メルスペクトログラムから音声へ（Griffin-Lim）
`mfccToMel(mfcc, nMfcc, nFrames, nMels?)`	`InverseMelResult`	MFCC 係数からメルスペクトログラムへ
`mfccToAudio(mfcc, nMfcc, nFrames, nMels?, sampleRate?, nFft?, hopLength?, fmin?, fmax?, nIter?, htk?)`	`Float32Array`	MFCC 係数から音声へ

librosa 互換ヘルパー

対応する librosa 関数の挙動に合わせています。マッピングの全体像は librosa 互換性を参照してください。

各ヘルパーの位置づけ

preemphasis / deemphasis — 高域を持ち上げる／戻す古典的な 1 タップ IIR の前処理。
trimSilence / splitSilence — 前後無音のトリムや、無音区間での区切り出し。
frameSignal / padCenter / fixLength / fixFrames — 固定フレーム DSP に通すためのフレーミング・サイズ揃え。
peakPick / vectorNormalize — 1 次元信号のピーク検出と、ベクトルのノルム正規化。
pcen — メルスペクトログラム向けの動的レンジ圧縮。
tonnetz — クロマを 6 次元のハーモニック空間へ射影。
tempogram / plp — オンセット包絡線から構築するテンポ表現と支配的なパルスの抽出。

関数	戻り値	説明
`preemphasis(samples, coef?, zi?)`	`Float32Array`	プリエンファシス
`deemphasis(samples, coef?, zi?)`	`Float32Array`	ディエンファシス
`trimSilence(samples, topDb?, frameLength?, hopLength?)`	`{ audio: Float32Array; startSample: number; endSample: number }`	`librosa.effects.trim`。しきい値 `trim(...)` とは別物
`splitSilence(samples, topDb?, frameLength?, hopLength?)`	`Int32Array`	`librosa.effects.split`。`[start0, end0, start1, end1, ...]` のフラット配列
`frameSignal(samples, frameLength, hopLength)`	`{ nFrames: number; frames: Float32Array }`	`librosa.util.frame`（row-major）
`padCenter(values, targetSize, padValue?)`	`Float32Array`	`librosa.util.pad_center`
`fixLength(values, targetSize, padValue?)`	`Float32Array`	`librosa.util.fix_length`
`fixFrames(frames, xMin?, xMax?, pad?)`	`Int32Array`	`librosa.util.fix_frames`
`peakPick(values, preMax, postMax, preAvg, postAvg, delta, wait)`	`Int32Array`	`librosa.util.peak_pick`
`vectorNormalize(values, normType?, threshold?)`	`Float32Array`	`librosa.util.normalize`。`normType`: 0=inf, 1=L1, 2=L2, 3=power。Node wrapper の `threshold` 既定値は `0.0`、WASM は `1e-12`
`pcen(values, nBins, nFrames, options?)`	`Float32Array`	`librosa.pcen`（row-major のメル入力）
`tonnetz(chromagram, nChroma, nFrames)`	`Float32Array`	`librosa.feature.tonnetz`（`[6 x nFrames]`）
`tempogram(onsetEnvelope, sr?, hopLength?, winLength?, mode?)`	`{ nFrames: number; winLength: number; data: Float32Array }`	`librosa.feature.tempogram`。`mode` は `'autocorrelation'`（既定）または `'cosine'`
`fourierTempogram(onsetEnvelope, sr?, hopLength?, winLength?)`	`{ nBins: number; nFrames: number; data: Float32Array }`	`librosa.feature.fourier_tempogram`
`cyclicTempogram(onsetEnvelope, sr, hopLength?, winLength?, bpmMin?, nBins?)`	`{ nFrames: number; nBins: number; data: Float32Array }`	巡回（テンポオクターブ不変）テンポグラム
`tempogramRatio(tempogramData, winLength?, sr?, hopLength?)`	`Float32Array`	`librosa.feature.tempogram_ratio`
`plp(onsetEnvelope, sr?, hopLength?, tempoMin?, tempoMax?, winLength?)`	`Float32Array`	`librosa.beat.plp`

変換関数

関数	説明
`hzToMel(hz)`	ヘルツ → Mel スケール
`melToHz(mel)`	Mel スケール → ヘルツ
`hzToMidi(hz)`	ヘルツ → MIDI ノート番号
`midiToHz(midi)`	MIDI ノート番号 → ヘルツ
`hzToNote(hz)`	ヘルツ → 音名（例: "A4"）
`noteToHz(note)`	音名 → ヘルツ
`framesToTime(frames, sr?, hopLength?)`	フレームインデックス → 秒（`sr` 既定 `22050`、`hopLength` 既定 `512`）
`timeToFrames(time, sr?, hopLength?)`	秒 → フレームインデックス（`sr` 既定 `22050`、`hopLength` 既定 `512`）
`framesToSamples(frames, hopLength?, nFft?)`	フレームインデックス → サンプルインデックス（`librosa.frames_to_samples`）
`samplesToFrames(samples, hopLength?, nFft?)`	サンプルインデックス → フレームインデックス（`librosa.samples_to_frames`）
`powerToDb(values, ref?, amin?, topDb?)`	パワー → dB（`librosa.power_to_db`）
`amplitudeToDb(values, ref?, amin?, topDb?)`	振幅 → dB（`librosa.amplitude_to_db`）
`dbToPower(values, ref?)`	dB → パワー
`dbToAmplitude(values, ref?)`	dB → 振幅

メータリング関数

レベル・ダイナミクス・ステレオイメージを測る単体メーターです。各関数は validate フラグ(既定 true)を持つ options を任意で受け取ります。ホットパスでは { validate: false } を渡して NaN/Inf 入力チェックを省略できます。ステレオメーターは left と right が同じ長さである必要があります。

関数	戻り値	説明
`meteringPeakDb(samples, sr?, options?)`	`number`	サンプルピーク(dBFS)
`meteringRmsDb(samples, sr?, options?)`	`number`	RMS レベル(dBFS)
`meteringCrestFactorDb(samples, sr?, options?)`	`number`	クレストファクター、ピーク − RMS(dB)
`meteringDcOffset(samples, sr?, options?)`	`number`	平均(DC)オフセット、リニア振幅
`meteringTruePeakDb(samples, sr?, oversampleFactor?, options?)`	`number`	インターサンプル(トゥルー)ピーク(dBFS)。`oversampleFactor` は 1..16 の 2 の冪(既定 4)
`meteringDetectClipping(samples, sr?, options?)`	`ClippingReport`	クリップしたサンプルの連続区間。`options` で `threshold`(既定 `0.999`)と `minRegionSamples`(既定 `1`)を指定
`meteringDynamicRange(samples, sr?, options?)`	`DynamicRangeReport`	スライディングウィンドウのダイナミックレンジ。`options` で `windowSec`・`hopSec`・`lowPercentile`・`highPercentile` を指定(省略時は既定値の窓 3 秒・ホップ 1 秒・low 0.10・high 0.95)
`meteringStereoCorrelation(left, right, sr?, options?)`	`number`	ピアソン相関、−1..1
`meteringStereoWidth(left, right, sr?, options?)`	`number`	ミッド/サイドのステレオ幅
`meteringVectorscope(left, right, sr?, options?)`	`VectorscopeReport`	サンプルごとのミッド/サイド点列
`meteringPhaseScope(left, right, sr?, options?)`	`PhaseScopeReport`	フェーズスコープの点列と要約統計
`meteringSpectrum(samples, sr?, options?)`	`SpectrumReport`	単一フレームの振幅/パワー/dB スペクトラム。`options` で `nFft`・`applyOctaveSmoothing`・`octaveFraction`・`dbRef`・`dbAmin` を指定

スケール量子化

ピッチ補正ターゲットを構築するための 12-TET スケールヘルパーです。

modeMask は 12 ビットのマスクです。ビット i が、root（PitchClass、C = 0）を基準とした i 番目のピッチクラスを有効化します。自然な長調は 0b101010110101 です。

referenceMidi はチューニング基準音です。A4 = 69 にするには 0 を渡します。pitchCorrectToMidi(...) と組み合わせて最も近いスケール構成音へリチューンします。

関数	戻り値	説明
`scaleQuantizeMidi(root, modeMask, midi, referenceMidi?)`	`number`	小数を含む MIDI 番号を最も近い有効なピッチクラスへスナップ
`scaleCorrectionSemitones(root, modeMask, midi, referenceMidi?)`	`number`	補正量（量子化後 − 入力）をセミトーンで返す
`scalePitchClassEnabled(root, modeMask, pitchClass)`	`boolean`	`pitchClass`（0..11）が `root` を基準に有効か

ストリーミング／リアルタイムクラス

一括処理の関数に加えて、ネイティブアドオンは WASM ビルドと同じストリーミング／リアルタイムクラスを公開します。

クラス	用途
`StreamAnalyzer`	ブロック単位の解析。プログレッシブな BPM/キー推定と `readFramesSoa`／`readFramesI16`／`readFramesU8`。リアルタイムストリーミングを参照。
`StreamingEqualizer`	リアルタイムセーフなブロック EQ。
`StreamingMasteringChain`	逐次的なマスタリングレンダリング（上記で解説）。
`RealtimeVoiceChanger`	プリセット駆動のライブ音声チェーン。ブロック処理向け。
`Mixer`	JSON シーンから構築する永続マルチストリップミキサー。ミキシングエンジンを参照。
`RealtimeEngine`	DAW 風ホスティング向けのトランスポート／クリップ／オートメーションエンジン。

typescript

import { StreamAnalyzer } from '@libraz/libsonare-native';

const analyzer = new StreamAnalyzer({ sampleRate: 48000, computeMel: true, computeOnset: true });
analyzer.process(block);                 // Float32Array のブロックを供給
const frames = analyzer.readFramesSoa(analyzer.availableFrames());
const stats = analyzer.stats();          // stats.estimate.bpm / .key（PitchClass の整数）

Node ネイティブでは float の Structure-of-Arrays 読み出し名は readFramesSoa(...) です。WASM ラッパーは、ブラウザ向け例で同じ操作を readFrames(...) として公開しています。

Node ネイティブの RealtimeVoiceChanger は { sampleRate, maxBlockSize, channels, preset } で構築します。

処理には processMono(...)、processMonoInto(...)、processInterleaved(...)、processPlanarStereo(...) を使います。

オフラインの便利用途では、voiceChangeRealtime(...) が同じプリセットチェーンでモノラルバッファ全体を 512 サンプルブロック単位に処理します。

typescript

import {
  RealtimeVoiceChanger,
  realtimeVoiceChangerPresetConfig,
  realtimeVoiceChangerPresetNames,
  voiceCharacterPresetId,
  voiceChangeRealtime,
} from '@libraz/libsonare-native';

const changer = new RealtimeVoiceChanger({
  sampleRate: 48000,
  maxBlockSize: 128,
  channels: 1,
  preset: 'bright-idol',
});

const blockOut = changer.processMono(inputBlock);
const rendered = voiceChangeRealtime(vocal, 48000, 'soft-whisper');
const presetConfig = realtimeVoiceChangerPresetConfig('bright-idol');
console.log(
  voiceCharacterPresetId(1),
  realtimeVoiceChangerPresetNames(),
  presetConfig,
  changer.latencySamples(),
  blockOut,
  rendered,
);
changer.destroy();

RealtimeEngine はクラスとしては共有されていますが、ラッパーの細部は異なります。

Runtime	違い
WASM	`engineCapabilities()` を追加し、構築前に ABI 互換性を確認します。キャプチャバッファは `setCaptureBuffer(numChannels, capacityFrames)` で設定します。
Node ネイティブ	`engineAbiVersion()` を公開します。ブラウザ向けの機能確認ヘルパーはありません。キャプチャバッファは、事前確保したチャンネルバッファを `setCaptureBuffer(channels)` として渡します。

型定義

typescript

interface Key {
  root: string;        // ピッチクラス名。例: "C"、"C#"、"A"
  mode: string;        // モード名。例: "major"、"minor"
  confidence: number;
  name: string;        // "C major"、"A minor" など
  shortName: string;   // "C"、"Am" など
}

interface TimeSignature {
  numerator: number;
  denominator: number;
  confidence: number;
}

interface AnalysisResult {
  bpm: number;
  bpmConfidence: number;
  key: Key;
  timeSignature: TimeSignature;
  beatTimes: Float32Array;                       // beats[].time から導出
  beats: Array<{ time: number; strength: number }>;
  chords: AnalysisChord[];                       // 検出したコード進行
  sections: AnalysisSection[];                   // 楽曲構造セクション
  timbre: AnalysisTimbre;                        // 音色の集約サマリー
  dynamics: AnalysisDynamics;                    // ダイナミクスの集約サマリー
  rhythm: AnalysisRhythm;                        // リズムの集約サマリー
  melody: AnalysisMelody;                        // 旋律輪郭のサマリー
  form: string;                                  // 楽曲形式ラベル。例: "AABA"
}
// analyze() は上記のフル結果を返します。専用の detect*／analyze* 関数は、
// 個別解析やパラメータ指定の解析向けに引き続き利用できます。

interface HpssResult {
  harmonic: Float32Array;
  percussive: Float32Array;
  sampleRate: number;
}

interface StftResult {
  nBins: number;
  nFrames: number;
  nFft: number;
  hopLength: number;
  sampleRate: number;
  magnitude: Float32Array;  // nBins × nFrames, row-major
  power: Float32Array;      // nBins × nFrames, row-major
}

interface StftDbResult {
  nBins: number;
  nFrames: number;
  db: Float32Array;         // dB 単位のパワー
}

interface MelSpectrogramResult {
  nMels: number;
  nFrames: number;
  sampleRate: number;
  hopLength: number;
  power: Float32Array;      // nMels × nFrames, row-major
  db: Float32Array;         // nMels × nFrames, row-major
}

interface MfccResult {
  nMfcc: number;
  nFrames: number;
  coefficients: Float32Array;  // nMfcc × nFrames, row-major
}

interface ChromaResult {
  nChroma: number;
  nFrames: number;
  sampleRate: number;
  hopLength: number;
  features: Float32Array;   // nChroma × nFrames, row-major
  meanEnergy: number[];     // nChroma 個の値
}

interface PitchResult {
  f0: Float32Array;         // フレームごとの基本周波数（Hz）
  voicedProb: Float32Array; // フレームごとの有声確率（0–1）
  voicedFlag: boolean[];    // フレームごとの有声／無声判定
  nFrames: number;
  medianF0: number;
  meanF0: number;
}

ネイティブパッケージは、オプション、コールバック、ストリーミングスナップショット、リアルタイムエンジンメッセージ用の TypeScript 補助型もエクスポートしています。アプリ側で同じ構造を再定義せず、これらの型名を使ってください。

分野	エクスポートされる型
解析オプション／結果	`AnalysisProgressCallback`, `BpmCandidate`, `ChordChromaMethod`, `KeyMode`, `KeyProfile`, `MelodyPoint`, `SectionTypeOrdinal`, `TempogramMode`, `TrimSilenceMode`
ストリーミング解析	`StreamAnalyzerConfig`, `StreamAnalyzerStats`, `StreamFramesSoa`, `StreamProgressiveEstimate`, `StreamChordChange`, `StreamBarChord`, `StreamPatternScore`
マスタリングとメータリング	`MasteringPreset`, `SoloProcessor`, `StreamingPlatform`, `DynamicsProcessorResult`, `CompressorDetector`, `DecrackleMode`, `DenoiseClassicalMode`, `DenoiseClassicalNoiseEstimator`, `EqBandInput`, `EqPhaseMode`, `EqSpectrumSnapshot`
ミキシング	`AutomationCurve`, `GoniometerPoint`, `MeterTap`, `MixMeterSnapshot`, `MixResult`, `MixerProcessResult`, `PanLaw`, `PanMode`, `SendTiming`
リアルタイム音声	`VoicePresetId`, `RealtimeVoiceChangerConfigInput`, `RealtimeVoiceChangerConfig`, `RealtimeVoiceChangerOptions`
リアルタイムエンジングラフ	`EngineGraphSpec`, `EngineGraphNode`, `EngineGraphNodeType`, `EngineGraphConnection`, `EngineGraphMix`, `EngineGraphParameterBinding`, `EngineParameterInfo`
リアルタイムエンジントランスポート	`EngineTransportState`, `EngineMarker`, `EngineClip`, `EngineAutomationPoint`, `EngineAutomationPointCurve`, `EngineMetronomeConfig`
リアルタイムエンジンのジョブ／テレメトリ	`EngineBounceOptions`, `EngineBounceResult`, `EngineFreezeOptions`, `EngineFreezeResult`, `EngineCaptureStatus`, `EngineTelemetry`, `EngineTelemetryType`, `EngineTelemetryError`, `EngineMeterTelemetry`

用語集

基礎

解析ガイド

ミキシングガイド

編集ガイド

楽器と MIDI

アレンジとプロジェクト

リアルタイムガイド

室内音響

マスタリング概念

マスタリングガイド

ネイティブバインディング

このページで身につくこと

比較

Node.js（N-API）

Node パッケージの選び方

要件

インストール

マスタリング API

ミキシング API

プロジェクト・インストゥルメント・ライブ MIDI

エラーハンドリング

Audio ラッパーの違い

StreamingMasteringChain

StreamingEqualizer

使用例

API リファレンス

Audio

`using` によるクリーンアップ（Node 22 以上）

解析関数

非同期版（Node 専用）

エフェクト関数

特徴抽出関数

逆再構成関数

librosa 互換ヘルパー

変換関数

メータリング関数

スケール量子化

ストリーミング／リアルタイムクラス

型定義

ネイティブバインディング ​

このページで身につくこと ​

比較 ​

Node.js（N-API） ​

Node パッケージの選び方 ​

要件 ​

インストール ​

マスタリング API ​

ミキシング API ​

プロジェクト・インストゥルメント・ライブ MIDI ​

エラーハンドリング ​

Audio ラッパーの違い ​

StreamingMasteringChain ​

StreamingEqualizer ​

使用例 ​

API リファレンス ​

Audio ​

using によるクリーンアップ（Node 22 以上） ​

解析関数 ​

非同期版（Node 専用） ​

エフェクト関数 ​

特徴抽出関数 ​

逆再構成関数 ​

librosa 互換ヘルパー ​

変換関数 ​

メータリング関数 ​

スケール量子化 ​

ストリーミング／リアルタイムクラス ​

型定義 ​

ネイティブバインディング

このページで身につくこと

比較

Node.js（N-API）

Node パッケージの選び方

要件

インストール

マスタリング API

ミキシング API

プロジェクト・インストゥルメント・ライブ MIDI

エラーハンドリング

Audio ラッパーの違い

StreamingMasteringChain

StreamingEqualizer

使用例

API リファレンス

Audio

`using` によるクリーンアップ（Node 22 以上）

解析関数

非同期版（Node 専用）

エフェクト関数

特徴抽出関数

逆再構成関数

librosa 互換ヘルパー

変換関数

メータリング関数

スケール量子化

ストリーミング／リアルタイムクラス

型定義