光奏 (GuangZou) - 功能与特性文档

一款基于 Kotlin 开发的《光·遇》自动弹奏应用. 无需 Root权限
通过无障碍服务或 ADB 两种模式实现触控模拟
UI 遵循 Material Design,风格简洁并支持动态取色

详情请访问项目的 GitHub 主页:Dong-Jing-Yu/GuangZou

✨ 主要特性

• 双触摸引擎:支持标准的无障碍服务模式和更高效的 Shizuku (ADB) 高级模式,可随时切换
• 高度自定义界面:
  • 智能主题:在 Android 12+ 上支持 Material You 动态取色,低版本系统亦有优化的暗色模式
  • 悬浮窗定制:可自由调整主悬浮窗和最小化悬浮球的不透明度,并支持自定义悬浮球图标
• 精准适配:
  • 分辨率管理:内置多种分辨率布局方案,应用会为你自动匹配,也支持手动选择,确保在不同设备上的按键定位准确
  • 键位预览:在开始弹奏前,可开启按键位置预览,方便对齐游戏内乐器界面
• 现代化的体验:完全使用 Kotlin 和最新的 Android Jetpack 组件开发,性能与体验俱佳

📱 应用信息

属性	值
应用名称	光奏
英文名	GuangZou
包名	com.GuangZou.sky
平台	Android
开发语言	Kotlin
最低 SDK	API 28 (Android 9.0)
构建工具	Kotlin DSL (build.gradle.kts)
Root	❌

🎨 主题与配色

• Android 12+: 使用 Material You 动态壁纸取色
• Android 10-11: 启用系统的 Force Dark 模式
• Android 9: 使用内置的 Dark Theme 暗色主题

🔐 权限说明

应用需要以下权限以正常工作:

• 无障碍服务 (核心):用于执行模拟点击操作,是实现自动弹奏的基础。这是最主要的权限
• 存储访问:用于读取存放于指定目录下的琴谱文件
• 悬浮窗:用于显示控制播放/暂停/停止的浮动操作面板
• Shizuku (可选):若想使用更高效的 ADB 触摸模式,可以避免无障碍的反复授权

🎼 琴谱格式

• 路径:请将琴谱文件放置在 /storage/emulated/0/光奏/谱/ 目录下。

• 格式:适配来自 Sky Studio 导出的未加密 txt 格式琴谱,应用会读取文件中的元数据以在列表中展示

  一个基础的琴谱文件结构如下:

  {
    "name": "琴谱标题",
    "author": "作者",
    "bpm": 120,
    "notes": [
      // ... 音符数据 ...
    ]
  }
  

⚙️ 功能设置

应用内提供了丰富的设置选项,让你能根据自己的习惯进行配置:

• 页面外观: 切换应用的主题。
• 分辨率选择: 手动选择一个最适合你设备的按键布局方案。
• 触摸方式: 在 无障碍服务 和 Shizuku 两种模拟触摸模式之间切换。
• 悬浮窗/悬浮球不透明度: 分别调整主窗口和最小化小球的透明度。
• 悬浮球图标: 个性化设置最小化状态下的悬浮球图标。