Alas Wiki

# 3.4. Exception 异常

介绍 module/exception.py 中的异常。

# CampaignEnd

关卡战斗结束

# Raise

  • BOSS Clear. BOSS 战斗结束。
  • In stage. 战斗结束后退出至章节界面。
  • Image is in stage 对章节界面执行海图识别。
  • Withdraw 关卡撤退。

# Catch

  • 结束当前关卡出击。

# MapDetectionError

海域地图识别错误

# Raise

  • Vanish point and distant point too close 仅海图识别方法为 perspective 时，拟合得到的灭点和距点距离太近，拟合结果对于一点透视的计算无意义。通常是因为网格线太少，导致拟合出错，此时需要调整识别的参数。
  • No data feed to load_homography, please input at least one. 仅海图识别方法为 homography 时，未输入任何初始化透视参数。
  • Failed to find a free tile 仅海图识别方法为 homography 时，无法找到定位点。通常是因为识别的图像并不是海域地图的图像，或者地图地面的杂物较多影响识别。
  • Camera outside map: offset=({x}, {y}) 海图识别时，镜头（画面中心）在地图外。(x, y) 是超出地图边界的距离。

# Catch

  • 若信息为 Camera outside map: offset=({x}, {y})，将镜头重新对准至最近的海域网格内，并重新识别。

# MapWalkError

无法移动至目标点。目标点超出舰队的移动距离，或者通往目标点的道路被敌舰阻挡。

# Raise

  • walk_out_of_step 在舰队移动时，在第一个消息框（INFO_BAR_1）出现 移动 二字。

# Catch

  • 捕捉到第一次 MapWalkError 时，尝试降低舰队步长（FLEET_STEP）至 1，也就是一格一格地移动。若降低舰队步长后仍然捕捉到 MapWalkError，通常是因为敌人信息丢失，舰队位置错误，镜头位置错误。直接设置舰队步长为 1，一般不能解决问题。

# MapEnemyMoved

敌人已经移动，需要重新进行地图扫描。

# Raise

  • 计算移动回合，若当前回合后精英敌人会移动，对已移动敌人的进行扫描，并抛出。玩家舰队移动 2 次或 3 次后，精英敌人移动。具体是 2 次还是 3 次，根据敌人不同而不同，可以查看 expedition_data_template.lua 中的 ai_mov 属性。若使用 map_extractor.py 生成地图文件，将自动提取至 MOVABLE_ENEMY_TURN。

# Catch

  • 捕捉后，重新执行当前 battle_function，上限 10 次。超出次数后，抛出 ScriptError('No combat executed.')

# CampaignNameError

无法识别关卡名称。

# Raise

  • Stage not found: {name} 无法在当前界面找到所请求的关卡名称。
  • 无法在当前界面找到所请求的章节序号。

# Catch

  • 捕捉后重新识别，上限 20 次。超出次数后，抛出 ScriptEnd('Campaign name error')

# ScriptError

发生脚本内部错误，且无法处理。若开启 ENABLE_EXCEPTION，撤退，不抛出异常。

# Raise

  • No combat executed. 未攻击敌人。当前 battle_function 执行后未攻击任何一个敌人。
  • Battle function exhausted. battle_function 耗尽。执行了超过 20 次 battle_function，尝试攻击了超过 20 个敌人。
  • {key} filter switch object does not exist in module/retire/dock.py 船坞筛选条件未在 module/retire/dock.py 中定义。
  • No book found. 在战术学院，检测不到任何一本技能书。
  • Login failed more than 3 游戏登录失败次数超过 3。
  • 'No ocr-tool found, please install tesseract by yourself and make sure to set correct env vars.' 仅日服，未安装 tesseract。
  • No jpn found in tesseract langs, please install japanese data files. 仅日服，tesseract 中未安装 jpn 训练数据。

# ScriptEnd

脚本运行结束。

# Raise

  • Reach condition: {self.config.STOP_IF_MAP_REACH} 触发用户设置中的停止条件。
  • Campaign name error 无法识别关卡名称，无法进入关卡。

# Catch

  • Script end 停止脚本的运行。

# GameStuckError

游戏卡死。

# Raise

  • Wait too long 等待时间过长。超过 60 秒和 60 张截图后无任何操作，或在战斗中超过 300 秒和 300 张截图后无任何操作，抛出。（若识别对象包含BATTLE_STATUS_S 或 PAUSE，认为在战斗中。）
  • Triggered commission list flashing bug 执行委托时，失败次数超过 3，可能触发游戏内的委托列表闪烁 bug，导致无法委托开始。

# Catch

  • 仅在使用 GUI 运行时，重启游戏。在重启时，若再次发生 GameStuckError，不再捕捉，通常是因为服务器在维护，或者网络连接已断开。

# GameTooManyClickError

点击游戏内同一按钮， 或者执行相同滑动的次数过多。

# Raise

  • Too many click for a button: {button} 点击或滑动某个按钮次数过多。若在最后 15 次点击中，包含 12 次当前点击，则抛出。

# Catch

  • 仅在登录时，重启游戏，最大次数 3。超过次数后，抛出 ScriptError('Login failed more than 3')

# GameNotRunningError

游戏未运行。

# Raise

  • Game not running 在无法识别的界面启动 Alas，且游戏未运行。

# Catch

  • 仅在使用 GUI 运行时，重启游戏。

# AscreencapError

调用 ascreencap 发生错误。

# Raise

  • Repositioning byte pointer failed, corrupted aScreenCap data received 无法定位 ascreencap 数据中的图片。
  • aScreenCap header verification failure, corrupted image received. 接收到的数据有误。

# Catch

  • 重新安装 ascreencap。

# Exit without error

Alas 停止运行，不报错。通常是用户设置有误或者使用方式不对。

  • Not supported screen size: {width}x{height}
Alas requires 1280x720

    不支持的分辨率，Alas 需要在 1280x720 下运行。

  • Received a pure black screenshot
Color: {color}

    截图为纯黑色。通常是设备处于锁屏状态，或者当前模拟器不支持当前截图方式。

  • Map file not found: campaign.{folder}.{name}

    未找到地图文件。通常是用户出击未适配的地图，或者运行目录有误。

  • Unable to goto page_main
Starting from current page is not supported
Supported page: {[str(page) for page in self.ui_pages]}
Supported page: Any page with a "HOME" button on the upper-right

    无法前往游戏主界面，不支持从当前游戏界面启动。Alas可以自动切换到需要的游戏界面, 但是只允许在这些界面下启动：主界面，出击，编队，演习，每日，活动，SP活动，任务领取。共斗活动。Alas也可以在右上角有 “一键回港” 按钮的界面下启动。游戏中大部分界面都有这个按钮，除了主界面本身，后宅，指挥喵。

  • UI route too long

    寻找到的游戏界面切换路径过长。防止自动切换游戏界面时进入死循环，快速占满内存。已经修复。

  • Unknown raid mode: {mode}

    不支持的共斗活动难度。

  • Unable to connect %s' % serial

    ADB 无法连接至该模拟器。

  • No ship retired, exit
This may happens because wrong options of one click retirement in game

    仅使用一键退役时，未退役任何船只，通常是游戏内的一键退役设置有误。

  • No ship retired, exit
This may happens because some filters are set in dock

    仅使用传统退役时，未退役任何船只，通常是在游戏内的船坞设置了别的筛选条件。

  • Frame body does not strt with JPEG header

    仅使用 minicap 截图时，接收到的数据不是 JPEG 图像。

  • Mob fleet [{self.FLEET_1}] and boss fleet [{self.FLEET_2}] is the same
They should to be set to different fleets

    将道中队和 BOSS 队设置为同一队。企图使用骚操作绕过 Alas 必须使用两队的限制，最终也会在 BOSS 出现时报错，所以在保存设置时增加了检查。

  • You should use 2 fleets from chapter 7 to 13
Current: mob fleet [{self.FLEET_1}], boss fleet [{self.FLEET_2}]

    在 7 到 13 章需要使用两队。解释同上。

  • Ocr model not prepared: {model_dir}

    未找到 OCR 模型，或 OCR 模型不符合要求。

  • Enemy detection template not found: {name}

    未找到精英敌人的识别模板，通常是开发者适配地图时有遗漏，或者命名有误。

  • No suitable version of aScreenCap lib is available
Please use ADB or uiautomator2 screenshot instead

    acreencap 不支持这个模拟器或这个安卓版本，请使用 ADB 或 uiautomator2 截图。

← 4.1. Detection objects 识别类 →