menu
 
版本
2024.1.5.8803

2024.1.5.8803

2023.1.13.8732

2022.1.19.8584

2021.1.14.8108

2019.2.15.7667

2019.1.11.7296

2018.1.11.6987

2017.2.10.6745

2017.1.9.6501

2016.2.6.6153

2015.1.9.5624

menu

Wwise Unreal Integration Documentation
使用工程迁移 Commandlet

Wwise Unreal 插件包含相应的 Commandlet,方便通过命令行将 Unreal 工程迁移到 Wwise 2022.1。

Commandlet 用法和参数

Commandlet 用法:

<UnrealEditor.exe> <path_to_uproject> -run=AkMigration [ [-transfer-bank-waapi] OR [-generate-bank-definition=<Path/To/Save/FileName>.tsv] ][-ignore-bank-errors] [-transfer-bank-autoload] [-delete-banks] [-migrate-assets] [-update-settings] [-delete-deprecated-assets] [-generated-soundbanks-folder=<Path/To/Folder>]

以下参数执行 Migration Window 中可用的相同操作。有关这些操作的详细信息,请参阅 将工程升级到 Wwise 2022.1 页面。

  • transfer-bank-waapi:(可选)通过 WAAPI 将 Unreal 工程中的 SoundBank 传输到 Wwise。此参数不可与 generate-bank-definition 结合使用。
  • generate-bank-definition:(可选)在指定的路径创建 SoundBank 定义文件。使用绝对文件路径 (C:...)。之后须将文件手动导入到 Wwise 中来创建 SoundBank。此参数不可与 transfer-bank-waapi 结合使用。
    • ignore-bank-errors:(可选)忽略在通过 WAAPI 传输 SoundBank 期间或在写入到 SoundBank 定义文件时发生的错误并继续实施迁移。
  • transfer-bank-autoload:(可选)将 AkAudioBank AutoLoad 属性传输到其中分组存放的素材。
  • delete-banks:(可选)在完成传输后删除 Unreal 工程中的所有 SoundBank 素材。
  • delete-deprecated-assets:(可选)删除所有还在工程中但已弃用的 Wwise 素材。
  • migrate-assets:(可选)迁移工程中的 Wwise 素材。
  • update-settings:更新 Wwise 和 Unreal 工程的设置。
    • generated-soundbanks-folder:(可选)与 update-settings 结合使用的 GeneratedSoundBanks 文件夹的路径。使用绝对文件路径 (C:/...)。此参数用于设定 Unreal 工程中的 Generated Sound Banks Folder 设置。
  • help:(可选)输出消息来描述所有参数并马上终止 Commandlet。

使用示例

C:\UE_5.0\Engine\Binaries\Win64\UnrealEditor-Cmd.exe C:\MyProjects\Demo\WwiseDemoGame.uproject -run=AkMigration -transfer-bank-waapi -transfer-bank-autoload -delete-banks -migrate-assets -delete-deprecated-assets -update-settings -generated-soundbanks-folder="C:/Project/WwiseProject/GeneratedSoundBanks"
check_circleTIP: Commandlet 窗口会在执行命令后立即关闭。若要将命令的结果输出到文本文件,请在命令的末尾添加 > log.txt。这时会在当前目录下创建名为 log.txt 的文本文件并在其中包含相关错误或警告。

操作顺序

迁移操作的执行顺序跟编辑器内的迁移相同,其并不受命令行中的参数顺序影响。 顺序如下:

  1. 生成 Bank
    1. 传输 Auto Load 属性
    2. 传输 Bank(WAAPI 或 SoundBank 定义文件)
    3. 删除弃用的 AkAudioBank 素材

迁移 Wwise 素材

  1. 删除弃用的素材
  2. 更新工程设置

此页面对您是否有帮助?

需要技术支持?

仍有疑问?或者问题?需要更多信息?欢迎联系我们,我们可以提供帮助!

查看我们的“技术支持”页面

介绍一下自己的项目。我们会竭力为您提供帮助。

来注册自己的项目,我们帮您快速入门,不带任何附加条件!

开始 Wwise 之旅