desktop_device.py 4.9 KB

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