Unity Windows平台：通过WinProc钩子实现窗口比例锁定与全屏适配

1. Windows平台下Unity窗口比例锁定的必要性

在开发Windows平台的Unity应用时，经常会遇到需要固定窗口比例的需求。比如开发教育类软件时，课件内容通常按照16:9或4:3的比例设计；开发游戏模拟器时，需要保持原始游戏机的显示比例。如果允许用户随意拉伸窗口，就会导致内容变形失真。

传统的Unity窗口控制方法存在明显局限。直接使用Screen.SetResolution()虽然可以设置分辨率，但无法阻止用户手动拖拽窗口改变比例。而通过Player Settings设置Supported Aspect Ratios只能限制全屏模式下的比例，对窗口模式无效。

我在实际项目中就遇到过这样的问题：一个化学实验模拟软件要求严格保持4:3的显示比例，但测试时发现用户通过拖拽窗口边框就能破坏这个比例，导致烧杯、试管等实验器材看起来被压扁或拉长，严重影响使用体验。

2. WinProc消息钩子技术解析

2.1 Windows消息机制基础

Windows操作系统采用消息驱动机制，所有用户操作都会转化为消息发送给应用程序。比如当用户调整窗口大小时，系统会发送WM_SIZING消息；移动窗口时发送WM_MOVING消息。应用程序通过窗口过程(Window Procedure，简称WinProc)函数来处理这些消息。

在Unity中，虽然引擎已经封装了大部分窗口管理功能，但我们仍然可以通过钩子(Hook)技术拦截这些底层消息。具体来说，就是替换Unity窗口默认的WinProc函数，插入我们自己的处理逻辑。

2.2 实现消息钩子的关键API

要实现WinProc钩子，需要用到几个关键的Windows API函数：

[DllImport("user32.dll", EntryPoint = "SetWindowLongPtr", CharSet = CharSet.Auto)] private static extern IntPtr SetWindowLongPtr64(IntPtr hWnd, int nIndex, IntPtr dwNewLong); [DllImport("user32.dll")] private static extern IntPtr CallWindowProc(IntPtr lpPrevWndFunc, IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam);

SetWindowLongPtr用于替换窗口过程，CallWindowProc用于调用原始窗口过程。这里需要注意32位和64位系统的兼容性问题，需要根据IntPtr.Size选择正确的API变体。

3. Unity中实现比例锁定的完整方案

3.1 核心实现步骤

完整的实现流程可以分为以下几个步骤：

1. 获取Unity窗口句柄：通过EnumThreadWindows枚举当前线程的所有窗口，根据类名"UnityWndClass"找到目标窗口
2. 计算窗口边框尺寸：使用GetWindowRect和GetClientRect的差值确定边框和标题栏的像素大小
3. 替换窗口过程：保存原始窗口过程指针，设置新的处理函数
4. 处理WM_SIZING消息：根据拖拽方向计算符合比例的新尺寸
5. 全屏模式适配：切换全屏时自动计算最大可用分辨率并保持比例

3.2 关键代码解析

处理WM_SIZING消息的核心逻辑如下：

if (msg == WM_SIZING) { RECT rc = (RECT)Marshal.PtrToStructure(lParam, typeof(RECT)); // 去除边框计算客户区大小 rc.Right -= borderWidth; rc.Bottom -= borderHeight; // 根据拖拽方向调整尺寸 switch (wParam.ToInt32()) { case WMSZ_LEFT: rc.Left = rc.Right - newWidth; rc.Bottom = rc.Top + Mathf.RoundToInt(newWidth / aspect); break; // 其他方向处理... } // 添加回边框并更新窗口 rc.Right += borderWidth; rc.Bottom += borderHeight; Marshal.StructureToPtr(rc, lParam, true); }

这段代码首先从消息参数中提取窗口矩形，去除边框后根据当前拖拽方向（左、右、上、下等）和预设比例计算新尺寸，最后再添加回边框并更新窗口。

4. 全屏模式下的黑边适配策略

4.1 比例不匹配时的处理

当显示器比例与程序设定比例不一致时，直接全屏会导致图像拉伸变形。正确的做法是保持内容比例，在两侧或上下添加黑边。这类似于电影中常见的"信箱模式"。

实现时需要先比较显示器比例和程序比例：

bool blackBarsLeftRight = aspect < (float)pixelWidthOfCurrentScreen / pixelHeightOfCurrentScreen; if (blackBarsLeftRight) { height = pixelHeightOfCurrentScreen; width = Mathf.RoundToInt(pixelHeightOfCurrentScreen * aspect); } else { width = pixelWidthOfCurrentScreen; height = Mathf.RoundToInt(pixelWidthOfCurrentScreen / aspect); } Screen.SetResolution(width, height, true);

4.2 多显示器环境考虑

在多显示器环境下，还需要注意：

1. 获取当前所在显示器的分辨率，而不是主显示器
2. 窗口移动到不同显示器时，要更新pixelWidthOfCurrentScreen等参数
3. 全屏切换时应该使用当前显示器的最大分辨率

可以通过Screen.currentResolution获取当前显示器的信息，并在窗口移动消息(WM_MOVE)中更新相关参数。

5. 实际应用中的注意事项

5.1 编辑器与发布版的区别

在Unity编辑器中运行时，脚本会作用于编辑器窗口本身而不是Game视图。因此需要通过预处理指令隔离编辑器逻辑：

#if !UNITY_EDITOR // 正式版的实现代码 #endif

在编辑器中可以通过监听Screen.width/height的变化来模拟分辨率改变事件。

5.2 常见问题排查

1. 窗口无响应：通常是消息处理不当导致，确保所有消息都传递给原始窗口过程
2. 闪烁或卡顿：检查是否有频繁的SetResolution调用，避免在每帧都修改分辨率
3. 64位系统兼容性问题：确保使用SetWindowLongPtr64而非32位版本

我在一个项目中就遇到过64位系统下窗口偶尔崩溃的问题，最后发现是因为错误地调用了32位API。通过添加IntPtr.Size判断解决了这个问题。

6. 性能优化与扩展功能

6.1 减少不必要的分辨率更改

频繁调用Screen.SetResolution会导致性能开销。可以通过以下优化减少调用次数：

1. 在Update中检查分辨率是否真的需要改变
2. 添加防抖机制，避免快速连续调整
3. 只在WM_SIZING消息或全屏切换时修改分辨率

6.2 扩展功能建议

基于这个基础框架，还可以实现更多实用功能：

1. 动态修改比例：通过公开方法让游戏运行时可以改变锁定比例
2. 记忆窗口位置：在注册表中保存窗口位置和大小，下次启动时恢复
3. 多比例支持：根据内容自动切换不同比例，如视频播放器中的原始比例/全屏切换

我曾经在一个电子书阅读器中实现了动态比例功能，当切换到漫画模式时自动改为4:3，切换到文档模式时改为16:9，大大提升了阅读体验。

7. 完整实现与项目集成

将脚本挂载到场景中的任意GameObject上即可生效。Inspector面板提供了直观的参数配置：

• Allow Fullscreen：是否允许切换到全屏模式
• Aspect Ratio：目标宽高比（如16:9）
• Min/Max Width/Height：窗口最小最大尺寸限制

使用时需要注意：

1. 在Player Settings中启用"Resizable Window"
2. 如果需要全屏支持，确保取消勾选"Fullscreen Window"以外的其他全屏模式
3. 对于不支持的比例，在Supported Aspect Ratios中取消勾选

实际测试发现，这套方案在Windows 10/11上运行稳定，能够完美实现比例锁定需求。对于需要严格保持显示比例的项目，这种WinProc钩子方案是目前最可靠的实现方式。