Wwise 帮助文档

1. 提交所有工程：

   1. 对于处于版本控制之下的工程，请求团队其他成员一并提交所有更改。

      这样可以避免以后产生合并问题。

2. 获取所有最新版本的待迁移工程：

   1. 对于处于版本控制之下的工程，将所有工程全部导入到本地系统。

   2. 确保所有工程文件均具备读写权限。

      For projects under source control, you might need to check out the project file (WPROJ) and all Work Unit files (WWU) from the various subfolders.

3. 验证待迁移工程：

   1. In the current version of Wwise, open each project that you plan to migrate and save.

   2. If the Project Load Log dialog displays messages and suggested fixes, accept these fixes, save the changes, and close the project. 重复这一操作，直到不再显示任何消息。这样做的目的是排除所有工程错误以简化升级流程。

4. 标记待迁移工程：

   1. 对于处于版本控制之下的工程，提交并标记为升级之前最后版本的工程。

      Committing the project at this point records all changes made prior to the migration process. 版本控制记录中，此后的其他更改都与迁移直接相关。

1. 升级 Wwise：

   1. Upgrade Wwise on your local system as described in Installing Wwise and Component Packages.

2. 将工程迁移到新的版本：

   1. 确认当前 Wwise 工程中的所有文件均具备读写权限。

   2. 进行工程备份并将备份工程存储到系统或网络上的另一文件夹中。The project will be backed up automatically by Wwise, but it is good practice to create your own backup as well.

   3. Open the new version of Wwise. In the Project Launcher dialog that opens, select the project you plan to migrate.

      The Project Migration dialog opens prompting you to migrate the project to the later version of Wwise.

      info	备注
      	The Migration dialog is only displayed when significant changes have been made to the project file between versions. 倘若工程不需要迁移，则 Wwise 会跳到迁移流程的下一步。

   4. Click Migrate.

      Wwise migrates the project. 在迁移工程之后，Wwise 会检查现有工程缓存文件夹是否与当前 Wwise 版本兼容。若否，则 Wwise 将删除工程缓存文件夹。When the project cache is deleted, the following message is displayed.

      

   5. 单击 OK（确定）。

   6. 在 Wwise 菜单栏中，依次选择 Views > Utilities > Logs（视图 >实用工具 > 日志）。此时将打开 Logs 视图。

   7. 在 Logs（日志）视图中，选中 Project Load（工程加载）选项卡。The Project Load log displays messages related to the migration and indicates if any files were created for the new version of Wwise.

      

      info	备注
      	This information is stored in the file named projectname.wproj_migration.log in the project folder. If needed, you can click Copy to clipboard to save this information for later reference.

   8. 若使用了版本控制系统，请将迁移过程中创建的所有新文件添加到版本控制系统。

   9. 关闭 Logs（日志）视图。

3. 生成 SoundBank（音频包）：

   1. 针对已迁移的工程生成 SoundBank 以便用来测试。

1. 升级 Wwise SDK：

   1. Confirm that your system meets the Wwise SDK Platform Requirements.

   2. Optionally, uninstall the earlier version of the Wwise SDK.

      It's good practice to also manually remove any temporary files created by the sample C++ projects.

   3. Install the later version of the Wwise SDK. Refer to Install Wwise through the Launcher and select SDK (C++) under Packages.

   4. Verify that the WWISESDK environment variable points to the installation folder of the later version. （有关如何设置环境变量的详细信息，请参阅选用多个 Wwise SDK 版本）。

2. Update the game code for the later version of the Wwise SDK:

   1. Refer to the migration notes in the Wwise SDK documentation to familiarize yourself with the modifications you will be making.

   2. To migrate the game code, you must port the existing functionalities of the C++ project from the earlier version of the Wwise SDK to the later version. This task might include modifying or refactoring code in different modules. Changes to the following modules might need to be addressed to update the game code:

      • Sound Engine（声音引擎）

      • Memory Manager

      • Stream Manager

      • Communications Module

      info	备注
      	To ensure that your game is not adversely affected by some of the new features in the later version, we recommend you first upgrade the components that you need for your game. 在确保游戏比较稳定后，则可根据需要集成这些新功能。

   3. 根据需要修改代码。

      check_circle	技巧
      	It's good practice to rebuild the C++ project often when you are modifying the code.

3. 构建游戏。

测试已迁移的游戏工程，然后提交：

1. 在游戏中，确认声音和音频行为。确认事项可能包括：

   • 基本的音频播放。

   • 受代码更改影响的行为。

   • 平台行为。

   • 与 Wwise 设计工具的通信。

2. 将已迁移的 Wwise 工程和代码更改提交到版本控制系统。

在所有工作站上升级 Wwise：

1. 可选择卸载所有 Wwise 组件。This might include:

   • Wwise 设计工具

   • Wwise SDK

   For more information on uninstalling, refer to Uninstalling Wwise.

   info	备注
   	并不一定非要卸载 Wwise。在必要时，可在同一工作站上保留多个 Wwise 版本和内部版本。

2. Install the later version of Wwise. This might include:

   • Wwise 设计工具

   • Wwise SDK

   • Wwise Game Simulator

   For more information about installing, refer to Installing Wwise and Component Packages.

Access the migrated Wwise project on all workstations:

1. After you have installed the later version of Wwise, retrieve the migrated Wwise project.

2. 打开 Wwise。

   此时将显示 End-User License Agreement（最终用户授权协议）。

3. 仔细阅读协议。若接受，请点击 Accept（接受）。

   此时将打开 Project Launcher 窗口。

4. 打开已迁移的工程。

   info	备注
   	If some users have Work Units in the Wwise project that have been saved locally and are not under source control, a message appears prompting them to accept that these Work Units will be migrated when the project opens in the new version of Wwise.

   在加载工程之前，Wwise 会检查并确保工程缓存文件夹与当前版本兼容。若否，则 Wwise 将删除工程缓存文件夹。在删除工程缓存后，会显示以下消息框。

   

5. 单击 OK（确定）。

   在删除缓存后，便会将工程加载到 Wwise 中。