알림: 고객님의 주요 출시 버전( 2023.1.8.8601 )에 해당하는 최신 설명서로 이동했습니다. 특정 버전의 설명서를 보시려면 Audiokinetic 런처에서 오프라인 설명서를 다운로드하고 Wwise Authoring의 Offline Documentation을 확인하세요.

Wwise SDK 2023.1.8

플러그인 미디어 시스템을 이용하면 플러그인(효과, 음원, 싱크, 믹서)에서 Wwise 아키텍처를 활용해 프로젝트 내 이진 데이터 파일을 저장할 수 있습니다.

플러그인에서 커스텀 데이터를 사용하는 대신 플러그인 미디어를 사용하면 다음과 같은 다양한 장점이 있습니다.

데이터 빌트인 지속
Source Control 통합 (작업 그룹 기능 사용)
플랫폼별로 허용된 데이터 변환
허용된 데이터를 담을 SoundBank를 최종 사용자가 선택

Wwise 저작 플러그인

플러그인 미디어 관리하기

자신의 플러그인 백엔드에서 AK::Wwise::Plugin::RequestObjectMedia 를 상속받아 Object Media 서비스를 요청할 수 있습니다. 그러면 m_objectMedia 멤버가 제공돼 해당 서비스의 메소드에 접근할 수 있습니다. 오브젝트 미디어를 사용자가 변경하는 등, 관련된 알림을 받으려면 AK::Wwise::Plugin::Notifications::ObjectMedia 로부터 상속받아 AK::Wwise::Plugin::Notifications::ObjectMedia::NotifyPluginMediaChanged() 를 오버라이드합니다.

AK::Wwise::Plugin::ObjectMedia::SetMediaSource() 를 호출해 미디어 파일을 가져올 수 있습니다. 미디어를 가져올 때, 해당 미디어는 플러그인의 "Originals" 디렉터리에 복사되어 전적으로 Wwise가 관리하게 됩니다. 인덱스 0에서 플러그인 미디어 파일을 추가하려면:

플러그인 데이터가 변경되었을 때 알림을 받기 위해 NotifyPluginMediaChanged 함수를 오버라이드합니다. NotifyPluginMediaChanged is triggered by any modifications to the media source.

더 자세한 정보은 AK::Wwise::Plugin::ObjectMedia 함수의 설명 문서를 참고하세요.

런타임을 위한 미디어 변환

If the plug-in definition file uses CanReferenceDataFile, you must convert your imported original WAV media at runtime to an appropriate format for the real-time component.

To implement conversion functions, inherit from AK::Wwise::Plugin::MediaConverter and implement the required functions:

다음은 AK::Wwise::Plugin::MediaConverter 함수의 구현 예시입니다.

플러그인 정의

In the plug-in definition file (the plug-in XML file), ensure that the CanReferenceDataFile element is set to true.

런타임 플러그인

런타임에 플러그인 미디어 사용하기

자신의 플러그인의 Sound Engine 부분에서, AK::IAkEffectPlugin 을 구현하면 Init(...) 함수에서 AK::IAkEffectPluginContext 포인터를 받게 됩니다. AK::IAkEffectPluginContext 로부터 AK::IAkPluginContextBase::GetPluginMedia 를 호출하여 Wwise SoundBank에 패키징된 변환된 미디어를 구할 수 있습니다.

참고: 이 예제에서는 런타임 때 effect 플러그인 미디어를 사용하는 방법을 설명합니다. 그러나 source plug-in 과 같이 다른 플러그인 타입을 사용하는 방법도 보여줍니다. 이 경우, AK::IAkSourcePlugin 을 구현하고 AK::IAkSourcePluginContex 포인터를 받게 됩니다.