Poi's Soundbox
音乐播放器:上传即播,无需电台流地址
Poi 的 Soundbox 用最简单的方式把你的音乐带进 Second Life:上传音频、拖进去、摸一下、播放。当摆件放着或穿在身上都行,无需电台流地址,还会记住上次播到哪里。一张平铺歌单,或整张整张的专辑,随你。

- 随处播放你的音乐
- 轻量级播放器,直接播放物品栏里上传的音频:不用媒体地址、不用地块电台流、不用任何设置。放进世界里当摆件,或穿在身上,按下播放即可。
- 完整的播放控制
- 播放、停止、上一首、下一首,翻页歌单里任选一首,循环全部、单曲循环、随机三种模式随意切换。音量按 10% 步进调节(10%–100%),实时显示在菜单标题里。
- 两种歌库加载方式
- 把声音文件拖进物品栏即得一张平铺歌单;或用 SongList 记事卡组建完整专辑:上一首、下一首、循环、随机都只在当前专辑内切换。
- 悬浮曲目显示
- 盒子上方的悬浮文字显示当前曲目、下一首与播放模式:完整或仅歌名两种样式,8 种预设颜色外加自定义 RGB,透明度可调。
- 公开或私有
- 默认仅限主人操作;打开公开开关,客人也能自己点歌。界面支持英语和中文,随时切换。
更新日志v1.0.01 条更新 — 点击展开
1.0.0
- 首次发布
使用说明
开始使用
Poi 的 Soundbox 是一台世界内音乐播放器,直接播放物品栏里上传的音频,不需要任何媒体流。放进世界里摆着,或穿在身上都可以。
- 放置或穿戴 Soundbox。
- 触摸打开菜单。
- 按 ▶ 播放。
按下后先显示「预加载中…」约 10 秒才出声,这是在缓冲第一段音频,属正常现象。
功能
Soundbox 以短片段(切片)方式串接播放整首歌曲。支持两种歌库模式,在 Music.Config 记事卡中配置。
INVENTORY 模式(默认)
扫描盒子物品栏中名为 SongName_1、SongName_2 等的声音文件,显示为一张平铺歌单。
添加新歌:
- 将音频切割为每段不超过 29.9 秒的片段。推荐用 Audio for SL Converter 自动切割并转换。
- 每段上传到 Second Life,命名为
SongName_1、SongName_2…… - 拖入 Soundbox 的物品栏。
- 可选:在
Music.Config里加显示名称(见「设置」)。 - 按 ⚙ 设置 → 重载歌库。
NOTECARD 模式
从 SongList.* 记事卡加载歌曲,每张记事卡就是一个专辑。支持多专辑、专辑内导航(上一首/下一首/循环/随机只在当前专辑内),以及每首歌自定义切片时长。
SongList 记事卡格式:
# 每首歌以标题行开始:
歌曲标题|切片时长|切片数量
# 紧接着切片数量个切片标识符(UUID 或旧式名称):
12345678-1234-1234-1234-123456789abc
...
示例 SongList.专辑名:
Opening Theme|29.9|3
uuid-切片1
uuid-切片2
uuid-切片3
Battle Music|25.0|2
uuid-切片4
uuid-切片5
切换模式:编辑 Music.Config,把 music_source_mode 设为 INVENTORY 或 NOTECARD,再按 重载歌库。
权限控制
默认仅主人可打开菜单。公开开关(仅对主人显示)可以放开:
- ☑ 公开:附近任何人都能打开菜单、控制播放。再按一次关闭。
- ☐ 公开:仅主人可用。按一次开启。
设置
从主菜单 ⚙ 设置 进入。
悬浮文字
- 悬浮:循环切换 开(歌曲 + 下一首 + 模式)→ 简洁(仅歌曲名)→ 关。NOTECARD 模式下「开」还会显示专辑名。
- 透明度:循环切换 10% → 25% → 50% → 75% → 100%。
文字颜色
颜色 ▶ 打开取色菜单,8 种预设(白、绿、蓝、黄、红、青、粉、橙),另有 自定义... 可输入 RGB 向量,如 <1.0, 0.5, 0.0>。
重载歌库
重载歌库 重新读取 Music.Config 并重建歌库。添加/删除声音文件、编辑 Music.Config、改动 SongList.* 记事卡之后都要按一次。
Music.Config
格式:参数 = 值,每行一条,# 开头为注释。
| 参数 | 含义 |
|---|---|
music_source_mode |
INVENTORY(扫描物品栏)或 NOTECARD(从 SongList.* 记事卡加载) |
song_name |
显示名称映射,可重复多行:`song_name = 原始名称 |
INVENTORY 模式下原始名称是文件前缀(如 BGM01);NOTECARD 模式下是记事卡标题行里的歌曲标题。
常见问题
- 显示「预加载中…」但没有声音:正常缓冲,约 10 秒后出声。
- 菜单里没有歌:INVENTORY:音频文件要在 Soundbox 自己的物品栏里(不能在子部件中),命名符合
SongName_1、SongName_2……然后 重载歌库。NOTECARD:至少有一张SongList.某名称记事卡且含有效的标题|时长|数量标题行,然后 重载歌库。 - 歌名显示成文件名:在
Music.Config里加一条song_name映射,然后 重载歌库。 - 重新登录会记住当前歌曲吗? 会,只要脚本没被重置;脚本重置或重新放置后会回到第一首。