版本

menu_open
警告:系统已根据您所用大版本 (2023.1.10.8659) 自动跳转至最新文档。若想访问特定版本的文档,请从 Audiokinetic Launcher 下载离线文档,并在 Wwise 设计程序中勾选 Offline Documentation 选项。

Using Wwise with your source control system

所有 Wwise 工程文件(包括各个 Work Unit)都基于 XML。所以,用户可使用版本控制系统轻松管理这些文件。建议将某些(并非全部)文件添加到版本控制系统。

File Manager(文件管理器)中的所有文件都可添加到版本控制系统。Wwise 会使用这些文件生成工程所需的其他文件。建议将以下内容添加到版本控制系统:

  • .wproj —— Wwise 工程文件。这些文件存放在工程文件夹的根目录下。

  • .wwu – Wwise Work Unit。这些文件存放在主工程文件夹的子目录下。

  • Originals 文件夹 – 原始媒体文件。这些文件可用于创建工程的最终音频素材。

总的来说,Wwise 生成的文件可以放在版本控制系统之外。因为没必要将它们添加到版本控制系统,而且在多用户环境下共享某些文件可能会导致同步问题。建议将以下内容放在版本控制系统之外:

  • .backup 文件夹 – 在使用新的 Wwise 大版本打开工程时,会对工程进行升级并生成 .backup 文件夹。这样是为了在需要时将工程恢复为升级之前的状态。若将工程添加到了版本控制系统,则可藉此恢复为升级之前的状态。为此,可将 .backup 文件夹放在版本控制系统之外。

  • .cache 文件夹 – 工程目录下的 .cache 文件夹是 Wwise 的本地工作文件夹。.cache 文件夹的内容不得添加到版本控制系统,因为这可能造成 Wwise 中发生异常行为。

  • .prof – 这些文件在每次捕获时生成,其并非工程数据的一部分。

  • .validationcache – 这些文件由 .wwu 文件生成,可放在版本控制系统之外。

  • .wsettings – 此文件特定于本地用户和电脑。

  • IncrementalSoundBankData.xml – 此文件用于根据 Wwise 工程的本地内容和本地 SoundBank 生成记录来追踪 SoundBank 的状态。

注意,在创建新的工程时会包含 .gitignore 和 .p4ignore 文件。下面有个示例 .gitignore 文件:

# Wwise
.backup*
.cache*
*.akd
*.prof
*.validationcache
*.wsettings
IncrementalSoundBankData.xml

您可以随时通过工程来生成 SoundBank。不过,若有不使用 Wwise 的团队成员,则其需要这些生成的文件来在开发当中试玩游戏时试听声音。借助版本控制系统,团队成员可以访问这些文件。若有不止一个 Wwise 用户将 SoundBank 添加到版本控制系统,这些文件可能会不同步。为了避免这种情况,请将所有.bnk 和 .wem 文件添加到 soundbanks/ 路径下。鉴于 Wwise 与游戏引擎的集成方式各不相同,可能还要添加 .txt、.xml 和 .json 文件。

工程中的大文件可能还要进行特别处理以便节省时间(比如使用 Git LFS)。通过 Git LFS 放在版本控制系统之外的文件可能包括大的二进制文件(如 .wav、.aif、.png 和 .jpg)。

在游戏的整个开发过程中,都可在 File Manager 中查看工程文件 (.wproj)、Work Unit 文件 (.wwu) 和音频文件的状态。若使用 Perforce、Subversion 或别的版本控制插件,则可直接在 Wwise 中执行版本控制功能。有关如何在 Wwise 中使用版本控制插件的详细信息,请参阅“Managing project files with a source control plug-in”一节

在默认情况下,Wwise 会在保存 Work Unit 文件、SoundBank 文件和某些工程文件时应用 LF 行结束符。Wwise 也可在保存时为其应用 CRLF 结束符。详见 Project Settings 的 “General 选项卡”一节中的 Line Ending

若您是团队的一员且使用版本控制系统来管理工程文件,请时刻留意有无其他成员在处理这一工程,以及是否存在可能需要解决的合并冲突。因此,经常同步和合并您的工作,并频繁与团队成员沟通交流您正在做的工作非常重要。有关经验总结的完整列表,请参阅“Source control tips and best practices”一节


此页面对您是否有帮助?

需要技术支持?

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

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

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

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

开始 Wwise 之旅