ADV-Plugin
---
# 简介
`ADV-Plugin`是[SAO Utils 2](http://sao.gpbeta.com/)的第三方插件，可以提供系统音频数据的可视化服务。
得益于SAO Utils 2允许用户使用qml脚本编写扩展插件，相对于[第一代](https://github.com/Mashiro-Sorata/AudioDVServer-Plugin)的插件方案，第二代可以整合第一代中客户端与服务器端的功能，无需复杂的配置即可使用。
## 特色
* 整合客户端与服务器端的功能，使用更简单
* 预设5种频谱显示形式，其中每种都可以进一步自定义设置其样式
* 提供了Style的开发接口，供开发者添加更多的可视化样式
* 导入第三方Style类似其他插件，预计支持steam创意工坊下载
* 服务端崩溃后自启动
## 样式设置
安装并启用插件后，默认加载第一种预设Style样式。右键点击挂件可调出菜单，在挂件菜单中点击“样式设置...”选项，呼出样式设置窗口。点击其中的样式选项可切换不同的样式风格，若此样式提供可配置项，则在样式选项下方会出现配置项。
## 服务器设置
右键点击挂件后，在菜单项选择“服务器设置...”即可对服务器进行设置与调试。一般采用默认设置即可，也可进一步自定义服务端的参数，调节所有音频可视化挂件的动画效果。此外对于所有音频可视化挂件无法正常显示的用户，提供了调试接口以便更好的帮助定位错误。
其参数的具体说明如下。
* `调试模式`：因为插件有着错误自启功能，每次自启都会覆盖日志文件，打开调试模式后，会关闭错误自启功能，这时可打开日志文件定位具体错误。
* `常规`设置
* `端口号`：Websocket服务器的端口号。
* `最大客户端数量`：Websocket服务器的最大连接数，音频可视化挂件均共用同一个连接的数据。
* `启用日志`：启用后会在插件服务器目录下输出日志文件`ADV_Log.log`以定位错误，进入`调试模式`时必须启用日志。
* `数据`设置
* `增大系数`：可调节频谱数据增大时的速度，该值越大，数据增大时的速度越慢。
* `减小系数`：可调节频谱数据减小时的速度，该值越大，数据减小时的速度越慢。
* `峰值额外增量`：数据归一化峰值的额外增量，调节频谱的动态范围。
* `动态归一化系数`：数据归一化峰值的收敛速度，该值越大，归一化的峰值数据收敛速度越快。
* `传输速率`：数据每秒发送的次数，可理解为挂件刷新率。
* `变化速度`：按照`变化速度/传输速率`的比例调节频谱数据变化速度，一般该值小于`传输速率`。
# 频谱样式开发
如果想开发新的频谱样式，可以参照[ADV-Plugin Wiki](https://nvg.dev/Mashiro_Sorata/ADV-Plugin/wiki)的说明及开发教程。
欢迎开发更多有趣好玩的频谱样式，与大家分享~
