From 5a202a821ac3d3e9ac3f76101cfe46ad5db3c1de Mon Sep 17 00:00:00 2001 From: ERR0RPR0MPT Date: Wed, 26 Feb 2025 11:56:30 +0800 Subject: [PATCH] update doc --- README.md | 23 ++++++++++++----------- 1 file changed, 12 insertions(+), 11 deletions(-) diff --git a/README.md b/README.md index 7967025..9a37dd6 100644 --- a/README.md +++ b/README.md @@ -12,27 +12,28 @@ - 仅支持 Linux 多点触控协议类型 B 而不支持 A (#6), 这可能会导致较旧的设备不受支持, 两种类型不同之处详见[文档](https://www.kernel.org/doc/Documentation/input/multi-touch-protocol.txt) - 输出 Touch Keys 但无按键按下(分辨率问题) -- 游戏内按两下只识别一个tap(脚本未进入运行模式) +- 游戏内按两下只识别一个 tap(脚本未进入运行模式) - 游戏内始终显示按下(未知原因) -本人暂无时间去修复存在的 Bug, 对于 open issue 和B站私信问题的很抱歉本人无法进行答复, -有能力的可以自行修复, 也欢迎提交PR. +本人暂无时间去修复存在的 Bug, 对于 open issue 和 B 站私信问题的很抱歉本人无法进行答复, +有能力的可以自行修复, 也欢迎提交 PR. 另外本项目使用了效率较为低下且抽象的方案(Python+读图+串流), 存在延迟等问题, 由于本身是娱乐项目故未做优化. 更加优秀的项目有: -- [AstroDX](https://github.com/2394425147/astrodx) -- [MajdataPlay](https://github.com/LingFeng-bbben/MajdataPlay) +- [KanadeDX](https://github.com/KanadeDX/Public) (某八个按键程序在 Android/iOS 上的实现) +- [AstroDX](https://github.com/2394425147/astrodx) (Android, Windows?) +- [MajdataPlay](https://github.com/LingFeng-bbben/MajdataPlay) (Windows, Android?) 这些项目包含对 Mai2 Chart Player 的完整实现, 而不仅仅是一个触摸输入程序. ## 使用方法 1. 请先将游戏配置文件中 `DummyTouchPanel` 的值改为 `0` -2. 打开任意P图工具, 准备一个和设备屏幕大小相同的一张图片(例如:1600x2560), 将 `./image/color_exp_panel.png` +2. 打开任意 P 图工具, 准备一个和设备屏幕大小相同的一张图片(例如:1600x2560), 将 `./image/color_exp_panel.png` 放置到该图片圆形触摸区域的位置, 编辑好的图片放到脚本 `image` 目录下取名 `image_monitor.png`. -3. 编辑 `config.yaml` 配置文件, 修改 `exp_image_dict` 配置, 将各区块对应的 RGB 通道颜色值改为刚P的图的对应区块颜色值( +3. 编辑 `config.yaml` 配置文件, 修改 `exp_image_dict` 配置, 将各区块对应的 RGB 通道颜色值改为刚 P 的图的对应区块颜色值( 一般不用改默认就行) 4. 电脑安装 ADB 调试工具, 安装路径添加到系统环境变量里面 5. 如果电脑上没有 Python 环境, 请先去 [官网](https://www.python.org/) 下载安装 @@ -50,8 +51,8 @@ 设备, 详细过程请自行寻找, 不在本篇讨论范围之内 13. 手机连接电脑, 先双击运行 `start.bat`, 再运行游戏, 脚本控制台输出 `已连接到游戏` 即可 -14. 进游戏调整延迟, 一般判定A/B都要调才能正常用, 我这边是 `A:-1.0/B:+0.5` 到 `A:-2.0/B:+2.0` -15. 打一把看看蹭不蹭星星/触控是否灵敏, 根据体验修改 `AREA_SCOPE` 变量 +14. 进游戏调整延迟, 一般判定 A/B 都要调才能正常用, 我这边是 `A:-1.0/B:+0.5` 到 `A:-2.0/B:+2.0` +15. 打一把看看蹭不蹭星星/触控是否灵敏, 根据体验修改 `AREA_SCOPE` 变量 c'c'x'c'c'z'z'z'z'd'd'd'd'c'x 16. 如果单点延迟低但滑动时延迟极大, 请将脚本中 `TOUCH_THREAD_SLEEP_MODE` 修改为 false, 或者可以调小 `TOUCH_THREAD_SLEEP_DELAY` 的值(如果还是卡请提 issue 反馈) @@ -67,7 +68,7 @@ 关于延迟/其他建议可参考 [#3](https://github.com/ERR0RPR0MPT/maimai-android-touch-panel/issues/3) -Q: 在安卓高版本(13,14)上测试触摸区域完全对不上，只有点屏幕左上角有用，图片用的是平板实际分辨率，在一台安卓10设备测试是正常的 +Q: 在安卓高版本(13,14)上测试触摸区域完全对不上，只有点屏幕左上角有用，图片用的是平板实际分辨率，在一台安卓 10 设备测试是正常的 A: 按步骤修改脚本内 `ANDROID_ABS_MONITOR_SIZE` 和 `ANDROID_ABS_INPUT_SIZE` 配置 @@ -75,7 +76,7 @@ A: 按步骤修改脚本内 `ANDROID_ABS_MONITOR_SIZE` 和 `ANDROID_ABS_INPUT_SI 想要加 2P 的重新复制一下脚本并添加串口 COM4 到 COM44 的转发就好 -该脚本仅用于测试, 目前来说打12+及以下应该是问题不大, 12+以上水平不够没试过. +该脚本仅用于测试, 目前来说打 12+及以下应该是问题不大, 12+以上水平不够没试过. ## 类似项目