ChiptuneSynth — はじめに

ChiptuneSynthをステップごとに学ぶ — "実行"をクリックして各例をライブで聴く

こんにちは、チップチューン！

シンセを作成し、初期化して、最初のサウンドエフェクトを再生する — すべて3行で。

const synth = new ChiptuneSynth();
await synth.init();
synth.playPreset('coin');  // ding!

AudioContextの開始にはユーザーのジェスチャー（クリック）が必要です — そのためボタンを使用しています。

名前で音符を演奏

リードトラック（トラック0）でミドルCを0.5秒間演奏します。

synth.playNoteByName('C', 4, 0, 0.5);
// note, octave, track, duration (seconds)

メロディーを演奏

タイミングで複数の音符をスケジュールして簡単なメロディーを作成します。

const melody = [
  { note:'C', oct:4, time:0 },
  { note:'E', oct:4, time:0.25 },
  { note:'G', oct:4, time:0.5 },
  { note:'C', oct:5, time:0.75 }
];
melody.forEach(n =>
  setTimeout(() =>
    synth.playNoteByName(n.note, n.oct, 0, 0.3),
    n.time * 1000
  )
);

楽器を読み込む

デフォルトの矩形波からバイオリンに切り替えて音符を演奏します。

synth.loadInstrument('violin', 0);
synth.playNoteByName('A', 4, 0, 1.5);
// Available: piano, violin, cello, flute, organ,
// brass, harmonica, synthLead, synthPad, synthBass,
// marimba, electricGuitar

マルチトラック・レイヤリング

異なるトラックで異なる楽器を同時に演奏します。

synth.loadInstrument('synthPad', 0);  // Lead
synth.loadInstrument('synthBass', 1); // Bass

// Play a chord on the pad
synth.playNoteByName('C', 4, 0, 2);
synth.playNoteByName('E', 4, 0, 2);
synth.playNoteByName('G', 4, 0, 2);

// Bass note underneath
synth.playNoteByName('C', 2, 1, 2);

サウンドを調整

エンベロープ、ビブラート、波形をカスタマイズしてサウンドを形成します。

// Slow attack pad
synth.updateEnvelope(0, {
  attack: 0.5, decay: 0.3,
  sustain: 0.6, release: 1.0
});

// Add vibrato
synth.updateVibrato(0, {
  rate: 5, depth: 8
});

// Change waveform to sawtooth
synth.updateTrack(0, { type: 'sawtooth' });

synth.playNoteByName('D', 4, 0, 2.5);

ゲームSFXコンボ

ゲームシーケンスのために複数のサウンドエフェクトを連結 — コイン収集、パワーアップ、射撃！

synth.playPreset('coin');
setTimeout(() => synth.playPreset('powerup'), 400);
setTimeout(() => synth.playPreset('laser'), 1200);
setTimeout(() => synth.playPreset('explosion'), 1500);
setTimeout(() => synth.playPreset('1up'), 2200);

波形ビジュアライゼーション

ライブオーディオ波形をキャンバスに描画 — ゲームUIに最適！

function draw() {
  const data = synth.getWaveformData();
  ctx.clearRect(0, 0, canvas.width, canvas.height);
  ctx.strokeStyle = '#00f0ff';
  ctx.beginPath();
  data.forEach((v, i) => {
    const x = (i / data.length) * canvas.width;
    const y = (v / 255) * canvas.height;
    i === 0 ? ctx.moveTo(x, y) : ctx.lineTo(x, y);
  });
  ctx.stroke();
  requestAnimationFrame(draw);
}
draw();