Spatial Audio System 更新日志

Sound Handy

可以从远处操作自己的 Playback Device。右键点击目标装置进行选择，按鼠标中键播放或停止。Shift＋滚轮切换目标，Shift＋R 显示和编辑范围，Shift＋H 切换装置边框的显示。

装置的名称、音源、播放状态等可以在迷你 HUD 中查看。可以在 Sound Handy 的界面中更改名称或打开装置的界面。测试播放只有您自己能在当前位置听到。Wiki 中新增了专门的讲解页面。

播放与范围设置

• 为普通播放新增了循环按钮（↻）。在停止之前，会循环播放单曲槽位中的音源。
• 计划播放最多可设置 16 项。界面每次显示 6 行，通过滚动切换。
• 将计划播放的启用、禁用切换移至计划播放界面。删除项目改为使用垃圾桶按钮，并在每行设置了停止按钮（■）。
• 启用计划播放后，普通槽位中的媒介会返回物品栏。没有空位时会掉落在脚下。
• 不使用 Range Board 时的播放范围现在可在 1〜64 格之间设置。新装置的默认值为 64 格。更改会从下次播放起生效。
• 使用 Range Board 时以板的范围为优先。各面的衰减距离未设置时，使用板的默认值 8 格。

红石输出

最多可设置 16 条与播放状态联动的规则。支持“Playing”的持续输出，以及“On start”“On stop”“On end”的脉冲输出。信号强度为 1〜15，延迟以 0.5 秒为单位、最长 30 秒，脉冲长度以 0.1 秒为单位、最长 5 秒。也可以只针对特定的计划播放项目。

多个输出重叠时，使用最强的信号。信号以弱信号的形式输出到周围，不会通过固体方块传递。装置自身的输出回到输入时，不会再重新开始播放。现有装置的输出默认处于禁用状态。

中途加入时的播放

加入服务器、切换维度或进入范围时，现在可以从与已经过时间相应的位置开始听到声音。由于下载时间等原因，玩家之间的播放位置可能会有差异。

修复与改进

• 修复了循环播放在 10 分钟后停止的问题。
• 修复了向空槽位发送信号会解除循环设置的问题，以及取出媒介后仍继续播放的问题。
• Range Board 的说明和上传失败时的消息现已支持翻译。
• 改善了中途加入玩家的播放位置延迟。
• 内置 Manta 2.5.0，更新了界面、提示框、HUD 和 Wiki 的文字渲染。

兼容性与开发者信息

通信协议版本为 1.5。旧版客户端无法连接。请将服务器和客户端统一为对应版本。可以使用服务器日志中的 SAS-CatchUp 和 SAS-Delivery 确认播放的开始位置。另请注意与要求 Manta 1.x 的旧版本同时使用的条件。

• 将 Playback Device 和 Memory Device 的界面迁移至 Manta UI。jar 中内置了 Manta 1.1.12。
• 新增最多 6 项、每项 1〜10 次的计划播放。可以通过拖动媒介或 Shift＋点击进行登记，还可以调整顺序和试听。
• 新增 5 个日语、英语的游戏内 Wiki 页面。显示提示时按 F1，可以打开对应功能的讲解。
• 界面上现在会显示封面图片、提示和写入错误。
• 装置现在可以在公开和非公开之间切换。
• 为 Range Board 新增了显示操作状态的 HUD。
• 现在可以沿用 1.0.3 及以前版本的方块、媒介和音频保存位置。此版本不再需要 1.0.4 中建议的迁移到新世界。
• 改进了播放会话管理、超时、通信数据校验和存储处理，并新增了 52 个单元测试。

• 名称从 Station Sound System 更改为 Spatial Audio System。模组 ID 从 stationsoundsystem 变为 spatialaudiosystem。
• 新增供其他模组使用的公开 API belugalab.sas.api。可以获取媒介和范围的信息、加载音频、播放、停止，并使用播放完成事件。
• 修复了关闭世界后音频仍继续播放的问题。退出时也会清理传输途中的数据。

此版本的注意事项

存在无法直接识别更名前的方块和 Recording Medium 的问题。沿用支持已在 1.0.5 中添加。

• 音频按每 500KB 分割发送，单个文件的上限扩大至 10MB。
• 修复了写入或播放大型音频时玩家被服务器断开连接的问题。
• 未完成的传输现在会在 30 秒后丢弃。
• 改进了通知用通信的兼容性和同步数据的生成。
• 将 Range Board 的坐标设置、解除消息移至物品名称下方。

• Recording Medium 现在保存的不是音频本身，而是引用保存位置的 ID。旧媒介会在首次播放时迁移。
• 改为可以防止因物品同步或创造模式操作导致音频数据损坏的方式。
• 新增模组图标。
• 将 Range Board 的显示日语化，并新增最远 64 格的指定和跟随视线的预览。
• 修复了刚加入世界时在范围外发出声音的问题。

• 修复了音量衰减未生效的问题，以及刚离开范围时瞬间发出很大声音的问题。
• 其他玩家的音源现在也会正确应用衰减。
• 修复了红石输入无法开始播放的问题。
• 检测到无效的音频数据时，现在会跳过播放。
• 破坏 Playback Device 时，其他玩家的声音现在也会停止。

为 Minecraft 1.21.1／NeoForge 新增了 Playback Device、写入音频的装置、Recording Medium 和 Range Board。支持 MP3、OGG、WAV、红石输入和多人游戏。

当时的模组 ID 为 stationsoundsystem。在 1.0.4 中更名为 Spatial Audio System。