You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
66 lines
3.5 KiB
66 lines
3.5 KiB
2 years ago
|
<div align="center"><h1>ADV-Plugin</h1></div>
|
||
|
|
<div align="center"><img src="https://p.qlogo.cn/zc_icon/0/0afa95dfc4850ec9539eb0800b61a15016277179577515/0.png"></div>
|
||
|
|
<div align="center">Powered By <a href="http://mashiros.top">Mashiro_Sorata</a></div>
|
||
|
|
|
||
|
|
---
|
||
|
|
|
||
|
|
# 简介
|
||
|
|
|
||
|
|
`ADV-Plugin`是[SAO Utils 2](http://sao.gpbeta.com/)的第三方插件，可以提供系统音频数据的可视化服务。
|
||
|
|
得益于SAO Utils 2允许用户使用qml脚本编写扩展插件，相对于[第一代](https://github.com/Mashiro-Sorata/AudioDVServer-Plugin)的插件方案，第二代可以整合第一代中客户端与服务器端的功能，无需复杂的配置即可使用。
|
||
|
|
|
||
|
|
## 特色
|
||
|
|
* 整合客户端与服务器端的功能，使用更简单
|
||
|
|
* 预设4种频谱显示形式，其中每种都可以进一步自定义设置其样式
|
||
|
|
* 提供了Style的开发接口，供开发者添加更多的可视化样式
|
||
|
|
* 导入第三方Style类似其他插件，预计支持steam创意工坊下载
|
||
|
|
* 服务端崩溃后自启动
|
||
|
|
|
||
|
|
## 使用说明
|
||
|
|
|
||
|
|
安装并启用插件后，默认加载第一种预设Style样式。右键挂件可调出菜单，在挂件菜单的挂件名选单中点击Settings选项，呼出Style设置窗口。点击其中的Styles选项可切换不同的Style风格，若此Style提供可配置项，则在Styles选项下方会出现配置界面的入口。
|
||
|
|
|
||
|
|
<div align="center"><img src="https://p.qlogo.cn/zc_icon/0/5c7aacc6a0ddcb889bdacabdbf3a466716282394846386/0.png" style="zoom:80%;" /></div>
|
||
|
|
|
||
|
|
# 进阶设置
|
||
|
|
|
||
|
|
样式设置可在插件内设置，一般服务端设置采用默认设置即可，但也提供了服务端设置的接口作为高级设置。可通过更改本插件目录`bin`文件夹中的`advConfig.ini`文件来配置插件服务器与数据设置。当配置数据错误或无配置文件时使用默认值，配置值不区分大小写。其参数的具体说明如下。
|
||
|
|
|
||
|
|
- [Server]
|
||
|
|
- `ip`：可选，默认值为`local`，指代地址127.0.0.1，可更改为`any`，指代地址0.0.0.0。只支持`any`与默认参数`local`，定义插件提供服务的地址。
|
||
|
|
- `port`：可选，默认值为`5050`，定义插件提供服务的端口号。
|
||
|
|
- `maxClient`：可选，默认值为`5`，定义WebSocket的最大连接数。
|
||
|
|
- `logger`：可选，默认值为`false`。设置为`true`后可在插件所在目录下输出日志文件`ADV_Log.log`。
|
||
|
|
- [FFT]
|
||
|
|
- `attack`：可选，默认值为25。可调节频谱数据增大时的速度，该值越大，增大速度越慢。
|
||
|
|
- `decay`：可选，默认值为25。可调节频谱数据减小时的速度，该值越大，减小速度越慢。
|
||
|
|
- `norspeed`：可选，默认值为1。动态归一化系数，取值范围从1~99，该值越大，归一化的峰值数据收敛速度越快。
|
||
|
|
- `peakthr`：可选，默认值为10。归一化的峰值数据的额外增量。
|
||
|
|
- `fps`：可选，默认值为30。每秒钟数据发送的次数，**<font color='red'>必须确保该值大于5</font>**。
|
||
|
|
- `changeSpeed`：可选，默认值为25。按照`changeSpeed/fps`的比例调节频谱数据变化速度，**一般该值小于fps**。
|
||
|
|
|
||
|
|
|
||
|
|
`advConfig.ini` 文件示例：
|
||
|
|
```ini
|
||
|
|
[Server]
|
||
|
|
ip = local
|
||
|
|
port = 5050
|
||
|
|
maxClient = 5
|
||
|
|
logger = true
|
||
|
|
|
||
|
|
[FFT]
|
||
|
|
attack = 25
|
||
|
|
decay = 25
|
||
|
|
norspeed = 1
|
||
|
|
peakthr = 10
|
||
|
|
fps = 35
|
||
|
|
changeSpeed = 25
|
||
|
|
```
|
||
|
|
|
||
|
|
# 频谱样式开发
|
||
|
|
|
||
|
|
如果想开发新的频谱样式，可以参照[ADV-Plugin Wiki](https://github.com/Mashiro-Sorata/ADV-Plugin/wiki)的说明及开发教程。
|
||
|
|
|
||
|
|
欢迎开发更多有趣好玩的频谱样式，与大家分享~
|
||
|
|
|