Mach1SpatialAPI
- 许可证
- 摘要
- 文档: dev.mach1.tech
- 联系方式
许可证
通过下载和使用 Mach1 空间 SDK(包括对 binaries/ 中任何内容的任何使用),您同意并承认由 Mach1 空间 SDK 许可证 阐述的使用条款。如果您不同意 Mach1 空间 SDK 许可证 中规定的条款,您无权使用、链接、编译和/或分发此存储库中的任何内容。
摘要
Mach1空间VVBP(基于向量的虚拟球面声场平移)是传统VBAP(基于向量的幅度平移)或SPS(空间PCM采样)的一种受控虚拟版本。Mach1空间格式设计用于简单易用且易于内容制作人和开发人员实现。Mach1空间音频混音仅基于幅度系数的变化进行编码和解码,与许多其他空间音频方法不同,没有额外的信号处理过程(如房间建模、延迟或滤波器)来创建一致准确的空间声场,并从第一人称视角播放。由于格式的简单性和依赖的向量空间,它也非常适合在不改变混音的情况下转换和传输环绕声和空间声音混音,使其成为一个理想的基于服务器的音频中转容器,轻松将受控后期制作的空间音频引入新媒介。
Mach1空间SDK包括四个组件和库
- Mach1Encode库:将输入流/音频编码和转换为Mach1空间VVBP格式。
- Mach1Decode库:解码Mach1空间VVBP格式,并使用设备方向/头部追踪,以输出方向性空间音频。
- Mach1DecodePositional库:添加额外的可选解码层,以解码具有6DOF的位置和方向解码的空间混音。
- Mach1Transcode库:将任何音频格式(环绕声/空间声)转换为或从Mach1空间VVBP格式进行转换。
示例
要运行任何示例项目,请首先克隆存储库,然后从示例目录运行pod install
,或者是通过在本目录下运行make build
或按照每个示例的README进行设置。
- mach1-decode-example:使用Mach1Decode API和设备方向播放空间声场的示例。
- mach1-encode-example:使用Mach1Encode API将输入单声道/立体声源平铺到Mach1空间向量空间中的示例UI,并通过Mach1Decode API同时播放。
- mach1-navigation-example:使用TTS输出作为Mach1Encode API的源输入,用于导航或空间提示用例的空间化播放的示例。
- mach1-positional-example:使用Mach1Decode和Mach1DecodePositional API,并通过添加方向和位置数据输入播放空间声场的示例。
- mach1-transcode-example:将其他格式的声场混音转换为Mach1空间,以表明使用Mach1Transcode API向Mach1Decode API进行无格式格式摄入和播放的示例。
截至2021年11月11日,推荐的iOS最小目标版本为14.0,以确保示例与Apple的Headphone Motion Manager API兼容。如果您需要针对较旧的iOS SDK进行目标定位,请删除所有使用CMHeadphoneMotionManager
的逻辑,或者回滚到较旧的示例版本。
安装
Mach1SpatialAPI目前仅限内部使用(即将推出正式版本)。要安装它,只需在将《Pod-Mach1SpatialAPI》目录放置到项目父目录后,将以下行添加到您的 Podfile
pod 'Mach1SpatialAPI', :path => 'Pod-Mach1SpatialAPI'
下载音频示例
- 在此目录中使用
make setup
将下载示例音频文件
作者
Mach1
联系
许可
Mach1SpatialAPI 适用于 Mach1 免费开发者许可协议。有关更多信息,请参阅 LICENSE 文件或Mach1 Spatial SDK 许可证。