1 个稳定版本
2.220.2 | 2024年6月11日 |
---|---|
2.2.20 |
|
#861 在 音频
67 每月下载量
在 fmod-oxide 中使用
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 (包含特定于架构的目录)
- core
依赖关系
~0.3–2.7MB
~56K SLoC