-
Notifications
You must be signed in to change notification settings - Fork 5
App Music
HoshinoYumeka edited this page Sep 7, 2026
·
2 revisions
曲库、唱片仓、支持的格式，以及 MP3 的那一条限制。
播放 config/mcphone/music/ 下你自己的音乐：播放 / 暂停 / 继续、上一首下一首、三种循环模式、进度条、音量。
| 曲库（耳机） | 唱片仓（外放） | |
|---|---|---|
| 放的是什么 | 只有你自己放进目录的文件，游戏里的唱片不会混进来 | 手持唱片点一下放进去 |
| 谁听得见 | 只有你 | 周围人都听得见，声音跟着你走，像扛着一台唱片机 |
| 谁在解码 | 你的客户端 | 服务端播原版音效 |
| 能不能暂停 | 能，还能看进度 | 只有播和停 |
外放没有暂停，是因为原版音效系统里没有"从中间接着放"这回事。
两条路可以同时响，就像一边戴耳机一边开外放。
本地的 MP3、OGG 为什么不能外放：服务端没法把你硬盘上那个文件发给别人，别人电脑上也没有它。
用 NetMusic 的电脑方块搜歌、刻成 CD，把 CD 放进手机，按播放——走到哪儿放到哪儿，周围人都听得见。
网络音乐能外放而本地文件不能，原因就在上一段：网上那首歌人人都拿得到，它只需要广播一个地址，每个客户端自己去拉。
搜歌、登录、VIP、刻盘全是 NetMusic 的事，我们只接手"放"这一件。
| 格式 | 说明 |
|---|---|
| OGG / OGA | 游戏自带解码器，最省事、最稳 |
| MP3 / MP2 / MP1 | 靠打包进来的 JavaMP3（MIT 许可），许可证全文在 jar 里的 THIRD-PARTY.txt
|
| WAV / AIFF / AU | — |
放进 config/mcphone/music/ 就行，进音乐 App 会自动重扫，不用重启游戏。
采样率 44100 / 48000 / 32000 Hz，绝大多数音乐都是这一档。
MPEG-2 与 MPEG-2.5 放不了 —— 那是低采样率的 MP3（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。