「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 以上
CMake3.22 以上
WindowsVisual Studio 2019 以降
MacXcode 12.4 以降

プロジェクトの形を決める

JUCE には、画面でプロジェクトを組み立てる Projucer というツールもあります。ただ、これから始めるなら CMake をおすすめします。設定がテキストで残るので、Git で差分を追いやすく、AIコーディングツールにも読ませやすいからです。

フォルダ構成はこれだけ。JUCE 本体は、プロジェクトの中に丸ごと置きます。

DezignGain/ ├── CMakeLists.txt ├── JUCE/ ← git clone した JUCE 本体 └── Source/ ├── PluginProcessor.h └── PluginProcessor.cpp
ターミナル — JUCE 9.0.5 を取得
git clone --depth 1 --branch 9.0.5 https://github.com/juce-framework/JUCE.git JUCE

次に CMakeLists.txt。JUCE 公式の CMake サンプル(examples/CMake/AudioPlugin)を土台に、今回のプラグイン用に書き換えています。

CMakeLists.txt
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のオートメーションも、プロジェクト保存も、これに任せられます。

Source/PluginProcessor.h
#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か所です。

Source/PluginProcessor.cpp
#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全体の音がプツプツ途切れます。

❌ やりがちなNG
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かけて」を聞き比べてみてください。

▶ Live Demo — 音量を急に変える vs なめらかに変える

ボタンを押すと音が出ます。最初は音量を小さめにしてください。

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 から見えるようになります。

OSVST3 の置き場所
WindowsC:\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 を読み込んだ確認もできます。

📌 配る前のチェック
人に使ってもらうなら、Tracktion がオープンソースで公開している検証ツール pluginval にかけておくと安心です。パラメーターの扱いやスレッドまわりの不具合を、実際のDAWより先に見つけてくれます。Mac 向けに配るなら署名と公証も必要になりますが、それはまた別の記事で。

どの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 で検証する。