在Unity里面使用user32.dll

· 2025-10-13 · # 知识积累 # Unity # 知识库

在 Unity 中，user32.dll 主要用于调用 Windows 系统级的用户界面功能，以实现 Unity 自身 API 不直接支持的系统交互需求（如控制窗口、全局热键、系统消息拦截等）。由于 user32.dll 是 Windows 特有的系统文件，因此相关功能仅适用于 Windows 平台的 Unity 程序（PC standalone 版本）。

核心使用场景

在 Unity 中调用 user32.dll 通常用于解决以下需求：

控制 Unity 程序窗口（如修改大小、位置、标题、窗口样式等）；
监听全局热键（即使 Unity 窗口不在焦点状态也能响应）；
获取系统级输入信息（如全局鼠标位置、键盘状态）；
调用 Windows 标准对话框（如文件选择框、消息框）；
拦截或处理 Windows 系统消息（如窗口最小化、屏幕分辨率变化）。

调用方式：通过 P/Invoke 实现

Unity 使用 C# 作为主要脚本语言，而 C# 可以通过 P/Invoke（Platform Invocation Services） 机制调用原生 DLL 中的函数。调用 user32.dll 时，需用 [DllImport] 特性声明函数签名，再在脚本中直接调用。

实用示例代码

以下是 Unity 中调用 user32.dll 的常见场景示例：

1. 显示 Windows 消息框（MessageBox）

最简单的示例，调用 user32.dll 的 MessageBox 函数弹出系统级消息框（区别于 Unity 的 UnityEngine.Debug.Log）：

using System;
using System.Runtime.InteropServices;
using UnityEngine;

public class User32Example : MonoBehaviour
{
    // 声明 user32.dll 中的 MessageBox 函数
    [DllImport("user32.dll", CharSet = CharSet.Unicode)]
    private static extern int MessageBox(IntPtr hWnd, string text, string caption, uint type);

    void Start()
    {
        // 调用消息框：标题为"提示"，内容为"来自 user32.dll 的消息"，按钮为 OK
        MessageBox(IntPtr.Zero, "来自 user32.dll 的消息", "提示", 0);
    }
}

2. 控制 Unity 程序窗口位置和大小

通过 FindWindow 获取 Unity 窗口句柄，再用 MoveWindow 调整窗口位置和大小：

using System.Runtime.InteropServices;
using UnityEngine;

public class WindowController : MonoBehaviour
{
    // 获取窗口句柄（根据窗口标题）
    [DllImport("user32.dll", CharSet = CharSet.Unicode)]
    private static extern IntPtr FindWindow(string lpClassName, string lpWindowName);

    // 移动/调整窗口（x,y 为左上角坐标；width,height 为宽高；bRepaint 是否重绘）
    [DllImport("user32.dll")]
    private static extern bool MoveWindow(IntPtr hWnd, int x, int y, int nWidth, int nHeight, bool bRepaint);

    void Start()
    {
        // 获取 Unity 窗口句柄（窗口标题默认为项目名，可在 PlayerSettings 中修改）
        string windowTitle = "MyUnityGame"; // 替换为你的游戏窗口标题
        IntPtr hWnd = FindWindow(null, windowTitle);

        if (hWnd != IntPtr.Zero)
        {
            // 将窗口移动到屏幕 (100, 100) 位置，大小设为 800x600
            MoveWindow(hWnd, 100, 100, 800, 600, true);
        }
        else
        {
            Debug.LogError("未找到 Unity 窗口！");
        }
    }
}

3. 注册全局热键（即使窗口不在焦点也能响应）

通过 RegisterHotKey 注册全局热键，配合 WndProc 消息回调处理热键触发：

using System;
using System.Runtime.InteropServices;
using UnityEngine;

public class GlobalHotkey : MonoBehaviour
{
    // 注册热键
    [DllImport("user32.dll")]
    private static extern bool RegisterHotKey(IntPtr hWnd, int id, uint fsModifiers, uint vk);

    // 注销热键
    [DllImport("user32.dll")]
    private static extern bool UnregisterHotKey(IntPtr hWnd, int id);

    // Windows 消息处理（需通过回调捕获）
    private delegate IntPtr WndProc(IntPtr hWnd, uint msg, IntPtr wParam, IntPtr lParam);
    
    [DllImport("user32.dll")]
    private static extern IntPtr SetWindowLongPtr(IntPtr hWnd, int nIndex, WndProc dwNewLong);

    private IntPtr hWnd;
    private WndProc wndProcDelegate;
    private const int HOTKEY_ID = 1; // 热键ID（自定义）
    private const uint WM_HOTKEY = 0x0312; // 热键消息ID

    void Start()
    {
        // 获取当前窗口句柄
        hWnd = FindWindow(null, Application.productName);

        // 注册热键：Ctrl + F1（fsModifiers=2 表示 Ctrl，vk=112 表示 F1）
        bool success = RegisterHotKey(hWnd, HOTKEY_ID, 2, 112);
        if (!success)
        {
            Debug.LogError("热键注册失败！");
            return;
        }

        // 注册消息回调（监听热键触发）
        wndProcDelegate = new WndProc(WndProcCallback);
        SetWindowLongPtr(hWnd, -4, wndProcDelegate); // -4 表示设置窗口过程函数
    }

    // 消息回调函数
    private IntPtr WndProcCallback(IntPtr hWnd, uint msg, IntPtr wParam, IntPtr lParam)
    {
        if (msg == WM_HOTKEY && wParam.ToInt32() == HOTKEY_ID)
        {
            Debug.Log("全局热键 Ctrl+F1 被触发！");
            // 在这里添加你的逻辑（如暂停游戏、截图等）
        }
        return IntPtr.Zero;
    }

    void OnDestroy()
    {
        // 注销热键（避免内存泄漏）
        UnregisterHotKey(hWnd, HOTKEY_ID);
    }

    // 辅助：获取窗口句柄（复用之前的 FindWindow）
    [DllImport("user32.dll", CharSet = CharSet.Unicode)]
    private static extern IntPtr FindWindow(string lpClassName, string lpWindowName);
}

4. 获取屏幕分辨率和系统参数

通过 GetSystemMetrics 获取系统级参数（如屏幕宽高、任务栏高度等）：

using System.Runtime.InteropServices;
using UnityEngine;

public class SystemInfoGetter : MonoBehaviour
{
    // 获取系统参数（参数 id 对应不同指标）
    [DllImport("user32.dll")]
    private static extern int GetSystemMetrics(int nIndex);

    void Start()
    {
        // SM_CXSCREEN = 0（屏幕宽度，像素）
        int screenWidth = GetSystemMetrics(0);
        // SM_CYSCREEN = 1（屏幕高度，像素）
        int screenHeight = GetSystemMetrics(1);
        // SM_CYCAPTION = 4（窗口标题栏高度）
        int captionHeight = GetSystemMetrics(4);

        Debug.Log($"屏幕分辨率：{screenWidth}x{screenHeight}");
        Debug.Log($"窗口标题栏高度：{captionHeight}px");
    }
}

注意事项

平台限制：
user32.dll 仅存在于 Windows 系统，因此相关代码必须用 #if UNITY_STANDALONE_WIN 包裹，避免在其他平台（如 Mac、Android）编译报错：
```
#if UNITY_STANDALONE_WIN
// 这里放 user32.dll 相关代码
#endif
```
权限问题：
部分函数（如修改系统显示设置）需要管理员权限。在 Unity 中，可通过以下方式配置：
- 打开 PlayerSettings → Windows → Configuration → Execution Level → 选择 Require Administrator。
窗口标题匹配：
FindWindow 函数依赖窗口标题，需确保与 PlayerSettings 中设置的 Product Name 一致（默认与项目名相同）。
版本兼容性：
不同 Windows 版本的 user32.dll 可能存在函数差异（如 Win11 新增的高 DPI 相关函数），需在目标系统上测试。
替代方案优先：
能用 Unity 自身 API 实现的功能（如 Screen.width 获取屏幕宽、Input.mousePosition 获取鼠标位置），优先使用 Unity API，减少对系统 DLL 的依赖。

通过合理使用 user32.dll，可以为 Unity 程序添加更深度的 Windows 系统交互能力，但需注意控制使用范围，避免过度依赖导致跨平台兼容性问题。