Beeplayは、開発者がコードを使って直接音楽を作曲できる革新的なJavaScriptライブラリです。音楽愛好家でもプログラミング初心者でも、シンプルなJavaScript構文でメロディー、コード、リズムを記述し、プログラミングと音楽が融合したクリエイティブな旅を始められます。

🎵 Beeplayとは？

Beeplayの核となる機能は、音楽理論をプログラム可能なAPIに変換し、メソッドチェーンで音楽シーケンスを構築することです。このプロジェクトはweb-audio-apiを基盤にオーディオ生成を実現し、音符、音価、コードなどの音楽要素を精密に制御できます。モジュール設計（lib/modules/）により、音楽制作がブロックを積むように簡単に行えます。

🚀 クイックインストール手順

npmを使用したインストール

npm install beeplay

Bowerを使用したインストール

bower install beeplay

ソースコードからのインストール

git clone https://gitcode.com/gh_mirrors/be/beeplay
cd beeplay
npm run build

ビルド後のファイルはdist/ディレクトリに生成され、同時にdocs/js/にも自動コピーされWebデモで使用できます。

✨ 基本的な使用例

最初の音楽フラグメントはわずか3行のコードで作成できます：

var beeplay = require('beeplay')

beeplay()
  .play('D#5', 1/4).play('E5', 1/4).play('F#5', 1/2)
  .play('B5', 1/2).play('D#5', 1/4).play('E5', 1/4);

このコードは高音と低音が交互に現れる短いメロディーを定義しています。各.play()メソッドは2つの引数を受け取ります：音符（例：'D#5'）と音価（例：1/4は四分音符を表します）。

🎹 コア機能の詳細

1. 音符システム

C0からB8までの完全な音域をサポートし、自然音（C）、シャープ（C#）、フラット（Cb）を含みます。lib/modules/pn.jsモジュールで音高を解析し、音楽理論の正確性を確保します。

2. リズム制御

数値で音価を定義します：

• 1：全音符
• 1/2：二分音符
• 1/4：四分音符
• 1/8：八分音符
• 複雑なリズムの組み合わせもサポート（例：1/4 + 1/8）

3. コード機能

配列を使ってコードを定義します：

.play(['C4', 'E4', 'G4'], 1) // Cメジャーコード

コードの実装はlib/modules/pd.jsモジュールが処理し、三和音、七の和音など様々なコードタイプに対応します。

🎼 応用テクニック：完全な楽曲の作曲

Beeplayは音楽をセクションに分割して組み合わせることができます。公式サンプルdocs/js/nyan.jsは「Nyancat」のテーマ曲全体を実装しています：

// イントロを定義
var intro = beeplay({bpm: 120})
  .play(null, 2)
  .play('D#5', 1/4).play('E5', 1/4).play('F#5', 1/2);

// バース（主歌）を定義
var verse = beeplay({bpm: 120})
  .play('F#6', 1/2).play('G#6', 1/2)
  .play('C#6', 1/4).play('D#6', 1/2).play('B5', 1/4);

// 組み合わせて再生
intro.play(verse).play(verse);

🧪 テストと検証

プロジェクトには完全なユニットテストが用意されており、以下のコマンドで実行できます：

npm test

テストファイルはtest/ディレクトリにあり、音高検証（test/isArray.js）やニューラルネットワーク合成（test/nn.js）などのコア機能を確認します。

📚 リソースとドキュメント

• 公式ドキュメント：docs/index.html
• コアモジュール：lib/index.js
• サンプルコード：docs/js/beeplay.js

Beeplayを使えば、プログラミングは単なるロジックの構築だけでなく、メロディーの創作にもなります。今すぐインストールして、コードで最初のJavaScript音楽を作曲してみましょう！🎶