1. 项目概述为什么需要自定义游戏窗口在Unity开发中尤其是制作独立游戏、工具软件或需要特殊展示效果的项目时默认的游戏视图窗口往往显得“千篇一律”。那个标准的深灰色标题栏、固定的边框以及右上角一成不变的“最大化/最小化/关闭”按钮有时会与游戏的艺术风格格格不入或者无法满足特定的产品需求。比如你想做一个复古风格的像素游戏希望窗口标题栏也变成像素风或者开发一个演示工具需要隐藏所有边框让内容全屏沉浸又或者你需要动态改变窗口的置顶状态就像在Ubuntu中右键标题栏选择“Always on Top”那样。这就是“Unity游戏窗口自定义实现标题栏与边框的动态控制”这个项目的核心价值。它不仅仅是改个颜色那么简单而是深入到操作系统原生窗口的层面去操控那些Unity引擎默认没有暴露给我们的底层属性。通过这个项目你可以实现完全隐藏标题栏和边框创造一个无边框窗口常用于制作启动器、桌面小部件或极简风格应用。自定义标题栏的样式包括图标、文字颜色、按钮样式虽然完全重绘按钮逻辑复杂但可以隐藏后自己用UI模拟。动态控制窗口行为如置顶、改变透明度、设置点击穿透等提升应用的交互灵活性。解决跨平台适配问题因为Windows、macOS、Linux对窗口管理的API差异很大本项目需要处理这些兼容性。简单来说这相当于为你Unity应用的“外壳”赋予了灵魂让它从内到外都符合你的设计预期。接下来我将以一个在Windows平台上实现无边框、可拖拽、可置顶的自定义窗口为例拆解其核心思路、技术实现与避坑指南。2. 核心思路与方案选型P/Invoke是钥匙Unity本身是一个强大的游戏引擎和渲染框架但它对原生窗口的管理功能封装得非常有限主要集中在Screen类的一些基础设置上比如设置分辨率、全屏模式。要实现深度的窗口自定义我们必须绕过Unity直接与操作系统对话。2.1 为什么选择P/Invoke我们的核心武器是P/InvokePlatform Invocation Services。这是一种.NET框架提供的机制允许托管代码我们的C#脚本调用非托管动态链接库DLL中的函数比如Windows的user32.dll、dwmapi.dll。可行性Windows的窗口管理功能查找窗口、修改样式、发送消息都封装在这些系统DLL中。Unity基于.NET/Mono天然支持P/Invoke。必要性Unity没有提供相应的API这是唯一可行的深度控制路径。跨平台考量本方案主要针对Windows。对于macOS需要使用Cocoa的API通过[DllImport(“__Internal”)]调用Objective-C对于Linux如Ubuntu则通常使用Xlib或GTK。本文聚焦Windows实现但会提及跨平台思路的差异。2.2 核心Windows API函数解析要实现自定义我们需要用到几个关键的Windows API函数FindWindow根据类名和窗口标题找到我们游戏窗口的“句柄”HWND。句柄是操作系统识别每个窗口的唯一身份证。GetWindowLong/SetWindowLong这对函数用于获取和设置窗口的“扩展样式”GWL_EXSTYLE和“样式”GWL_STYLE。窗口的边框、标题栏、系统菜单等外观属性都由这些样式位控制。SetWindowPos这个函数功能强大可以设置窗口的位置、大小、Z序置顶/取消置顶等。我们主要用它来实现“窗口置顶”功能。ReleaseCapture/SendMessage当隐藏了标题栏后窗口就无法拖动了。我们需要模拟Windows的窗口拖动机制在用户按下鼠标左键时向窗口发送一个WM_NCLBUTTONDOWN消息并指定点击区域为“标题栏”HTCAPTION这样系统就会接管拖动逻辑。2.3 方案设计流程图逻辑描述整个流程可以概括为以下几步初始化获取句柄在游戏启动后如Start方法中使用FindWindow找到当前游戏窗口的句柄。修改窗口样式使用GetWindowLong获取当前样式通过位操作按位与、按位或|移除代表标准边框和标题栏的样式位如WS_CAPTION,WS_THICKFRAME然后使用SetWindowLong应用新样式。刷新窗口修改样式后必须调用SetWindowPos或发送WM_NCACTIVATE消息来强制窗口重绘否则更改可能不立即生效。实现拖拽功能在自定义的标题栏UI元素上监听鼠标按下事件调用ReleaseCapture然后SendMessage发送WM_NCLBUTTONDOWN消息。实现置顶功能提供一个按钮或开关点击时调用SetWindowPos并传入HWND_TOPMOST或HWND_NOTOPMOST参数来切换置顶状态。注意直接修改窗口样式可能会导致一些副作用例如窗口阴影丢失在Windows 10/11上或者任务栏预览缩略图异常。高级效果如亚克力模糊背景需要调用DWMDesktop Window Manager相关API复杂度更高。3. 核心细节解析与实操要点理解了核心思路我们深入每个环节的细节。这里假设你已经创建了一个Unity项目并准备了一个简单的UI一个作为自定义标题栏的Panel上面有文字、关闭按钮和一个“置顶”切换按钮。3.1 定义P/Invoke接口与Windows对话的桥梁首先我们需要在C#脚本中声明我们要使用的Windows API函数。创建一个名为NativeWindowController.cs的脚本。using System; using System.Runtime.InteropServices; using UnityEngine; public class NativeWindowController : MonoBehaviour { // 窗口句柄 private IntPtr _windowHandle; // 窗口样式常量 private const int GWL_STYLE -16; private const int GWL_EXSTYLE -20; // 窗口样式位 private const uint WS_CAPTION 0x00C00000; // 标题栏 private const uint WS_THICKFRAME 0x00040000; // 可调整大小的边框 private const uint WS_SYSMENU 0x00080000; // 系统菜单关闭按钮等 private const uint WS_MINIMIZEBOX 0x00020000; // 最小化按钮 private const uint WS_MAXIMIZEBOX 0x00010000; // 最大化按钮 // 扩展窗口样式位用于点击穿透等 private const uint WS_EX_LAYERED 0x00080000; private const uint WS_EX_TRANSPARENT 0x00000020; // SetWindowPos 参数 private static readonly IntPtr HWND_TOPMOST new IntPtr(-1); private static readonly IntPtr HWND_NOTOPMOST new IntPtr(-2); private const uint SWP_NOSIZE 0x0001; private const uint SWP_NOMOVE 0x0002; private const uint SWP_NOACTIVATE 0x0010; private const uint SWP_SHOWWINDOW 0x0040; // Windows消息常量 private const int WM_NCLBUTTONDOWN 0xA1; private const int HTCAPTION 2; // 1. 查找窗口 [DllImport(user32.dll)] private static extern IntPtr FindWindow(string lpClassName, string lpWindowName); // 2. 获取/设置窗口样式 [DllImport(user32.dll)] private static extern int GetWindowLong(IntPtr hWnd, int nIndex); [DllImport(user32.dll)] private static extern int SetWindowLong(IntPtr hWnd, int nIndex, int dwNewLong); // 3. 设置窗口位置和Z序用于置顶和刷新 [DllImport(user32.dll)] [return: MarshalAs(UnmanagedType.Bool)] private static extern bool SetWindowPos(IntPtr hWnd, IntPtr hWndInsertAfter, int X, int Y, int cx, int cy, uint uFlags); // 4. 释放鼠标捕获并发送消息用于拖拽 [DllImport(user32.dll)] private static extern bool ReleaseCapture(); [DllImport(user32.dll)] private static extern IntPtr SendMessage(IntPtr hWnd, int Msg, IntPtr wParam, IntPtr lParam); // 初始化获取当前活动窗口的句柄 void Start() { // 注意Unity窗口的类名通常是“UnityWndClass”窗口名是应用产品名。 // 一个更可靠的方法是使用GetActiveWindow但这里用FindWindow。 // 为了通用性可以尝试传入null或Application.productName。 _windowHandle FindWindow(null, Application.productName); if (_windowHandle IntPtr.Zero) { Debug.LogError(无法找到游戏窗口句柄); } else { Debug.Log($成功获取窗口句柄: {_windowHandle}); // 初始时可以应用一次无边框样式 // RemoveWindowBorder(); } } }关键点解析IntPtr用于在C#中表示原生指针这里就是窗口句柄HWND。DllImport属性指定函数来自哪个DLL。user32.dll是Windows用户界面核心库。常量值如WS_CAPTION这些十六进制数字是Windows SDK中定义的宏。我们通过位运算来操作它们。FindWindow参数第一个参数是窗口类名第二个是窗口标题。传入null可以匹配任意类名或标题。使用Application.productName在Player Settings中设置作为标题通常很可靠。3.2 移除边框与标题栏位运算的艺术在NativeWindowController脚本中添加核心方法public void RemoveWindowBorder() { if (_windowHandle IntPtr.Zero) return; // 获取当前窗口样式 int currentStyle GetWindowLong(_windowHandle, GWL_STYLE); // 获取当前扩展样式 int currentExStyle GetWindowLong(_windowHandle, GWL_EXSTYLE); Debug.Log($当前样式: {currentStyle:X}, 当前扩展样式: {currentExStyle:X}); // 移除我们不想要的样式位 // 使用按位与()和取反(~)来清除特定位 int newStyle currentStyle; newStyle ~(int)(WS_CAPTION | WS_THICKFRAME | WS_SYSMENU | WS_MINIMIZEBOX | WS_MAXIMIZEBOX); // 也可以添加一些扩展样式例如让窗口支持透明需要配合SetLayeredWindowAttributes // int newExStyle currentExStyle | (int)WS_EX_LAYERED; // SetWindowLong(_windowHandle, GWL_EXSTYLE, newExStyle); // 应用新的窗口样式 SetWindowLong(_windowHandle, GWL_STYLE, newStyle); Debug.Log($新样式: {newStyle:X}); // 关键步骤强制窗口重绘以应用样式更改 // 使用SetWindowPos并指定SWP_FRAMECHANGED标志0x0020和SWP_SHOWWINDOW等 SetWindowPos(_windowHandle, IntPtr.Zero, 0, 0, 0, 0, SWP_NOACTIVATE | SWP_SHOWWINDOW | SWP_NOMOVE | SWP_NOSIZE | 0x0020); Debug.Log(已移除窗口边框和标题栏。); }实操心得位运算 ~是“清除位”的标准操作。WS_CAPTION | WS_THICKFRAME ...是将多个样式位合并为一个掩码。currentStyle ~mask的结果就是清除了掩码中所有为1的位。立即生效问题仅仅调用SetWindowLong是不够的窗口不会立即重绘非客户区边框、标题栏。必须随后调用SetWindowPos并传入SWP_FRAMECHANGED0x0020标志这是让更改生效的秘诀。副作用移除WS_THICKFRAME后窗口将无法通过拖拽边缘来调整大小。如果你需要调整大小功能需要自己用UI模拟这非常复杂。通常无边框窗口是固定大小的。3.3 实现窗口拖拽模拟标题栏点击现在窗口没有标题栏了我们需要让用户能通过拖拽我们自定义的UI Panel来移动窗口。为你的自定义标题栏Panel添加EventTrigger组件或者在相关脚本中监听鼠标事件。using UnityEngine.EventSystems; // 需要引入命名空间 // 假设这个脚本挂在你的自定义标题栏UI对象上 public class CustomTitleBar : MonoBehaviour, IPointerDownHandler { public NativeWindowController windowController; // 拖拽赋值 public void OnPointerDown(PointerEventData eventData) { // 检查是否是鼠标左键按下 if (eventData.button PointerEventData.InputButton.Left) { StartDragWindow(); } } private void StartDragWindow() { if (windowController ! null) { windowController.DragWindow(); } } }在NativeWindowController中添加拖拽方法public void DragWindow() { if (_windowHandle IntPtr.Zero) return; // 释放Unity可能持有的鼠标捕获 ReleaseCapture(); // 向窗口发送“非客户区鼠标左键按下”消息并指定区域为标题栏 SendMessage(_windowHandle, WM_NCLBUTTONDOWN, (IntPtr)HTCAPTION, IntPtr.Zero); }注意事项ReleaseCapture()至关重要。在Unity的UI事件系统中鼠标可能被EventSystem捕获直接发送拖拽消息可能无效。先释放捕获将控制权交还给系统。这个方法模拟了用户点击原生标题栏的行为因此拖拽的流畅度和效果与原生窗口完全一致。确保你的自定义标题栏UI的Raycast Target是开启的否则无法接收到点击事件。3.4 实现窗口置顶Z序的管理置顶功能相对简单主要依靠SetWindowPos函数和HWND_TOPMOST参数。在NativeWindowController中添加private bool _isTopMost false; public void ToggleWindowTopMost() { if (_windowHandle IntPtr.Zero) return; _isTopMost !_isTopMost; IntPtr hWndInsertAfter _isTopMost ? HWND_TOPMOST : HWND_NOTOPMOST; bool success SetWindowPos(_windowHandle, hWndInsertAfter, 0, 0, 0, 0, SWP_NOACTIVATE | SWP_SHOWWINDOW | SWP_NOMOVE | SWP_NOSIZE); if (success) { Debug.Log($窗口置顶状态已切换为: {_isTopMost}); } else { Debug.LogError(切换窗口置顶状态失败); } }原理说明HWND_TOPMOST将窗口置于所有非置顶窗口之上即使它失去焦点。HWND_NOTOPMOST将窗口放回正常的Z序队列。SWP_NOMOVE | SWP_NOSIZE表示不改变窗口的位置和大小只改变Z序。你可以将此方法绑定到一个UI按钮的点击事件上。4. 实操过程与核心环节实现让我们将上述代码整合到一个完整的、可操作的流程中。假设我们要制作一个简单的“桌面时钟”无边框应用。4.1 项目设置与UI搭建创建新Unity项目任意模板。设置Player SettingsProduct Name设置为“MyCustomWindowApp”。这将是我们FindWindow查找的窗口标题。在Resolution and Presentation下可以选择Windowed模式并设置一个初始分辨率如800x600。搭建UI创建一个Canvas。在Canvas下创建一个Panel命名为TitleBar。设置其锚点在顶部拉伸高度为40。给它一个独特的背景颜色如深蓝色。在TitleBar内添加一个Text显示“My Desktop Clock”。一个Button作为关闭按钮稍后实现功能。一个Toggle作为“置顶”开关标签设为“Always on Top”。在Canvas下再创建一个Panel或Text作为主内容区显示时间。4.2 脚本编写与挂载创建NativeWindowController.cs脚本包含上述所有API声明和方法Start,RemoveWindowBorder,DragWindow,ToggleWindowTopMost。创建CustomTitleBar.cs脚本包含IPointerDownHandler的实现。在场景中创建一个空物体如WindowManager挂载NativeWindowController组件。将TitleBarPanel挂载CustomTitleBar组件。在Inspector中将WindowManager物体拖拽到CustomTitleBar脚本的windowController字段上。为“关闭按钮”编写一个简单的脚本调用Application.Quit()。为“置顶”Toggle的OnValueChanged事件添加监听调用WindowManager上NativeWindowController组件的ToggleWindowTopMost方法。4.3 初始化与样式应用在NativeWindowController的Start方法中我们获取句柄后可以立即应用无边框样式。但更好的做法是提供一个控制开关。void Start() { _windowHandle FindWindow(null, Application.productName); if (_windowHandle IntPtr.Zero) { // 备选方案有时标题可能带有“(Unity)”后缀可以尝试带后缀查找 _windowHandle FindWindow(null, Application.productName (Unity)); if (_windowHandle IntPtr.Zero) { Debug.LogError(无法找到游戏窗口句柄); return; } } // 默认启动时移除边框 RemoveWindowBorder(); // 可选初始化置顶状态为false _isTopMost false; }现在运行游戏你应该会看到一个没有标准标题栏和边框的窗口。你可以拖拽我们自定义的深蓝色标题栏来移动窗口点击Toggle可以切换置顶状态。4.4 添加关闭与最小化按钮模拟原生标题栏被移除后关闭和最小化按钮也没了。我们需要自己实现关闭直接调用Application.Quit()。在编辑器模式下可以使用#if UNITY_EDITOR ... #endif来执行UnityEditor.EditorApplication.isPlaying false;。最小化这需要另一个Windows APIShowWindow并传入SW_MINIMIZE命令。实现起来类似置顶。[DllImport(user32.dll)] private static extern bool ShowWindow(IntPtr hWnd, int nCmdShow); private const int SW_MINIMIZE 6; public void MinimizeWindow() { if (_windowHandle IntPtr.Zero) return; ShowWindow(_windowHandle, SW_MINIMIZE); }重要提醒自己模拟最小化/最大化/关闭逻辑时要小心处理应用程序状态。特别是最大化在无边框模式下实现真正的最大化覆盖任务栏非常复杂通常选择“全屏窗口化”模式作为替代。5. 常见问题与排查技巧实录在实际操作中你几乎一定会遇到下面这些问题。这里是我的踩坑记录和解决方案。5.1 窗口句柄获取失败现象FindWindow返回IntPtr.Zero日志报错。排查窗口标题不匹配Unity构建出的exe其窗口标题默认是Product Name。但在编辑器播放模式下标题通常是“Product Name (Unity)”。使用Application.productName并加上“ (Unity)”后缀进行尝试。时机问题在Awake中调用FindWindow可能太早窗口尚未创建。Start通常是个好时机但也不是100%稳定。最保险的做法是在第一个Update之后或者使用Coroutine等待几帧。使用更可靠的APIGetActiveWindow可以获取当前活动窗口的句柄但它可能不是你的Unity窗口。更复杂但可靠的方法是枚举所有窗口通过进程ID来筛选。[DllImport(user32.dll)] private static extern IntPtr GetActiveWindow(); // 在Start或一个延迟调用的方法中 _windowHandle GetActiveWindow(); Debug.Log($通过GetActiveWindow获取句柄: {_windowHandle});5.2 无边框后窗口阴影丢失现象移除WS_THICKFRAME后Windows 10/11漂亮的窗口投影也消失了窗口看起来像一张“纸片”贴在屏幕上。解决方案这是Windows DWM桌面窗口管理器的行为。要重新添加阴影需要更复杂的DWM API。一个相对简单的方法是保留WS_THICKFRAME样式但将其尺寸设置为0。这需要处理WM_NCCALCSIZE消息对于新手来说过于复杂。一个取巧的方案是在移除边框后手动为你的UI根Canvas添加一个半透明的、带模糊的边缘阴影Image从视觉上模拟。5.3 拖拽功能在编辑器下正常打包后失效现象在Unity编辑器中运行拖拽完美构建成exe后点击自定义标题栏无法拖拽。排查EventSystem确保打包后的场景中也有EventSystem。Unity UI依赖它。屏幕坐标与DPI缩放在高DPI缩放显示器上鼠标坐标可能需要转换。但我们的SendMessage方法不依赖具体坐标所以问题不在这里。管理员权限如果你的应用需要以管理员权限运行而你没有在清单文件中声明或者用户没有授权某些API调用可能会受到限制。但这通常不会只影响拖拽。最可能的原因——窗口样式残留在某些Windows版本或主题下移除样式位可能不彻底。尝试在RemoveWindowBorder中在调用SetWindowPos强制刷新后再额外调用一次SetWindowPos有时能解决。// 在RemoveWindowBorder方法的最后尝试调用两次 SetWindowPos(_windowHandle, IntPtr.Zero, 0, 0, 0, 0, SWP_NOACTIVATE | SWP_SHOWWINDOW | SWP_NOMOVE | SWP_NOSIZE | 0x0020); // 延迟一帧再调用一次可以通过协程实现 StartCoroutine(RefreshWindowAgain());5.4 点击穿透问题需求希望制作一个半透明的信息展示窗口鼠标点击能穿透它直接操作后面的其他窗口。实现这需要修改窗口的扩展样式GWL_EXSTYLE添加WS_EX_TRANSPARENT和WS_EX_LAYERED。但要注意WS_EX_TRANSPARENT会使窗口对鼠标点击完全透明包括你自己的UI按钮也将无法点击。通常需要配合SetLayeredWindowAttributes来设置透明度颜色键实现更复杂的点击穿透逻辑例如只有特定颜色区域穿透。这是一个高级话题实现不当会导致窗口完全无法交互建议先掌握基础样式修改后再尝试。5.5 跨平台实现的巨大差异macOS需要使用Objective-C的Cocoa API。你需要编写一个.mmObjective-C文件通过[DllImport(“__Internal”)]调用。核心类是NSWindow方法如setStyleMask:、setTitlebarAppearsTransparent:、setMovableByWindowBackground:等。逻辑和API风格与Windows截然不同。Linux (Ubuntu)通常使用XlibX11或更高层的GTK。你需要查找当前窗口的Window XID然后使用Xlib函数如XSetWindowAttributes、XChangeWindowAttributes来修改属性。同样复杂。建议对于跨平台项目务必使用条件编译#if UNITY_STANDALONE_WIN/#elif UNITY_STANDALONE_OSX...将不同平台的代码完全隔离开。可以抽象出一个通用的接口如IWindowController但底层实现各平台独立。public interface IWindowController { void RemoveBorder(); void DragWindow(); void ToggleTopMost(); } #if UNITY_STANDALONE_WIN public class WindowsWindowController : MonoBehaviour, IWindowController { // ... Windows P/Invoke 实现 } #elif UNITY_STANDALONE_OSX public class MacWindowController : MonoBehaviour, IWindowController { // ... macOS Objective-C 桥接实现 } #endif自定义Unity游戏窗口是一个深入系统底层的实践它打破了引擎的“黑盒”给予了开发者极大的自由但也带来了平台兼容性和稳定性的挑战。从最基础的移除边框、实现拖拽开始逐步尝试置顶、透明、点击穿透等高级特性是稳妥的学习路径。最关键的是每一步修改都要理解其背后的Windows消息机制或相应操作系统的窗口管理原理这样在遇到诡异问题时你才能有方向地去排查和搜索。
Unity游戏窗口自定义：P/Invoke实现无边框与置顶功能
1. 项目概述为什么需要自定义游戏窗口在Unity开发中尤其是制作独立游戏、工具软件或需要特殊展示效果的项目时默认的游戏视图窗口往往显得“千篇一律”。那个标准的深灰色标题栏、固定的边框以及右上角一成不变的“最大化/最小化/关闭”按钮有时会与游戏的艺术风格格格不入或者无法满足特定的产品需求。比如你想做一个复古风格的像素游戏希望窗口标题栏也变成像素风或者开发一个演示工具需要隐藏所有边框让内容全屏沉浸又或者你需要动态改变窗口的置顶状态就像在Ubuntu中右键标题栏选择“Always on Top”那样。这就是“Unity游戏窗口自定义实现标题栏与边框的动态控制”这个项目的核心价值。它不仅仅是改个颜色那么简单而是深入到操作系统原生窗口的层面去操控那些Unity引擎默认没有暴露给我们的底层属性。通过这个项目你可以实现完全隐藏标题栏和边框创造一个无边框窗口常用于制作启动器、桌面小部件或极简风格应用。自定义标题栏的样式包括图标、文字颜色、按钮样式虽然完全重绘按钮逻辑复杂但可以隐藏后自己用UI模拟。动态控制窗口行为如置顶、改变透明度、设置点击穿透等提升应用的交互灵活性。解决跨平台适配问题因为Windows、macOS、Linux对窗口管理的API差异很大本项目需要处理这些兼容性。简单来说这相当于为你Unity应用的“外壳”赋予了灵魂让它从内到外都符合你的设计预期。接下来我将以一个在Windows平台上实现无边框、可拖拽、可置顶的自定义窗口为例拆解其核心思路、技术实现与避坑指南。2. 核心思路与方案选型P/Invoke是钥匙Unity本身是一个强大的游戏引擎和渲染框架但它对原生窗口的管理功能封装得非常有限主要集中在Screen类的一些基础设置上比如设置分辨率、全屏模式。要实现深度的窗口自定义我们必须绕过Unity直接与操作系统对话。2.1 为什么选择P/Invoke我们的核心武器是P/InvokePlatform Invocation Services。这是一种.NET框架提供的机制允许托管代码我们的C#脚本调用非托管动态链接库DLL中的函数比如Windows的user32.dll、dwmapi.dll。可行性Windows的窗口管理功能查找窗口、修改样式、发送消息都封装在这些系统DLL中。Unity基于.NET/Mono天然支持P/Invoke。必要性Unity没有提供相应的API这是唯一可行的深度控制路径。跨平台考量本方案主要针对Windows。对于macOS需要使用Cocoa的API通过[DllImport(“__Internal”)]调用Objective-C对于Linux如Ubuntu则通常使用Xlib或GTK。本文聚焦Windows实现但会提及跨平台思路的差异。2.2 核心Windows API函数解析要实现自定义我们需要用到几个关键的Windows API函数FindWindow根据类名和窗口标题找到我们游戏窗口的“句柄”HWND。句柄是操作系统识别每个窗口的唯一身份证。GetWindowLong/SetWindowLong这对函数用于获取和设置窗口的“扩展样式”GWL_EXSTYLE和“样式”GWL_STYLE。窗口的边框、标题栏、系统菜单等外观属性都由这些样式位控制。SetWindowPos这个函数功能强大可以设置窗口的位置、大小、Z序置顶/取消置顶等。我们主要用它来实现“窗口置顶”功能。ReleaseCapture/SendMessage当隐藏了标题栏后窗口就无法拖动了。我们需要模拟Windows的窗口拖动机制在用户按下鼠标左键时向窗口发送一个WM_NCLBUTTONDOWN消息并指定点击区域为“标题栏”HTCAPTION这样系统就会接管拖动逻辑。2.3 方案设计流程图逻辑描述整个流程可以概括为以下几步初始化获取句柄在游戏启动后如Start方法中使用FindWindow找到当前游戏窗口的句柄。修改窗口样式使用GetWindowLong获取当前样式通过位操作按位与、按位或|移除代表标准边框和标题栏的样式位如WS_CAPTION,WS_THICKFRAME然后使用SetWindowLong应用新样式。刷新窗口修改样式后必须调用SetWindowPos或发送WM_NCACTIVATE消息来强制窗口重绘否则更改可能不立即生效。实现拖拽功能在自定义的标题栏UI元素上监听鼠标按下事件调用ReleaseCapture然后SendMessage发送WM_NCLBUTTONDOWN消息。实现置顶功能提供一个按钮或开关点击时调用SetWindowPos并传入HWND_TOPMOST或HWND_NOTOPMOST参数来切换置顶状态。注意直接修改窗口样式可能会导致一些副作用例如窗口阴影丢失在Windows 10/11上或者任务栏预览缩略图异常。高级效果如亚克力模糊背景需要调用DWMDesktop Window Manager相关API复杂度更高。3. 核心细节解析与实操要点理解了核心思路我们深入每个环节的细节。这里假设你已经创建了一个Unity项目并准备了一个简单的UI一个作为自定义标题栏的Panel上面有文字、关闭按钮和一个“置顶”切换按钮。3.1 定义P/Invoke接口与Windows对话的桥梁首先我们需要在C#脚本中声明我们要使用的Windows API函数。创建一个名为NativeWindowController.cs的脚本。using System; using System.Runtime.InteropServices; using UnityEngine; public class NativeWindowController : MonoBehaviour { // 窗口句柄 private IntPtr _windowHandle; // 窗口样式常量 private const int GWL_STYLE -16; private const int GWL_EXSTYLE -20; // 窗口样式位 private const uint WS_CAPTION 0x00C00000; // 标题栏 private const uint WS_THICKFRAME 0x00040000; // 可调整大小的边框 private const uint WS_SYSMENU 0x00080000; // 系统菜单关闭按钮等 private const uint WS_MINIMIZEBOX 0x00020000; // 最小化按钮 private const uint WS_MAXIMIZEBOX 0x00010000; // 最大化按钮 // 扩展窗口样式位用于点击穿透等 private const uint WS_EX_LAYERED 0x00080000; private const uint WS_EX_TRANSPARENT 0x00000020; // SetWindowPos 参数 private static readonly IntPtr HWND_TOPMOST new IntPtr(-1); private static readonly IntPtr HWND_NOTOPMOST new IntPtr(-2); private const uint SWP_NOSIZE 0x0001; private const uint SWP_NOMOVE 0x0002; private const uint SWP_NOACTIVATE 0x0010; private const uint SWP_SHOWWINDOW 0x0040; // Windows消息常量 private const int WM_NCLBUTTONDOWN 0xA1; private const int HTCAPTION 2; // 1. 查找窗口 [DllImport(user32.dll)] private static extern IntPtr FindWindow(string lpClassName, string lpWindowName); // 2. 获取/设置窗口样式 [DllImport(user32.dll)] private static extern int GetWindowLong(IntPtr hWnd, int nIndex); [DllImport(user32.dll)] private static extern int SetWindowLong(IntPtr hWnd, int nIndex, int dwNewLong); // 3. 设置窗口位置和Z序用于置顶和刷新 [DllImport(user32.dll)] [return: MarshalAs(UnmanagedType.Bool)] private static extern bool SetWindowPos(IntPtr hWnd, IntPtr hWndInsertAfter, int X, int Y, int cx, int cy, uint uFlags); // 4. 释放鼠标捕获并发送消息用于拖拽 [DllImport(user32.dll)] private static extern bool ReleaseCapture(); [DllImport(user32.dll)] private static extern IntPtr SendMessage(IntPtr hWnd, int Msg, IntPtr wParam, IntPtr lParam); // 初始化获取当前活动窗口的句柄 void Start() { // 注意Unity窗口的类名通常是“UnityWndClass”窗口名是应用产品名。 // 一个更可靠的方法是使用GetActiveWindow但这里用FindWindow。 // 为了通用性可以尝试传入null或Application.productName。 _windowHandle FindWindow(null, Application.productName); if (_windowHandle IntPtr.Zero) { Debug.LogError(无法找到游戏窗口句柄); } else { Debug.Log($成功获取窗口句柄: {_windowHandle}); // 初始时可以应用一次无边框样式 // RemoveWindowBorder(); } } }关键点解析IntPtr用于在C#中表示原生指针这里就是窗口句柄HWND。DllImport属性指定函数来自哪个DLL。user32.dll是Windows用户界面核心库。常量值如WS_CAPTION这些十六进制数字是Windows SDK中定义的宏。我们通过位运算来操作它们。FindWindow参数第一个参数是窗口类名第二个是窗口标题。传入null可以匹配任意类名或标题。使用Application.productName在Player Settings中设置作为标题通常很可靠。3.2 移除边框与标题栏位运算的艺术在NativeWindowController脚本中添加核心方法public void RemoveWindowBorder() { if (_windowHandle IntPtr.Zero) return; // 获取当前窗口样式 int currentStyle GetWindowLong(_windowHandle, GWL_STYLE); // 获取当前扩展样式 int currentExStyle GetWindowLong(_windowHandle, GWL_EXSTYLE); Debug.Log($当前样式: {currentStyle:X}, 当前扩展样式: {currentExStyle:X}); // 移除我们不想要的样式位 // 使用按位与()和取反(~)来清除特定位 int newStyle currentStyle; newStyle ~(int)(WS_CAPTION | WS_THICKFRAME | WS_SYSMENU | WS_MINIMIZEBOX | WS_MAXIMIZEBOX); // 也可以添加一些扩展样式例如让窗口支持透明需要配合SetLayeredWindowAttributes // int newExStyle currentExStyle | (int)WS_EX_LAYERED; // SetWindowLong(_windowHandle, GWL_EXSTYLE, newExStyle); // 应用新的窗口样式 SetWindowLong(_windowHandle, GWL_STYLE, newStyle); Debug.Log($新样式: {newStyle:X}); // 关键步骤强制窗口重绘以应用样式更改 // 使用SetWindowPos并指定SWP_FRAMECHANGED标志0x0020和SWP_SHOWWINDOW等 SetWindowPos(_windowHandle, IntPtr.Zero, 0, 0, 0, 0, SWP_NOACTIVATE | SWP_SHOWWINDOW | SWP_NOMOVE | SWP_NOSIZE | 0x0020); Debug.Log(已移除窗口边框和标题栏。); }实操心得位运算 ~是“清除位”的标准操作。WS_CAPTION | WS_THICKFRAME ...是将多个样式位合并为一个掩码。currentStyle ~mask的结果就是清除了掩码中所有为1的位。立即生效问题仅仅调用SetWindowLong是不够的窗口不会立即重绘非客户区边框、标题栏。必须随后调用SetWindowPos并传入SWP_FRAMECHANGED0x0020标志这是让更改生效的秘诀。副作用移除WS_THICKFRAME后窗口将无法通过拖拽边缘来调整大小。如果你需要调整大小功能需要自己用UI模拟这非常复杂。通常无边框窗口是固定大小的。3.3 实现窗口拖拽模拟标题栏点击现在窗口没有标题栏了我们需要让用户能通过拖拽我们自定义的UI Panel来移动窗口。为你的自定义标题栏Panel添加EventTrigger组件或者在相关脚本中监听鼠标事件。using UnityEngine.EventSystems; // 需要引入命名空间 // 假设这个脚本挂在你的自定义标题栏UI对象上 public class CustomTitleBar : MonoBehaviour, IPointerDownHandler { public NativeWindowController windowController; // 拖拽赋值 public void OnPointerDown(PointerEventData eventData) { // 检查是否是鼠标左键按下 if (eventData.button PointerEventData.InputButton.Left) { StartDragWindow(); } } private void StartDragWindow() { if (windowController ! null) { windowController.DragWindow(); } } }在NativeWindowController中添加拖拽方法public void DragWindow() { if (_windowHandle IntPtr.Zero) return; // 释放Unity可能持有的鼠标捕获 ReleaseCapture(); // 向窗口发送“非客户区鼠标左键按下”消息并指定区域为标题栏 SendMessage(_windowHandle, WM_NCLBUTTONDOWN, (IntPtr)HTCAPTION, IntPtr.Zero); }注意事项ReleaseCapture()至关重要。在Unity的UI事件系统中鼠标可能被EventSystem捕获直接发送拖拽消息可能无效。先释放捕获将控制权交还给系统。这个方法模拟了用户点击原生标题栏的行为因此拖拽的流畅度和效果与原生窗口完全一致。确保你的自定义标题栏UI的Raycast Target是开启的否则无法接收到点击事件。3.4 实现窗口置顶Z序的管理置顶功能相对简单主要依靠SetWindowPos函数和HWND_TOPMOST参数。在NativeWindowController中添加private bool _isTopMost false; public void ToggleWindowTopMost() { if (_windowHandle IntPtr.Zero) return; _isTopMost !_isTopMost; IntPtr hWndInsertAfter _isTopMost ? HWND_TOPMOST : HWND_NOTOPMOST; bool success SetWindowPos(_windowHandle, hWndInsertAfter, 0, 0, 0, 0, SWP_NOACTIVATE | SWP_SHOWWINDOW | SWP_NOMOVE | SWP_NOSIZE); if (success) { Debug.Log($窗口置顶状态已切换为: {_isTopMost}); } else { Debug.LogError(切换窗口置顶状态失败); } }原理说明HWND_TOPMOST将窗口置于所有非置顶窗口之上即使它失去焦点。HWND_NOTOPMOST将窗口放回正常的Z序队列。SWP_NOMOVE | SWP_NOSIZE表示不改变窗口的位置和大小只改变Z序。你可以将此方法绑定到一个UI按钮的点击事件上。4. 实操过程与核心环节实现让我们将上述代码整合到一个完整的、可操作的流程中。假设我们要制作一个简单的“桌面时钟”无边框应用。4.1 项目设置与UI搭建创建新Unity项目任意模板。设置Player SettingsProduct Name设置为“MyCustomWindowApp”。这将是我们FindWindow查找的窗口标题。在Resolution and Presentation下可以选择Windowed模式并设置一个初始分辨率如800x600。搭建UI创建一个Canvas。在Canvas下创建一个Panel命名为TitleBar。设置其锚点在顶部拉伸高度为40。给它一个独特的背景颜色如深蓝色。在TitleBar内添加一个Text显示“My Desktop Clock”。一个Button作为关闭按钮稍后实现功能。一个Toggle作为“置顶”开关标签设为“Always on Top”。在Canvas下再创建一个Panel或Text作为主内容区显示时间。4.2 脚本编写与挂载创建NativeWindowController.cs脚本包含上述所有API声明和方法Start,RemoveWindowBorder,DragWindow,ToggleWindowTopMost。创建CustomTitleBar.cs脚本包含IPointerDownHandler的实现。在场景中创建一个空物体如WindowManager挂载NativeWindowController组件。将TitleBarPanel挂载CustomTitleBar组件。在Inspector中将WindowManager物体拖拽到CustomTitleBar脚本的windowController字段上。为“关闭按钮”编写一个简单的脚本调用Application.Quit()。为“置顶”Toggle的OnValueChanged事件添加监听调用WindowManager上NativeWindowController组件的ToggleWindowTopMost方法。4.3 初始化与样式应用在NativeWindowController的Start方法中我们获取句柄后可以立即应用无边框样式。但更好的做法是提供一个控制开关。void Start() { _windowHandle FindWindow(null, Application.productName); if (_windowHandle IntPtr.Zero) { // 备选方案有时标题可能带有“(Unity)”后缀可以尝试带后缀查找 _windowHandle FindWindow(null, Application.productName (Unity)); if (_windowHandle IntPtr.Zero) { Debug.LogError(无法找到游戏窗口句柄); return; } } // 默认启动时移除边框 RemoveWindowBorder(); // 可选初始化置顶状态为false _isTopMost false; }现在运行游戏你应该会看到一个没有标准标题栏和边框的窗口。你可以拖拽我们自定义的深蓝色标题栏来移动窗口点击Toggle可以切换置顶状态。4.4 添加关闭与最小化按钮模拟原生标题栏被移除后关闭和最小化按钮也没了。我们需要自己实现关闭直接调用Application.Quit()。在编辑器模式下可以使用#if UNITY_EDITOR ... #endif来执行UnityEditor.EditorApplication.isPlaying false;。最小化这需要另一个Windows APIShowWindow并传入SW_MINIMIZE命令。实现起来类似置顶。[DllImport(user32.dll)] private static extern bool ShowWindow(IntPtr hWnd, int nCmdShow); private const int SW_MINIMIZE 6; public void MinimizeWindow() { if (_windowHandle IntPtr.Zero) return; ShowWindow(_windowHandle, SW_MINIMIZE); }重要提醒自己模拟最小化/最大化/关闭逻辑时要小心处理应用程序状态。特别是最大化在无边框模式下实现真正的最大化覆盖任务栏非常复杂通常选择“全屏窗口化”模式作为替代。5. 常见问题与排查技巧实录在实际操作中你几乎一定会遇到下面这些问题。这里是我的踩坑记录和解决方案。5.1 窗口句柄获取失败现象FindWindow返回IntPtr.Zero日志报错。排查窗口标题不匹配Unity构建出的exe其窗口标题默认是Product Name。但在编辑器播放模式下标题通常是“Product Name (Unity)”。使用Application.productName并加上“ (Unity)”后缀进行尝试。时机问题在Awake中调用FindWindow可能太早窗口尚未创建。Start通常是个好时机但也不是100%稳定。最保险的做法是在第一个Update之后或者使用Coroutine等待几帧。使用更可靠的APIGetActiveWindow可以获取当前活动窗口的句柄但它可能不是你的Unity窗口。更复杂但可靠的方法是枚举所有窗口通过进程ID来筛选。[DllImport(user32.dll)] private static extern IntPtr GetActiveWindow(); // 在Start或一个延迟调用的方法中 _windowHandle GetActiveWindow(); Debug.Log($通过GetActiveWindow获取句柄: {_windowHandle});5.2 无边框后窗口阴影丢失现象移除WS_THICKFRAME后Windows 10/11漂亮的窗口投影也消失了窗口看起来像一张“纸片”贴在屏幕上。解决方案这是Windows DWM桌面窗口管理器的行为。要重新添加阴影需要更复杂的DWM API。一个相对简单的方法是保留WS_THICKFRAME样式但将其尺寸设置为0。这需要处理WM_NCCALCSIZE消息对于新手来说过于复杂。一个取巧的方案是在移除边框后手动为你的UI根Canvas添加一个半透明的、带模糊的边缘阴影Image从视觉上模拟。5.3 拖拽功能在编辑器下正常打包后失效现象在Unity编辑器中运行拖拽完美构建成exe后点击自定义标题栏无法拖拽。排查EventSystem确保打包后的场景中也有EventSystem。Unity UI依赖它。屏幕坐标与DPI缩放在高DPI缩放显示器上鼠标坐标可能需要转换。但我们的SendMessage方法不依赖具体坐标所以问题不在这里。管理员权限如果你的应用需要以管理员权限运行而你没有在清单文件中声明或者用户没有授权某些API调用可能会受到限制。但这通常不会只影响拖拽。最可能的原因——窗口样式残留在某些Windows版本或主题下移除样式位可能不彻底。尝试在RemoveWindowBorder中在调用SetWindowPos强制刷新后再额外调用一次SetWindowPos有时能解决。// 在RemoveWindowBorder方法的最后尝试调用两次 SetWindowPos(_windowHandle, IntPtr.Zero, 0, 0, 0, 0, SWP_NOACTIVATE | SWP_SHOWWINDOW | SWP_NOMOVE | SWP_NOSIZE | 0x0020); // 延迟一帧再调用一次可以通过协程实现 StartCoroutine(RefreshWindowAgain());5.4 点击穿透问题需求希望制作一个半透明的信息展示窗口鼠标点击能穿透它直接操作后面的其他窗口。实现这需要修改窗口的扩展样式GWL_EXSTYLE添加WS_EX_TRANSPARENT和WS_EX_LAYERED。但要注意WS_EX_TRANSPARENT会使窗口对鼠标点击完全透明包括你自己的UI按钮也将无法点击。通常需要配合SetLayeredWindowAttributes来设置透明度颜色键实现更复杂的点击穿透逻辑例如只有特定颜色区域穿透。这是一个高级话题实现不当会导致窗口完全无法交互建议先掌握基础样式修改后再尝试。5.5 跨平台实现的巨大差异macOS需要使用Objective-C的Cocoa API。你需要编写一个.mmObjective-C文件通过[DllImport(“__Internal”)]调用。核心类是NSWindow方法如setStyleMask:、setTitlebarAppearsTransparent:、setMovableByWindowBackground:等。逻辑和API风格与Windows截然不同。Linux (Ubuntu)通常使用XlibX11或更高层的GTK。你需要查找当前窗口的Window XID然后使用Xlib函数如XSetWindowAttributes、XChangeWindowAttributes来修改属性。同样复杂。建议对于跨平台项目务必使用条件编译#if UNITY_STANDALONE_WIN/#elif UNITY_STANDALONE_OSX...将不同平台的代码完全隔离开。可以抽象出一个通用的接口如IWindowController但底层实现各平台独立。public interface IWindowController { void RemoveBorder(); void DragWindow(); void ToggleTopMost(); } #if UNITY_STANDALONE_WIN public class WindowsWindowController : MonoBehaviour, IWindowController { // ... Windows P/Invoke 实现 } #elif UNITY_STANDALONE_OSX public class MacWindowController : MonoBehaviour, IWindowController { // ... macOS Objective-C 桥接实现 } #endif自定义Unity游戏窗口是一个深入系统底层的实践它打破了引擎的“黑盒”给予了开发者极大的自由但也带来了平台兼容性和稳定性的挑战。从最基础的移除边框、实现拖拽开始逐步尝试置顶、透明、点击穿透等高级特性是稳妥的学习路径。最关键的是每一步修改都要理解其背后的Windows消息机制或相应操作系统的窗口管理原理这样在遇到诡异问题时你才能有方向地去排查和搜索。
