버전
Wwise SDK 2019.2.15
|
모션(motion)은 사용자가 컨트롤 인터페이스의 햅틱 피드백 제어를 사용할 수 있도록 허용하는 기능입니다. Wwise로 오디오를 관리할 때 사용하는 것과 동일한 기능으로 애플리케이션의 모션을 관리할 수 있습니다. 내부적으로 모션 데이터는 오디오 데이터와 차이점이 없습니다. 즉, 오디오에서 이용 가능한 모든 기능을 모션에서도 사용할 수 있다는 뜻입니다. Wwise 모션 기능으로 사용할 수 있는 햅틱 피드백에는 두 가지 타입이 있습니다. 프로젝트 내 오디오 신호를 사용해서 모션으로 변환하거나 Motion Generator 소스를 사용해 전용 모션 신호를 생성할 수 있습니다. 이 기능은 Windows에서 제공되는 컨트롤러로 Wwise 저작 도구에서 직접 테스트해볼 수 있습니다.
모션은 애플리케이션에서 동작하도록 Wwise 사운드 엔진 플러그인 시스템을 사용하며, 두 개의 모듈로 나뉠 수 있습니다. Motion Generator라는 오디오 음원과 Wwise Motion인 오디오 장치입니다. Motion Generator는 선택 사항이지만, 정밀하고도 유연하게 모션 디자인을 생성할 수 있는 강력한 도구입니다.
모션 싱크 플러그인은 사운드 엔진과 모션-레디 장치 사이의 연결 고리처럼 생각할 수 있습니다. 다른 싱크 플러그인과 같이 리스너로부터 데이터를 받으며, 이 데이터를 장치로 '나타내는' 역할을 담당합니다. 이 플러그인은 독립된 라이브러리 내에 있으며, 저작 도구와 애플리케이션 둘 다에 포함돼있어야 합니다. 더 많은 정보는 모션 구축 섹션을 참고하세요.
Motion Generator(모션 생성기) 소스 플러그인은 햅틱 피드백 효과 처리를 설계하는 데 매우 유용하고도 정밀한 방법을 제공합니다. 다른 오디오 음원과 마찬가지로 곡선 기반의 햅틱 피드백을 생성하도록 Wwise 프로젝트에서 Sound SFX 노드에 모션 생성기를 추가할 수 있습니다. Sound SFX 노드의 Output Bus는 반드시 모션-레디 버스로 설정돼야 합니다.
애플리케이션에서 모션을 사용하기 위해서는 각 컴포넌트를 적절히 구축해야 합니다. 오디오 작업 과정에 적용되는 모든 개념은 모션에도 적용 가능하다는 점을 기억하세요. 모션은 동일한 버스와 리스너, 방사체를 사용합니다 ( 리스너 통합하기 참고).
사운드나 모션 데이터를 장치로 보내려면 라이선스가 있는 Wwise Motion ShareSet를 Wwise 프로젝트의 Audio Device 폴더에 추가해야 합니다. Audio Device 폴더는 Project Explorer의 ShareSets 탭에 있습니다. Wwise Motion ShareSet는 모션-레디 장치와 소통할 때 사운드 엔진이 사용하는 Audio Device 플러그인입니다. 이 플러그인은 Wwise Motion ShareSet를 상위 레벨 Audio Bus에 할당하는 데에도 결정적인 역할을 합니다. 모션 버스 라는 용어는 편의상 할당된 Wwise Motion ShareSet으로의 상위 레벨 Audio Bus를 의미합니다. 손쉽게 문제를 해결하고 모니터링하기 위해서는 프로젝트에서 단일 모션 버스 계층을 사용하는 것이 좋습니다. 이제 Sound SFX의 Output Bus를 모션 버스로 설정해 햅틱 피드백을 생성할 수 있습니다. 일반적으로 모션 버스를 사용하는 Sound SFX 구성요소는 Motion Generator 소스도 사용합니다. 오디오와 모션을 동시에 가지려면, Sound SFX에 Output Bus나 Auxiliary Bus로서 최소한 한 개의 모션 버스와 Audio Bus가 있어야 합니다.
게임에서 가장 먼저 해야 할 것은 AkMotionSink
가 호출되는 독립된 라이브러리로 연결하는 것입니다. 이 라이브러리는 지원하는 플랫폼의 표준 컨트롤러를 제공합니다. 또한 SDK\include \AK\plugin 에 위치한 AkMotionSinkFactory.h 파일도 포함시켜야 합니다. 이 파일을 포함하면 자동으로 플러그인을 등록하기 때문에 매우 중요합니다.
![]() |
참고: Unity에서는 플러그인 라이브러리가 자동으로 관리됩니다. 즉 AkMotionSink 를 직접 추가할 필요가 없습니다. |
지원하는 컨트롤러와 추가 요구사항에 관한 목록은 다음 표를 참고하세요.
플랫폼 | 장치 | 추가 요구 사항 |
Android | 진동을 지원하는 Android 장치 | |
iOS | 지원하지 않음. iOS 장치의 다양한 햅틱 피드백 API는 Apple의 사양 제한으로 인해 Audiokinetic의 Motion 기능 지원 요구사항에 부합하지 않습니다. | |
Linux | 지원하지 않음. | |
Mac | 지원하지 않음. | |
PlayStation 4 | DUALSHOCK 4 PlayStation Move |
|
Switch | Joy-Con | |
Windows | Xbox One 컨트롤러 Xbox 360 컨트롤러 DirectInput 컨트롤러 |
XInput.lib Dinput8.lib Winmm.lib |
UWP | UWP 게임패드 | C++/CX |
Xbox One | Xbox One 컨트롤러 |
지정된 출력은 자신의 애플리케이션이 모션을 사용하고자 하는 각각의 장치로 추가되어야 합니다. 예를 들어, 4인 플레이어가 연결된 분할 화면 게임은 햅틱 피드백을 받을 수 있는 컨트롤러를 위해 네 개의 서로 다른 출력을 추가해야 합니다. 출력 장치를 추가하려면 Wwise API 함수 AK::SoundEngine::AddOutput
을 사용해서 AkOutputSettings
매개 변수에 ShareSet 이름을 지정해 줍니다. (Wwise 프로젝트에 정의된 것과 동일한 이름) 추가로, 복수의 장치가 연결되어 있기 때문에 장치 ID를 제공해줘야 합니다. 장치 ID에 관한 더 많은 정보는 다음 표를 참고하세요. 단일 컨트롤러를 사용하는 경우, 간단한 구축을 위해 기본 장치 ID가 지원됩니다. '0'으로 사용하면 첫 번째로 연결된 모션 지원 장치가 Motion 싱크의 대상이 됩니다.
플랫폼 | 장치 | 정보 | |
Android | 진동을 지원하는 Android 장치 | 0을 사용 | |
iOS | 지원하지 않음 | - | |
Linux | 지원하지 않음 | - | |
Mac | 지원하지 않음 | - | |
Windows | XboxOne 컨트롤러 Xbox360 컨트롤러 |
0에서 3 사이의 플레이어 인덱스를 사용합니다. | |
Windows | DirectInput 컨트롤러 | DIDEVICEINSTANCE에 저장된 guidProduct를 사용합니다. AK::FNVHash32 를 사용해 guidProduct를 해시 합니다. |
|
UWP | UWP 게임패드 |
AK::GetDeviceIDFromGamepad 를 호출해 게임패드 참조의 ID를 가져옵니다. |
|
PlayStation 4 | DUALSHOCK 4 | scePadOpen 또는 scePadGetHandle에 의해 반환되는 장치의 핸들을 사용합니다. | |
PlayStation 4 | PlayStation Move | scePadOpen 또는 scePadGetHandle에 의해 반환되는 장치의 핸들을 사용합니다. | |
XboxOne | XDK | XboxOne 컨트롤러 | IGamepad 객체에 저장된 Id를 사용합니다. |
XboxOne | GDK | AK/SoundEngine/Platforms/GX/AkGXSoundEngine.h의 AK::SoundEngine::GetGameInputDeviceID() 를 사용합니다. |
|
Switch | Joy-Con | 원하는 인덱스로 nn::hid::NpadId를 사용합니다. |
게임 컨트롤러는 물리적인 문제나 통신 문제로 연결이 끊어질 수 있다는 점에 유의하세요. 불필요한 리소스를 사용한다는 점 외에, 사운드 엔진에 불리한 영향을 미치지는 않습니다. 오랫동안 장치 연결이 끊어졌다고 생각되면, AK::SoundEngine::RemoveOutput
을 호출하여 이에 상응하는 AddOutput()
함수 호출로 반환된 AkOutputDeviceID 를 제공해야 합니다. 이는 리소스를 제거합니다.
모션 출력은 일반적인 Secondary Output과 동일하기 때문에 제한 및 요구 사항도 그와 동일합니다. 1인 플레이어 게임을 만든다는 것은 하나의 플레이어만 게임을 지역적으로 제어한다는 의미로, 리스너/게임 오브젝트 구축이 매우 간단합니다. 일반적인 경우, 새로운 모션 출력은 주요 오디오 출력에 대해 동일한 기본 Listener를 재사용하게 됩니다. 간단하게 말해서, 1인 플레이어 게임 구축에 Listener를 관리할 필요는 거의 없습니다.
멀티플레이어 게임을 만들려면, 모션 출력마다 하나씩 리스너/게임 오브젝트를 생성해줘야 합니다. 게임에 따라 각 플레이어가 각자의 햅틱 피드백을 갖게 하기 위해서입니다. 장치와 연관된 Listener는 반드시 AK::SoundEngine::AddOutput()
에 의해 해당 출력이 초기화되는 동시에 함께 초기화되어야 합니다. 지정된 Listener는 사운드나 모션을 전송하는 추가 레이어를 제공합니다. 해당 플레이어의 Listener와 고유하게 연결된 Game Object에 Event를 재생하면 특정 플레이어를 지정할 수 있습니다. 이는 AK::SoundEngine::SetListeners
를 호출하여 연결할 수 있습니다. Listener와 게임 오브젝트에 대한 더 많은 정보는 리스너 통합하기 를 확인하세요. 여러 개의 리스너를 한 게임 오브젝트로 연결할 수 있으며, 이 경우 모든 리스너에 "브로드캐스트(broadcast)" 효과가 생긴다는 점을 기억하세요.
![]() |
참고: Listener Emitter가 모션 출력으로 설정되어 있다 하더라도 사운드가 모션 버스 계층 구조로 전송되어야 합니다. |
다음 예제는 모션을 사용하기 위해서 애플리케이션을 어떻게 구축하는지에 대한 정보를 제공합니다. SDK 예제에 포함된 Integration Demo (DemoMotion.cpp)의 Demo Motion을 참고해도 됩니다. 여기에는 지원하는 모든 플랫폼에서 대해 작동하는 예제가 나와있습니다.
먼저 몇 가지 일반적인 플그러인의 관리가 필요합니다. 즉, 다른 플러그인처럼 필요한 파일을 포함시키고 해당 라이브러리를 연결해줘야 합니다. (Wwise 네이티브 개발에만 필요한 사항입니다. Unity에는 해당되지 않습니다.)
그런 다음 Wwise 프로젝트에 Motion ShareSet로 추가적인 출력을 추가합니다. 여기서는 'Wwise_Motion'이라는 이름을 사용합니다. 첫 번째로 연결된 게임 컨트롤러에 대해서 출력 ID로 0을 사용합니다.
그런 다음 평소대로 이벤트를 재생합니다. Wwise 프로젝트에서 'Play_Explosion' Event는, 특정 버스로 전송되는 Sound SFX를 가리키며, 이 버스의 Audio Device는 'Wwise_Motion' ShareSet가 할당돼있습니다.
여기에서의 멀티플레이어는 '동일한 콘솔상에서 복수의 플레이어'를 의미하며 '네트워크상에서의 멀티플레이어 게임'을 의미하지 않습니다. 멀티플레이어 시나리오에서 모션 믹스나 플레이어 전용 출력은 게임 세계 안에서 플레이어의 관점을 나타내기 위해 다르게 표현돼야 합니다. 이를 위해, 각 플레이어는 자신만의 Listener가 필요합니다.
그런 다음 모든 플레이어에 해당되는 출력을 추가하세요. 이 때 여러 개의 ShareSets가 필요하지 않으며, 각각의 ShareSet를 여러 번 사용하면 됩니다. 모든 컨트롤러에 대한 실제 장치 ID를 제공해야 합니다. 이 예제는 Windows의 Xbox 컨트롤러를 사용합니다. 특정 플랫폼에 대한 장치 ID를 구하는 방법은 게임 구축 표를 참고하세요.
그런 다음 평소대로 이벤트를 재생합니다. Wwise 프로젝트에서 'Play_GunFire' Event는, 특정 버스로 전송되는 Sound SFX를 가리키며, 이 버스의 Audio Device는 'Wwise_Motion' ShareSet가 할당돼있습니다.
여러 장치에 영향을 주는 Event를 재생하려면, 모든 플레이어 전용 Listener에 의해 수신되는 새로운 Game Object를 구축해야 합니다.
IntegrationDemo 예제에서 DemoMotion
클래스를 참고해도 됩니다. 이 클래스는 멀티플레이어 구축 예제를 제공합니다.
하나의 장치로 모션을 받는 특정 장치를 위해서 다음 사항을 처리해야 합니다.
AkMotionSink
라이브러리에 연결되도록 AkMotionSinkFactory.h를 포함해 AkMotionSink 라이브러리 연결합니다.AK::SoundEngine::RegisterGameObj
를 사용해서 모션 Event를 전송하고 받을 수 있게 게임 오브젝트를 생성합니다.Ak::SoundEngine::AddOutput
를 호출합니다. 멀티플레이어라면 각 플레이어에 대해 Listener 객체를 제공합니다.Wwise 프로젝트에서 모션을 가지려면:
문제를 해결하기 위해서는 애플리케이션을 프로파일링해보시기 바랍니다. 저작 도구에서 애플리케이션을 연결하고 Profiler layout (F6)를 사용해 프로파일링할 수 있습니다. 몇몇 도구는 문제가 있는 소스코드를 이해하는 데 도움이 될 수 있습니다. Capture Log 뷰는 빨간색으로 나타나는 에러 코드를 볼 수 있게 해줍니다. Graph 뷰는 사운드 엔진 파이프라인을 시각적으로 표현해 출력합니다. 파이프라인의 마지막에서 모션 장치를 볼 수 있습니다. 그렇지 않은 경우, 사운드 엔진이 지정된 장치를 찾을 수 없다는 것을 의미합니다. 또 다른 아주 유용한 뷰로 Emitter/Listener 탭이 있습니다. 이 뷰는 모든 방사체-리스너 쌍을 보여줍니다. Motion Effect가 동작하지 않는다면, 모션 장치에 지정한 Listener로 Emitter가 연결되지 않았기 때문입니다.
Motion 효과를 트리거 했지만 작동하지 않는다면, 다음 사항을 확인하세요.
AddOutput
가 호출될 때 Capture Log에서의 오류를 확인해야 합니다.RegisterGameObj
와 SetListeners
및 AddOutput
의 호출을 확인하세요.Android 장치에 대해서, 애플리케이션의 AndroidManifest.xml 파일에서 다음과 같은 퍼미션을 추가하는 것을 잊지 마세요.
프로젝트를 등록하세요. 아무런 조건이나 의무 사항 없이 빠른 시작을 도와드리겠습니다.
Wwise를 시작해 보세요