handle.py 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464
  1. # This Python file uses the following encoding: utf-8
  2. # @author runhey
  3. # github https://github.com/runhey
  4. import re
  5. from enum import Enum
  6. from time import sleep
  7. from cached_property import cached_property
  8. from anytree import NodeMixin, RenderTree, PreOrderIter
  9. from win32api import GetSystemMetrics, SendMessage, MAKELONG, PostMessage
  10. from win32print import GetDeviceCaps
  11. from win32process import GetWindowThreadProcessId
  12. from win32gui import (GetWindowText, EnumWindows, FindWindow, FindWindowEx,
  13. IsWindow, GetWindowRect, GetWindowDC, DeleteObject,
  14. SetForegroundWindow, IsWindowVisible, GetDC, GetParent,
  15. EnumChildWindows)
  16. from win32con import (SRCCOPY, DESKTOPHORZRES, DESKTOPVERTRES, WM_LBUTTONUP,
  17. WM_LBUTTONDOWN, WM_ACTIVATE, WA_ACTIVE, MK_LBUTTON,
  18. WM_NCHITTEST, WM_SETCURSOR, HTCLIENT, WM_MOUSEMOVE)
  19. from module.config.config import Config
  20. from module.config.utils import desktop_mode_enabled
  21. from module.device.method.desktop_impl import DesktopWindow
  22. from module.exception import EmulatorNotRunningError
  23. from module.logger import logger
  24. def handle_title2num(title: str) -> int:
  25. """
  26. 从标题到句柄号
  27. :param title:
  28. :return: 如果没有找到就是返回零
  29. """
  30. return FindWindow(None, title)
  31. def handle_num2title(num: int) -> str:
  32. """
  33. 通过句柄号返回窗口的标题,如果传入句柄号不合法则返回None
  34. :param num:
  35. :return:
  36. """
  37. return None if num is None or num == 0 or num == '' else GetWindowText(num)
  38. def is_handle_valid(num: int) -> bool:
  39. """
  40. 输入一个句柄号,如果还在返回True
  41. :param num:
  42. :return:
  43. """
  44. return IsWindow(num)
  45. def handle_num2pid(num: int) -> int:
  46. """
  47. 通过句柄号获取句柄进程id,如果句柄号非法则返回0
  48. :param num:
  49. :return:
  50. """
  51. return 0 if num is None or num == 0 or num == '' else GetWindowThreadProcessId(num)[1]
  52. def window_scale_rate() -> float:
  53. """
  54. 获取window的系统缩放 一遍是1
  55. :return:
  56. """
  57. hDC = GetDC(0)
  58. # 物理上(真实的)的 横纵向分辨率
  59. wReal = GetDeviceCaps(hDC, DESKTOPHORZRES)
  60. hReal = GetDeviceCaps(hDC, DESKTOPVERTRES)
  61. # 缩放后的 分辨率
  62. wAfter = GetSystemMetrics(0)
  63. hAfter = GetSystemMetrics(1)
  64. # print(wReal, wAfter)
  65. return round(wReal / wAfter, 2)
  66. class WindowNode(NodeMixin):
  67. def __init__(self, name, num, parent=None):
  68. super().__init__()
  69. self.name = name
  70. self.num = num
  71. self.parent = parent
  72. @classmethod
  73. def get_tree_depth(cls, root_node: 'WindowNode'):
  74. if not root_node.children:
  75. return 1 if root_node else 0
  76. return max(node.depth for node in root_node.descendants) + 1
  77. class EmulatorFamily(Enum):
  78. FAMILY_MUMU = 10 # mumu模拟器
  79. FAMILY_NOX = 20 # 夜神模拟器
  80. FAMILY_LD = 30 # 雷电模拟器
  81. FAMILY_MEMU = 40 # 逍遥模拟器
  82. FAMILY_BLUESTACKS = 50 # 蓝叠模拟器
  83. FAMILY_OTHER = 60 # 其他模拟器 待定
  84. # 各个模拟器的句柄树*******************************************************************************************************
  85. """"
  86. <MuMu>系列
  87. 模拟器的窗口名字
  88. ----MuMuPlayer (!如果是mumu12是MuMuPlayer, 否则是NemuPlayer)
  89. --------nemudisplay
  90. <雷电模拟器系列>
  91. 雷电模拟器的窗口名字
  92. ----TheRender
  93. --------sub
  94. <夜神模拟器系列> =====> 这个模拟器窗口很复杂,而且有的时候还会变化
  95. 夜神模拟器的窗口名字
  96. ----Nox
  97. ----Nox
  98. --------toolbar_nox
  99. --------Nox
  100. ------------Nox
  101. ----------------sub
  102. ---Nox
  103. --------Nox
  104. --------Nox ==> 妈的太多了自己用spy++看吧
  105. <蓝叠模拟器>
  106. 蓝叠模拟器的窗口名字
  107. ----HD-Player
  108. --------_ctl.W
  109. """""
  110. # **********************************************************************************************************************
  111. class Handle(DesktopWindow):
  112. emulator_list = ['MuMu12',
  113. 'MuMu',
  114. '雷电',
  115. '夜神',
  116. '蓝叠',
  117. '逍遥',
  118. '模拟器'] # 最后一个我又不知道还有哪些模拟器
  119. emulator_handle = {
  120. # 夜神
  121. 'nox_player': ['root_handle_title', 'Nox'],
  122. 'nox_player_64': ['root_handle_title', 'Nox'],
  123. 'nox_player_family': ['root_handle_title', 'Nox'],
  124. # 雷电
  125. 'ld_player': ['TheRender'],
  126. 'ld_player_4': ['TheRender'],
  127. 'ld_player_9': ['TheRender'],
  128. 'ld_player_family': ['TheRender'],
  129. # 逍遥
  130. 'memu_player': ['root_handle_title'],
  131. 'memu_player_family': ['root_handle_title'],
  132. # mumu
  133. 'mumu_player': ['root_handle_title', 'NemuPlayer'],
  134. 'mumu_player_12': ['root_handle_title', 'MuMuPlayer'],
  135. 'mumu_player_family': ['root_handle_title', 'MuMuPlayer'],
  136. # 蓝叠
  137. 'bluestacks_5': ['root_handle_title'],
  138. 'bluestacks_family': ['root_handle_title']
  139. }
  140. config: Config = None
  141. is_desktop_window: bool = False
  142. """是否为桌面客户端模式(script.desktop.enable),桌面分支统一用此标志隔离"""
  143. def __init__(self, config) -> None:
  144. """
  145. :param config:
  146. """
  147. logger.hr('Handle')
  148. if self.config is None:
  149. if isinstance(config, str):
  150. self.config = Config(config, task=None)
  151. else:
  152. self.config = config
  153. # 桌面模式:PID 只在运行时存在(不落配置),按「档案状态文件 → 窗口枚举」定位,
  154. # 找不到抛错交给 Device.__init__ 自动拉起。须排在 handle 空判之前(桌面模式留空是常态)
  155. if desktop_mode_enabled(self.config):
  156. self.root_handle_title = ''
  157. self.root_handle_num = 0
  158. self.root_handle = ''
  159. pid, hwnd = self._desktop_locate_window()
  160. if pid and hwnd:
  161. self.desktop_bind_pid(pid, hwnd)
  162. logger.info(f'Desktop client window bound: PID={pid}, hwnd={hwnd}')
  163. return
  164. if pid:
  165. logger.info(f'Desktop client process alive (PID={pid}) but window not ready yet')
  166. raise EmulatorNotRunningError('Desktop client window not found')
  167. if not self.config.script.device.handle or self.config.script.device.handle == '':
  168. logger.info('Handle is empty, oas not use handle')
  169. return
  170. # 获取根的句柄
  171. self.root_handle_title = ''
  172. self.root_handle_num = 0
  173. self.root_handle = self.config.script.device.handle
  174. if self.root_handle == "auto":
  175. logger.info('Handle is auto. oas will find window emulator')
  176. window_list = Handle.all_windows()
  177. self.root_handle_title = self.auto_handle_title(window_list)
  178. self.root_handle_num = handle_title2num(self.root_handle_title)
  179. if isinstance(self.root_handle, str):
  180. try:
  181. self.root_handle_num = int(self.root_handle)
  182. logger.info('Handle is a number, using it as root handle num')
  183. if is_handle_valid(self.root_handle_num):
  184. logger.info(f'Handle number {self.root_handle_num} is valid')
  185. self.root_handle_title = handle_num2title(self.root_handle_num)
  186. except ValueError:
  187. logger.info('Handle is a string, looking up window by title')
  188. if handle_title2num(self.root_handle) != 0:
  189. self.root_handle_num = handle_title2num(self.root_handle)
  190. self.root_handle_title = self.root_handle
  191. logger.info(f'The root handle title is {self.root_handle_title} and num is {self.root_handle_num}')
  192. # 获取句柄树(加重试,等待子窗口渲染就绪)
  193. self.root_node = WindowNode(name=self.root_handle_title, num=self.root_handle_num)
  194. Handle.handle_tree(self.root_handle_num, self.root_node)
  195. if not self.root_node.children:
  196. logger.info('Window child tree not ready, waiting for emulator to finish initializing')
  197. for i in range(9):
  198. sleep(1)
  199. self.root_node = WindowNode(name=self.root_handle_title, num=self.root_handle_num)
  200. Handle.handle_tree(self.root_handle_num, self.root_node)
  201. if self.root_node.children:
  202. logger.info(f'Window child tree ready after {i + 2} attempts')
  203. break
  204. else:
  205. logger.warning('Window child tree still not ready after 10 attempts, will use title-based fallback')
  206. logger.info('Emulator handle structure:')
  207. for pre, fill, node in RenderTree(self.root_node):
  208. logger.info("%s%s" % (pre, node.name))
  209. for pre, fill, node in RenderTree(self.root_node):
  210. logger.info("%s%s" % (pre, node.num))
  211. # 判断是哪一个模拟器 通过句柄树结构
  212. logger.info(f'Emulator family: {self.emulator_family}')
  213. # window系统的缩放
  214. logger.info(f'Window screen scale rate: {window_scale_rate()}')
  215. # screenshot_handle_num 和 screenshot_size 延迟到首次截屏时按需求值,不在初始化时预计算
  216. @staticmethod
  217. def all_windows() -> list:
  218. """
  219. 获取桌面上的所有窗体
  220. :return: 类似这样['MuMu模拟器']
  221. """
  222. def enum_windows_callback(hwnd, windows):
  223. window_text = GetWindowText(hwnd)
  224. windows.append(window_text)
  225. windows = []
  226. EnumWindows(enum_windows_callback, windows)
  227. return windows
  228. @classmethod
  229. def auto_handle_title(cls, windows: list) -> str:
  230. """
  231. 返回第一个找到的有模拟器的标题
  232. :param windows:
  233. :return:
  234. """
  235. if windows is None:
  236. logger.error("auto_handle_title: windows list is None")
  237. emu_list = []
  238. for window_title in windows:
  239. for item in Handle.emulator_list:
  240. if window_title.find(item) != -1:
  241. emu_list.append(window_title)
  242. if not len(emu_list):
  243. logger.error('Can not find emulator handle, please check your emulator is running')
  244. return None
  245. emulator_title = ''
  246. # 测试mumu12的时候发现 获取的全部的窗体标题有这样的: 'MuMuPlayer', 'MuMuPlayer', 'MuMuPlayer', 'MuMu模拟器12'
  247. # 事实上 我们只需要最后一个 'MuMu模拟器12',其他的不重要
  248. if 'MuMu模拟器12' in emu_list and 'MuMuPlayer' in emu_list:
  249. emulator_title = 'MuMu模拟器12'
  250. # MuMu5.0更新,窗体标题改动: 'MuMu模拟器','MuMuNxDevice','MuMu安卓设备'
  251. # 如果没有匹配上旧版本,尝试匹配MuMu5.0窗口名
  252. if emulator_title == '' and 'MuMu安卓设备' in emu_list:
  253. emulator_title = 'MuMu安卓设备'
  254. if len(emu_list) > 1 and emulator_title == '':
  255. logger.warning(f'Find more than one emulator handle, oas will use the first one {emu_list[0]}')
  256. emulator_title = emu_list[0]
  257. if len(emu_list) == 1:
  258. emulator_title = emu_list[0]
  259. logger.info(f'Auto-detected emulator window: {emulator_title}')
  260. return emulator_title
  261. @staticmethod
  262. def handle_tree(hwnd, node: WindowNode, level: int = 0) -> None:
  263. """
  264. 生成一个窗口的句柄树
  265. :param hwnd:
  266. :param node:
  267. :param level:
  268. :return:
  269. """
  270. child_windows = []
  271. EnumChildWindows(hwnd, lambda hwnd, param: param.append(hwnd), child_windows)
  272. if not child_windows:
  273. return
  274. for child_hwnd in child_windows:
  275. if GetParent(child_hwnd) == hwnd:
  276. child_text = GetWindowText(child_hwnd)
  277. child_node = WindowNode(name=child_text, num=child_hwnd, parent=node)
  278. # 递归遍历子窗体的子窗体
  279. Handle.handle_tree(child_hwnd, child_node, level + 1)
  280. @cached_property
  281. def emulator_family(self) -> EmulatorFamily:
  282. """
  283. 通过句柄树来判断这个是那个模拟器大类
  284. :return:
  285. """
  286. children_num = len(self.root_node.children)
  287. if children_num == 1: #
  288. name = self.root_node.children[0].name
  289. if name == 'MuMuPlayer':
  290. return EmulatorFamily.FAMILY_MUMU
  291. elif name == 'MuMuNxDevice':
  292. return EmulatorFamily.FAMILY_MUMU
  293. elif name == 'NemuPlayer':
  294. return EmulatorFamily.FAMILY_MUMU
  295. elif name == 'TheRender':
  296. return EmulatorFamily.FAMILY_LD
  297. elif name == 'HD-Player':
  298. return EmulatorFamily.FAMILY_BLUESTACKS
  299. elif children_num >= 3:
  300. name = self.root_node.children[0].name
  301. if name == 'Nox':
  302. return EmulatorFamily.FAMILY_NOX
  303. # 基于句柄标题的判定
  304. for emu in Handle.emulator_list:
  305. if self.root_handle_title.find(emu) != -1:
  306. if emu == 'MuMu':
  307. return EmulatorFamily.FAMILY_MUMU
  308. elif emu == '雷电':
  309. return EmulatorFamily.FAMILY_LD
  310. elif emu == '夜神':
  311. return EmulatorFamily.FAMILY_NOX
  312. elif emu == '蓝叠':
  313. return EmulatorFamily.FAMILY_BLUESTACKS
  314. elif emu == '逍遥':
  315. return EmulatorFamily.FAMILY_MEMU
  316. return EmulatorFamily.FAMILY_OTHER
  317. @cached_property
  318. def screenshot_handle_num(self) -> int:
  319. """
  320. 截屏的句柄其实并不是根句柄
  321. :return: 出错返回None
  322. """
  323. if getattr(self, 'is_desktop_window', False):
  324. return self.root_handle_num
  325. if self.emulator_family == EmulatorFamily.FAMILY_MUMU:
  326. # 使用正则匹配12 来判定是不是mumu12这并不是一个好的方法
  327. name = self.root_node.children[0].name
  328. num = self.root_node.children[0].num
  329. if name == 'MuMuPlayer':
  330. logger.info('The emulator is MuMu模拟器12')
  331. return num
  332. elif name == 'NemuPlayer':
  333. logger.info('The emulator is MuMu模拟器')
  334. return num
  335. elif name == 'MuMuNxDevice':
  336. logger.info('The emulator is MuMu模拟器5.0')
  337. return num
  338. # 夜神
  339. elif self.emulator_family == EmulatorFamily.FAMILY_NOX:
  340. try:
  341. return self.root_node.children[1].children[1].num
  342. except:
  343. return self.root_node.children[2].children[1].num
  344. elif self.emulator_family == EmulatorFamily.FAMILY_LD:
  345. for node in PreOrderIter(self.root_node):
  346. if node.name == Handle.emulator_handle['ld_player_family'][0]:
  347. return node.num
  348. elif self.emulator_family == EmulatorFamily.FAMILY_MEMU:
  349. for node in PreOrderIter(self.root_node):
  350. if node.name == Handle.emulator_handle['memu_player_family']:
  351. return node.num
  352. elif self.emulator_family == EmulatorFamily.FAMILY_BLUESTACKS:
  353. for node in PreOrderIter(self.root_node):
  354. if node.name == Handle.emulator_handle['bluestacks_family']:
  355. return node.num
  356. return self.root_node.num
  357. @cached_property
  358. def screenshot_size(self) -> tuple or None:
  359. """
  360. 第一个是width 第二个是heigth
  361. 2023.7.1 在高缩放的设备上应该输出1280X720
  362. :return:
  363. """
  364. if getattr(self, 'is_desktop_window', False):
  365. # 桌面模式固定输出 1280x720(物理目标,与资产 1:1),位图由截图方法缩放得到
  366. return 1280, 720
  367. winRect = GetWindowRect(self.screenshot_handle_num)
  368. scale_rate = window_scale_rate()
  369. width_before: int = winRect[2] - winRect[0] # 右x-左x
  370. height_before: int = winRect[3] - winRect[1] # 下y - 上y 计算高度
  371. width, height = width_before, height_before
  372. if abs((width_before * scale_rate) - 1280) < 5:
  373. width = 1280
  374. if abs((height_before * scale_rate) - 720) < 5:
  375. height = 720
  376. if width is None or height is None:
  377. logger.error(f'Get screenshot size error, width={width}, height={height}')
  378. return None
  379. return width, height
  380. @cached_property
  381. def window_scale_rate(self) -> float:
  382. """
  383. 获取window的系统缩放 一般是1
  384. :return:
  385. """
  386. hDC = GetDC(0)
  387. # 物理上(真实的)的 横纵向分辨率
  388. wReal = GetDeviceCaps(hDC, DESKTOPHORZRES)
  389. hReal = GetDeviceCaps(hDC, DESKTOPVERTRES)
  390. # 缩放后的 分辨率
  391. wAfter = GetSystemMetrics(0)
  392. hAfter = GetSystemMetrics(1)
  393. # print(wReal, wAfter)
  394. return round(wReal / wAfter, 2)
  395. @classmethod
  396. def handle_has_children(cls, hwnd: int, name: str = 'MuMuPlayer12') -> bool:
  397. root_node = WindowNode(name=name, num=hwnd)
  398. Handle.handle_tree(hwnd=hwnd, node=root_node)
  399. handle_depth = WindowNode.get_tree_depth(root_node)
  400. if handle_depth > 1:
  401. logger.info(f'Window handle [{hwnd}] depth: {handle_depth}')
  402. return True
  403. return False
  404. if __name__ == '__main__':
  405. h = Handle(config='oas1')
  406. # logger.info(h.auto_handle_title(h.all_windows()))
  407. # logger.info(h.root_handle_num)
  408. # logger.info(h.emulator_family)