前言

众所周知，Wwise是一款功能极为强大的跨平台声音引擎。虽然引擎本身是跨平台的，但其设计工具（Authoring Tool）则是基于Winnows平台编写的。为了实现在Mac平台运行设计工具，音能（Audiokinetic）团队使用了一种名为Wine技术的兼容层，该兼容层可将软件调用的各类Windows API实时转译成POSIX API，以最小的性能损失与迁移成本实现在macOS上运行设计工具。音能团队使用的是由CodeWeavers提供技术支持商业的Wine版本——CrossOver。

本文记录了在使用Mac版Wwise（Wwise on macOS, WoM)时遇到的各种问题与对应的解决方案，不定时更新。

• 前言
• 正文
  • Wine中的磁盘映射
  • 配置Environment Variable
    • 解决方案
    • 问题上下文
  • macOS下的快捷键映射与注意事项
  • 双开工程

正文

Wine中的磁盘映射

在没有Wwise的情况下，C盘将被映射至~/.wine/drive_c/，Y盘将被映射至根目录，Z盘为用户Home文件夹。
在有Wwise的情况下，C盘将被映射至/Applications/Audiokinetic/Wwise\ <Wwise版本>/Wwise.app/Contents/SharedSupport/Wwise2019x64/support/Wwise2019x64/drive_c 。

因此如果希望在WoM中访问用户文稿内的文件foo.wproj，则文件路径则可以写为：Z:\Documents\foo.wproj或Y:\Users\<你的用户名>\Documents\foo.wproj。
若希望访问其他应用程序，则只能通过Y盘访问。

此外，每个版本的Wwise还在~/Library/Application Support/Wwise2019/Bottles/Wwise2019x64/处提供了dosdevice的映射。笔者暂时未发现其除增长路径外的其它用途。

配置Environment Variable

解决方案

1. 使用Wwise.app内的Wine启动Wine注册表编辑器。以2021.10.7883版为例，在终端中输入/Applications/Audiokinetic/Wwise\ 2021.1.10.7883/Wwise.app/Contents/SharedSupport/Wwise2019x64/Wwise2019/wine regedit即可启动。
2. 在HKCU:Environment中新建字符串值。名称为变量名，数据填入Unity工程地址。
3. 关闭注册表编辑器后，重启Wwise即可生效。

问题上下文

某些项目组希望将Unity工程与Wwise工程拆分开来。由此导致的问题是，在没有Wwise工程的电脑上，Unity无法加载正确的声音库（Soundbank），打包时也无法将声音库和流播放文件自动拷贝至apk/ipa包的StreamingAssets中。对于这种问题，我的解决方案是，在生成后步骤（Post-Generation Step）中使用 xcopy命令，将平台对应的声音库与流播放文件拷贝至StreamingAssets的对应文件夹内。（xcopy是Windows的内置命令，可以复制文件和目录，包括子目录。）

在命令（Commands）窗口中硬写入Unity工程地址也是一种可行的方案，讨论过程如下：

• 不能使用绝对路径。生成前后步骤信息是记录在 <工程名>.wproj 文件中的。使用绝对路径则要求每个设计师都需要在本地忽略.wproj文件。该文件是Wwise的工程文件，因此该方法不可行。
• 使用相对路径则要求所有设备的工程文件相对位置固定。降低了工程的灵活性，违背了Wwise项目与Unity项目解耦的目标。若需分开存放，还需在对应位置创建软连接。

因此我采用了在Windows的环境变量中添加Unity项目的工程地址，以此来提高其解耦度。

macOS下的快捷键映射与注意事项

众所周知，Windows中的很多快捷键仅需将Ctrl替换为command即可，在WoM中也是如此。唯一需需要额外注意的地方是，对于各位中文用户，在输入快捷键时记得关闭中文输入法。否则Wwise将无法识别所有非修饰键（control、option、command）的按键。若需使用功能键，记得按下fn。如，生成全部声音库的快捷键在WoM中为：fn+option+command+F7 。在某些情况下，command+C/command+V的快捷键会失效。此时不妨尝试按下角落的control键，说不定会有奇效。

双开工程

默认情况下，无论是直接双击wproj文件还是在Wwise Launcher-Projects中选择工程，只有当前已经有工程打开，后一个工程便无法打开。若试图在当前窗口使用Project-Open...的方法打开第二个工程当前工程则会被关闭。

若想双开工程，可在Wwise.app上右键（或control-click），选择显示包内容(Show Package Content)后，打开Contents/MacOS，并双击Wwise2019即可双开WoM。