修改

Author: Dong-Jing-Yu

_posts/2025-07-29-GuangZou.md

@@ -1,38 +1,89 @@
 ---
-title: "光奏(GuangZou)"
+title: "光奏 (GuangZou) - Android APK 开发文档"
 date: 2025-07-27 08:00:00 +0800
-categories: [开发]
-tags: [Android开发]
+categories: [Android]
+tags: [APK,Kotlin]
 ---
 
-❗暂未开发...
+一个基于 **Kotlin** 开发的 Android 音乐自动弹奏工具，支持无障碍与 ADB 模拟触控，无需 Root 权限
 
-## 🏷️ 基本信息
+---
+
+## 📱 应用信息
+
+| 属性           | 值                                         |
+|----------------|--------------------------------------------|
+| **应用名称**   | 光奏                                        |
+| **英文名**     | GuangZou                                   |
+| **包名**       | `com.djy.guangzou`                         |
+| **平台**       | Android                                    |
+| **开发语言**   | Kotlin                                     |
+| **最低 SDK**   | API 28（Android 9.0）                      |
+| **构建工具**   | Kotlin DSL (`build.gradle.kts`)            |
+| **权限**   | 无障碍,存储,悬浮窗                              |
+| **ADB工具**    | Shizuku                                    |
+| **Root**  | ❌                                             |
+
+---
+
+## 🔐 权限说明
+
+- **无障碍服务**：用于模拟触控弹奏
+- **存储访问**：读取/写入琴谱文件
+- **悬浮窗**：用于浮动控制面板
+
+---
+
+## 🎼 琴谱存储
 
-* **应用名称**：光奏
-* **英文名**：GuangZou
-* **包名**：`com.djy.guangzou`
-* **平台**：Android
-* **开发语言**：Kotlin
-* **最低 SDK**：API 28（Android 9.0）
-* **构建脚本语言**：Kotlin DSL(`build.gradle.kts`)
-* **权限**：无障碍,存储,悬浮窗,应用列表
-* **琴谱存储方式**：外部(`/storage/emulated/0/光奏/琴谱/`)
-* **弹奏方式**：模拟触控
-* **触控方式**：无障碍/adb命令(adb shell input tap X Y)
-* **触控位置**：优先使用已有分辨率布局,其次使用计算布局
-* **可能需要读取的应用包名**：`com.Maple.SkyStudio`,`com.netease.sky`,`com.netease.sky.*`
-* **Root**：否
+- 路径：`/storage/emulated/0/光奏/琴谱/`
+- 支持格式：`.json`(推荐)
+- 适配**未加密**的**sky studio**琴谱文件(`.txt`)
 
+```json
+{
+  "name": "标题",
+  "author": "作者",
+  "bpm": 320,
+  "notes": [
+    { "time": 0, "key": [1,2,3] },
+    { "time": 1000, "key": [9] }
+  ]
+}
+```
 
-**琴键布局(共 15 个键)：**
+**key对应的琴键：**
 ```
 第一排：0  1  2  3  4
 第二排：5  6  7  8  9
 第三排：10 11 12 13 14
 ```
 
-1220x2712
+
+---
+
+## 🎹 弹奏机制
+
+- **核心方式**：模拟触控
+- **实现手段**：
+  - 无障碍 API
+  - `adb shell input swipe X Y X Y 0`
+- **坐标策略**：
+  - 优先使用预设分辨率布局
+  - 若无匹配布局 → 选取相近的布局 → 自行设置琴键坐标(只需要四个角的坐标即可)
+
+---
+
+## ⚠️ 注意事项
+
+* 暂无
+
+---
+
+## 已有布局
+
+- [x] 1220x2712
+
 ```
 1-X:901
 5-X:1809
@@ -43,41 +94,28 @@ tags: [Android开发]
 中-X:1356
 ```
 
+## 📜 许可证-MIT License
 
----
+```
+MIT License
 
-#### 📄 琴谱文件示例
+Copyright (c) 2025 东经雨
 
-```json
-{
-  "name": "Example_Canon.C",
-  "author": "",
-  "bpm": 320,
-  "notes": [
-    { "time": 2992, "key": [7,9,11] },
-    { "time": 3366, "key": [9] },
-    { "time": 3553, "key": [10] },
-    { "time": 3740, "key": [11] },
-    { "time": 4114, "key": [9] },
-    { "time": 4301, "key": [10] },
-    { "time": 4488, "key": [4,6,11] },
-    { "time": 4675, "key": [6] },
-    { "time": 4862, "key": [5] },
-    { "time": 5049, "key": [6] },
-    { "time": 5236, "key": [7] },
-    { "time": 5423, "key": [8] },
-    { "time": 5610, "key": [9] },
-    { "time": 5797, "key": [10] },
-    { "time": 5984, "key": [5,7,9] },
-    { "time": 6358, "key": [7] },
-    { "time": 6545, "key": [8] },
-    { "time": 6732, "key": [9] },
-    { "time": 7106, "key": [2] },
-    { "time": 7293, "key": [3] },
-    { "time": 7480, "key": [0,2,4] },
-    { "time": 7667, "key": [5] },
-    { "time": 7854, "key": [4] },
-    ...
-  ]
-}
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
 ```