archive
/
maimai-android-touch-panel
mirror of https://github.com/ERR0RPR0MPT/maimai-android-touch-panel
1
0
Fork 0
Code Issues Actions Packages Projects Releases Wiki Activity

update doc

main
ERR0RPR0MPT 2025-02-26 11:56:30 +08:00
parent 772c5ab794
commit 5a202a821a
1 changed files with 12 additions and 11 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
README.md
View File

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