Python3实现全局热键注册：基于win32con与多线程的核心源码解析

Python3全局热键实现方案概述

此前在利用Python3开发游戏自动化脚本的过程中，尝试了多种技术方案，最终形成了一套较为完整的解决思路。在此简要分享其中的核心设计逻辑。

游戏辅助工具开发核心思路

关于游戏辅助工具的界面设计环节：

无需引入PyQt等大型GUI框架，开发轻量级小工具时，使用Python自带的tkinter即可满足需求。值得注意的是，这并非要求完全手动编写代码，而是可以通过可视化拖拽方式生成界面。或许你尚未了解到，tkinter配合特定工具也能像VB一样通过拖拽生成代码？

推荐尝试PAGE这款工具。

针对游戏辅助应用的分发与发布环节：

推荐使用pyinstaller将程序打包为32位exe文件进行发布。在此过程中，添加程序图标和版本信息等操作均十分简便。

在游戏核心功能模拟环节：

这同样不依赖纯手工编码，而是通过调用市场上成熟的DLL插件来实现。例如，可以使用大漠插件或乐玩插件等COM组件；或者将易语言编写的模块编译为windll进行调用。

全局热键注册原理与封装实现

在辅助窗体的热键注册环节：

此部分涉及底层系统调用，需借助win32相关接口实现全局热键注册。其原理是：创建一个独立线程用于监听热键按下事件，当检测到热键被按下时，再开辟新的线程来执行相应的功能逻辑。鉴于原生API实现较为复杂，本人对此进行了封装并编写了演示Demo。该方案支持注册全局组合键及独立热键，均能正常工作。

前三个方面的实现思路因人而异，但关于热键注册部分，为避免日后遗忘，此处直接提供核心源代码。

以下展示一段较新的代码实现：

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
# File : 简单热键.py
# Author: DaShenHan&道长-----先苦后甜，任凭晚风拂柳颜------
# Date : 2020/3/4
 
import win32con
import ctypes
import ctypes.wintypes
from threading import Thread,activeCount, enumerate
from time import sleep,time
 
class Hotkey(Thread):
  user32 = ctypes.windll.user32
  hkey_list = {}
  hkey_flags = {} #按下
  hkey_running = {} #启停
  _reg_list = {} #待注册热键信息
 
  def regiskey(self, hwnd=None, flagid=0, fnkey=win32con.MOD_ALT, vkey=win32con.VK_F9): # 注册热键，默认一个alt+F9
    return self.user32.RegisterHotKey(hwnd, flagid, fnkey, vkey)
 
  def get_reginfo(self):
    return self._reg_list
 
  def get_id(self,func):
    self_id = None
    for id in self.get_reginfo():
      if self.get_reginfo()[id]["func"] == func:
        self_id = id
        break
    if self_id:
      self.hkey_running[self_id] = True
    return self_id
 
  def get_running_state(self,self_id):
    if self.hkey_running.get(self_id):
      return self.hkey_running[self_id]
    else:
      return False
 
  def reg(self,key,func,args=None):
    id = int(str(round(time()*10))[-6:])
    fnkey = key[0]
    vkey = key[1]
    info = {
      "fnkey":fnkey,
      "vkey":vkey,
      "func":func,
      "args":args
    }
    self._reg_list[id] = info
    # print(info) #这里待注册的信息
    sleep(0.1)
    return id
 
  def fast_reg(self,id,key = (0,win32con.VK_HOME),func = lambda:print('热键注册开始')):
    if not self.regiskey(None, id, key[0], key[1]):
      print("热键注册失败")
      return None
    self.hkey_list[id] = func
    self.hkey_flags[id] = False
    return id
 
  def callback(self):
    def inner(self = self):
      for flag in self.hkey_flags:
        self.hkey_flags[flag] = False
 
      while True:
        for id, func in self.hkey_list.items():
          if self.hkey_flags[id]:
            args = self._reg_list[id]["args"]
            if args:
              # print(args)  #这里打印传入给注册函数的参数
              thread_it(func,*args)
            else:
              thread_it(func)
            self.hkey_flags[id] = False
    return inner
 
  def run(self):
    for id in self._reg_list:
      reg_info = self._reg_list[id]
      fnkey = reg_info["fnkey"]
      vkey = reg_info["vkey"]
      func = reg_info["func"]
      self.fast_reg(id,(fnkey, vkey), func)
 
    fn = self.callback()
    thread_it(fn) # 启动监听热键按下线程
 
    try:
      msg = ctypes.wintypes.MSG()
      while True:
        if self.user32.GetMessageA(ctypes.byref(msg), None, 0, 0) != 0:
          if msg.message == win32con.WM_HOTKEY:
            if msg.wParam in self.hkey_list:
              self.hkey_flags[msg.wParam] = True
          self.user32.TranslateMessage(ctypes.byref(msg))
          self.user32.DispatchMessageA(ctypes.byref(msg))
    finally:
      for id in self.hkey_list:
        self.user32.UnregisterHotKey(None, id)
 
def thread_it(func, *args):
  t = Thread(target=func, args=args)
  t.setDaemon(True)
  t.start()
 
def jump(func,hotkey):
  self_id = hotkey.get_id(func)
  while hotkey.get_running_state(self_id):
    print(f"{self_id : } 你正在1秒1次的跳动")
    sleep(1)
 
def stop_jump(start_id,hotkey):
  hotkey.hkey_running[start_id] = False
  print(f"{start_id} 即将停止")
  sleep(1)
  print(f'当前线程列表:{activeCount()}', enumerate())
 
def main():
  hotkey = Hotkey()
  start_id = hotkey.reg(key = (win32con.MOD_ALT,win32con.VK_HOME),func=jump,args=(jump,hotkey)) #alt home键 开始
  hotkey.reg(key = (0,win32con.VK_END),func=stop_jump,args=(start_id,hotkey)) #alt end键 结束
  hotkey.start() #启动热键主线程
 
  print(f"当前总线程数量:{activeCount()}")
  print('当前线程列表:', enumerate())
  print('热键注册初始化完毕，尝试按组合键alt+Home 或者单键END看效果')
 
if __name__ == '__main__':
  main()

以下是较早版本的代码，使用相对繁琐。

#!/usr/bin/env python3
# _*_ coding: utf-8 _*_
# File : demo.py
# Author: DaShenHan&道长-----先苦后甜，任凭晚风拂柳颜------
# Date : 2019/6/28
 
import win32con
import ctypes
import ctypes.wintypes
from threading import Thread, Timer, activeCount, enumerate
from time import sleep
h_ids = [i for i in range(2)] # 创建两个热键序列
h_keys = {i: False for i in h_ids} # 初始化所有热键序列的标志符为False
h_dict = {} # 初始化一个空的字典，记录id与func
 
 
class Hotkey(Thread): # 创建一个Thread的扩展类
  user32 = ctypes.windll.user32 # 加载user32.dll
  # global h_ids, h_keys,h_dict
 
  def regiskey(self, hwnd=None, flagid=0, fnkey=win32con.MOD_ALT, vkey=win32con.VK_F9): # 注册热键，默认一个alt+F9
    return self.user32.RegisterHotKey(hwnd, flagid, fnkey, vkey)
 
  def callback(self, id, func):
    h_dict[id] = func # 这个id对应这个func，没有就是新增，有就是修改
 
    def inner():
      for key, value in h_dict.items():
        print(f'总的热键池:{h_ids},当前热键序号:{key}, 当前热键功能:{value}，当前热键状态:{h_keys[h_ids[key]]}')
      while True:
        for key, value in h_dict.items():
          if h_keys[h_ids[key]]:
            thread_it(value) # 另外开线程执行value
            h_keys[h_ids[key]] = False
    return inner
 
  def run(self):
    # print(self.user32)
    if not self.regiskey(None,h_ids[0],win32con.MOD_ALT,win32con.VK_F9):  # 注册快捷键alt+F9并判断是否成功，该热键用于执行一次需要执行的内容。
      print(f"热键注册失败！ id{h_ids[0]}") # 返回一个错误信息
    if not self.regiskey(None,h_ids[1],0,win32con.VK_F10):  # 注册快捷键F10并判断是否成功，该热键用于结束程序，且最好这么结束，否则影响下一次注册热键。
      print(f"热键注册失败！ id{h_ids[1]}")
 
    # 以下为检测热键是否被按下，并在最后释放快捷键
    try:
      msg = ctypes.wintypes.MSG()
      while True:
        if self.user32.GetMessageA(ctypes.byref(msg), None, 0, 0) != 0:
          if msg.message == win32con.WM_HOTKEY:
            if msg.wParam in h_ids:
              h_keys[msg.wParam] = True
          self.user32.TranslateMessage(ctypes.byref(msg))
          self.user32.DispatchMessageA(ctypes.byref(msg))
    finally:
      for i in h_ids:
        self.user32.UnregisterHotKey(None, i)
        # 必须得释放热键，否则下次就会注册失败，所以当程序异常退出，没有释放热键，
        # 那么下次很可能就没办法注册成功了，这时可以换一个热键测试
 
 
def thread_it(func, *args):
  t = Thread(target=func, args=args)
  t.setDaemon(True)
  t.start()
 
 
def settimeout(func, sec):
  def inner():
    func()
    Timer(sec, inner).start()
 
  thread_it(inner)
 
 
def setinterval(func, sec, tmrname, flag=True):
  global timer_dict
  timer_dict[tmrname] = flag
  print("已设置tqtimer启用状态为:{}".format(flag))
 
  def inner():
    global timer_dict
    if timer_dict[tmrname]:
      func()
      Timer(sec, inner).start()
 
  thread_it(inner)
 
 
def clearinterval(timername):
  global timer_dict
  timer_dict[timername] = False
  flag = timer_dict[timername]
  print("已设置tqtimer启用状态为:{}".format(flag))
 
 
def test_start():
  print("按下了开始键...the programe is running")
 
 
def test_stop():
  print("按下了停止键...the programe is stopped")
 
 
def run_ok():
  hotkey = Hotkey()
  hotkey.start()
  fn = hotkey.callback(0, test_start)
  fn = hotkey.callback(1, test_stop)
  thread_it(fn)
  sleep(0.5)
  count = activeCount()
  print(f"当前总线程数量:{count}")
  print('当前线程列表:', enumerate())
  print('热键注册初始化完毕，尝试按组合键alt+F9 或者单键F10看效果')
  while True:
    pass
 
 
if __name__ == '__main__':
  run_ok()

由于此处未涉及界面开发，因此采用主线程死循环阻塞的方式运行。程序启动后，按下Alt+F9会打印“按下了开始键”，按下F10则会打印“按下了停止键”。

若将该逻辑嵌入tkinter程序中，只需删除run_ok函数末尾的while True:pass语句，并在init函数内部调用run_ok()即可。此处特指使用PAGE工具设计的tkinter程序场景。

如此，窗体创建完成后会自动阻塞主线程，而负责监控热键的线程则随主线程结束而终止。在启动阶段，各线程独立运行，互不干扰。

至此，关于Python3注册全局热键的实现介绍完毕。如需了解更多Python3注册全局热键的相关内容，建议搜索本站历史文章或继续浏览后续相关文章，感谢大家的支持！