Wwise 음원 플러그인 및 효과 플러그인 문제 해결 안내

Wwise SDK 2022.1.18

Problem: At startup, Wwise displays an error message stating that two plug-ins have the same Company ID and Plug-in ID.

각 플러그인에는 고유한 Company ID / Plug-in ID의 조합이 있어야 합니다. ID를 정의하는 방법에 대한 자세한 내용은 Plug-in Type Elements 을(를) 참고하세요.

Problem: My plug-in is not available to the user in Wwise.

자신의 플러그인 설명 파일에 올바른 플러그인 타입이 지정돼있는지 확인하세요. The file should use the SourcePlugin tag for source plug-ins and EffectPlugin for effect plug-ins. Refer to Plug-in Type Elements for more information. 이 카테고리는 엔진 쪽 코드의 XML 파일과 PluginRegistration 클래스 둘 다와 일치해야 합니다.
자신의 플러그인 설명 파일에 지원 플랫폼이 올바르게 명시돼있는지 확인하세요. Refer to PluginInfo Element for more information.
Verify that the Company ID and Plug-in ID specified in your plug-in's XML file match those used by the AkCreatePlugin() function in your DLL and in the PluginRegistration object. PluginRegistration 예제는 사운드 엔진 플러그인 개요 를 참고하세요. 더 자세한 내용은 Wwise 플러그인 XML 설명 파일 및 오디오 플러그인의 Authoring(저작) 부분 작성하기 를 참고하세요.
If Wwise displays an error message on startup stating that two plug-ins have the same IDs, refer to the corresponding problem on this page.
XML과 DLL이 같은 이름으로 돼있는지 확인하세요.
XML과 DLL이 plugins 폴더에 있는지 확인하세요.

Problem: My plug-in is not available to users on Mac but works on PC.

Problem: One of the controls in my plug-in's user interface is empty or disabled.

리소스에서 컨트롤의 텍스트에 명시된 속성 이름(예: Prop=SineFrequency)이 플러그인 설명 파일에 명시된 이름(예: Property Name="SineFrequency")과 동일한지 확인하세요. Refer to "Prop" 제어 속성 and 속성 구성 요소 for more information.
컨트롤 클래스(에: Class=SuperRange)가 속성 유형에 적합한 지 확인하세요. 더 자세한 내용은 "Class" 제어 속성 과 속성 구성 요소 를 확인하세요.

Problem: One of the Wwise controls in my plug-in's user interface does not appear correctly.

Class 속성이 대화 리소스에 올바르게 설정돼있는지 확인하세요. 더 자세한 내용은 "Class" 제어 속성 을 참고하세요.
자신의 코드가, 해당 대화가 완전하게 생성되기 전에 컨트롤 텍스트를 변경하지 않도록 하세요. 이 경우 Wwise는 필요시 Class 속성에 접근할 수 없습니다. 속성에 묶여있는 컨트롤의 텍스트는 절대 변경해서는 안 됩니다. 더 자세한 정보는 "Prop" 제어 속성 을 참고하세요.
그 외 제어 속성들 을 참고해 다양한 컨트롤 속성이 올바르게 설정돼있는지 확인하세요.
플러그인 대화에 사용할 수 있는 두 가지 컨트롤 유형에 대한 정보는 자신의 대화 상자에 규칙 제어 추가하기 와 자신의 대화 상자에 Wwise 속성 제어 추가하기 를 참고하세요.

Problem: My plug-in doesn't recognize property changes in the UI.

플러그인 정의 파일에 명시돼있는 AudioEnginePropertyID 가 0-32767 범위 안에 있는지, 또는 wcustomproperties 파일이 0-150 범위 안에 있는지 확인하세요. AudioEnginePropertyID 태그에 대한 더 자세한 정보는 속성 구성 요소 를 참고하세요.
플러그인 정의 파일에 명시돼있는 AudioEnginePropertyID 가 AK::IAkEffectParam::SetParam() 의 구현에서 사용하는 ID와 동일한 지 확인하세요. AudioEnginePropertyID tag 에 대한 더 자세한 정보는 속성 구성 요소 를, AK::IAkEffectParam::SetParam() 구현에 대한 더 자세한 정보는 AK::IAkPluginParam::SetParam() 을 참고하세요.

Problem: My plug-in works in Wwise but not in my game.

여기에는 두 가지 경우가 있습니다.

자신의 게임이 특정 효과에 고정적으로 연결된 경우, 플러그인 라이브러리와 해당되는 팩토리 헤더 파일이 CPP 파일 안에 연결돼있도록 하세요.
자신의 게임이 동적 라이브러리를 사용할 경우 (DLL, SO, PRX 등), 자신의 효과 DLL이 실행 파일과 동일한 폴더에 들어있도록 하세요. 만약 같은 폴더 안에 있지 않을 경우, AkInitSettings::szPluginDLLPath 가 DLL 검색 경로를 추가하도록 설정하세요.

Problem: I can add my plug-in in a project, but I can't hear its effects when playing a sound in Wwise.

You can debug this issue if you click Start Capture before playing the sound with your plugin. Capture Log에 "Plugin not registered(등록되지 않은 플러그인)"이라는 내용이 뜰 경우, 저작 쪽 DLL 코드의 cpp 파일 중 하나에 AK_STATIC_LINK_PLUGIN(YourPlugin) 을 추가하면 이 문제를 해결할 수 있습니다.

Problem: My plug-in does not display debugging and/or diagnostic information.

To send debug or diagnostic information to Wwise Authoring, you can use AK::IAkPluginContextBase::PostMonitorMessage(), which is a method that can be called from the AK::IAkEffectPluginContext instance passed as an argument to your plug-in's AK::IAkSourcePlugin::Init() or AK::IAkEffectPlugin::Init() function.
To output debugging information to the debugger (Visual Studio), you can use AKPLATFORM::OutputDebugMsg() or AKPLATFORM::OutputDebugMsgV(), found in AkPlatformFuncs.h.

Problem: My plug-in doesn't work in Unity.

Here are a few points to validate for new plugins in Unity:

Unity에서 Wwise가 로드하는 플러그인은 반드시 \Assets\Wwise\Deployment\Plugins\[Platform]\DSP로 복사되어야 합니다. 대부분 여기에는 Release 버전이 사용됩니다.
플러그인에는 Windows\x86, Windows\x86_64, Mac 버전이 있어, 해당 플러그인이 Unity Editor에서 작동하게 됩니다.
일반적인 Unity 통합은, 뱅크를 만들 때 생성되는 PluginInfo.xml로부터 플러그인 사용을 감지합니다. PluginInfo.xml의 "DLL" 태그는, Wwise 저작 폴더 내 플러그인을 설명하는 XML 파일에 작성된 "EngineDllName"로부터 직접 가져옵니다. 자신의 DLL이 동일한 이름으로 돼있는지 확인하세요.

더 자세한 내용은 플러그인 정적(static) 등록 을(를) 참고하세요.

질문이 있으신가요? 문제를 겪고 계신가요? 더 많은 정보가 필요하신가요? 저희에게 문의해주시면 도와드리겠습니다!

프로젝트를 등록하세요. 아무런 조건이나 의무 사항 없이 빠른 시작을 도와드리겠습니다.

Wwise를 시작해 보세요