空间音频系统

空间音频系统

一个基于 Manta 构建的 BelugaLab 音频模组。

---

English

空间音频系统（SAS）可在世界内播放你自己的音频文件。将电脑中的 mp3 / ogg / wav 文件通过记忆装置写入记录介质，再用播放装置播放，并使用范围板定义声音的可闻范围及衰减方式——适用于出发旋律、建筑内广播、背景音乐等场景。支持多人游戏，所有界面均通过 BelugaExperience 设计工作流在 Manta UI 运行时之上渲染。

功能特性

• 播放你自己的音频 —— 支持电脑中的 mp3 / ogg / wav 文件，单个文件最大 10 MB
• 3D 范围控制 —— 范围板定义一个声音可闻的箱体区域，支持按方向衰减
• ♪ 播放列表 —— 最多排列 6 个媒体并按顺序播放，每个条目重复 1–10 次
• 封面显示 —— 音频文件中嵌入的艺术图会显示在设备屏幕上
• 红石自动化 —— 播放装置在上升沿触发，适用于车站广播、过场动画和环境音触发
• 访问模式 —— 第一个打开设备的玩家成为所有者；可在公开与私有之间切换
• 多人游戏安全 —— 音频存储在服务器端并流式传输给每个客户端，因此不会出现客户端间不同步
• 内置 Wiki —— 所有界面均在游戏内有文档说明，支持悬停提示和 F1（英文 / 日文）
• 公开 API —— 附加模组可触发播放并挂钩播放完成事件

环境要求

依赖	版本
Minecraft	1.21.1
NeoForge	21.1.220+
Manta	1.1.12 —— 已随 jar 捆绑，无需单独下载

开源信息

SAS 以 MIT 许可证发布，托管于 github.com/hololocheck/SpatialAudioSystem。 附加模组应基于稳定的 belugalab.sas.api 包进行构建，该包可广播播放指令、读取范围和介质元数据，并监听 PlaybackEndedEvent 事件。内部 com.spatialaudiosystem.* 包不属于 API 表面，在不同版本之间可能会被重新打包。

---

日本語

Spatial Audio System (SAS) は、自分の音声ファイルをワールド内で再生する Mod です。PC 内の mp3 / ogg / wav を記憶装置で記録媒体に書き込み、再生装置で再生し、範囲指定ボードで「どこまで聞こえるか・どう減衰するか」を決めます。発車メロディ、館内放送、BGM などに使えます。マルチプレイ対応。全画面を Manta UI ランタイム上の BelugaExperience デザインワークフローで描画しています。

特徴

• 自分の音声を再生 — PC 内の mp3 / ogg / wav を、1 ファイル最大 10 MB まで
• 3D 範囲制御 — 範囲指定ボードで音の聞こえる箱を定義し、方向ごとにフェードアウト
• ♪ スケジュール — 最大 6 件の媒体を並べて順番に再生。各エントリ 1〜10 回
• ジャケット表示 — 音声ファイルに埋め込まれたアートワークをデバイス画面に表示
• レッドストーン自動化 — 立ち上がり信号で再生。駅放送・カットシーン・環境音トリガに
• アクセスモード — 最初に開いたプレイヤーが所有者。公開 / 非公開を切り替え可能
• マルチプレイ安全 — 音声はサーバー側に保存して各クライアントへ配信するため desync なし
• 内蔵 wiki — 全画面をゲーム内で解説。ホバーヒントと F1 対応（英/日）
• 公開 API — addon mod から再生指示・再生完了のフックが可能

必要な環境

依存	バージョン
Minecraft	1.21.1
NeoForge	21.1.220+
Manta	1.1.12 — jar に同梱、別途ダウンロード不要

オープンソース

SAS は MIT ライセンスで github.com/hololocheck/SpatialAudioSystem に公開しています。addon mod は安定 API の belugalab.sas.api パッケージを参照してください（再生指示、範囲・媒体メタデータの取得、PlaybackEndedEvent の購読が可能）。内部パッケージ com.spatialaudiosystem.* は API 表面ではなく、バージョン間でリパッケージされる可能性があります。