desktop_device.py 4.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788
  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. # 认领的是已存在的窗口,可能是用户手动开的且已登录,
  35. # 登录态由 find_desktop_login_popup 实测,不能假设未登录
  36. self.desktop_bind_pid(located_pid, hwnd, just_launched=False)
  37. return True
  38. return self.launch_desktop_client()
  39. def app_lost_login(self) -> bool:
  40. """客户端是否掉回了未登录态。
  41. MPay 登录窗存活时游戏画面上的一切页面标志都无效,发现即复位登录标记,
  42. 使 app_is_running() 与任务前置检查能拦住后续流程。模拟器模式恒为 False。
  43. """
  44. if not self.is_desktop or not self.find_desktop_login_popup():
  45. return False
  46. logger.warning('Desktop MPay login popup present, client is not logged in')
  47. self.desktop_mark_logged_out()
  48. return True
  49. def desktop_mark_logged_in(self) -> None:
  50. """标记客户端已完成登录(Restart 的登录流程成功后调用)。"""
  51. self._desktop_login_done = True
  52. def desktop_mark_logged_out(self) -> None:
  53. """标记客户端处于未登录态。"""
  54. self._desktop_login_done = False
  55. def _init_desktop(self) -> None:
  56. """桌面客户端模式初始化:跳过模拟器健康检查/full_recovery。"""
  57. logger.info('Desktop client mode: skip emulator health check and full recovery')
  58. if self.config.script.device.screenshot_method == 'auto':
  59. # auto 是「自动选择」的语义,桌面模式自动落到后台截图,无需告警
  60. self.config.script.device.screenshot_method = 'window_background'
  61. elif self.config.script.device.screenshot_method != 'window_background':
  62. logger.warning(
  63. f'Desktop mode requires screenshot_method=window_background, '
  64. f'current={self.config.script.device.screenshot_method}, overriding'
  65. )
  66. self.config.script.device.screenshot_method = 'window_background'
  67. if self.config.script.device.control_method != 'window_message':
  68. logger.warning(
  69. f'Desktop mode requires control_method=window_message, '
  70. f'current={self.config.script.device.control_method}, overriding'
  71. )
  72. self.config.script.device.control_method = 'window_message'
  73. self.config.save()
  74. self.screenshot_interval_set()
  75. # 客户区校准到 1280x720 保证识别 1:1。窗口存在性已由 __init__ 的
  76. # _desktop_ensure_launched 保证,运行期掉了由 Restart 负责重拉
  77. self.desktop_window_set_size()