.NET 8 + Avalonia下Windows全局Win+S快捷键实现问题

我正在开发一款受Contexts启发的应用切换器，使用.NET 8 + Avalonia框架，目前在实现全局键盘快捷键时遇到问题。我希望通过按下Win+S组合键激活程序，但当前实现偶尔生效，多数情况下会弹出开始菜单。

现有实现代码如下：

using System;
using System.Diagnostics;
using System.Reactive;
using System.Reactive.Linq;
using System.Reactive.Subjects;
using System.Runtime.InteropServices;

namespace WindowSwitcher.Services.Keyboard;

public class KeyboardInterceptor2 : IKeyboardInterceptor
{
    private const int WhKeyboardLl = 13;
    private const int WmKeydown = 0x0100;
    private const int WmSyskeydown = 0x0104;
    private const int WmKeyup = 0x0101;
    private const int WmSyskeyup = 0x0105;

    private readonly Subject<Unit> _signalSubject = new();
    private readonly IntPtr _hookId;
    private bool _consumeNextWinKeyUp;

    public IObservable<Unit> Signal => _signalSubject.AsObservable();

    public KeyboardInterceptor2()
    {
        _hookId = SetHook(HookCallback);
    }

    private IntPtr SetHook(LowLevelKeyboardProc proc)
    {
        using var curProcess = Process.GetCurrentProcess();
        using var curModule = curProcess.MainModule!;

        return SetWindowsHookEx(WhKeyboardLl, proc, GetModuleHandle(curModule.ModuleName), 0);
    }

    private IntPtr HookCallback(int nCode, IntPtr wParam, IntPtr lParam)
    {
        if (nCode >= 0)
        {
            int vkCode = Marshal.ReadInt32(lParam);

            if (wParam == WmKeydown || wParam == WmSyskeydown)
            {
                if (vkCode == (int)VirtualKeyStates.VkS)
                {
                    if ((GetAsyncKeyState(VirtualKeyStates.VkLwin) & 0x8000) != 0 ||
                        (GetAsyncKeyState(VirtualKeyStates.VkRwin) & 0x8000) != 0)
                    {
                        _signalSubject.OnNext(Unit.Default);
                        _consumeNextWinKeyUp = true;
                        return 1; // Consume the S key press when Windows key is pressed
                    }
                }
            }
            else if (wParam == WmKeyup || wParam == WmSyskeyup)
            {
                if ((vkCode == (int)VirtualKeyStates.VkLwin || vkCode == (int)VirtualKeyStates.VkRwin) && _consumeNextWinKeyUp)
                {
                    _consumeNextWinKeyUp = false;
                    return 1; // Consume the Windows key up event
                }
            }
        }

        return CallNextHookEx(_hookId, nCode, wParam, lParam);
    }

    public void Dispose()
    {
        UnhookWindowsHookEx(_hookId);
        _signalSubject.Dispose();
    }

    private delegate IntPtr LowLevelKeyboardProc(int nCode, IntPtr wParam, IntPtr lParam);

    [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = true)]
    private static extern IntPtr SetWindowsHookEx(int idHook, LowLevelKeyboardProc lpfn, IntPtr hMod, uint dwThreadId);

    [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = true)]
    [return: MarshalAs(UnmanagedType.Bool)]
    private static extern bool UnhookWindowsHookEx(IntPtr hhk);

    [DllImport("user32.dll", CharSet = CharSet.Auto, SetLastError = true)]
    private static extern IntPtr CallNextHookEx(IntPtr hhk, int nCode, IntPtr wParam, IntPtr lParam);

    [DllImport("kernel32.dll", CharSet = CharSet.Auto, SetLastError = true)]
    private static extern IntPtr GetModuleHandle(string lpModuleName);

    [DllImport("user32.dll")]
    private static extern short GetAsyncKeyState(VirtualKeyStates nVirtKey);

    private enum VirtualKeyStates
    {
        VkLwin = 0x5B,
        VkRwin = 0x5C,
        VkS = 0x53
    }
}

我猜测可能存在同步问题，曾考虑用两个Observable分别监控按键状态，同时触发时发送信号。也尝试过GlobalHotKey库，但在.NET 8下Key类不可用，即使将TargetFramework设为net8.0-windows也无效。请问最佳实现方案是什么？Avalonia是否有内置相关功能？已知InputManager已被标记为内部类无法使用。

问题根源 #

当前实现的核心问题：

• 仅拦截S键按下事件，Win键的按下信号仍会传递给系统，触发开始菜单
• 使用GetAsyncKeyState判断Win键状态存在时序误差，可能在S键触发时Win键状态未被系统完全记录

修复现有钩子实现 #

修改钩子回调逻辑，同时拦截Win键的按下/释放事件，确保组合键触发时系统不会收到Win键的独立信号：

private bool _winKeyPressed = false;

private IntPtr HookCallback(int nCode, IntPtr wParam, IntPtr lParam)
{
    if (nCode >= 0)
    {
        int vkCode = Marshal.ReadInt32(lParam);
        bool isKeyDown = wParam == WmKeydown || wParam == WmSyskeydown;
        bool isKeyUp = wParam == WmKeyup || wParam == WmSyskeyup;

        // 跟踪并拦截Win键的按下/释放
        if ((vkCode == (int)VirtualKeyStates.VkLwin || vkCode == (int)VirtualKeyStates.VkRwin))
        {
            if (isKeyDown)
            {
                _winKeyPressed = true;
                return 1; // 拦截Win键按下，避免触发开始菜单
            }
            else if (isKeyUp)
            {
                _winKeyPressed = false;
                return 1; // 拦截Win键释放，确保组合键完全被消费
            }
        }

        // 处理Win+S组合键
        if (isKeyDown && vkCode == (int)VirtualKeyStates.VkS && _winKeyPressed)
        {
            _signalSubject.OnNext(Unit.Default);
            return 1; // 拦截S键按下
        }
    }

    return CallNextHookEx(_hookId, nCode, wParam, lParam);
}

Avalonia相关方案 #

Avalonia目前没有内置全局快捷键API，InputManager为内部类无法直接使用：

• 若仅需窗口激活时响应快捷键，可使用Window的KeyDown事件，但不满足全局需求
• 针对跨平台场景，Windows用上述钩子方案，macOS可使用CGEventTap，Linux可基于X11或libinput实现对应逻辑

替代库方案 #

不想手动实现钩子的话，可尝试适配.NET 8的第三方库：

• WindowsInput: 支持全局键盘钩子与输入模拟，适配.NET 8，可直接监听Win+S组合键
• GlobalHotkey: 升级到最新版本，或手动修改库代码，用VirtualKey枚举替代失效的Key类

注意事项 #

• 全局键盘钩子需足够权限，建议以管理员身份运行测试
• 钩子回调逻辑需简洁，避免阻塞影响系统键盘响应
• 程序退出时务必释放钩子资源，防止内存泄漏

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