Skip to content

Commit 4ac18ba

Browse files
committed
doc
1 parent 947704a commit 4ac18ba

File tree

1 file changed

+16
-6
lines changed

1 file changed

+16
-6
lines changed

NbsPlayer/readme.md

+16-6
Original file line numberDiff line numberDiff line change
@@ -9,23 +9,25 @@ BDS 中的 NBS 音乐播放器!
99

1010
### 运作原理
1111

12-
1. 插件通过[NbsConvertor](NbsConvertor) nbs 文件转换成 json 格式存储在 `cache` 目录中
13-
2. 读取 json 数据,通过`setInterval`设置循环执行函数获取当前时间来对时和播放,并且根据已播放时间根据 json 解析后的各数据生成`PlaySoundPacket`数据包发送给客户端
12+
1. 插件通过[NBS.js](https://github.com/Encode42/NBS.js)解析 nbs 文件
13+
2. 通过`setInterval`设置循环执行函数获取当前时间来对时,根据经过时间生成`PlaySoundPacket`数据包发送给客户端
1414

1515
### 特点
1616

17-
- 支持 单音符/轨道/音色 的音高、音量等设置
17+
- 支持 单音符/轨道/音色 的音高、音量等设置,单音符的精细调音
1818
- 支持超过两个八度限制的音符
1919
- 支持自定义音色
2020
- 请将自定义音色的名称设置为`playsound`命令可以播放的声音 ID,例:`dig.stone`,支持资源包自定义的音色
2121

2222
### 缺点
2323

2424
- 播放效果不好,会有小卡顿(对不上拍)(脚本语言~~ / 调用 BDS 执行命令~~效率问题?)
25-
- Tip:`0.2.0`版本已换为向客户端发送数据包,卡顿问题有所改善
26-
- 无法实现左右声道偏离(`playsound`局限)
25+
- Tip:`0.2.0`版本已换为向客户端发送数据包~~,卡顿问题有所改善~~(呜呜我是废物)
26+
- 无法实现左右声道偏离(~~`playsound`局限~~ 无法实现精细偏移,干脆不做了
2727
- 稍微动一下视角声道就会偏(`playsound`局限)
28-
- 插件没有经过深度测试,可能会有小 bug
28+
- 不支持 layer 独奏(懒)
29+
- 不支持 loop(懒)
30+
- 插件~~没有经过深度测试,~~可能会有小 bug
2931

3032
### 截图
3133

@@ -117,3 +119,11 @@ QQ:3076823485
117119
- 加入歌曲列表为 0 时的提示,与页数小于 2 无法跳页的提示
118120
- `nbsplayer`命令加入可选参数`filename`,可以直接指定播放的文件名
119121
- 加入命令`nbsplay` `nbsisplaying`[指令列表](#指令)
122+
- 1.0.0
123+
- 迁移到 nodejs 插件
124+
- 更换 nbs 文件解析方式,弃用 `NbsConvertor`
125+
- 歌曲进度显示方式更换为 boss 条
126+
- 修复由于我对单音符`pitch`的错误理解导致的音符音高错误
127+
- 修复玄学的命令方块内目标选择器问题(可能是我命令注册的问题)
128+
- `nbsplay`指令的有关小 bug
129+
- 其他问题修复/特性调整(不要问,问就是我忘了)

0 commit comments

Comments
 (0)