버전

menu_open
Wwise SDK 2024.1.0
Audiokinetic 런처를 위해 자신의 플러그인 패키지하기

대상 플랫폼 및 환경 설정에 맞게 자신의 플러그의 빌드가 끝나면 Audiokinetic 런처를 통한 설치를 위한 패키지가 필요할 수 있습니다. 여기에는 두 단계 과정이 있습니다.

  1. 각 대상 플랫폼 패키지와 함께 특수한 Common (공통) 플랫폼도 패키지합니다. 패키지 스크립트는 Wwise 설치에서 필요한 모든 파일을 자동으로 불러옵니다.
  2. bundle.json 파일을 생성합니다. 번들 생성 스크립트는 플러그인 디렉터리에서 이전에 패키지된 아카이브를 자동으로 불러옵니다.

예를 들어 다음 명령줄을 실행해 Common, Documentation, Windows_vc160 및 Authoring 플랫폼을 패키지합니다.

python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" package Common --version=XXXX.X.X.X
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" package Documentation --version=XXXX.X.X.X
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" package Windows_vc160 --version=XXXX.X.X.X
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" package Authoring --version=XXXX.X.X.X
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" generate-bundle --version=XXXX.X.X.X

version 인자는 year.major.minor.build 형태의 Wwise 버전 번호 양식을 사용합니다.

참고: 또한, 번들을 생성하기 전에 bundle_template.json 파일을 편집할 수도 있습니다. 플러그인 패키지 형식 및 이 형식이 Audiokinetic 런처와 어떻게 연관되는지는 Plug-in Packaging Format for the Audiokinetic Launcher 를 참고하세요.
참고: 플러그인의 Documentation (문서) 부분은 선택 사항입니다.

플러그인의 추가 파일 패키지하기

–additional-artifacts 플래그나 –additional-artifacts-file 플래그를 사용해 모든 플랫폼에 대해 추가 파일을 패키지할 수 있습니다.

–additional-artifacts-file 플래그를 사용할 경우, 패키지할 추가 파일들의 경로 목록이 있는 JSON 파일이 있어야 합니다. 대상 경로는 반드시 자신의 Wwise 설치 루트에 대해 상대적이여야 하며, 소스 경로는 플러그인 디렉터리 루트에 대해 상대적이여야 합니다.

예를 들어, 다음은 앞에서 언급한 섹션의 명령줄입니다. Windows_vc160 및 Authoring 플랫폼으로 추가 DLL 파일을 패키지하도록 업데이트됩니다.

python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" package Common --version=XXXX.X.X.X
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" package Documentation --version=XXXX.X.X.X
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" package Windows_vc160 --version=XXXX.X.X.X --additional-artifacts-file=additional_artifacts.json
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" package Authoring --version=XXXX.X.X.X --additional-artifacts-file=additional_artifacts.json
python "%WWISEROOT%/Scripts/Build/Plugins/wp.py" generate-bundle --version=XXXX.X.X.X

이전 예제에서 사용한 additional_artifacts.json 파일은 플러그인 디렉터리 루트에 있으며, 내용은 다음과 같습니다 (lib/Debug/library.dlllib/Release/library.dll이 해당 플러그인 디렉터리에 존재할 경우).

{
"Authoring": [
{
"Authoring/x64/Release/bin/Plugins": ["lib/Release/library.dll"]
}
],
"Windows_vc160": [
{
"SDK/Win32_vc160/Debug/bin": ["/lib/Debug/library.dll"],
"SDK/Win32_vc160/Release/bin": ["/lib/Release/library.dll"],
"SDK/x64_vc160/Debug/bin": ["lib/Debug/library.dll"],
"SDK/x64_vc160/Release/bin": ["lib/Release/library.dll"]
}
],
}

–additional-artifacts 플래그도 비슷하게 동작하지만, 한 번에 한 경로만 허용합니다 (따라서 두 개 이상의 추가 파일을 패키지할 경우 플래그를 여러번 지정해줘야 함).

마지막으로, 이 동일한 additional_artifacts.json 파일을 사용해 프로젝트 디렉터리에 있는 다른 파일들을 패키지할 수도 있습니다. 이 때는, 경로 대신 대상 -> 소스 항목을 지정하세요. 앞서 언급했듯이 대상 경로는 Wwise 설치 루트에 상대적이어야 하며, 소스 경로는 플러그인 디렉터리 루트에 대해 상대적이어야 합니다. 다음은 앞에서 다룬 Authoring 플랫폼 예제의 또 다른 버전으로, 여기서는 Factory AssetsHelp 파일을 패키지합니다.

{
"Authoring": [
{
"Authoring/x64/Release/bin/Plugins": ["lib/Release/library.dll"]
"Authoring/Help/<PluginName>": ["Help/*.pdf"],
"Authoring/Data/Factory Assets/<PluginName>": [
"FactoryAssets/*.wproj",
"FactoryAssets/*.xml"
]
}
],
"Windows_vc160": [
{
"SDK/Win32_vc160/Debug/bin": ["/lib/Debug/library.dll"],
"SDK/Win32_vc160/Release/bin": ["/lib/Release/library.dll"],
"SDK/x64_vc160/Debug/bin": ["lib/Debug/library.dll"],
"SDK/x64_vc160/Release/bin": ["lib/Release/library.dll"]
}
],
}

위에 제시된 추가 결함 파일을 사용하면 프로젝트 루트의 파일들을 Wwise 설치 루트로 쉽게 복사할 수 있습니다. 대상 -> 소스 항목은 –copy-artifacts 플래그를 사용해 복사할 수 있습니다. 이 옵션은 모든 패키징을 건너뛰고 파일만 복사합니다.

다음 섹션: 플러그인의 Factory Asset 만들기


이 페이지가 도움이 되었나요?

지원이 필요하신가요?

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

지원 페이지를 방문해 주세요

작업하는 프로젝트에 대해 알려주세요. 언제든지 도와드릴 준비가 되어 있습니다.

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

Wwise를 시작해 보세요