기술 자료

Unity 엔진

Unity 엔진

SDK에 포함된 네이티브 오디오 플러그인 예시

GUI 사용자 정의가 포함되어 있거나 없는 DSP 플러그인 예시
읽는 시간 5분최근 업데이트: 10일 전

오디오 플러그인 SDK에는 다양한 오디오 플러그인 유형이 들어 있습니다. SDK의 플러그인 코드는 공용 도메인에서 사용할 수 있으므로 이 코드를 템플릿으로 사용할 수 있습니다. 이 프로젝트에는 커스터마이즈된 GUI 포함되어 있거나 없는 네이티브 DSP 플러그인의 예제가 포함되어 있습니다.
IDE를 사용하여 예제 플러그인 코드를 편집하고 컴파일하려면 SDK에 여러 개의 IDE용 프로젝트가 포함되어 있습니다. 다음 표는 각 IDE의 프로젝트를 찾을 수 있는 위치를 보여 줍니다.

IDE

위치

Visual Studio
NativeAudioPlugins-master\NativeCode\VisualStudio\AudioPluginDemo.sln
(플러그인 프로젝트).
Visual Studio
NativeAudioPlugins-master\GUICode\AudioPluginDemoGUI\AudioPluginDemoGUI.sln
(GUI 프로젝트).
XCode
NativeAudioPlugins-master\NativeCode\Xcode\AudioPluginDemo.xcodeproj
UWP
NativeAudioPlugins-master\NativeCode\UWP\AudioPluginDemo.sln
Unity 예제 플러그인에 액세스하려면 다음 단계를 따르십시오.
  1. demos
    Unity 프로젝트를 엽니다(폴더: NativeAudioPlugin > Assets).
  2. Unity 프로젝트에서 Assets > mixers로 이동합니다.
  3. 일부 믹서 옆의 화살표를 클릭 수 확장합니다.
  4. 오디오 믹서 그룹 컨트롤러를 클릭 수 있습니다. 인스펙터에는 오디오 믹서 그룹 컨트롤러에 연결된 모든 효과가 표시됩니다.
  5. 효과를 추가하려면 효과 추가 버튼을 클릭하십시오. 추가할 수 있는 모든 예제 플러그인 효과를 나열합니다.
  6. 추가하려는 효과를 선택합니다. Unity 인스펙터에 효과를 표시합니다.
인스펙터가 열려 있는 상태에서 플레이 모드를 시작하면 사운드가 변경될 때 일부 효과가 업데이트됩니다.

사용자 지정 GUI가 없는 플러그인 예제

이 섹션에는 사용자 지정 GUI 대신 기본 Unity 슬라이더가 있는
AudioNativePlugin
프로젝트에 포함된 플러그인 예제 몇 개가 나와 있습니다.
플러그인 코드 파일에 직접 액세스하려면 SDK 폴더에서
NativeAudioPlugins/NativeCode
로 이동합니다.

Simple plug-ins without custom GUIs.

NoiseBox 플러그인

NoiseBox 플러그인은 변수 주파수에서 입력 신호를 흰색 노이즈로 추가하고 곱하는 플러그인입니다. 이를 Lofinator 플러그인과 애니메이션화된 파라미터와 함께 사용하여 휴대폰 사운드, 부적절한 라디오 수신, 손상된 스피커와 같은 효과를 시뮬레이션할 수 있습니다.

링 모듈레이터 예제 플러그인

링 모듈레이터 예제 플러그인은 들어오는 모든 신호에 사인파를 곱하는 간단한 조절기 예제입니다. 이는 라디오 노이즈 또는 손실 신호 효과를 생성합니다. 효과를 높이려면 다양한 주파수로 여러 개의 링 모듈레이션 효과를 연결합니다.

StereoWidener 예제 플러그인

StereoWidener 플러그인은 스테레오 입력 신호를 변수 지연이 있는 Mono 및 측면 구성 요소로 분해한 다음 이를 다시 결합하여 인식되는 스테레오 효과를 강화합니다.

Lofinator 플러그인

Lofinator 플러그인은 신호를 간단하게 다운샘플링하고 양자화합니다. 노이즈박스 플러그인과 애니메이션화된 파라미터를 함께 사용하여 휴대폰 사운드, 부족한 라디오 수신, 손상된 스피커와 같은 효과를 시뮬레이션할 수 있습니다.

사용자 지정 GUI가 있는 오디오 플러그인 예제

이 섹션에서는 균등 및 멀티밴드 압축 효과를 비롯한 고급 플러그인 사용 사례를 제공합니다. 플러그인에는 이전 섹션의 플러그인보다 더 많은 파라미터가 있습니다. 일부 플러그인 파라미터는 디폴트 슬라이더에 너무 복잡합니다.
예제 커스텀 GUI 코드에 직접 액세스하려면 SDK 폴더에서
NativeAudioPlugins-master\GUICode\AudioPluginDemoGUI
로 이동합니다.

이퀄라이저 예제 플러그인

이퀄라이저 플러그인에는 결과 커브와 개별 필터 기여도를 보여주는 디스플레이 그래프가 포함되어 있습니다. 하나 이상의 파라미터 값을 변경하려면 컨트롤 그래프의 파라미터를 클릭 수 드래그합니다. 이렇게 하면 각 슬라이더를 개별적으로 변경할 필요가 없습니다.

The Inspector window displays the Equalizer plug-in with control graph and sliders for individual configurable parameters.

필터 커브의 게인과 빈도를 변경하려면 컨트롤 그래프에서 세 개의 밴드를 드래그합니다. 각 밴드의 모양을 변경하려면 Shift 키를 누른 채로 해당 밴드를 클릭 수 후 드래그합니다.
Unity 내부 API 함수를 사용하여 커브를 그리고 주파수 응답을 위한 안티앨리어싱 커브를 그릴 수 있습니다.

플러그인 데이터 및 GUI 성능 분석 코드

이퀄라이저 및 멀티밴드 플러그인 모두 입력 및 출력 스펙트럼을 오버레이하여 플러그인의 효과를 시각화하는 코드를 제공합니다. GUI 코드는 오디오 프로세싱보다 훨씬 낮은 업데이트 속도로 실행되며 오디오 스트림에 액세스할 수 없습니다. 따라서 이 데이터를 읽기 위해 네이티브 코드는 다음 함수를 제공합니다.
UNITY_AUDIODSP_RESULT UNITY_AUDIODSP_CALLBACK GetFloatParameterCallback( UnityAudioEffectState* state, int 인덱스, float * 값, char *valuestr){ EffectData::Data* data = &state->GetEffectData<EffectData>()->data; if(index >= P_NUM) return UNITY_AUDIODSP_ERR_UNSUPPORTED; if(value != NULL) *value = data->p[index]; if(valuestr != NULL) valuestr[0] = 0; return UNITY_AUDIODSP_OK;}
이 함수를 사용하면 GUI 네이티브 플러그인의 부동 소수점 데이터를 읽을 수 있습니다.
GetFloatBufferCallback
라는 어레이 배리언트도 있습니다. 요청이 UI 또는 네이티브 코드의 성능에 영향을 주지 않는 한 플러그인 시스템은 모든 데이터를 받습니다.
이퀄라이저 및 멀티밴드 코드의 경우,
FFTAnalyzer
라는 유틸리티 클래스를 사용하면 플러그인에서 입력 및 출력 데이터를 쉽게 입력하고 스펙트럼을 다시 가져올 수 있습니다. 그런 다음,
GetFloatBufferCallback
는 이 스펙트럼 데이터를 다시 샘플링하고 C# GUI 코드로 전송합니다.
데이터를 다시 샘플링해야
FFTAnalyzer
가 고정된 주파수 해상도로 분석을 실행합니다.
GetFloatBufferCallback
는 데이터를 표시하는 뷰의 너비에 따라 결정되는 요청된 샘플 수만 반환합니다.

CorrelationMeter 예제 플러그인

CorrelationMeter 플러그인에는 최소한의 DSP 코드가 있습니다. 이 플러그인은 왼쪽 채널의 진폭을 오른쪽 채널의 진폭과 비교하여 표시하여 신호의 스테레오 효과를 보여줍니다.

Custom GUI of the CorrelationMeter plugin.

Equalizer GUI with overlaid spectrum analysis (green curve is source, red is processed).

이퀄라이저와 멀티밴드 효과는 의도적으로 단순하고 최적화되지 않은 상태로 유지되지만 플러그인 시스템에서 지원하는 더 복잡한 UI의 좋은 예입니다.

음량 모니터링 툴

다음은 3가지 시간 스케일에서 레벨을 측정하는 소리 모니터링 툴의 예입니다. 이는 데모 목적으로만 사용되지만 최신 음량 표준화를 준수하는 모니터 툴을 빌드할 수 있습니다. 커브 렌더링 코드는 Unity 내장되어 있습니다.

The Inspector window displays the loudness monitoring tool plug-in with graph and sliders for individual configurable parameters.

DSP 클럭 동기화

또한 플러그인 시스템을 사용하여 사운드를 처리하지 않고 생성할 수도 있습니다.
Plugin_TeeBee.cpp
및
Plugin_TeeDee.cpp
는 다음과 같은 단순한 합성체입니다.
  • 무작위 메모로 패턴 생성
  • 합성 엔진 필터와 엔벨로프를 미세 조정하기 위한 파라미터를 포함한다.
ProcessCallback
는
state->dsptick
파라미터를 읽고 노래의 포지션을 결정합니다. 이 카운터는 전역 샘플 포지션입니다. 모든 플러그인 효과를 동일한 샘플 기반 시계에 동기화 상태로 유지하려면 다음 단계를 따르십시오.
  1. 카운터를 샘플에 지정된 각 메모의 길이로 나눈다.
  2. 이 분할에 남은 값이 0이면 합성 엔진 메모 이벤트를 발생시킵니다.
이러한 효과를 통해 미리 녹화된 음악을 알려진 속도에 재생하려면 타이밍 정보를 사용하여 음악에 타임 동기화 필터 효과 또는 지연을 적용하십시오.

공간화

Spatialization SDK는 네이티브 오디오 플러그인 SDK를 기본으로 사용하는 플러그인의 한 예입니다. 공간화 SDK를 사용하면 오디오 소스별로 인스턴스화할 수 있는 커스텀 공간화 효과를 개발할 수 있습니다. 자세한 내용은 Audio Spatializer SDK를 참고하십시오.

추가 리소스