win32gui向Minecraft发送按键后无法释放的问题解决

问题描述 #

使用win32gui向Minecraft窗口发送按键输入，期望在窗口最小化或失焦时仍能控制角色移动：按住W键1秒后释放，接着按住A键1秒后释放，等待1秒重复流程。但实际运行时，按键按下后始终无法释放。代码中实际调用的是1、2键（与描述的W、A为笔误），原代码如下：

import time
import win32gui
import win32con

def find_minecraft_window():
    hwnd = None

    def enum_windows_proc(inner_hwnd, lParam):
        nonlocal hwnd
        if "Minecraft" in win32gui.GetWindowText(inner_hwnd):
            hwnd = inner_hwnd
            return False  
        return True  

    try:
        win32gui.EnumWindows(enum_windows_proc, None)
    except Exception as e:
        print(f"Exception during window enumeration: {e}")
    return hwnd

def is_window_valid(hwnd):
    return win32gui.IsWindow(hwnd)

def hold_key(hwnd, key, duration):
    if not is_window_valid(hwnd):
        raise ValueError("Invalid window handle")

    try:
        win32gui.SendMessage(hwnd, win32con.WM_KEYDOWN, key, 0)
        time.sleep(duration)
        win32gui.SendMessage(hwnd, win32con.WM_KEYUP, key, 0)
        time.sleep(0.5)  # Small delay to ensure the game registers the key release
    except Exception as e:
        print(f"Exception during key press: {e}")

def main():
    print("Starting Minecraft key press script...")
    hwnd = find_minecraft_window()
    if hwnd is None:
        print("Minecraft window not found!")
        return

    print(f"Minecraft window found: {hwnd}")

    try:
        while True:
            # Validate window handle before each key press
            if not is_window_valid(hwnd):
                print("Window handle became invalid, trying to find Minecraft window again.")
                hwnd = find_minecraft_window()
                if hwnd is None:
                    print("Minecraft window not found!")
                    return

            # hold 'W' for 2 seconds, then 'A' for 1 second
            hold_key(hwnd, ord('1'), 1)
            hold_key(hwnd, ord('2'), 1)

            # Restart loop
            time.sleep(1)  

    except KeyboardInterrupt:
        print("Script stopped by user.")

if __name__ == "__main__":
    main()

问题原因 #

1. WM_KEYDOWN/WM_KEYUP参数不完整：原代码中发送消息时最后一个参数lParam直接传0，而该参数包含按键扫描码、重复次数、状态标志等关键信息，Minecraft这类游戏依赖这些信息识别按键释放动作。
2. 窗口消息的局限性：SendMessage发送的窗口消息，在窗口失焦或最小化时，可能被游戏的输入过滤逻辑忽略，无法触发正确的按键状态切换。

修复方案 #

方案一：正确构造lParam参数 #

按照Windows消息规范构造lParam，确保游戏能识别按键的按下与释放：

import time
import win32gui
import win32con
import win32api

def find_minecraft_window():
    hwnd = None
    def enum_windows_proc(inner_hwnd, lParam):
        nonlocal hwnd
        if "Minecraft" in win32gui.GetWindowText(inner_hwnd):
            hwnd = inner_hwnd
            return False
        return True
    try:
        win32gui.EnumWindows(enum_windows_proc, None)
    except Exception as e:
        print(f"枚举窗口异常: {e}")
    return hwnd

def get_key_lparam(key_down, key_char):
    key_code = ord(key_char)
    repeat_count = 0
    scan_code = win32api.MapVirtualKey(key_code, 0)
    extended = 0
    context_code = 0
    previous_state = 0 if key_down else 1
    transition_state = 0 if key_down else 1
    # 按Windows消息规范拼接lParam
    lParam = repeat_count | (scan_code << 16) | (extended << 24) | (context_code << 29) | (previous_state << 30) | (transition_state << 31)
    return lParam

def hold_key(hwnd, key_char, duration):
    if not win32gui.IsWindow(hwnd):
        raise ValueError("无效窗口句柄")
    try:
        # 发送带正确参数的WM_KEYDOWN
        win32gui.SendMessage(hwnd, win32con.WM_KEYDOWN, ord(key_char), get_key_lparam(True, key_char))
        time.sleep(duration)
        # 发送带正确参数的WM_KEYUP
        win32gui.SendMessage(hwnd, win32con.WM_KEYUP, ord(key_char), get_key_lparam(False, key_char))
        time.sleep(0.1)
    except Exception as e:
        print(f"按键操作异常: {e}")

def main():
    print("启动Minecraft按键脚本...")
    hwnd = find_minecraft_window()
    if hwnd is None:
        print("未找到Minecraft窗口!")
        return
    print(f"找到Minecraft窗口: {hwnd}")
    
    try:
        while True:
            if not win32gui.IsWindow(hwnd):
                print("窗口句柄失效，重新查找Minecraft窗口...")
                hwnd = find_minecraft_window()
                if hwnd is None:
                    print("未找到Minecraft窗口!")
                    return
            # 替换为W、A键，对应描述逻辑
            hold_key(hwnd, 'W', 1)
            hold_key(hwnd, 'A', 1)
            time.sleep(1)
    except KeyboardInterrupt:
        print("用户终止脚本")

if __name__ == "__main__":
    main()

方案二：改用SendInput模拟硬件输入（更可靠） #

SendInput模拟硬件级输入，对游戏类窗口兼容性更强，即使窗口失焦也能生效（注意：部分游戏可能有反作弊机制，使用前需确认）：

import time
import win32api
import win32con
import win32gui

def find_minecraft_window():
    hwnd = None
    def enum_windows_proc(inner_hwnd, lParam):
        nonlocal hwnd
        if "Minecraft" in win32gui.GetWindowText(inner_hwnd):
            hwnd = inner_hwnd
            return False
        return True
    try:
        win32gui.EnumWindows(enum_windows_proc, None)
    except Exception as e:
        print(f"枚举窗口异常: {e}")
    return hwnd

def hold_key_input(key_code, duration):
    # 构造按键按下事件
    down_event = win32api.INPUT(
        win32con.INPUT_KEYBOARD,
        win32api.KEYBDINPUT(key_code, 0, 0, 0, 0)
    )
    # 构造按键释放事件
    up_event = win32api.INPUT(
        win32con.INPUT_KEYBOARD,
        win32api.KEYBDINPUT(key_code, 0, win32con.KEYEVENTF_KEYUP, 0, 0)
    )
    # 发送按下动作
    win32api.SendInput(1, down_event, win32api.sizeof(down_event))
    time.sleep(duration)
    # 发送释放动作
    win32api.SendInput(1, up_event, win32api.sizeof(up_event))
    time.sleep(0.1)

def main():
    print("启动Minecraft按键脚本...")
    hwnd = find_minecraft_window()
    if hwnd is None:
        print("未找到Minecraft窗口!")
        return
    print(f"找到Minecraft窗口: {hwnd}")
    
    try:
        while True:
            if not win32gui.IsWindow(hwnd):
                print("窗口句柄失效，重新查找Minecraft窗口...")
                hwnd = find_minecraft_window()
                if hwnd is None:
                    print("未找到Minecraft窗口!")
                    return
            # VK_W=0x57，VK_A=0x41，对应W、A键
            hold_key_input(0x57, 1)
            hold_key_input(0x41, 1)
            time.sleep(1)
    except KeyboardInterrupt:
        print("用户终止脚本")

if __name__ == "__main__":
    main()

关键说明 #

• 原代码中ord('1')/ord('2')对应数字键，若要实现W、A键，需替换为ord('W')/ord('A')或虚拟键码0x57/0x41。
• 使用SendInput时无需依赖窗口句柄，但部分游戏可能要求窗口处于前台，可添加win32gui.SetForegroundWindow(hwnd)实现窗口置顶。
• 建议以管理员权限运行脚本，避免权限不足导致输入失效。

内容的提问来源于stack exchange，提问作者Makatina