-
Notifications
You must be signed in to change notification settings - Fork 5
App Music
HoshinoYumeka edited this page Sep 7, 2026
·
2 revisions
播放 config/mcphone/music/ 下玩家自己的音乐文件，另有唱片仓可对周围人外放。
播放 / 暂停 / 继续、上一首下一首、三种循环模式、进度条、音量。
| 曲库（耳机） | 唱片仓（外放） | |
|---|---|---|
| 内容来源 |
仅 config/mcphone/music/ 下的文件，游戏内唱片不混入 |
手持唱片点击放入，仓位 1 格 |
| 谁听得见 | 只有本人 | 周围玩家都听得见，声音跟随移动 |
| 由谁解码 | 本地客户端 | 服务端播放原版音效 |
| 可用操作 | 播放 / 暂停 / 继续 / 切换 / 进度 / 音量 | 仅播放与停止 |
外放没有暂停：原版音效系统中不存在"从中间接着放"。
两条路可同时发声。
本地 MP3 / OGG 无法外放：服务端无法把玩家硬盘上的文件发给其他人，其他人的客户端上也没有该文件。
装了 NetMusic 后，唱片仓同时接收它刻录的 CD：用其电脑方块搜歌、刻成 CD，放入手机后按播放，走到哪儿放到哪儿。
网络音乐能外放而本地文件不能，原因在于服务端只需广播一个地址，每个客户端各自去拉取。
搜歌、登录、会员、刻盘均属 NetMusic；本模组只接手"播放"这一件。
放入 config/mcphone/music/ 即可，进入音乐 App 会自动重扫，无须重启游戏。
| 解码器 | 扩展名 | 说明 |
|---|---|---|
| 原版 Vorbis |
.ogg .oga
|
游戏本体自带，最稳 |
| JavaMP3 |
.mp3 .mp2 .mp1
|
MIT 许可，全文见 jar 内的 THIRD-PARTY.txt
|
| 内置 PCM |
.wav .wave .aiff .aif .au
|
— |
| 采样率 | 是否可播 | |
|---|---|---|
| MPEG-1 | 44100 / 48000 / 32000 Hz | ✅ 绝大多数音乐属于此档 |
| MPEG-2 / MPEG-2.5 | 22050 / 24000 / 16000 / 11025 / 12000 / 8000 Hz | ❌ |
这是所打包解码库的限制，对应其 issue #8。
不可播放的文件不会静默失败：曲库中该行置灰，悬停提示「MPEG-2 放不了，只认 MPEG-1」，日志中记录完整规格：
[MCphone] 打开 MP3 我的歌.mp3 —— MPEG-1 Layer III, 44100Hz, 立体声, 320kbps
[MCphone] 放不了 local:老歌.mp3：MPEG-2 Layer III, 22050Hz, 单声道, 64kbps。
这个播放器只认 MPEG-1（44100 / 48000 / 32000 Hz），请转成 44.1kHz 再放进来
用任意转码工具转成 44.1kHz 的 MP3 即可，或转成 OGG。
循环模式与音量存于 config/mcphone-client.toml：
| 键 | 默认 |
|---|---|
musicMode |
LIST_LOOP（列表循环 / 单曲循环 / 随机） |
musicVolume |
100，范围 0–100 |
音量为该 App 自身的音量，最终输出还要乘以游戏主音量与唱片音量。