오디오 콘솔 명령

언리얼 엔진에서 게임 또는 다른 프로젝트를 디버깅할 때는 현재 실행 중인 게임 또는 에디터로 명령을 직접 전송하는 것이 도움이 될 수 있습니다. 특히 오디오의 경우에는 더더욱 그렇습니다. 범위가 제한되거나 알려지지 않은 상황에서만 발생하는 버그를 트래킹하려고 한다면 콘솔 명령을 통해 특정 기능을 활성화 또는 비활성화하거나 실시간으로 주요 파라미터를 조정하면 유용합니다.

콘솔 사용 방법

기본적으로 명령 콘솔(Command Console) 은 하단 툴바에 포함되어 있으며, 언리얼 에디터 창 하단에서 찾을 수 있습니다. ~ 모양의 물결 키를 눌러서 명령 콘솔 입력창을 직접 표시할 수도 있습니다. 영국식 키보드에서는 ` 모양의 악센트 키를 사용합니다.

물결 키를 눌러도 명령 콘솔이 열리지 않거나 콘솔을 열기 위해 물결 키가 아닌 다른 키를 사용하려면 프로젝트 세팅(Project Settings) > 엔진(Engine) >입력(Input) >콘솔 키(Console Keys) 에서 키보드 바인딩을 변경할 수 있습니다.

콘솔 명령을 사용할 때는 출력 로그(Output Log) 도 함께 여는 것이 좋습니다. 명령 콘솔 왼쪽의 단축키를 클릭합니다. ~ 모양의 물결 키 를 두 번 눌러도 '출력 로그' 창을 열 수 있습니다. 또는 창(Window) > 출력 로그(Output Log) 를 사용해도 됩니다.

대부분의 오디오 콘솔 명령에는 [CVar name] [Value] 구문을 통해 지정된 콘솔 변수 , 즉 CVar 를 원하는 값으로 설정하는 것이 포함됩니다.

예를 들어 사운드 믹스를 디버깅하려면 콘솔에 au.Debug.SoundMixes 1 명령을 입력하여 CVar au.Debug.SoundMixes 를 true 로 설정할 수 있습니다. 여기서 1은 true를 의미합니다.

[CVar name ?] 명령을 입력하여 지정된 CVar 사용 사례에 대한 추가 정보를 찾을 수도 있습니다.

콘솔에 입력한 명령은 실시간으로 에디터에 적용됩니다. 콘솔 명령은 게임에서, 에디터에서 또는 게임이 실행된 후 서버 콘솔에서 -server switch를 입력하여 실행할 수 있습니다.

일반 오디오 CVar 및 사용

일부 이전 함수를 제외하고 오디오 전용 콘솔 명령과 변수는 au. 으로 시작합니다. 언리얼 엔진의 콘솔은 자동 완성을 지원하기 때문에 콘솔에 au. 을 입력하고 나열된 명령을 검색하여 빠르게 사용 가능한 명령 목록을 얻을 수 있습니다.

• au.Debug.SoundMixes 변수를 1 로 설정하면 현재 활성 사운드 클래스 믹스에 대한 정보를 얻을 수 있습니다. 사운드 믹스는 한 번에 레벨의 여러 사운드에 영향을 미칠 수 있는 오브젝트이므로 사소한 결함은 트래킹하기 어려울 수 있습니다. 사운드 믹스에 정보를 표시하면 예기치 않게 트리거된 사운드 믹스가 있거나, 사운드 믹스가 예상대로 사운드 믹스 모디파이어 목록에서 푸시 및 팝업되지 않거나, 동일한 믹스의 여러 인스턴스가 동시에 활성화되는지 등의 오류를 쉽게 파악할 수 있습니다. 이 방법은 단일 사운드 클래스가 갑자기 들리지 않게 되거나 할 때 디버깅하려 하는 경우 좋은 시작점이 될 수 있습니다.

• au.DumpActiveSounds 변수를 1 로 설정하면 현재 재생되는 모든 사운드의 목록을 얻을 수 있습니다. 이러한 기능은 사람이 듣는 것과 동일하게 들리지만 다른 원인이 있는 문제의 오류 소스 범위를 좁히는 데 유용합니다. 예를 들어 사운드를 더 이상 들을 수 없는 경우 활성 사운드를 덤프하여 사운드가 재생되지 않는 것인지 또는 사운드가 들을 수 없을 만큼 낮은 레벨에서 재생되고 있는 것인지 식별할 수 있습니다. 이와 마찬가지로, 똑같이 거대한 사운드로 인식될지는 몰라도 볼륨 모디파이어의 볼륨이 지나치게 크게 설정되어 소리가 큰 것인지, 동일한 여러 사운드 인스턴스가 동시에 재생되어 소리가 큰 것인지 구분하는 데 도움이 될 수 있습니다.

• AudioMemReport 명령은 별도로 값을 입력할 필요 없이 AudioMemReport 만 입력하면 활성 사운드 오브젝트의 메모리 사용량에 대한 상세 문서가 생성됩니다. 이는 오디오 시스템에서 예기치 않게 큰 메모리가 사용되었을 경우 트래킹하기에 유용합니다. 또한 일반적인 오디오 최적화에도 유용합니다.

오디오 콘솔 명령

언리얼 오디오 엔진을 디버그하려면 아래 명령을 사용합니다. 또한 해당되는 경우 새 명령으로 대체된 폐기 명령도 표시합니다.

대부분의 경우 1 또는 0, on 또는 off, true 또는 false 로 활성화 및 비활성화를 설정할 수 있습니다. 이때 on/off 및 true/false는 대소문자를 구분합니다).

0 = false(비활성화), 1 = true(활성화) 라는 점에 유의하면 au.DisableDeviceSwap처럼 효과 자체가 비활성화인 명령의 경우에는 true로 설정하여 활성화하면 비활성화 효과가 적용됩니다. 즉, 이 기능을 켜려면 au.DisableDeviceSwap 1 을 입력해야 하는 것입니다.

이전 오디오 콘솔 명령

아래 명령은 아직 사용하는 사용자가 있을 수 있고, 함수 기능이 제공되기 때문에 포함되었습니다.

하지만 이 명령에는 입력 인수가 없어 새로운 오디오 콘솔 명령처럼 자동으로 완성되지 않습니다.