OnmyojiAutoScript模拟器运行阴阳师脚本常见问题排查指南
项目地址: https://gitcode.com/gh_mirrors/on/OnmyojiAutoScript 问题现象分析
在使用OnmyojiAutoScript运行阴阳师自动化脚本时，用户遇到了两种典型问题场景：
-
自动启动问题：当脚本尝试自动启动游戏时，阴阳师会卡在登录界面并持续报错，无法正常进入游戏。
-
手动启动问题：当用户手动登录游戏后启动脚本，脚本又会出现无法识别游戏界面的错误，提示"Game page unknown"。
根本原因
经过技术分析，这些问题主要由以下几个因素导致：
-
截图方式配置不当：默认的窗口背景截图方式(WINDOW_BACKGROUND)在某些模拟器环境下无法正确捕获游戏画面，导致脚本无法识别游戏界面元素。
-
游戏界面识别机制：脚本需要识别特定的游戏界面(如主页、召唤、探索等带有HOME按钮的界面)才能正常运行，而登录界面不在支持列表中。
-
模拟器兼容性问题：不同模拟器(如MuMu模拟器)对ADB和截图接口的实现存在差异，可能导致功能异常。
解决方案
1. 修改截图方式
将截图方式从默认的WINDOW_BACKGROUND切换为ADB方式可以解决大多数识别问题：
- 在配置文件中找到EMULATOR__SCREENSHOT_METHOD设置
- 将其值修改为ScreenshotMethod.ADB
- 保存配置后重启脚本
2. 正确的启动流程
为确保脚本正常运行，建议采用以下启动顺序：
- 先手动启动游戏并登录
- 确保进入游戏主界面(带有明显HOME按钮的界面)
- 然后再启动OnmyojiAutoScript脚本
3. 模拟器环境检查
对于使用MuMu等模拟器的用户，还需检查：
- ADB连接是否正常
- 模拟器分辨率是否设置为脚本支持的1280x720
- 模拟器GPU渲染模式(建议尝试切换不同模式)
技术原理深入
OnmyojiAutoScript的界面识别机制依赖于精确的图像匹配技术。当截图方式配置不当时，获取的游戏画面可能出现以下问题：
- 全黑画面：窗口背景截图无法捕获游戏内容层
- 画面延迟：截图与真实界面不同步
- 元素缺失：关键UI元素未被正确捕获
ADB截图方式通过Android调试桥直接获取设备帧缓冲区内容，能更可靠地获取游戏画面，但可能牺牲少量性能。
最佳实践建议
- 首次配置：新环境部署后，先用ADB截图方式确保基本功能正常
- 性能优化：稳定运行后可尝试其他截图方式提升效率
- 日志分析：遇到问题时检查./log/error/目录下的错误日志和截图
- 多环境测试：在不同网络条件和时间段测试脚本稳定性
通过以上方法，大多数阴阳师自动化脚本在模拟器环境下的运行问题都能得到有效解决。对于特殊案例，建议详细记录复现步骤和环境信息以便进一步分析。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
