JackalClient

Appearance

AudioVisualizer ​

音频可视化 分类：Render 描述：显示音频波形或其他形式的可视化。

需求 ​

  • 安全级别：常规模块
  • 权限需求：无
  • 驱动依赖：否
  • 联网需求：否
  • 开发状态：稳定/常规
  • 版本属性：普通可用

介绍 ​

AudioVisualizer（音频可视化）用于显示音频波形或其他形式的可视化。 适合在日常管理与自动化场景中按需启用。 初次使用可优先调整：Capture Cooldown (ms)、Global HUD Pulse Effects、Global HUD Pulse Effects Intensity (0~1)、Beat Texture Shake。

配置项 ​

  • Capture Cooldown (ms)（捕获冷却（毫秒）） 类型：数值；默认：50L 说明：用于控制检测/刷新/动画节奏。默认值 50L 以稳定为主；调小会更灵敏但可能增加资源占用，调大则更省资源但响应更慢。
  • Menu On Alpha（菜单打开时不透明度） 类型：数值；默认：1.0f 说明：这是数值型配置。默认值 1.0f 通常在稳定性与效果之间做了平衡，建议小步调整并观察实际变化。
  • Menu Off Alpha（菜单关闭时不透明度） 类型：数值；默认：1.0f 说明：这是数值型配置。默认值 1.0f 通常在稳定性与效果之间做了平衡，建议小步调整并观察实际变化。
  • Global HUD Pulse Effects（全局HUD律动效果） 类型：布尔；默认：false 说明：这是开关型配置。默认值 false 代表作者推荐的初始行为；若要改动，建议一次只改一个开关便于观察影响。
  • Global HUD Pulse Effects Intensity (0~1)（全局HUD律动效果强度 (0~1)） 类型：数值；默认：0.5f 说明：这是数值型配置。默认值 0.5f 通常在稳定性与效果之间做了平衡，建议小步调整并观察实际变化。
  • Beat Texture Shake（节拍贴图抖动） 类型：布尔；默认：false 说明：开启后根据系统音频低频起音分析，对最终客户端贴图施加矩阵平移、轻微旋转和缩放冲击。抖动强度会随节拍和音量变化。
  • Beat Trigger SMTC Condition（节拍触发 SMTC 条件） 类型：枚举；默认："Playing Session" 说明：控制接受节拍触发所需的 SMTC 状态。默认仅在存在正在播放的 SMTC 会话时触发；Timeline 模式还要求该会话提供有效进度信息；Off 不检查 SMTC。 可选：Off（关闭条件）；Playing Session（正在播放的会话）；Playing Session with Timeline（具有进度信息的正在播放会话）
  • Disable Beat Trigger When Menu On（菜单打开时禁用节拍触发） 类型：布尔；默认：false 说明：开启后在客户端 GUI 打开期间停止节拍贴图抖动，并丢弃期间产生的节拍，关闭 GUI 后不会补触发旧节拍。
  • Beat Detection Sensitivity（节拍检测灵敏度） 类型：数值；默认：1.0 说明：控制低频频谱起音触发的灵敏度。数值越高越容易触发，过高可能把人声或持续低音误判为节拍。
  • Beat Texture Shake Intensity (px)（节拍贴图抖动强度（像素）） 类型：数值；默认：2.0 说明：控制节拍时贴图的最大平移幅度。
  • Beat Texture Shake Decay (ms)（节拍贴图抖动衰减（毫秒）） 类型：数值；默认：400 说明：控制一次节拍冲击的回落速度。数值越小越利落，数值越大残留律动越明显。
  • Beat Texture Rotation (deg)（节拍贴图旋转（度）） 类型：数值；默认：0.0 说明：控制节拍时的轻微旋转幅度。
  • Beat Texture Scale Punch (0~1)（节拍贴图缩放冲击（0~1）） 类型：数值；默认：0.05 说明：控制节拍时的缩放冲击，并会自动配合位移增加少量 overscan 以减少边缘露底。
  • Enable Better Lyrics Module（启用更好的歌词模块） 类型：布尔；默认：false 说明：这是行为开关项。建议先按默认值使用，确认行为符合预期后再逐项启停，避免多个开关同时改动造成排查困难。
  • Visualizer Mode（可视化模式） 类型：枚举；默认："Bar Graph" 说明：这是该模块的核心行为开关，不同选项对应不同执行策略。建议先保持默认 Bar Graph ，确认稳定后再逐项切换比较效果。 可选：Off（关闭）；Bar Graph（柱状图）；Line Wave（折线波）；Circle Spectrum（环状频谱）
  • Bar Graph Style（柱状图风格） 类型：枚举；默认："Normal" 说明：这是选项型配置。默认值 Normal 一般更稳妥；建议按使用场景逐个试用，而不是一次性切换多项。 可选：Normal（普通）；Pixel（像素）；Capsule (PRO)（胶囊，专业版）
  • Bar Pixel Gap（柱像素间距） 类型：数值；默认：40 说明：这是数值型配置。默认值 40 通常在稳定性与效果之间做了平衡，建议小步调整并观察实际变化。
  • Bar Width（柱宽度） 类型：数值；默认：100L 说明：这是数值型配置。默认值 100L 通常在稳定性与效果之间做了平衡，建议小步调整并观察实际变化。
  • Bar Horizontal Gap（柱子横向间隙） 类型：数值；默认：2 说明：这是数值型配置。默认值 2 通常在稳定性与效果之间做了平衡，建议小步调整并观察实际变化。
  • Bar Opacity (0~1)（柱不透明度 (0~1)） 类型：数值；默认：0.3f 说明：用于控制透明度。默认值 0.3f 兼顾可见性和遮挡；如果你觉得挡视线可小幅下调，若看不清可小幅上调。
  • Bar Easing Speed (0~1)（柱缓动速率 (0~1)） 类型：数值；默认：0.15f 说明：这是数值型配置。默认值 0.15f 通常在稳定性与效果之间做了平衡，建议小步调整并观察实际变化。
  • Bar Y Rate（柱纵坐标比例） 类型：数值；默认：1.0f 说明：用于控制界面元素在屏幕中的相对位置。默认值 1.0f 一般是作者调过的稳定布局；建议每次只改一个轴，避免元素跑出可视区域。
  • Bar Direction（柱子方向） 类型：枚举；默认："Up" 说明：这是选项型配置。默认值 Up 一般更稳妥；建议按使用场景逐个试用，而不是一次性切换多项。 可选：Up（向上）；Down（向下）；Both（两者）
  • Bar Top Enabled（启用顶部柱子） 类型：布尔；默认：false 说明：控制 Bar Graph 是否绘制顶部柱状图。顶部、底部、左侧和右侧柱子可以同时启用，颜色、透明度、间距、宽度和样式共用同一组 Bar 配置；最大高度和位置可按边单独设置。
  • Bar Top Reversed（反转顶部柱子） 类型：布尔；默认：false 说明：反转顶部柱状图内部的频谱方向。
  • Bar Top Max Height（顶部柱子最大高度） 类型：数值；默认：250L 说明：控制顶部柱状图的最大延伸高度。
  • Bar Top X Rate（顶部柱子横坐标比例） 类型：数值；默认：0.5f 说明：控制顶部柱状图的水平中心位置。
  • Bar Top Y Rate（顶部柱子纵坐标比例） 类型：数值；默认：0.0f 说明：控制顶部柱状图的基准纵坐标，柱子从该位置向下延伸。
  • Bar Bottom Enabled（启用底部柱子） 类型：布尔；默认：true 说明：控制 Bar Graph 是否绘制底部柱状图，默认开启以保持旧版默认视觉。
  • Bar Bottom Reversed（反转底部柱子） 类型：布尔；默认：false 说明：反转底部柱状图内部的频谱方向。开启后，底部低频区域会从左侧切换到右侧。
  • Bar Bottom Max Height（底部柱子最大高度） 类型：数值；默认：250L 说明：控制底部柱状图的最大延伸高度。
  • Bar Bottom X Rate（底部柱子横坐标比例） 类型：数值；默认：0.5f 说明：控制底部柱状图的水平中心位置。
  • Bar Bottom Y Rate（底部柱子纵坐标比例） 类型：数值；默认：1.0f 说明：控制底部柱状图的基准纵坐标，柱子从该位置向上延伸。
  • Bar Left Enabled（启用左侧柱子） 类型：布尔；默认：false 说明：控制 Bar Graph 是否绘制左侧柱状图。
  • Bar Left Reversed（反转左侧柱子） 类型：布尔；默认：false 说明：反转左侧柱状图内部的频谱方向。
  • Bar Left Max Height（左侧柱子最大高度） 类型：数值；默认：250L 说明：控制左侧柱状图的最大延伸宽度。
  • Bar Left X Rate（左侧柱子横坐标比例） 类型：数值；默认：0.0f 说明：控制左侧柱状图的基准横坐标，柱子从该位置向右延伸。
  • Bar Left Y Rate（左侧柱子纵坐标比例） 类型：数值；默认：0.5f 说明：控制左侧柱状图的垂直中心位置。
  • Bar Right Enabled（启用右侧柱子） 类型：布尔；默认：false 说明：控制 Bar Graph 是否绘制右侧柱状图。
  • Bar Right Reversed（反转右侧柱子） 类型：布尔；默认：false 说明：反转右侧柱状图内部的频谱方向。
  • Bar Right Max Height（右侧柱子最大高度） 类型：数值；默认：250L 说明：控制右侧柱状图的最大延伸宽度。
  • Bar Right X Rate（右侧柱子横坐标比例） 类型：数值；默认：1.0f 说明：控制右侧柱状图的基准横坐标，柱子从该位置向左延伸。
  • Bar Right Y Rate（右侧柱子纵坐标比例） 类型：数值；默认：0.5f 说明：控制右侧柱状图的垂直中心位置。
  • Bar Color（柱颜色） 类型：枚举；默认："White" 说明：用于控制视觉配色。建议先选对比度高的配色保证可读性；若是动态颜色，注意在复杂背景下的辨识度。 可选：Flow（流动）；其余颜色见 NAMED_COLOR_BASE_LIST
  • Bar Color (Top)（柱颜色 (顶部)） 类型：枚举；默认："Same" 说明：用于控制视觉配色。建议先选对比度高的配色保证可读性；若是动态颜色，注意在复杂背景下的辨识度。 可选：Same（相同）；其余颜色见 NAMED_COLOR_BASE_LIST
  • Line Y Rate（线条纵坐标比例） 类型：数值；默认：0.8f 说明：用于控制界面元素在屏幕中的相对位置。默认值 0.8f 一般是作者调过的稳定布局；建议每次只改一个轴，避免元素跑出可视区域。
  • Line Thickness（线条宽度） 类型：数值；默认：3L 说明：用于细调显示样式和间距。默认值 3L 通常是平衡视觉效果与紧凑度的设置，建议小步调整并实时观察。
  • Line Amplitude（线条振幅） 类型：数值；默认：300.0f 说明：这是数值型配置。默认值 300.0f 通常在稳定性与效果之间做了平衡，建议小步调整并观察实际变化。
  • Line Color（线条颜色） 类型：枚举；默认："Blue" 说明：用于控制视觉配色。建议先选对比度高的配色保证可读性；若是动态颜色，注意在复杂背景下的辨识度。 可选：见 NAMED_COLOR_BASE_LIST
  • Line Opacity (0~1)（线条不透明度 (0~1)） 类型：数值；默认：0.6f 说明：用于控制透明度。默认值 0.6f 兼顾可见性和遮挡；如果你觉得挡视线可小幅下调，若看不清可小幅上调。
  • Line Direction（线条方向） 类型：枚举；默认："Up" 说明：这是选项型配置。默认值 Up 一般更稳妥；建议按使用场景逐个试用，而不是一次性切换多项。 可选：Up（向上）；Down（向下）；Both（两者）
  • Circle Radius（圆圈半径） 类型：数值；默认：250L 说明：用于细调显示样式和间距。默认值 250L 通常是平衡视觉效果与紧凑度的设置，建议小步调整并实时观察。
  • Circle Thickness（圆圈厚度） 类型：数值；默认：5L 说明：用于细调显示样式和间距。默认值 5L 通常是平衡视觉效果与紧凑度的设置，建议小步调整并实时观察。
  • Circle Scale（圆圈缩放） 类型：数值；默认：1.8f 说明：这是数值型配置。默认值 1.8f 通常在稳定性与效果之间做了平衡，建议小步调整并观察实际变化。
  • Circle Color（圆圈颜色） 类型：枚举；默认："Gold" 说明：用于控制视觉配色。建议先选对比度高的配色保证可读性；若是动态颜色，注意在复杂背景下的辨识度。 可选：见 NAMED_COLOR_BASE_LIST
  • Circle Opacity (0~1)（圆圈不透明度 (0~1)） 类型：数值；默认：0.8f 说明：用于控制透明度。默认值 0.8f 兼顾可见性和遮挡；如果你觉得挡视线可小幅下调，若看不清可小幅上调。

历史更新 ​

    1. 新增 Capsule (PRO) 柱状图风格，每个柱子以两端半圆的胶囊形态绘制。
    1. 为 Audio Visualizer 添加配置：
    1. 添加模块： AudioVisualizer，音频可视化。
    1. 添加模块：Island，简单的灵动岛效果。在 Audio Visualizer 启用时会随音频旋律震动。

备注 ​

该模块可能受系统版本、权限级别、目标进程状态或安全软件策略影响；若功能未生效，优先检查管理员权限、驱动依赖、联网状态与系统兼容性。

相关命令 ​

无

相关模块 ​

相关资料 ​

无