Unity 오디오 플러그인 SDK 개요

Unity의 네이티브 오디오 플러그인 SDK는 Unity의 내장 네이티브 오디오 플러그인 인터페이스로, 주로 C 또는 C++로 작성된 DSP(디지털 신호 처리) 플러그인을 사용해 오디오 효과를 구현할 수 있도록 합니다. 이 문서에서는 플러그인을 개발하는 데 필요한 기본 개념과 활용 사례를 다룹니다.

선행 조건

플러그인 개발을 시작하기 전에 최신 오디오 플러그인 SDK를 다운로드해야 합니다.

시스템 개요

네이티브 오디오 플러그인 시스템은 두 가지 주요 부분으로 구성됩니다:

1. 네이티브 DSP 플러그인: C나 C++로 작성된 .dll(Windows) 또는 .dylib(OSX) 파일입니다. 이 플러그인은 플랫폼별 최적화를 통해 모든 플랫폼에서 컴파일할 수 있도록 되어 있습니다.
2. C# GUI: 사용자 인터페이스는 선택 사항으로, 보통 기본 슬라이더 기반 UI를 통해 제공됩니다.

플러그인 개발 시작하기

플러그인을 개발하려면 먼저 파라미터를 정의해야 합니다. 사용자가 경험하게 될 다양한 컴포넌트에 대한 대략적인 계획을 가지는 것이 좋습니다.

예시: 링 모듈레이터

링 모듈레이터는 입력 신호를 사인파와 곱하여 다양한 링 모듈레이션 효과를 생성합니다. 아래는 이 플러그인의 예시 코드입니다.

enum Param
{
    P_FREQ,
    P_MIX,
    P_NUM
};

int InternalRegisterEffectDefinition(UnityAudioEffectDefinition& definition)
{
    int numparams = P_NUM;
    definition.paramdefs = new UnityAudioParameterDefinition[numparams];
    RegisterParameter(definition, "Frequency", "Hz",
        0.0f, kMaxSampleRate, 1000.0f,
        1.0f, 3.0f,
        P_FREQ);
    RegisterParameter(definition, "Mix amount", "%",
        0.0f, 1.0f, 0.5f,
        100.0f, 1.0f,
        P_MIX);
    return numparams;
}

이 예시는 파라미터를 설정하는 방법을 보여줍니다. 파라미터 값은 사용자의 UI에 초점을 맞추어 조정됩니다.

플러그인 인스턴스화

플러그인을 인스턴스화하기 위해 데이터를 설정해야 합니다. 아래 예시는 플러그인 인스턴스를 생성하는 방법을 보여줍니다.

struct EffectData
{
    struct Data
    {
        float p[P_NUM]; // Parameters
        float s;        // Sine output of oscillator
        float c;        // Cosine output of oscillator
    };
    union
    {
        Data data;
        unsigned char pad[(sizeof(Data) + 15) & ~15];
    };
};

UNITY_AUDIODSP_RESULT UNITY_AUDIODSP_CALLBACK CreateCallback(
    UnityAudioEffectState* state)
{
    EffectData* effectdata = new EffectData;
    memset(effectdata, 0, sizeof(EffectData));
    effectdata->data.c = 1.0f;
    state->effectdata = effectdata;
    InitParametersFromDefinitions(
        InternalRegisterEffectDefinition, effectdata->data.p);
    return UNITY_AUDIODSP_OK;
}

이 데이터는 믹서 내에서 호출될 것입니다.

오디오 메인 프로세싱

오디오 프로세싱은 ProcessCallback에서 수행됩니다. 아래 코드에서는 입력 신호를 처리하는 방식이 설명되어 있습니다.

UNITY_AUDIODSP_RESULT UNITY_AUDIODSP_CALLBACK ProcessCallback(
    UnityAudioEffectState* state,
    float* inbuffer, float* outbuffer,
    unsigned int length,
    int inchannels, int outchannels)
{
    EffectData::Data* data = &state->GetEffectData<EffectData>()->data;

    float w = 2.0f * sinf(kPI * data->p[P_FREQ] / state->samplerate);
    for(unsigned int n = 0; n < length; n++)
    {
        for(int i = 0; i < outchannels; i++)
        {
            outbuffer[n * outchannels + i] =
                inbuffer[n * outchannels + i] *
                (1.0f - data->p[P_MIX] + data->p[P_MIX] * data->s);
        }
        data->s += data->c * w; // inexpensive way to calculate a sine-wave
        data->c -= data->s * w;
    }

    return UNITY_AUDIODSP_OK;
}

커스텀 GUI

이 SDK는 GUI 통합도 지원합니다. 커스텀 GUI를 통해 사용자는 데이터를 시각적으로 제어할 수 있습니다. 아래는 커스텀 GUI의 동작 방식을 설명하는 예시입니다.

bool OnGUI(IAudioEffectPlugin plugin)
{
    float masterGain;
    plugin.GetFloatParameter("MasterGain", out masterGain);

    // GUI 요소 추가 (예: 슬라이더)
    masterGain = GUILayout.HorizontalSlider(masterGain, 0.0f, 1.0f);
    plugin.SetFloatParameter("MasterGain", masterGain);

    return true;
}

결론

Unity의 네이티브 오디오 플러그인 SDK는 오디오 효과 개발을 위한 강력한 도구입니다. 위에서 설명한 다양한 예제와 API를 활용하면 다양한 오디오 플러그인을 생성하고 조작할 수 있습니다. 각 플러그인은 필요에 따라 다양한 기능을 구현할 수 있으며, 더 깊이 있는 고급 플러그인 또한 개발 가능합니다.

추가 질문이나 커스터마이징에 대한 도움이 필요하다면 Unity 포럼을 방문하거나 기술 문서를 참고하세요.