desktop_device.py 3.7 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970
  1. # This Python file uses the following encoding: utf-8
  2. """桌面客户端(serial='desktop')在 Device 层的生命周期策略。
  3. 窗口/进程的实现细节在 module/device/method/desktop_impl.py 的 DesktopWindow,
  4. 这里只管「什么时候把客户端拉起来、什么时候算它在运行」。
  5. """
  6. from module.logger import logger
  7. class DesktopDevice:
  8. # 登录态:OAS 自动启动的客户端停在 MPay 登录页时为 False,登录流程成功后
  9. # 置 True,运行期发现弹窗置回 False。默认 True 表示假设已在游戏中。
  10. _desktop_login_done = True
  11. def _desktop_ensure_launched(self) -> bool:
  12. """确保客户端可用:进程已死才拉起,进程活着只等窗口就绪。
  13. 判定顺序是关键——先看进程再看窗口。把「窗口不在」当成「客户端没在运行」
  14. 会拉起多余实例,并把配置里的 handle 覆盖成新实例的 PID,从此再也绑不回
  15. 原来那个。窗口被最小化不算没运行,截图方法会先还原再取帧。
  16. """
  17. pid = self.desktop_pid()
  18. if pid is None or not self._desktop_pid_alive(pid):
  19. return self.launch_desktop_client()
  20. if self.desktop_window_exists():
  21. return True
  22. return self._desktop_wait_window_ready(pid)
  23. def app_lost_login(self) -> bool:
  24. """客户端是否掉回了未登录态。
  25. MPay 登录窗存活时游戏画面上的一切页面标志都无效,发现即复位登录标记,
  26. 使 app_is_running() 与任务前置检查能拦住后续流程。模拟器模式恒为 False。
  27. """
  28. if not self.is_desktop or not self.find_desktop_login_popup():
  29. return False
  30. logger.warning('Desktop MPay login popup present, client is not logged in')
  31. self.desktop_mark_logged_out()
  32. return True
  33. def desktop_mark_logged_in(self) -> None:
  34. """标记客户端已完成登录(Restart 的登录流程成功后调用)。"""
  35. self._desktop_login_done = True
  36. def desktop_mark_logged_out(self) -> None:
  37. """标记客户端处于未登录态。"""
  38. self._desktop_login_done = False
  39. def _init_desktop(self) -> None:
  40. """桌面客户端模式初始化:跳过模拟器健康检查/full_recovery。"""
  41. logger.info('Desktop client mode: skip emulator health check and full recovery')
  42. if self.config.script.device.screenshot_method == 'auto':
  43. self.config.script.device.screenshot_method = 'window_background'
  44. if self.config.script.device.control_method != 'window_message':
  45. logger.warning(
  46. f'Desktop mode requires control_method=window_message, '
  47. f'current={self.config.script.device.control_method}, overriding'
  48. )
  49. self.config.script.device.control_method = 'window_message'
  50. self.config.save()
  51. self.screenshot_interval_set()
  52. # 桌面客户端的渲染经过 DPI 缩放重采样,相对模板截图环境(模拟器原生
  53. # 1280x720)存在约 1px 的相位差;仓库里约 1/3 的模板 roi 与模板等宽,
  54. # matchTemplate 结果只剩 1 列、横向无法平移补偿,这点相位差就足以把
  55. # 「元素存在」判成「不存在」。这里统一外扩 2px 吸收之,模拟器模式保持 0。
  56. from module.atom.image import DESKTOP_ROI_MATCH_PAD, set_roi_match_padding
  57. set_roi_match_padding(DESKTOP_ROI_MATCH_PAD)
  58. # 客户区校准到 1280x720 保证识别 1:1。窗口存在性已由 __init__ 的
  59. # _desktop_ensure_launched 保证,运行期掉了由 Restart 负责重拉
  60. self.desktop_window_set_size()