오디오 모듈레이션 레퍼런스 가이드

오디오 모듈레이션(Audio Modulation) 플러그인은 컴포넌트 및 블루프린트 시스템에서 볼륨 및 피치와 같은 부동 소수점 오디오 파라미터를 동적으로 제어하는 기능을 제공합니다.

에셋 타입

오디오 모듈레이션의 함수 기능을 제공하는 다섯 가지 에셋 타입이 있습니다.

이러한 에셋을 사용하여 모듈레이션 파이프라인의 기초를 생성한 다음 이를 엔드포인트 모듈레이션 대상에 연결할 수 있습니다.

오디오 모듈레이션 에셋 생성하려면 다음 단계를 따릅니다.

1. 콘텐츠 브라우저에서 추가(Add) 버튼을 클릭합니다.

2. 오디오(Audio) > 모듈레이션(Modulation) 아래에서 원하는 에셋 타입을 선택합니다.

모듈레이션 파라미터

모듈레이션 파라미터는 모듈레이션 값이 정규화되고, 표시되고, 다른 값과 믹싱되는 방식에 대한 컨텍스트를 제공합니다.

각 모듈레이션 파라미터에는 다음과 같은 베이스 프로퍼티가 있으며, 여기에 클래스에 따라 기타 파라미터가 추가됩니다.

• 디폴트 파라미터 값(Default Parameter Value): 디폴트 모듈레이션 값입니다. 이 파라미터를 참조하는 모듈레이터가 다른 모듈레이터와 믹싱될 때 입력이 변경되지 않도록 설정해야 하는 우회 값으로 작동합니다. 수학적으로는 믹스 함수가 입력으로 설정되었을 때 Identity 함수로 효과적으로 감소하도록 값을 선택해야 합니다.

• 유닛 표시명(Unit Display Name): 언리얼 에디터에서 레퍼런스에 표시할 유닛입니다. 이 정보는 개발 목적으로만 사용되며 패키지로 만든 빌드에서는 제거됩니다.

볼륨 믹싱과 주파수 조작 등, 다양한 사용 사례를 지원하는 여러 기본 모듈레이션 파라미터가 있습니다.

모듈레이션 값 정보

모듈레이션 값은 다음 두 값 공간 사이에서 변환됩니다.

• 유닛(Unit): 모듈레이션 파라미터와 연결된 유닛 값입니다. 예를 들어, 볼륨 모듈레이션 파라미터의 경우에는 데시벨(dB)입니다. 유닛 값은 정규화된 값에 매핑됩니다.

• 정규화(Normalized): 균등한 전달 및 믹싱을 위해 정규화된 0.0~1.0 사이의 값입니다.

여러 모듈레이터가 단일 모듈레이션 대상에 링크될 때 모듈레이션 값이 믹싱됩니다. 결합 방식은 연결된 모듈레이션 파라미터에 따라 다릅니다. 다음은 일부 기본 모듈레이션 파라미터 타입에서 믹싱을 처리하는 방식에 대한 몇 가지 예시입니다.

• 볼륨(Volume): 볼륨 감소는 애디티브 방식입니다. 예를 들어, 두 컨트롤 버스의 값이 각각 -6dB과 -12dB이면, 모듈레이션 대상의 볼륨은 -18dB로 설정됩니다.

• 하이 패스 필터 주파수(High-Pass Filter Frequency): 최댓값이 선택됩니다. 예를 들어, 두 컨트롤 버스의 값이 각각 1,000Hz와 500Hz이면, 모듈레이션 대상의 하이 패스 필터 주파수는 1,000Hz로 설정됩니다.

• 로우 패스 필터 주파수(Low-Pass Filter Frequency): 최솟값이 선택됩니다. 예를 들어, 두 컨트롤 버스의 값이 각각 1,000Hz와 500Hz이면, 모듈레이션 대상의 로우 패스 필터 주파수는 500Hz로 설정됩니다.

커스텀 모듈레이션 파라미터 클래스 생성

USoundModulationParameter 베이스 클래스에서 상속하고 다음 함수를 구현하여 자체 모듈레이션 파라미터 클래스를 생성할 수 있습니다.

• GetMixFunction: 입력 및 출력 값을 믹싱하는 함수를 반환할 것으로 예상됩니다.

• GetUnitConversionFunction: 값을 유닛 스페이스로 변환하는 함수를 반환할 것으로 예상됩니다.

• GetNormalizedConversionFunction: 값을 정규화된 스페이스로 변환하는 함수를 반환할 것으로 예상됩니다.

자세한 내용은 오디오 모듈레이션 C++ API 레퍼런스를 참조하세요.

컨트롤 버스

컨트롤 버스(Control Buses)는 모듈레이션 파라미터를 참조하는 커넥터입니다. 그 용도는 다음과 같습니다.

• 컨트롤 버스 믹스 및 모듈레이션 제너레이터에 의해 변조에 사용됩니다.

• 파라미터 패치에 의해 참조되고 리매핑됩니다.

컨트롤 버스 프로퍼티

컨트롤 버스 믹스

컨트롤 버스 믹스(Control Bus Mixes)는 다음과 같은 작업에 도움이 되는 모듈레이터입니다.

• 동시에 여러 컨트롤 버스 값에 영향을 줍니다.

• 다른 컨트롤 버스 믹스와 공유되는 컨트롤 버스로 변조합니다.

• 믹스 프로파일을 사용하여 실시간으로 오디오를 테스트하고 미세조정합니다.

컨트롤 버스 믹스 프로퍼티

컨트롤 버스 믹스의 프로퍼티가 업데이트되었으며, 컨트롤 버스 믹스와 관련된 일부 함수에는 새로운 경과시간 및 활성화 시 리트리거 변수에 대한 입력이 추가되었습니다.

파라미터 패치

파라미터 패치(Parameter Patches)는 주로 다음 두 가지 방면에서 유용한 하이브리드 커넥터-모듈레이터입니다.

• 하나 이상의 컨트롤 버스 값을 단일 출력 값으로 변환합니다.

• 파라미터 패치로 컨트롤 버스 값 커브를 커스터마이징할 수 있는데, 이는 값을 리매핑하고 다양한 페이드 이펙트를 생성하는 데 유용합니다.

파라미터 패치 프로퍼티

모듈레이션 제너레이터

모듈레이션 제너레이터(Modulation Generators)는 시간이 지남에 따라 값을 생성하는 하이브리드 커넥터-모듈레이터입니다. 컨트롤 버스 또는 모듈레이션 대상 프로퍼티에서 설정하여 모듈레이션 제네레이터로 변조할 수 있습니다.

이 플러그인은 다음 타입에 대한 구현을 제공합니다.

• 저주파수 오실레이터(Low-Frequency Oscillator, LFO): 사인파나 사각파 같은 주어진 파형의 진동에 따라 값을 생성합니다.

• 엔벨로프 팔로워(Envelope Follower): 주어진 오디오 버스의 진폭에 따라 값을 생성합니다.

• AD 엔벨로프(AD Envelope): 주어진 어택-디케이 엔벨로프에 따라 값을 생성합니다.

커스텀 모듈레이션 제너레이터 생성

제너레이터를 생성하고 등록하는 데 필요한 보일러플레이트 코드를 생성하는 USoundModulationGenerator 클래스용으로 제공된 코드 생성 템플릿을 사용하여 자체 모듈레이션 제너레이터를 생성할 수 있습니다.

USoundModulationGenerator 클래스를 생성하려면 다음 단계를 따릅니다.

1. 툴(Tools) > 새 C++ 클래스(New C++ class)를 선택합니다.

2. 부모 클래스 선택(Choose Parent Class) 창에서 모든 클래스(All Classes)를 선택합니다.

3. SoundModulatorBase 아래에서 SoundModulatorGenerator를 선택합니다.

다음과 같은 함수를 구현해야 합니다.

• GetValue: 0.0~1.0 사이의 캐시되고 정규화된, 유닛 없는 값을 반환할 것으로 예상됩니다. 이 값은 리스닝 모듈레이션 대상에 제공됩니다.

• Update: 다음 프레임의 캐시된 값 계산을 구현할 것으로 예상됩니다.

선택적으로 다음과 같은 함수를 구현할 수도 있습니다.

• IsBypassed: 제너레이터 값이 대상 계산에 포함되어야 할지에 따라 boolean 값을 반환할 것으로 예상됩니다. 기본적으로 생성된 USoundModulationGenerator Bypass 프로퍼티에서 언리얼 오디오 엔진으로 값을 전달합니다.

• GetDebugValues: 출시되지 않은 빌드에서 au.Debug.SoundModulators 디버그 명령 계열을 사용하여 런타임 시 표시할 제너레이터 인스턴스당 스트링 배열을 제공할 것으로 예상됩니다.

• GetDebugCategories: 이러한 인스턴스 값에서 제공하는 값에 해당하는 필드 이름의 스태틱 배열을 제공할 것으로 예상됩니다.

자세한 내용은 오디오 모듈레이션 C++ API 레퍼런스를 참조하세요.

모듈레이션 대상

모듈레이션 대상(Modulation Destination)은 오디오 모듈레이션 에셋이 변조할 주어진 유닛의 베이스 float 값을 제공하는 오디오 오브젝트에 연결된 엔드포인트입니다.

다음 오브젝트에 모듈레이션 대상이 있습니다.

• 사운드 웨이브

• 메타사운드 소스

• 오디오 컴포넌트

• 신디 컴포넌트

• 사운드 클래스

• 서브믹스

• 소스 이펙트(비트 크러셔(BitCrusher) 및 코러스(Chorus) 전용)

해당 디테일 패널의 모듈레이션 아래에서 지원되는 각 오디오 오브젝트의 모듈레이션 대상을 찾을 수 있습니다. 각 오브젝트에는 볼륨이나 피치 등, 변조될 프로퍼티를 결정하는 지원되는 모듈레이션 대상이 나열되어 있습니다.

모듈레이션 대상을 사용하려면 연결된 변조(Modulate) 체크박스를 활성화한 다음 배열에 원하는 커넥터(컨트롤 버스, 모듈레이션 제너레이터 또는 파라미터 패치)를 추가해야 합니다.

모듈레이션 대상 라우팅 옵션

오디오 컴포넌트의 모듈레이션 대상 같은 일부 모듈레이션 대상은 상속 기반 라우팅 옵션을 제공합니다. 자손 오브젝트는 부모 오브젝트로부터 모듈레이션 라우팅을 상속받을 수 있습니다. 특히 오디오 컴포넌트는 연결된 사운드 에셋으로부터 상속받을 수 있고, 사운드는 연결된 사운드 클래스로부터 상속받을 수 있습니다.

메타사운드 통합

오디오 모듈레이션 플러그인은 다음 메타사운드 노드를 제공합니다.

• 모듈레이터 값 구하기(Get Modulator Value): 정규화된 값이나 유닛 스페이스로 주어진 모듈레이터 값을 반환합니다.

• 모듈레이터 믹스(Mix Modulators): 두 개의 주어진 모듈레이터 사이의 믹싱된 파라미터 값을 정규화된 값 또는 유닛 스페이스로 반환합니다.

메타사운드 시스템에 대한 자세한 내용은 메타사운드 문서를 참조하세요.

오디오 모듈레이션 및 동시실행

소스의 볼륨 변조를 활성화하여 동시실행의 가장 작은 소리 중지(Stop Quietest) 옵션에 영향을 주는 CVar를 사용할 수 있습니다. 이 CVar의 이름은  au.Concurrency.IncludeVolumeModulation입니다.

동시실행(Concurrency) 탭의 해상도 규칙(Resolution Rule) 아래에서 동시실행 에셋(Concurrency Asset)을 더블클릭하면 메뉴를 찾을 수 있습니다.

• 0으로 설정하면 볼륨 변조는 동시실행 평가에 포함되지 않습니다.

• 1로 설정하면 볼륨이 원샷(One-shot)에 포함되지만 루핑 사운드에는 포함되지 않습니다.

• 2로 설정하면 볼륨 변조가 모든 사운드에 포함됩니다.

블루프린트 API 개요

블루프린트를 사용하여 모듈레이션 파이프라인을 동적으로 생성하고 제어할 수 있으며 게임플레이나 비주얼 이펙트 같은 다른 시스템을 구동할 수 있습니다.

오디오 모듈레이션에 관련된 대부분의 블루프린트 함수는 오디오 > 모듈레이션 아래에 있습니다. 아래 테이블에서 이러한 함수를 간략하게 살펴볼 수 있습니다.

자세한 내용은 오디오 모듈레이션 블루프린트 API 레퍼런스를 참조하세요.

UObject 및 프록시 정보

오디오 모듈레이션 컴포넌트 및 에셋으로 작업할 때는 일반적으로 UObject 값을 편집합니다. 그러나 오디오 모듈레이션은 다음 두 가지 이유로 UObjects를 직접 사용하여 처리하지 않습니다.

• UObject는 게임 스레드에서 실행됩니다.

• UObject는 오디오 모듈레이션 시스템의 제어를 벗어났을 때 가비지 컬렉션될 수 있습니다.

그 결과 UObjects에 설정된 값은 오디오 렌더 스레드의 오디오 모듈레이션 시스템에 있는 오브젝트에 전송됩니다. 이 점을 기억해야 하는 까닭은 일부 블루프린트 함수는 UObject를 편집하고 다른 함수는 오디오 모듈레이션 시스템의 프록시 오브젝트를 수정하기 때문입니다.

어떤 함수가 UObject 값만 수정하면 Update 블루프린트 함수를 호출하여 변경사항을 프록시에 전송해야 합니다. 또한, UObject 값을 수정하지 않는 함수를 호출한 다음 프록시를 업데이트하기 위한 함수를 호출하는 경우, UObject 값이 프록시를 덮어씁니다.