インストール

npm（ブラウザ/Node.js）

パッケージ未公開

npm パッケージ @libraz/sonare は現在ベータ版で、まだ公開されていません。現時点では、ソースからビルドするか、リポジトリから直接 WASM ファイルを使用してください。

# 未公開 - 近日公開予定
npm install @libraz/sonare
# または
yarn add @libraz/sonare

ソースからビルド

前提条件

• CMake 3.16以上
• C++17対応コンパイラ（GCC 9+、Clang 10+、MSVC 2019+）
• Emscripten（WebAssemblyビルド用）

ビルド手順

# リポジトリをクローン
git clone https://github.com/libraz/libsonare.git
cd libsonare

# ネイティブライブラリをビルド
mkdir build && cd build
cmake ..
make -j$(nproc)

# WebAssemblyをビルド
make build-wasm

使用方法

ブラウザ

import { init, detectBpm, detectKey, analyze } from '@libraz/sonare';

// WASMモジュールを初期化
await init();

// AudioContextから音声サンプルを取得
const audioContext = new AudioContext();
const response = await fetch('audio.mp3');
const arrayBuffer = await response.arrayBuffer();
const audioBuffer = await audioContext.decodeAudioData(arrayBuffer);
const samples = audioBuffer.getChannelData(0);

// BPM検出
const bpm = detectBpm(samples, audioBuffer.sampleRate);

// キー検出
const key = detectKey(samples, audioBuffer.sampleRate);

// 全解析
const result = analyze(samples, audioBuffer.sampleRate);

C++

#include <sonare/quick.h>

// BPM検出
float bpm = sonare::quick::detect_bpm(samples, size, sample_rate);

// キー検出
sonare::Key key = sonare::quick::detect_key(samples, size, sample_rate);

// 全解析
sonare::AnalysisResult result = sonare::quick::analyze(samples, size, sample_rate);