#fmod #sound #gamedev

sys fmod-audio-sys

FFI 绑定 FMOD 和 FMOD Studio

1 个稳定版本

2.220.2 2024年6月11日
2.2.20 2024年6月4日

#861音频

Download history 171/week @ 2024-06-04 332/week @ 2024-06-11

67 每月下载量
fmod-oxide 中使用

MPL-2.0 许可证

45KB
700 代码行

fmod-audio-sys

类似于其他 -sys Crates,为 FMOD 提供低级 bindgen 包装器。

该库本身根据 MPLv2 许可证授权,不包括 FMOD 的 API!您需要自行下载 FMOD 以充分利用此 crate。

目前命名为 fmod-audio-sys,既是为了将其作为 FMOD 音频引擎的绑定进行区分,也是因为 fmod-sys 已经被占用 :p

使用

将此 crate 添加为依赖项

[dependencies]
fmod-audio-sys = "2.220.0"

您需要下载并安装 FMOD 的 API。在 Windows 上,您只需运行安装程序即可——其他一切都会为您处理。

在其他平台上,您需要将 FMOD 放置在某个位置(通常为您的二进制文件根目录)并通过 .cargo/config.toml 设置 FMOD_SYS_FMOD_DIRECTORY


lib.rs:

对 FMOD 音频引擎的低级绑定。

由于许可限制,FMOD API 不能与该 crate 一起分发。提供了 FMOD API 的 docs.rs 文档,但实际 API 没有FMOD 库则不可用。

目前,此 crate 提供了核心和工作室绑定(没有 fsbank 绑定)。

配置

在调试构建中,此 crate 将链接到 FMOD 库的日志版本。在发布构建中,此 crate 将链接到 FMOD 库的发布版本。您可以通过启用 force-debug 功能强制使用库的调试版本。

默认情况下,此 crate 将在以下位置搜索 FMOD 安装目录

(在 Windows 上)

  • C:/Program Files (x86)/FMOD SoundSystem/FMOD Studio API Windows
  • D:/Program Files (x86)/FMOD SoundSystem/FMOD Studio API Windows
  • $OUT_DIR/FMODStudio API Windows
  • $OUT_DIR/FMODSoundSystem

(在所有平台上)

  • $CARGO_MANIFEST_DIR/fmod
  • $OUT_DIR/fmod
  • $FMOD_SYS_FMOD_DIRECTORY

预期此安装将遵循标准的 FMOD 目录结构。

fmod

  • api
    • core
      • inc
      • lib (包含特定于架构的目录)
    • studio
      • inc
      • lib (包含特定于架构的目录)

依赖关系

~0.3–2.7MB
~56K SLoC