OnmyojiAutoScript项目常见问题：截图方式不兼容导致运行异常分析

2026-02-03 04:23:47作者：郁楠烈Hubert

问题背景

OnmyojiAutoScript（OAS）作为阴阳师自动化脚本，其核心功能依赖于对游戏界面的准确截图识别。然而在实际使用过程中，许多用户会遇到截图方式不兼容导致的运行异常问题。本文将深入分析这一常见问题的根源、解决方案以及最佳实践。

截图机制架构解析

OAS采用了多层次的截图方法架构，支持多种截图技术以适应不同的模拟器环境：

classDiagram
    class Screenshot {
        +screenshot_methods: dict
        +screenshot() np.ndarray
        +check_screen_size() bool
        +check_screen_black() bool
    }
    
    class Adb {
        +screenshot_adb()
        +screenshot_adb_nc()
    }
    
    class DroidCast {
        +screenshot_droidcast()
        +screenshot_droidcast_raw()
    }
    
    class Scrcpy {
        +screenshot_scrcpy()
    }
    
    class Window {
        +screenshot_window_background()
    }
    
    class NemuIpc {
        +screenshot_nemu_ipc()
    }
    
    Screenshot --|> Adb
    Screenshot --|> DroidCast
    Screenshot --|> Scrcpy
    Screenshot --|> Window
    Screenshot --|> NemuIpc

支持的截图方法对比

截图方法	适用模拟器	优点	缺点	推荐指数
ADB	通用	兼容性好，稳定	速度较慢	⭐⭐⭐⭐
ADB_nc	通用	网络传输，效率高	需要网络配置	⭐⭐⭐
uiautomator2	主流模拟器	原生Android支持	可能黑屏	⭐⭐
DroidCast	MuMu等	专为模拟器优化	特定版本兼容	⭐⭐⭐⭐
DroidCast_raw	MuMu特定版本	原始数据流	兼容性差	⭐⭐
scrcpy	通用	实时流媒体	资源占用高	⭐⭐⭐⭐
window_background	桌面模式	直接窗口捕获	仅限桌面环境	⭐⭐
nemu_ipc	网易MuMu	官方接口	仅限MuMu	⭐⭐⭐⭐⭐

常见问题分析

1. 纯黑屏截图问题

def check_screen_black(self):
    # 检查屏幕颜色
    # 在某些模拟器上可能会获取到纯黑截图
    color = get_color(self.image, area=(0, 0, 1280, 720))
    if sum(color) < 1:
        logger.warning(f'Received pure black screenshots from emulator, color: {color}')
        # 处理逻辑...

问题表现：脚本运行后立即停止，日志显示"Received pure black screenshots"

根本原因：

模拟器未完全启动
截图方法不兼容当前模拟器版本
minicap组件未正确安装

2. 分辨率不匹配问题

def check_screen_size(self):
    """
    屏幕尺寸必须为1280x720
    调用前需要先截图
    """
    width, height = image_size(self.image)
    if width == 1280 and height == 720:
        return True
    else:
        logger.critical(f'Resolution not supported: {width}x{height}')
        raise RequestHumanTakeover

问题表现：脚本报错"Resolution not supported"

解决方案：

将模拟器分辨率设置为1280x720
检查模拟器DPI设置
确认游戏画面比例

3. 方向处理异常

def _handle_orientated_image(self, image):
    # 处理旋转的截图
    if self.orientation == 1:
        image = cv2.rotate(image, cv2.ROTATE_90_COUNTERCLOCKWISE)
    elif self.orientation == 2:
        image = cv2.rotate(image, cv2.ROTATE_180)
    # 其他方向处理...

问题表现：图像识别失败，坐标计算错误

解决方案与最佳实践

1. 模拟器选择与配置

flowchart TD
    A[选择模拟器] --> B{MuMu模拟器}
    A --> C{其他模拟器}
    
    B --> D[版本 ≥ 12.1.5.0]
    D --> E[截图方法: nemu_ipc]
    E --> F[✅ 最佳兼容性]
    
    C --> G[检查模拟器版本]
    G --> H[尝试DroidCast]
    H --> I[备用: ADB]
    I --> J[⚠️ 需要测试]

2. 截图方法调试流程

# 调试脚本示例
def debug_screenshot_methods():
    device = Device(config=config)
    methods = device.screenshot_methods.keys()
    
    for method in methods:
        try:
            device.config.script.device.screenshot_method = method
            image = device.screenshot()
            print(f"{method}: SUCCESS - {image.shape}")
        except Exception as e:
            print(f"{method}: FAILED - {str(e)}")

3. 配置优化建议

# 推荐配置
script:
  device:
    screenshot_method: "nemu_ipc"  # MuMu模拟器首选
    # screenshot_method: "DroidCast"  # 其他模拟器
    # screenshot_method: "scrcpy"    # 通用方案
  
  optimization:
    screenshot_interval: 0.1      # 截图间隔
    combat_screenshot_interval: 0.3 # 战斗中间隔
  
  error:
    save_error: true             # 保存错误截图
    screenshot_length: 60        # 保存最近60张截图

故障排除指南

1. 快速诊断命令

# 检查ADB连接
adb devices
adb shell wm size
adb shell dumpsys window | grep DisplayWidth

# 检查模拟器状态
adb shell ps | grep android

2. 常见错误代码处理

错误信息	含义	解决方案
`Resolution not supported`	分辨率不支持	设置1280x720分辨率
`Received pure black screenshots`	黑屏截图	更换截图方法
`Invalid device orientation`	方向错误	检查模拟器旋转设置
`minicap uninstalled`	minicap组件问题	重新安装或使用其他方法

3. 性能优化建议

graph LR
    A[高频任务] --> B[scrcpy<br/>实时流]
    B --> C[低延迟<br/>高CPU]
    
    D[常规任务] --> E[nemu_ipc<br/>专用接口]
    E --> F[平衡<br/>推荐]
    
    G[兼容模式] --> H[ADB<br/>通用]
    H --> I[高兼容<br/>低性能]