@@ -5,49 +5,95 @@ categories: [开发,Android]
5
5
tags : [APK,Kotlin]
6
6
---
7
7
8
- 一个基于 ** Kotlin** 开发的光遇自动弹奏工具,支持无障碍与 ADB 模拟触控,无需 Root 权限\
9
- UI配色自适应,使用简洁主题
8
+ #### ** 简介**
10
9
11
- 详情请去 [ GitHub ] ( https://github.com/Dong-Jing-Yu/ GuangZou) 查看
10
+ ` 光奏 ( GuangZou)` 是一款专为《光·遇》玩家设计的安卓端自动弹奏辅助工具。项目采用 ** Kotlin ** 语言进行原生开发,旨在提供一个功能强大、高度可定制且无需 Root 权限的弹奏体验。
12
11
13
- ---
12
+ 应用内置两种模拟触控方案( ** 无障碍服务 ** 与 ** Shizuku ** ),以满足不同用户对精度和稳定性的需求。UI 设计遵循 Material Design 规范,在不同安卓版本上可自适应主题与配色,确保界面简洁、美观、易用。
14
13
15
- ## 📱 应用信息
16
-
17
- | 属性 | 值 |
18
- | ----------------| --------------------------------------------|
19
- | ** 应用名称** | 光奏 |
20
- | ** 英文名** | GuangZou |
21
- | ** 包名** | ` com.GuangZou.sky ` |
22
- | ** 平台** | Android |
23
- | ** 开发语言** | Kotlin |
24
- | ** 最低 SDK** | API 28(Android 9.0) |
25
- | ** 构建工具** | Kotlin DSL (` build.gradle.kts ` ) |
26
- | ** 权限** | 无障碍,存储,悬浮窗 |
27
- | ** ADB工具** | [ Shizuku] ( https://shizuku.rikka.app/zh-hans/ ) |
28
- | ** Root** | ❌ |
14
+ ** 项目地址** : [ https://github.com/Dong-Jing-Yu/GuangZou ] ( https://github.com/Dong-Jing-Yu/GuangZou )
29
15
30
- ---
16
+ -----
31
17
32
- ## 🎨 配色
18
+ ### ** 核心功能 **
33
19
34
- - 在 Android 12 及以上,使用 ** Material You **
20
+ * ** 🎹 双模式触控引擎 ** :
35
21
36
- - 在 Android 10-11,使用 ** Force Dark**
22
+ * **无障碍服务**: 标准模式,稳定性与兼容性俱佳,满足绝大部分日常使用场景。
23
+ * **Shizuku (ADB)**: 高级模式,提供更低延迟、更精准的底层模拟触控,适合对演奏精度有极致要求的用户。
37
24
38
- - 在 Android 9,使用 ** Dark Theme **
25
+ * ** ✨ 强大的悬浮窗系统 ** :
39
26
40
- ---
27
+ * ** 主控制面板** : 集成乐谱信息展示与播放/暂停/停止等核心控制功能。
28
+ * ** 琴谱选择器** : 在独立的悬浮窗口中选择乐谱,操作互不干扰。
29
+ * ** 最小化悬浮球** : 可将主窗口最小化为可自定义图标的悬浮球,减少屏幕遮挡。
41
30
42
- ## 🔐 权限
31
+ * ** 🎨 高度自定义选项 ** :
43
32
44
- - ** 无障碍服务 ** :用于模拟触控弹奏
45
- - ** 存储访问 ** :读取/写入琴谱文件
46
- - ** 悬浮窗 ** :用于浮动控制面板
33
+ * ** 主题外观 ** : 自适应系统,支持 Material You、夜间模式等。
34
+ * ** 分辨率校准 ** : 内置多种屏幕分辨率布局,用户可根据设备情况自由选择,确保按键位置精确。
35
+ * ** 个性化设置 ** : 自由调整主悬浮窗与悬浮球的透明度、自定义悬浮球图标等。
47
36
48
- ---
37
+ * ** 📂 智能琴谱管理** :
38
+
39
+ * 自动扫描并解析指定目录下的 ` json ` 琴谱文件。
40
+ * 在主界面以可收缩列表形式清晰展示琴谱的标题、作者和BPM信息。
41
+
42
+ * ** 🎯 可视化键位预览** :
43
+
44
+ * 一键开启按键位置预览,在屏幕上显示半透明的坐标点,方便用户将悬浮窗与游戏内的乐器界面精确对齐。
45
+
46
+ -----
47
+
48
+ ### ** 📱 应用信息**
49
+
50
+ | 属性 | 值 |
51
+ | --------------| -----------------------------------------------|
52
+ | ** 应用名称** | 光奏 |
53
+ | ** 英文名** | GuangZou |
54
+ | ** 包名** | ` com.GuangZou.sky ` |
55
+ | ** 平台** | Android |
56
+ | ** 开发语言** | Kotlin |
57
+ | ** 最低 SDK** | API 28 (Android 9.0) |
58
+ | ** 构建工具** | Kotlin DSL (` build.gradle.kts ` ) |
59
+ | ** ADB 工具** | [ Shizuku] ( https://shizuku.rikka.app/zh-hans/ ) (可选) |
60
+ | ** Root** | ❌ |
61
+
62
+ -----
63
+
64
+ ### ** 🎨 配色方案**
65
+
66
+ * ** Android 12+** : 使用 ** Material You** 动态取色,与系统壁纸和主题融为一体。
67
+ * ** Android 10-11** : 启用系统的 ** Force Dark** (强制深色) 模式。
68
+ * ** Android 9** : 使用内置的 ** Dark Theme** (深色主题)。
69
+
70
+ -----
71
+
72
+ ### ** 🔐 权限说明**
73
+
74
+ #### 必要权限
75
+
76
+ * ** 无障碍服务** : 应用的核心,用于执行模拟屏幕点击操作来弹奏乐曲。
77
+ * ** 存储访问** : 用于扫描、读取本地琴谱 (` .json ` ) 文件。
78
+ * ** 悬浮窗** : 用于显示浮动控制面板和悬浮球,实现在游戏顶层的交互操作。
79
+
80
+ #### 可选权限
81
+
82
+ * ** Shizuku** : 用于启用“高级触摸模式”,通过 ADB 指令执行更底层的模拟点击。若不使用此模式,则无需授予该权限。
83
+
84
+ -----
49
85
50
- ## 🎼 琴谱
86
+ ### ** 🎼 琴谱规格 **
51
87
52
- - 路径:` /storage/emulated/0/光奏/琴谱/ `
53
- - 适配** 未加密** 的** sky studio** 琴谱文件
88
+ * ** 存储路径** : ` /storage/emulated/0/光奏/谱/ `
89
+ * ** 文件格式** : 应用适配基于 ` JSON ` 格式的未加密琴谱文件。` JSON ` 文件的基本结构应如下所示:
90
+ ``` json
91
+ {
92
+ "name" : " 琴谱标题" ,
93
+ "author" : " 作者" ,
94
+ "bpm" : 120 ,
95
+ "notes" : [
96
+ // 音符数据...
97
+ ]
98
+ }
99
+ ```
0 commit comments