bevy_fmod

本Crate旨在提供一个惯用的Bevy插件用于FMOD。本Crate封装了libfmod。

FMOD

FMOD是一个跨平台的音频引擎，被许多游戏使用。它是一个商业产品，提供了特定条款下的免费许可证。

FMOD署名

本Crate与FMOD没有任何关联。它未获得Firelight Technologies Pty, Ltd的支持或关联。要在您的应用程序中使用FMOD，您必须根据Firelight Technologies的条款进行署名。更多信息请参阅此处。

支持的平台

目前，本Crate仅针对Windows（非UWP）和Linux进行了测试和开发。最终将支持更多平台。

MacOS：https://github.com/Salzian/bevy_fmod/issues/2
Web：https://github.com/Salzian/bevy_fmod/issues/51

欢迎Pull requests。

外部依赖

本Crate未捆绑所需的FMOD库。您需要从此处下载适当的库。这需要一个免费的FMOD账户。

Windows

• 下载Windows的"FMOD Engine"包。
• 安装包。
• 您需要在Rust项目的根目录中包含以下4个文件
  • api/core/lib/x64/fmod.dll
  • api/core/lib/x64/fmod_vc.lib
  • api/studio/lib/x64/fmodstudio.dll
  • api/studio/lib/x64/fmodstudio_vc.lib

Linux

以下是相当简化的链接库的步骤。有关更多信息，请参阅build.rs中的注释。

• 下载Linux的"FMOD Engine"包。
• 在项目根目录下创建一个新的文件夹fmod。
• 将api文件夹提取到其中。
• 将build.rs的内容复制到您自己的构建脚本中。

使用方法

[dependencies]
bevy_fmod = { git = "https://github.com/Salzian/bevy_fmod.git", tag = "<bevy_fmod release tag>" }

获取最新发布标签 在发布页面。

示例

要测试此库的示例，请克隆仓库。FMOD Studio 附带一个示例项目。打开它，然后选择 文件 >另存为...。将项目保存为 <bevy_fmod>\assets\audio\demo_project.fspro。现在，构建项目（文件 > 构建）。这将创建一个名为 .\assets\audio\demo_project\Build 的文件夹，用于我们的示例。

使用 cargo run --example <example_name> 运行示例。在 Cargo.toml 中找到示例列表。查看示例的源代码以获取更多详细信息。

实时更新

实时更新是一种将 FMOD Studio 连接到游戏的方法，在游戏运行时进行，允许您实时更新和监控音频内容。

https://www.fmod.com/docs/2.02/studio/editing-during-live-update.html

要启用实时更新，您需要启用 live-update 功能。虽然您可以在 Cargo.toml 中这样做，但我建议使用 --features 标志显式启用它。这样，您就不会意外地将它包含在您的发布构建中。

cargo run --example minimal --features live-update