「JUCEで初めてのVST3プラグイン」ゲインプラグインで覚える、音の通り道とビルドの流れ
音量を上げ下げするだけのプラグインでも、作ってみるとプラグイン開発の骨組みがひと通り見えてきます。JUCE 9 と CMake で、コードを書いてビルドし、DAWで鳴らすところまで進めます。

なぜ最初の1本に JUCE を選ぶのか
VST3プラグインは、Steinberg が配布している VST 3 SDK だけでも作れます。ただ、SDK を直接触ると、Windows と Mac の違い、GUI、パラメーターの保存、プラグイン形式ごとのお作法まで、全部自分で面倒を見ることになります。最初の1本でそこまで抱えると、音を鳴らす前に力尽きます。
JUCE は、その面倒をまとめて引き受けてくれる C++ のフレームワークです。同じコードから VST3、AU(Mac の Logic Pro などが使う形式)、単体で動くスタンドアロンアプリまで書き出せます。2026年7月にメジャーバージョンの JUCE 9 が出て、11月2日には 9.0.5 が公開されています(2026年11月時点)。
お金の話も先に済ませておきます。JUCE は無料の Starter ライセンスで全機能が使え、年間の売り上げが2万ドルまでなら商用でも構いません。それを超えたら Indie(買い切り $800、または月 $40。年30万ドルまで)、さらに上は Pro です。オープンソースで公開するなら AGPLv3 で使う道もあります。
VST3 側の事情も変わりました。Steinberg は2025年10月の VST 3.8 SDK から、ライセンスを MIT に切り替えています。著作権表示とライセンス文を残せば、商用製品にも自由に組み込めます。個人がプラグインを作って配るハードルは、数年前よりだいぶ下がりました。
| 必要なもの | JUCE 9 の要件(公式 README より) |
|---|---|
| C++ | C++17 以上 |
| CMake | 3.22 以上 |
| Windows | Visual Studio 2019 以降 |
| Mac | Xcode 12.4 以降 |
プロジェクトの形を決める
JUCE には、画面でプロジェクトを組み立てる Projucer というツールもあります。ただ、これから始めるなら CMake をおすすめします。設定がテキストで残るので、Git で差分を追いやすく、AIコーディングツールにも読ませやすいからです。
フォルダ構成はこれだけ。JUCE 本体は、プロジェクトの中に丸ごと置きます。
git clone --depth 1 --branch 9.0.5 https://github.com/juce-framework/JUCE.git JUCE
次に CMakeLists.txt。JUCE 公式の CMake サンプル(examples/CMake/AudioPlugin)を土台に、今回のプラグイン用に書き換えています。
cmake_minimum_required(VERSION 3.22)
project(DEZIGN_GAIN VERSION 0.1.0)
add_subdirectory(JUCE)
juce_add_plugin(DezignGain
COMPANY_NAME "DEZIGN"
PLUGIN_MANUFACTURER_CODE Dzgn # 作者を表す4文字のID
PLUGIN_CODE Gn01 # プラグインを表す4文字のID
FORMATS VST3 Standalone
PRODUCT_NAME "DEZIGN Gain"
IS_SYNTH FALSE
NEEDS_MIDI_INPUT FALSE
NEEDS_MIDI_OUTPUT FALSE
COPY_PLUGIN_AFTER_BUILD FALSE)
target_sources(DezignGain PRIVATE Source/PluginProcessor.cpp)
target_compile_definitions(DezignGain PUBLIC
JUCE_WEB_BROWSER=0
JUCE_USE_CURL=0
JUCE_VST3_CAN_REPLACE_VST2=0)
target_link_libraries(DezignGain
PRIVATE juce::juce_audio_utils
PUBLIC juce::juce_recommended_config_flags
juce::juce_recommended_lto_flags
juce::juce_recommended_warning_flags)
大事なのは PLUGIN_CODE です。公式ドキュメントによると、省略すると CMake の構成をやり直すたびにランダムな値に変わってしまいます。DAWはこのIDでプラグインを見分けているので、途中で変わると、保存したプロジェクトが「プラグインが見つからない」状態になります。最初に決めて、二度と変えない。これだけは覚えておいてください。
音が通る場所、processBlock を書く
プラグインの心臓部は processBlock という関数です。DAWは音を数百サンプルずつの小さな塊(バッファ)に区切って、次々とこの関数に渡してきます。48kHz でバッファが512サンプルなら、1回あたり約10.7ミリ秒分。その短い時間で処理を終えて返さないと、音が途切れます。
まずはヘッダーです。パラメーターは JUCE の AudioProcessorValueTreeState(以下 APVTS)にまとめて持たせます。DAWのオートメーションも、プロジェクト保存も、これに任せられます。
#pragma once
#include <juce_audio_processors/juce_audio_processors.h>
class GainAudioProcessor final : public juce::AudioProcessor
{
public:
GainAudioProcessor();
void prepareToPlay (double sampleRate, int samplesPerBlock) override;
void releaseResources() override {}
bool isBusesLayoutSupported (const BusesLayout& layouts) const override;
void processBlock (juce::AudioBuffer<float>&, juce::MidiBuffer&) override;
using AudioProcessor::processBlock;
juce::AudioProcessorEditor* createEditor() override;
bool hasEditor() const override { return true; }
const juce::String getName() const override { return JucePlugin_Name; }
bool acceptsMidi() const override { return false; }
bool producesMidi() const override { return false; }
bool isMidiEffect() const override { return false; }
double getTailLengthSeconds() const override { return 0.0; }
int getNumPrograms() override { return 1; }
int getCurrentProgram() override { return 0; }
void setCurrentProgram (int) override {}
const juce::String getProgramName (int) override { return {}; }
void changeProgramName (int, const juce::String&) override {}
void getStateInformation (juce::MemoryBlock& destData) override;
void setStateInformation (const void* data, int sizeInBytes) override;
juce::AudioProcessorValueTreeState apvts;
private:
static juce::AudioProcessorValueTreeState::ParameterLayout createLayout();
std::atomic<float>* gainDb = nullptr; // パラメーターの現在値(dB)
juce::SmoothedValue<float> gain { 1.0f }; // 実際に掛ける倍率をなめらかに動かす
JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (GainAudioProcessor)
};
関数がずらっと並んでいますが、ほとんどは「MIDIは使わない」「プリセットは1つ」と答えているだけです。中身があるのは、パラメーターの定義、準備、音の処理、状態の保存の4か所です。
#include "PluginProcessor.h"
GainAudioProcessor::GainAudioProcessor()
: AudioProcessor (BusesProperties()
.withInput ("Input", juce::AudioChannelSet::stereo(), true)
.withOutput ("Output", juce::AudioChannelSet::stereo(), true)),
apvts (*this, nullptr, "PARAMS", createLayout())
{
gainDb = apvts.getRawParameterValue ("gain");
}
juce::AudioProcessorValueTreeState::ParameterLayout GainAudioProcessor::createLayout()
{
juce::AudioProcessorValueTreeState::ParameterLayout layout;
layout.add (std::make_unique<juce::AudioParameterFloat> (
juce::ParameterID { "gain", 1 }, // ID と バージョン
"Gain",
juce::NormalisableRange<float> (-60.0f, 12.0f, 0.1f), // -60dB 〜 +12dB
0.0f, // 初期値 0dB(素通し)
juce::AudioParameterFloatAttributes().withLabel ("dB")));
return layout;
}
void GainAudioProcessor::prepareToPlay (double sampleRate, int)
{
gain.reset (sampleRate, 0.02); // 目標値まで 20ms かけて動かす
gain.setCurrentAndTargetValue (juce::Decibels::decibelsToGain (gainDb->load()));
}
bool GainAudioProcessor::isBusesLayoutSupported (const BusesLayout& layouts) const
{
const auto out = layouts.getMainOutputChannelSet();
if (out != juce::AudioChannelSet::mono() && out != juce::AudioChannelSet::stereo())
return false;
return out == layouts.getMainInputChannelSet(); // 入力と出力のチャンネル数をそろえる
}
void GainAudioProcessor::processBlock (juce::AudioBuffer<float>& buffer, juce::MidiBuffer&)
{
juce::ScopedNoDenormals noDenormals;
gain.setTargetValue (juce::Decibels::decibelsToGain (gainDb->load()));
if (! gain.isSmoothing())
{
buffer.applyGain (gain.getTargetValue()); // 値が動いていないときはまとめて掛ける
return;
}
const int numChannels = buffer.getNumChannels();
const int numSamples = buffer.getNumSamples();
for (int i = 0; i < numSamples; ++i)
{
const float g = gain.getNextValue(); // 1サンプルずつ倍率を進める
for (int ch = 0; ch < numChannels; ++ch)
buffer.getWritePointer (ch)[i] *= g;
}
}
juce::AudioProcessorEditor* GainAudioProcessor::createEditor()
{
return new juce::GenericAudioProcessorEditor (*this); // 画面は自動生成で済ませる
}
void GainAudioProcessor::getStateInformation (juce::MemoryBlock& destData)
{
if (auto xml = apvts.copyState().createXml())
copyXmlToBinary (*xml, destData);
}
void GainAudioProcessor::setStateInformation (const void* data, int sizeInBytes)
{
if (auto xml = getXmlFromBinary (data, sizeInBytes))
if (xml->hasTagName (apvts.state.getType()))
apvts.replaceState (juce::ValueTree::fromXml (*xml));
}
// DAW がプラグインを作るときに呼ぶ入口
juce::AudioProcessor* JUCE_CALLTYPE createPluginFilter()
{
return new GainAudioProcessor();
}
GUI は GenericAudioProcessorEditor に任せました。パラメーターからスライダーを自動で作ってくれるので、見た目にこだわるのは音がちゃんと出てからで十分です。
processBlock でやってはいけないこと
processBlock は「オーディオスレッド」という、締め切りの厳しいスレッドで動きます。ここで時間が読めない処理をすると、DAW全体の音がプツプツ途切れます。
void GainAudioProcessor::processBlock (juce::AudioBuffer<float>& buffer, juce::MidiBuffer&)
{
std::vector<float> temp (buffer.getNumSamples()); // 毎回メモリを確保している
const juce::ScopedLock lock (settingsLock); // GUI と取り合うロックで待たされる
DBG ("block: " << buffer.getNumSamples()); // ログ出力も遅い
buffer.applyGain (juce::Decibels::decibelsToGain (gainDb->load())); // 値が飛ぶとノイズ
}
// ・必要なメモリは prepareToPlay で先に確保しておく
// ・GUI とのやり取りは std::atomic(APVTS の getRawParameterValue)で
// ・ログはオーディオスレッドの外で
// ・パラメーターは SmoothedValue でなめらかに動かす
ゲインを「なめらかに」変える理由を耳で確かめる
上のコードで SmoothedValue を使ったのには理由があります。音量をいきなり切り替えると、波形が途中で段差になり、「プチッ」というノイズ(ジッパーノイズと呼ばれます)が出るんです。オートメーションでフェーダーを動かしただけでプチプチ鳴るプラグインは、MIXでは使い物になりません。
同じことはブラウザの Web Audio API でも再現できます。下のデモは、サイン波の音量を0.25秒ごとに大小で切り替えています。「急に」と「20msかけて」を聞き比べてみてください。
ボタンを押すと音が出ます。最初は音量を小さめにしてください。
20ミリ秒は、人の耳には「瞬時」に聞こえる長さです。それでも段差がなくなるだけで、ノイズはほぼ消えます。JUCE の SmoothedValue がやっていることも、このデモの後半とまったく同じです。
ビルドして、DAWで鳴らす
コードがそろったら、プロジェクトのフォルダでビルドします。Windows でも Mac でもコマンドは同じです。
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --config Release
初回は JUCE 本体のコンパイルが入るので、少し待たされます。終わると build/DezignGain_artefacts/Release/VST3/ の中に DEZIGN Gain.vst3 ができています。これを VST3 の置き場所にコピーすれば、DAW から見えるようになります。
| OS | VST3 の置き場所 |
|---|---|
| Windows | C:\Program Files\Common Files\VST3 |
| Mac | ~/Library/Audio/Plug-Ins/VST3 |
毎回コピーするのが面倒なら、CMakeLists.txt の COPY_PLUGIN_AFTER_BUILD を TRUE にすると、ビルドのたびに自動で入れ替えてくれます。Windows ではこの場所への書き込みに管理者権限が要るので、その点だけ注意してください。
DAWを立ち上げる前に試したいなら、FORMATS に入れておいた Standalone が便利です。build/DezignGain_artefacts/Release/Standalone/ にできるアプリを起動すれば、オーディオインターフェースの入力にそのままゲインが掛かります。JUCE に同梱の AudioPluginHost(extras フォルダ)を使えば、DAWなしで VST3 を読み込んだ確認もできます。
どのDAWで試すか迷ったら、60日間無料で全機能を試せる REAPER を使うと、お金をかけずに確認できます。DAWごとの違いは「DAWの選び方 2026」にまとめています。
ここまで来たら、あとは processBlock の中身を差し替えていくだけ。次に作るなら、ディレイかフィルターがおすすめです。どちらも過去のサンプルを覚えておく仕組みが必要になり、DSP(デジタル信号処理)らしい考え方に触れられます。
まとめ
- JUCE は1つのコードから VST3・AU・スタンドアロンを書き出せる C++ フレームワークで、2026年11月時点の最新は JUCE 9.0.5。
- JUCE は年間売り上げ2万ドルまでなら無料の Starter で商用利用でき、VST 3 SDK も 3.8 から MIT ライセンスになった。
- プロジェクトは CMake で組むと設定がテキストで残り、Git や AI ツールと相性がいい。
- PLUGIN_CODE は最初に決めて変えない。変わるとDAWが保存済みのプロジェクトでプラグインを見失う。
- processBlock はオーディオスレッドで動くので、メモリ確保・ロック・ログ出力を持ち込まない。
- パラメーターは APVTS で持ち、音量は SmoothedValue で数十ミリ秒かけて動かすとジッパーノイズが出ない。
- ビルド後は Standalone や AudioPluginHost で動作を見て、配る前には pluginval で検証する。