用窗口自定義：徹底擺脫播放器感，實(shí)現(xiàn)專業(yè)級(jí)無(wú)邊框窗口)
1. 項(xiàng)目概述從播放器到專業(yè)應(yīng)用的最后一步如果你用Unity開(kāi)發(fā)過(guò)PC游戲或者工具應(yīng)用大概率經(jīng)歷過(guò)這個(gè)階段在編輯器里跑得飛快畫(huà)面炫酷交互流暢一切都那么完美。然后你滿懷期待地點(diǎn)擊“Build”生成一個(gè).exe文件雙擊打開(kāi)——一個(gè)帶著默認(rèn)Windows標(biāo)題欄、可能還有難看邊框的窗口彈了出來(lái)。那一刻感覺(jué)就像精心準(zhǔn)備的晚宴最后端上來(lái)的主菜卻用了一次性塑料餐盒裝著。項(xiàng)目的專業(yè)感瞬間崩塌。這就是我們今天要啃的硬骨頭Unity打包PC端應(yīng)用時(shí)如何徹底擺脫那個(gè)“播放器感”十足的默認(rèn)窗口實(shí)現(xiàn)隱藏標(biāo)題欄和深度自定義窗口外觀。這不僅僅是“看起來(lái)更酷”對(duì)于很多工具類、演示類、信息展示類應(yīng)用來(lái)說(shuō)一個(gè)干凈、無(wú)干擾、甚至形狀獨(dú)特的窗口是產(chǎn)品體驗(yàn)的核心組成部分。我見(jiàn)過(guò)太多優(yōu)秀的Unity項(xiàng)目最終卡在了這“最后一公里”的交付體驗(yàn)上要么是窗口無(wú)法置頂要么是隱藏標(biāo)題欄后窗口沒(méi)法拖動(dòng)或者自定義邊框帶來(lái)了詭異的點(diǎn)擊穿透問(wèn)題。網(wǎng)上的資料零散且坑多有的只講調(diào)用Windows API卻不提Unity不同渲染管線下的差異有的實(shí)現(xiàn)了無(wú)邊框但窗口再也無(wú)法移動(dòng)更常見(jiàn)的是代碼在編輯器里運(yùn)行良好一打包就失效?；谖疫@些年踩過(guò)的坑和項(xiàng)目實(shí)戰(zhàn)經(jīng)驗(yàn)這篇指南將系統(tǒng)性地拆解從標(biāo)準(zhǔn)“播放器窗口”到“專業(yè)級(jí)應(yīng)用窗口”的完整路徑。我們會(huì)深入原理提供可直接復(fù)制粘貼的健壯代碼并重點(diǎn)分享那些官方文檔不會(huì)告訴你的“避坑秘籍”。無(wú)論你是想做一個(gè)無(wú)邊框的儀表盤(pán)、一個(gè)可自定義形狀的創(chuàng)意工具還是一個(gè)需要隱藏所有系統(tǒng)UI的Kiosk模式應(yīng)用這里都有你需要的答案。2. 核心需求解析為什么以及何時(shí)需要自定義窗口在動(dòng)手寫(xiě)任何一行代碼之前我們必須先厘清需求。盲目地隱藏標(biāo)題欄或修改窗口樣式可能會(huì)引入意想不到的交互問(wèn)題。通常驅(qū)動(dòng)我們進(jìn)行窗口自定義的需求可以歸結(jié)為以下幾類每一種都對(duì)應(yīng)著不同的技術(shù)實(shí)現(xiàn)深度和潛在風(fēng)險(xiǎn)。2.1 提升視覺(jué)沉浸感與產(chǎn)品專業(yè)度這是最常見(jiàn)也是最直接的需求。Unity默認(rèn)的窗口帶有標(biāo)準(zhǔn)的Windows標(biāo)題欄包含圖標(biāo)、標(biāo)題、最小化、最大化、關(guān)閉按鈕和可調(diào)整大小的邊框。對(duì)于游戲而言全屏模式可以解決這個(gè)問(wèn)題。但對(duì)于非游戲應(yīng)用尤其是以下場(chǎng)景數(shù)字標(biāo)牌與信息展示屏在商場(chǎng)、展廳、會(huì)議室應(yīng)用需要長(zhǎng)時(shí)間全屏顯示任何系統(tǒng)UI都是干擾。創(chuàng)意工具與藝術(shù)裝置例如音樂(lè)可視化軟件、交互式藝術(shù)投影窗口本身需要成為畫(huà)布的一部分而非一個(gè)容器。模擬器與專業(yè)控制面板追求極致的界面還原模仿真實(shí)設(shè)備的屏幕不允許有多余的邊框。在這些場(chǎng)景下隱藏標(biāo)題欄和邊框是剛需。目標(biāo)是將Unity渲染的內(nèi)容直接作為“窗口”本身呈現(xiàn)給用戶實(shí)現(xiàn)應(yīng)用與操作系統(tǒng)桌面環(huán)境的視覺(jué)剝離讓用戶完全聚焦于內(nèi)容。2.2 實(shí)現(xiàn)特殊的窗口交互邏輯標(biāo)準(zhǔn)窗口的交互是由Windows系統(tǒng)管理的。當(dāng)你隱藏了標(biāo)題欄就意味著失去了系統(tǒng)提供的窗口移動(dòng)、縮放、關(guān)閉等標(biāo)準(zhǔn)交互方式。這時(shí)自定義需求就出現(xiàn)了自定義拖拽區(qū)域你可能希望點(diǎn)擊應(yīng)用的某個(gè)特定UI區(qū)域比如一個(gè)自定義的頂部工具欄來(lái)拖動(dòng)窗口而不是整個(gè)窗口客戶區(qū)。實(shí)現(xiàn)非矩形窗口通過(guò)透明通道和鼠標(biāo)點(diǎn)擊檢測(cè)創(chuàng)造出圓形、圓角矩形或其他任意形狀的窗口。這在制作桌面寵物、個(gè)性化小部件時(shí)非常流行。禁用或改寫(xiě)系統(tǒng)菜單右鍵點(diǎn)擊標(biāo)題欄彈出的系統(tǒng)菜單還原、移動(dòng)、大小、最小化、最大化、關(guān)閉可能不符合應(yīng)用邏輯需要禁用或替換為自定義菜單。這類需求要求我們不僅改變窗口的外觀還要接管一部分窗口消息處理邏輯技術(shù)復(fù)雜度更高。2.3 滿足特定的部署與運(yùn)行環(huán)境要求在一些受限或特殊的部署環(huán)境中對(duì)窗口有硬性規(guī)定Kiosk模式/信息亭模式應(yīng)用需要鎖定前臺(tái)防止用戶切換到其他程序。通常需要結(jié)合無(wú)邊框、全屏、以及屏蔽系統(tǒng)快捷鍵如AltF4, AltTab來(lái)實(shí)現(xiàn)。多顯示器拼接與控制在虛擬現(xiàn)實(shí)、環(huán)幕投影等系統(tǒng)中應(yīng)用可能需要跨多個(gè)顯示器顯示一個(gè)無(wú)縫的巨大畫(huà)面這就要求窗口能夠無(wú)邊框且精準(zhǔn)定位。與其他桌面應(yīng)用的窗口層級(jí)管理需要確保你的應(yīng)用窗口始終位于某些窗口之上或之下這涉及到窗口置頂Top-most屬性的管理而自定義窗口樣式是精細(xì)控制這些屬性的前提。理解你的核心需求屬于哪一類是選擇正確技術(shù)方案的第一步。例如如果僅僅是為了全屏沉浸或許Screen.fullScreen true就夠了但如果需要在窗口模式下無(wú)邊框且可移動(dòng)就必須深入Windows API的層面。3. 技術(shù)方案選型與原理剖析Unity本身提供了一些基礎(chǔ)的窗口設(shè)置但對(duì)于深度自定義則力有不逮。這時(shí)我們需要尋求外部力量的幫助主要是通過(guò)平臺(tái)原生插件Native Plugin來(lái)調(diào)用操作系統(tǒng)提供的API。對(duì)于Windows平臺(tái)這就是一系列來(lái)自u(píng)ser32.dll和dwmapi.dll的函數(shù)。3.1 Unity內(nèi)置設(shè)置的能力與局限首先看看不寫(xiě)代碼能做什么。在Player SettingsResolution and PresentationPC Mac Linux Standalone下有一些相關(guān)設(shè)置Fullscreen ModeExclusive Fullscreen獨(dú)占全屏、Fullscreen Window無(wú)邊框窗口全屏、Maximized Window最大化窗口、Windowed窗口化。Fullscreen Window模式會(huì)創(chuàng)建一個(gè)無(wú)邊框、覆蓋整個(gè)顯示器的窗口是實(shí)現(xiàn)無(wú)邊框最簡(jiǎn)單的方式但你失去了對(duì)窗口位置和尺寸的精確控制。Allow Fullscreen Switch允許通過(guò)AltEnter切換全屏。Resolution設(shè)置默認(rèn)窗口尺寸。在腳本中你可以通過(guò)Screen類動(dòng)態(tài)設(shè)置// 切換到無(wú)邊框全屏窗口 Screen.SetResolution(1920, 1080, FullScreenMode.FullScreenWindow); // 獲取當(dāng)前窗口句柄后續(xù)API調(diào)用需要 IntPtr hwnd GetActiveWindow(); // 需要自己聲明外部方法局限內(nèi)置設(shè)置無(wú)法實(shí)現(xiàn)真正的、可移動(dòng)的“無(wú)邊框窗口化”模式。FullScreenWindow是全屏的而Windowed模式一定有標(biāo)題欄和邊框。你無(wú)法創(chuàng)建一個(gè)在桌面任意位置、大小可調(diào)、且沒(méi)有標(biāo)題欄的窗口。這就是我們需要調(diào)用原生API的根本原因。3.2 Windows API我們的核心工具包為了實(shí)現(xiàn)高級(jí)窗口控制我們需要與Windows系統(tǒng)的窗口管理器直接對(duì)話。關(guān)鍵API函數(shù)來(lái)自u(píng)ser32.dllSetWindowLongPtr用于設(shè)置窗口的擴(kuò)展樣式GWL_EXSTYLE和普通樣式GWL_STYLE。這是我們隱藏標(biāo)題欄、邊框、菜單的關(guān)鍵。GetWindowLongPtr獲取當(dāng)前的窗口樣式。SetWindowPos設(shè)置窗口的位置、大小、Z序置頂?shù)纫约坝|發(fā)樣式更新。ReleaseCapture,SendMessage用于實(shí)現(xiàn)無(wú)標(biāo)題欄窗口的拖動(dòng)。當(dāng)用戶在沒(méi)有標(biāo)題欄的區(qū)域點(diǎn)擊并拖動(dòng)時(shí)我們需要向Windows發(fā)送WM_NCLBUTTONDOWN消息并附帶HTCAPTION參數(shù)欺騙系統(tǒng)認(rèn)為用戶正在拖動(dòng)標(biāo)題欄。FindWindow/GetActiveWindow用于獲取當(dāng)前Unity窗口的句柄HWND。句柄是操作系統(tǒng)識(shí)別每個(gè)窗口的唯一標(biāo)識(shí)所有API調(diào)用都離不開(kāi)它。一個(gè)關(guān)鍵概念窗口樣式Window StylesWindows窗口的外觀和行為由一系列樣式位標(biāo)志控制。例如WS_CAPTION包含標(biāo)題欄。WS_THICKFRAME可調(diào)整大小的邊框。WS_SYSMENU有關(guān)閉按鈕的系統(tǒng)菜單。WS_MAXIMIZEBOX/WS_MINIMIZEBOX最大化/最小化按鈕。 要隱藏它們我們的思路是先獲取當(dāng)前窗口的樣式然后用位操作 ~移除我們不需要的樣式位最后將新樣式設(shè)置回去。3.3 方案對(duì)比從簡(jiǎn)單到復(fù)雜根據(jù)需求復(fù)雜度我們可以選擇不同層級(jí)的方案方案A簡(jiǎn)易無(wú)邊框全屏方法使用Unity內(nèi)置FullScreenMode.FullScreenWindow。優(yōu)點(diǎn)零代碼最簡(jiǎn)單。缺點(diǎn)窗口必須鋪滿整個(gè)屏幕無(wú)法窗口化運(yùn)行。不適合需要同時(shí)查看其他應(yīng)用的工具軟件。方案B可移動(dòng)的無(wú)邊框窗口主流需求方法在Windowed模式下使用Windows API移除WS_CAPTION和WS_THICKFRAME樣式并自己實(shí)現(xiàn)窗口拖動(dòng)邏輯。優(yōu)點(diǎn)實(shí)現(xiàn)了真正意義上的、可自由移動(dòng)的“無(wú)邊框窗口”平衡了美觀與實(shí)用性。缺點(diǎn)需要編寫(xiě)并管理原生插件交互代碼實(shí)現(xiàn)拖動(dòng)邏輯。方案C完全自定義的非客戶區(qū)方法在方案B的基礎(chǔ)上進(jìn)一步處理WM_NCCALCSIZE消息允許你完全定義窗口的非客戶區(qū)邊框、標(biāo)題欄區(qū)域甚至可以繪制自定義的窗口控件最小化、關(guān)閉按鈕。優(yōu)點(diǎn)自由度最高可以實(shí)現(xiàn)任何視覺(jué)設(shè)計(jì)。缺點(diǎn)復(fù)雜度急劇上升需要處理大量的Windows消息容易引入穩(wěn)定性問(wèn)題且與Unity的UI系統(tǒng)整合困難。對(duì)于90%的需求方案B是最佳平衡點(diǎn)。接下來(lái)我們將重點(diǎn)深入方案B的實(shí)現(xiàn)細(xì)節(jié)與避坑要點(diǎn)。4. 核心實(shí)現(xiàn)移除標(biāo)題欄與實(shí)現(xiàn)窗口拖動(dòng)這是整個(gè)流程中最核心、也最容易出錯(cuò)的環(huán)節(jié)。我們將分步拆解并提供經(jīng)過(guò)項(xiàng)目驗(yàn)證的健壯代碼。4.1 第一步聲明與獲取窗口句柄首先我們需要在C#腳本中聲明將要使用的Windows API函數(shù)。建議創(chuàng)建一個(gè)單獨(dú)的類如WindowsWindowManager.cs。using System; using System.Runtime.InteropServices; using UnityEngine; public class WindowsWindowManager : MonoBehaviour { // 引入必要的Windows API函數(shù) [DllImport(user32.dll)] private static extern IntPtr GetActiveWindow(); [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); [DllImport(user32.dll)] private static extern bool SetWindowPos(IntPtr hWnd, IntPtr hWndInsertAfter, int X, int Y, int cx, int cy, uint uFlags); [DllImport(user32.dll)] private static extern bool ReleaseCapture(); [DllImport(user32.dll)] private static extern IntPtr SendMessage(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam); // 窗口樣式索引 private const int GWL_STYLE -16; // 窗口樣式常量 private const int WS_CAPTION 0x00C00000; private const int WS_THICKFRAME 0x00040000; private const int WS_SYSMENU 0x00080000; private const int WS_MAXIMIZEBOX 0x00010000; private const int WS_MINIMIZEBOX 0x00020000; // SetWindowPos 標(biāo)志 private const uint SWP_FRAMECHANGED 0x0020; private const uint SWP_NOMOVE 0x0002; private const uint SWP_NOSIZE 0x0001; private const uint SWP_NOZORDER 0x0004; // 消息常量 private const uint WM_NCLBUTTONDOWN 0xA1; private const int HTCAPTION 2; private IntPtr _windowHandle; void Start() { // 獲取當(dāng)前Unity窗口的句柄 _windowHandle GetActiveWindow(); if (_windowHandle IntPtr.Zero) { Debug.LogError(Failed to get window handle.); return; } // 可以在此處調(diào)用移除標(biāo)題欄的函數(shù) // RemoveWindowTitleBar(); } }注意132位與64位兼容性上面的代碼使用了GetWindowLong和SetWindowLong。在64位系統(tǒng)上更嚴(yán)謹(jǐn)?shù)淖龇ㄊ鞘褂肎etWindowLongPtr和SetWindowLongPtr因?yàn)樗鼈兲幚淼氖侵羔槾笮〉臄?shù)據(jù)。Unity的Mono/IL2CPP腳本后端在64位下是安全的但為了絕對(duì)兼容你可以使用IntPtr版本或條件編譯。一個(gè)更簡(jiǎn)單的辦法是確保你的項(xiàng)目Player Settings中“Architecture”設(shè)置為x86_64并使用GetWindowLong/SetWindowLong在大多數(shù)情況下是可行的。注意2獲取句柄的時(shí)機(jī)在Start()或Awake()中獲取句柄通常是安全的。但有時(shí)特別是窗口初始化的早期句柄可能還未就緒。一個(gè)更穩(wěn)健的做法是在OnApplicationFocus(true)時(shí)再執(zhí)行樣式修改或者使用Invoke延遲一小段時(shí)間。4.2 第二步移除標(biāo)題欄和邊框現(xiàn)在我們有了句柄可以編寫(xiě)移除樣式的核心函數(shù)。public void RemoveWindowTitleBar() { if (_windowHandle IntPtr.Zero) return; // 1. 獲取當(dāng)前的窗口樣式 int currentStyle GetWindowLong(_windowHandle, GWL_STYLE); // 2. 移除我們不需要的樣式 // 移除標(biāo)題欄(WS_CAPTION)它包含了WS_BORDER, WS_DLGFRAME, WS_SYSMENU, WS_THICKFRAME等的一部分 // 為了更精確控制我們分別移除相關(guān)樣式 int newStyle currentStyle; newStyle ~WS_CAPTION; // 移除標(biāo)題欄 newStyle ~WS_THICKFRAME; // 移除可調(diào)整大小的邊框同時(shí)會(huì)移除最大/最小化按鈕 // newStyle ~WS_SYSMENU; // 謹(jǐn)慎移除系統(tǒng)菜單會(huì)同時(shí)移除關(guān)閉按鈕通常保留。 // newStyle ~WS_MAXIMIZEBOX; // 移除最大化按鈕 // newStyle ~WS_MINIMIZEBOX; // 移除最小化按鈕 // 3. 應(yīng)用新的窗口樣式 SetWindowLong(_windowHandle, GWL_STYLE, newStyle); // 4. 關(guān)鍵步驟強(qiáng)制Windows重新計(jì)算窗口的非客戶區(qū)邊框、標(biāo)題欄區(qū)域 // 如果不調(diào)用SetWindowPos樣式更改可能不會(huì)立即生效或者窗口大小會(huì)出錯(cuò)。 SetWindowPos(_windowHandle, IntPtr.Zero, 0, 0, 0, 0, SWP_FRAMECHANGED | SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER); Debug.Log(Window title bar and thick frame removed.); }原理剖析為什么需要SetWindowPos當(dāng)你修改GWL_STYLE后Windows并不會(huì)自動(dòng)重新繪制窗口的非客戶區(qū)。SetWindowPos函數(shù)即使不改變窗口位置和大小通過(guò)SWP_NOMOVE | SWP_NOSIZE只要攜帶SWP_FRAMECHANGED標(biāo)志就會(huì)通知系統(tǒng)“窗口框架變了請(qǐng)重新計(jì)算和繪制”。這是讓無(wú)邊框效果生效的關(guān)鍵一步很多教程遺漏了這一點(diǎn)導(dǎo)致修改無(wú)效或窗口尺寸異常。4.3 第三步實(shí)現(xiàn)無(wú)標(biāo)題欄窗口的拖動(dòng)移除了標(biāo)題欄窗口就無(wú)法拖動(dòng)了。我們需要在Unity的UI或3D對(duì)象上監(jiān)聽(tīng)拖動(dòng)事件然后發(fā)送Windows消息來(lái)模擬標(biāo)題欄拖動(dòng)。// 在WindowsWindowManager類中添加此方法 public void DragWindow() { if (_windowHandle IntPtr.Zero) return; // 釋放Unity可能持有的鼠標(biāo)捕獲 ReleaseCapture(); // 發(fā)送消息告訴系統(tǒng)“用戶在標(biāo)題欄上按下了鼠標(biāo)左鍵并開(kāi)始拖動(dòng)” SendMessage(_windowHandle, WM_NCLBUTTONDOWN, (IntPtr)HTCAPTION, IntPtr.Zero); }現(xiàn)在你需要將這個(gè)拖動(dòng)邏輯綁定到某個(gè)可交互的UI元素上。例如你可以創(chuàng)建一個(gè)作為“自定義標(biāo)題欄”的UI Panel。在Unity中創(chuàng)建一個(gè)Image或Panel作為你的自定義標(biāo)題欄。為其添加Event Trigger組件。在Event Trigger中添加PointerDown事件。將WindowsWindowManager實(shí)例的DragWindow方法拖拽到事件回調(diào)中。實(shí)操心得拖動(dòng)區(qū)域設(shè)計(jì)你的自定義標(biāo)題欄最好有一定高度如30像素并放置在窗口頂部符合用戶習(xí)慣。雙擊最大化如果你保留了最大化功能可以嘗試監(jiān)聽(tīng)雙擊事件然后調(diào)用SendMessage發(fā)送WM_NCLBUTTONDBLCLK消息。但實(shí)現(xiàn)起來(lái)更復(fù)雜且與Unity UI事件可能沖突。一個(gè)更簡(jiǎn)單的替代方案是自己寫(xiě)代碼切換窗口大小。鼠標(biāo)光標(biāo)反饋當(dāng)鼠標(biāo)懸停在你的自定義標(biāo)題欄上時(shí)光標(biāo)不會(huì)自動(dòng)變成“移動(dòng)”形狀。你可以通過(guò)Cursor.SetCursor來(lái)設(shè)置自定義光標(biāo)提升體驗(yàn)。4.4 第四步處理關(guān)閉、最小化、最大化按鈕移除了系統(tǒng)標(biāo)題欄你還需要提供替代的窗口控制按鈕。關(guān)閉最簡(jiǎn)單直接調(diào)用Application.Quit()。但要注意在編輯器模式下這可能會(huì)停止播放?？梢约訔l件編譯#if UNITY_EDITOR UnityEditor.EditorApplication.isPlaying false; #else Application.Quit(); #endif最小化使用APIShowWindow傳入SW_MINIMIZE參數(shù)。最大化/還原這是最棘手的。你不能簡(jiǎn)單地移除WS_MAXIMIZEBOX然后自己實(shí)現(xiàn)因?yàn)樽畲蠡?還原涉及到窗口狀態(tài)管理和尺寸計(jì)算。一個(gè)相對(duì)穩(wěn)定的方案是保留WS_MAXIMIZEBOX樣式即不把它從樣式位中移除。隱藏系統(tǒng)提供的最大化按鈕通過(guò)將窗口客戶區(qū)擴(kuò)大覆蓋掉按鈕或者創(chuàng)建一個(gè)無(wú)標(biāo)題欄但保留邊框的樣式變體比較復(fù)雜。在自己的UI按鈕中調(diào)用ShowWindow傳入SW_MAXIMIZE或SW_RESTORE。由于最大化/還原的完全自定義實(shí)現(xiàn)非常復(fù)雜且容易出bug對(duì)于許多應(yīng)用我建議直接禁用最大化功能移除WS_MAXIMIZEBOX或者使用“切換到一個(gè)預(yù)設(shè)的較大尺寸”來(lái)模擬最大化而不是真正的系統(tǒng)最大化狀態(tài)。5. 高級(jí)主題與深度避坑指南完成了基礎(chǔ)功能我們來(lái)看看那些容易讓人栽跟頭的高級(jí)問(wèn)題和解決方案。5.1 坑點(diǎn)一DPI縮放與高分辨率屏幕在高DPI縮放比例 100%的顯示器上Windows會(huì)進(jìn)行DPI虛擬化。Unity 2017.4及以后版本對(duì)DPI感知有更好的支持但結(jié)合自定義窗口API可能會(huì)遇到坐標(biāo)錯(cuò)亂的問(wèn)題。現(xiàn)象你調(diào)用SetWindowPos設(shè)置的窗口位置和大小與實(shí)際顯示的位置大小不符。你的自定義拖動(dòng)區(qū)域點(diǎn)擊位置和實(shí)際拖動(dòng)響應(yīng)位置有偏移。原因Windows API使用的坐標(biāo)可能是“邏輯像素”而Unity和屏幕是“物理像素”。DPI縮放因子在其中作祟。解決方案確保Unity DPI感知在Player Settings中檢查Resolution and Presentation下的Use DXGI Flip Model...和DPI Awareness相關(guān)設(shè)置不同Unity版本位置可能不同。對(duì)于現(xiàn)代Unity版本通常設(shè)置為“Per Monitor”或“Per Monitor v2”更好。API調(diào)用使用物理坐標(biāo)在獲取鼠標(biāo)位置用于拖動(dòng)計(jì)算時(shí)使用Input.mousePosition屏幕坐標(biāo)是沒(méi)問(wèn)題的因?yàn)閁nity已經(jīng)處理了DPI縮放。但在通過(guò)API如SetWindowPos設(shè)置窗口矩形時(shí)如果你是從其他邏輯尺寸轉(zhuǎn)換而來(lái)需要小心。一個(gè)實(shí)用的方法是在修改窗口樣式和位置時(shí)盡量使用相對(duì)值或基于當(dāng)前屏幕分辨率的比例值而非絕對(duì)像素值。對(duì)于拖動(dòng)功能由于我們只是發(fā)送HTCAPTION消息系統(tǒng)會(huì)自己處理DPI所以通常沒(méi)有問(wèn)題。5.2 坑點(diǎn)二與Unity UIuGUI的輸入沖突當(dāng)你創(chuàng)建了一個(gè)覆蓋全窗口的可點(diǎn)擊UI作為拖動(dòng)區(qū)域時(shí)它可能會(huì)攔截掉其下方其他UI元素的點(diǎn)擊事件。解決方案確保你的“自定義標(biāo)題欄”UI元素上除了Event Trigger用于拖動(dòng)不要添加Graphic Raycaster組件或者將其Raycast Target屬性勾選掉。這樣它就不會(huì)阻擋射線投射下方按鈕的點(diǎn)擊事件就能正常觸發(fā)。拖動(dòng)事件依賴于IPointerDownHandler這不需要Graphic Raycaster。5.3 坑點(diǎn)三窗口陰影丟失移除WS_THICKFRAME樣式后Windows 10/11為窗口添加的默認(rèn)漂亮陰影也會(huì)消失窗口看起來(lái)像一張“紙片”貼在桌面上缺乏層次感。解決方案使用DWMDesktop Window ManagerAPI來(lái)為窗口重新添加陰影。這需要用到dwmapi.dll中的DwmExtendFrameIntoClientArea函數(shù)但用法較為晦澀。一個(gè)更簡(jiǎn)單、跨Unity版本兼容性更好的方案是創(chuàng)建一個(gè)比內(nèi)容區(qū)域稍大的、半透明的、帶模糊背景的UI作為窗口邊框。但這會(huì)消耗額外的渲染開(kāi)銷。折中方案對(duì)于很多應(yīng)用沒(méi)有陰影是可以接受的。如果你需要陰影可以搜索“Unity Windows drop shadow”尋找社區(qū)插件或更完整的原生插件解決方案。5.4 坑點(diǎn)四多平臺(tái)兼容性與未來(lái)維護(hù)本文所有代碼都只針對(duì)Windows平臺(tái).dll導(dǎo)入。如果你的項(xiàng)目需要發(fā)布到macOS或Linux這些代碼會(huì)編譯失敗。解決方案使用平臺(tái)依賴編譯。#if UNITY_STANDALONE_WIN [DllImport(user32.dll)] private static extern IntPtr GetActiveWindow(); // ... 其他Windows API聲明 #endif public void RemoveWindowTitleBar() { #if UNITY_STANDALONE_WIN // Windows平臺(tái)的實(shí)現(xiàn)代碼 #else Debug.LogWarning(Custom window styling is only supported on Windows standalone builds.); #endif }對(duì)于macOS自定義窗口需要使用Cocoa APILinux則可能需要X11相關(guān)庫(kù)實(shí)現(xiàn)復(fù)雜度更高通常需要專門(mén)的插件。5.5 坑點(diǎn)五殺毒軟件或系統(tǒng)安全軟件的誤報(bào)頻繁調(diào)用底層Windows API修改窗口屬性尤其是涉及SetWindowLong和SendMessage有時(shí)會(huì)被一些過(guò)于敏感的安全軟件標(biāo)記為可疑行為?，F(xiàn)象打包后的exe運(yùn)行時(shí)被攔截或功能被禁用。應(yīng)對(duì)措施代碼簽名為你的最終exe購(gòu)買(mǎi)代碼簽名證書(shū)并簽名這能極大增加軟件的可信度。減少敏感API組合調(diào)用避免在程序啟動(dòng)時(shí)立即進(jìn)行大量窗口樣式修改。可以考慮在用戶進(jìn)行某個(gè)操作如點(diǎn)擊“進(jìn)入演示模式”后再觸發(fā)。提交給安全軟件廠商白名單如果你的軟件是正規(guī)商業(yè)軟件可以向各大安全軟件廠商提交樣本申請(qǐng)加入白名單。清晰的用戶告知在軟件首次運(yùn)行時(shí)或設(shè)置中說(shuō)明本軟件會(huì)修改窗口外觀以獲得更好體驗(yàn)如果安全軟件報(bào)警請(qǐng)選擇允許。6. 完整示例與最佳實(shí)踐整合讓我們將上面的知識(shí)點(diǎn)整合成一個(gè)更健壯、更易用的管理器類并附上在Unity中的設(shè)置步驟。6.1 完整的Windows窗口管理器腳本// WindowsWindowManager.cs using System; using System.Runtime.InteropServices; using UnityEngine; using UnityEngine.EventSystems; public class WindowsWindowManager : MonoBehaviour { #if UNITY_STANDALONE_WIN [DllImport(user32.dll)] private static extern IntPtr GetActiveWindow(); [DllImport(user32.dll)] private static extern int GetWindowLong(IntPtr hWnd, int nIndex); [DllImport(user32.dll, SetLastError true)] private static extern int SetWindowLong(IntPtr hWnd, int nIndex, int dwNewLong); [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); [DllImport(user32.dll)] [return: MarshalAs(UnmanagedType.Bool)] private static extern bool ReleaseCapture(); [DllImport(user32.dll)] private static extern IntPtr SendMessage(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam); // 常量定義 private const int GWL_STYLE -16; private const int WS_CAPTION 0x00C00000; private const int WS_THICKFRAME 0x00040000; private const uint SWP_FRAMECHANGED 0x0020; private const uint SWP_NOMOVE 0x0002; private const uint SWP_NOSIZE 0x0001; private const uint SWP_NOZORDER 0x0004; private const uint WM_NCLBUTTONDOWN 0xA1; private const int HTCAPTION 2; private IntPtr _windowHandle; private bool _isBorderless false; #endif [Header(Settings)] [Tooltip(是否在啟動(dòng)時(shí)移除標(biāo)題欄和邊框)] public bool removeBorderOnStart true; [Tooltip(用于拖動(dòng)的自定義標(biāo)題欄RectTransform可選)] public RectTransform dragHandleArea; void Start() { #if UNITY_STANDALONE_WIN // 延遲獲取句柄確保窗口已創(chuàng)建 Invoke(nameof(InitializeWindowHandle), 0.1f); #else Debug.Log(Windows window styling is only applicable in Windows standalone builds.); #endif } #if UNITY_STANDALONE_WIN private void InitializeWindowHandle() { _windowHandle GetActiveWindow(); if (_windowHandle IntPtr.Zero) { Debug.LogError(Could not retrieve window handle. Borderless mode disabled.); return; } if (removeBorderOnStart) { SetBorderlessWindow(true); } // 為拖動(dòng)區(qū)域設(shè)置事件如果已指定 SetupDragHandle(); } /// summary /// 設(shè)置或取消無(wú)邊框窗口。 /// /summary /// param nameborderlesstrue為無(wú)邊框false為恢復(fù)默認(rèn)。/param public void SetBorderlessWindow(bool borderless) { if (_windowHandle IntPtr.Zero || _isBorderless borderless) return; int currentStyle GetWindowLong(_windowHandle, GWL_STYLE); int newStyle currentStyle; if (borderless) { // 移除標(biāo)題欄和厚邊框 newStyle ~WS_CAPTION; newStyle ~WS_THICKFRAME; } else { // 恢復(fù)標(biāo)題欄和厚邊框注意這不一定能完全恢復(fù)到初始默認(rèn)狀態(tài) newStyle | WS_CAPTION; newStyle | WS_THICKFRAME; } SetWindowLong(_windowHandle, GWL_STYLE, newStyle); // 強(qiáng)制刷新窗口框架 SetWindowPos(_windowHandle, IntPtr.Zero, 0, 0, 0, 0, SWP_FRAMECHANGED | SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER); _isBorderless borderless; Debug.Log($Window borderless set to: {borderless}); } /// summary /// 使窗口可被拖動(dòng)。應(yīng)由UI事件觸發(fā)。 /// /summary public void StartDragWindow() { if (_windowHandle IntPtr.Zero || !_isBorderless) return; ReleaseCapture(); SendMessage(_windowHandle, WM_NCLBUTTONDOWN, (IntPtr)HTCAPTION, IntPtr.Zero); } private void SetupDragHandle() { if (dragHandleArea ! null) { EventTrigger trigger dragHandleArea.gameObject.GetComponentEventTrigger(); if (trigger null) trigger dragHandleArea.gameObject.AddComponentEventTrigger(); EventTrigger.Entry entry new EventTrigger.Entry(); entry.eventID EventTriggerType.PointerDown; entry.callback.AddListener((data) { StartDragWindow(); }); trigger.triggers.Add(entry); // 重要確保拖動(dòng)區(qū)域不阻擋其下UI的點(diǎn)擊 var graphic dragHandleArea.GetComponentUnityEngine.UI.Graphic(); if (graphic ! null) graphic.raycastTarget true; // 需要接收事件所以設(shè)為true // 其下的UI元素應(yīng)正常設(shè)置raycastTarget } } #endif // 提供給UI按鈕的簡(jiǎn)單控制方法 public void CloseApplication() { #if UNITY_EDITOR UnityEditor.EditorApplication.isPlaying false; #else Application.Quit(); #endif } }6.2 Unity場(chǎng)景中的設(shè)置步驟創(chuàng)建管理器在場(chǎng)景中創(chuàng)建一個(gè)空的GameObject命名為“WindowManager”。掛載腳本將WindowsWindowManager腳本掛載上去。創(chuàng)建自定義標(biāo)題欄在Canvas下創(chuàng)建一個(gè)Image或Panel命名為“CustomTitleBar”。將其錨點(diǎn)Anchors設(shè)置為頂部拉伸Top Stretch調(diào)整高度如30。設(shè)置一個(gè)醒目的背景色以便調(diào)試。連接引用將“CustomTitleBar”的RectTransform拖拽到WindowsWindowManager組件的Drag Handle Area字段。創(chuàng)建控制按鈕可選在“CustomTitleBar”內(nèi)創(chuàng)建“關(guān)閉”按鈕。為按鈕的OnClick()事件添加監(jiān)聽(tīng)選擇WindowManager-WindowsWindowManager.CloseApplication方法。測(cè)試在編輯器中運(yùn)行由于API只在Windows Standalone生效你可能看不到變化。但可以測(cè)試按鈕點(diǎn)擊事件。關(guān)鍵的一步構(gòu)建項(xiàng)目Build Settings - PC, Mac Linux Standalone - Target Platform: Windows。運(yùn)行生成的.exe文件你將看到標(biāo)題欄和邊框已經(jīng)消失并且可以通過(guò)頂部的自定義標(biāo)題欄拖動(dòng)窗口。6.3 構(gòu)建設(shè)置檢查清單在打包前請(qǐng)確認(rèn)以下設(shè)置Player Settings Resolution and Presentation:Fullscreen Mode: 設(shè)置為Windowed。我們的API修改是基于窗口模式的。WidthHeight: 設(shè)置你期望的初始窗口分辨率。Allow Fullscreen Switch: 根據(jù)需求勾選。如果啟用用戶按AltEnter會(huì)切換到真正的全屏可能會(huì)覆蓋我們的無(wú)邊框效果。Player Settings Other Settings:Api Compatibility Level*: 保持.NET Standard 2.1或.NET Framework根據(jù)你的需求。Scripting Backend: Mono或IL2CPP均可。IL2CPP更推薦用于發(fā)布。構(gòu)建路徑確保輸出路徑?jīng)]有中文或特殊字符。7. 常見(jiàn)問(wèn)題排查與調(diào)試技巧即使按照指南操作你可能還是會(huì)遇到一些問(wèn)題。這里是一個(gè)快速排查清單。7.1 問(wèn)題打包后運(yùn)行窗口樣式?jīng)]有任何變化。可能原因1腳本中的平臺(tái)編譯指令#if UNITY_STANDALONE_WIN沒(méi)有生效。檢查確保你在構(gòu)建時(shí)選擇的目標(biāo)平臺(tái)是“Windows”。在編輯器中運(yùn)行不會(huì)調(diào)用這些API?？赡茉?獲取窗口句柄失敗。調(diào)試在InitializeWindowHandle函數(shù)中添加Debug.Log($Window Handle: {_windowHandle});。打包后運(yùn)行查看日志文件通常位于%USERPROFILE%\AppData\LocalLow\[CompanyName]\[ProductName]\output_log.txt。如果句柄是0說(shuō)明獲取失敗。嘗試將初始化延遲更長(zhǎng)的時(shí)間例如在Start()中用Invoke(nameof(InitializeWindowHandle), 0.5f)。可能原因3SetWindowPos沒(méi)有攜帶SWP_FRAMECHANGED標(biāo)志。檢查確認(rèn)調(diào)用SetWindowPos時(shí)包含了SWP_FRAMECHANGED。7.2 問(wèn)題窗口可以無(wú)邊框但無(wú)法拖動(dòng)?？赡茉?拖動(dòng)區(qū)域UI的Raycast Target未開(kāi)啟或EventTrigger設(shè)置不正確。檢查確認(rèn)自定義標(biāo)題欄的Image組件Raycast Target已勾選。確認(rèn)EventTrigger的PointerDown事件已正確綁定到StartDragWindow方法?？赡茉?ReleaseCapture()或SendMessage()調(diào)用失敗。調(diào)試在StartDragWindow方法開(kāi)始處添加Debug.Log(Dragging...);打包后測(cè)試看日志是否有輸出。確保_windowHandle有效且_isBorderless為true。7.3 問(wèn)題窗口位置或大小在移除邊框后變了?？赡茉蛞瞥齏S_CAPTION和WS_THICKFRAME后窗口的客戶區(qū)Client Area大小計(jì)算方式變了。SetWindowPos調(diào)用時(shí)如果之前窗口是標(biāo)準(zhǔn)樣式系統(tǒng)會(huì)基于包含標(biāo)題欄的窗口矩形來(lái)定位。移除后同樣的矩形參數(shù)可能導(dǎo)致窗口顯示位置偏移。解決方案在調(diào)用SetBorderlessWindow(true)之前先記錄當(dāng)前窗口的位置和大小可以通過(guò)Screen.width和Screen.height但這是整個(gè)窗口的尺寸。然后在設(shè)置無(wú)邊框后再用SetWindowPos將其設(shè)置回原來(lái)的位置和大小?；蛘吒?jiǎn)單的方法是在窗口初始就是無(wú)邊框的狀態(tài)下啟動(dòng)?？梢栽赟tart()中立刻調(diào)用SetBorderlessWindow這樣窗口創(chuàng)建時(shí)就是無(wú)邊框的位置由Player Settings中的設(shè)置決定。7.4 問(wèn)題在無(wú)邊框窗口下如何實(shí)現(xiàn)窗口縮放這是一個(gè)高級(jí)功能。標(biāo)準(zhǔn)做法是處理WM_NCHITTEST消息當(dāng)鼠標(biāo)移動(dòng)到窗口邊緣時(shí)返回HTLEFT,HTRIGHT,HTTOP,HTTOPLEFT等值告訴系統(tǒng)可以在此處調(diào)整大小。但這需要在C插件中實(shí)現(xiàn)復(fù)雜的消息循環(huán)鉤子并將其傳遞給Unity實(shí)現(xiàn)門(mén)檻很高。實(shí)用替代方案在你的應(yīng)用界面角落放置幾個(gè)透明的、可拖動(dòng)的UI元素。當(dāng)用戶拖動(dòng)這些元素時(shí)通過(guò)SetWindowPos動(dòng)態(tài)改變窗口的寬度和高度。這需要你手動(dòng)計(jì)算鼠標(biāo)移動(dòng)的偏移量并轉(zhuǎn)換為窗口尺寸的變化。雖然不如系統(tǒng)原生的邊緣縮放流暢但可以實(shí)現(xiàn)基本功能。7.5 調(diào)試建議使用日志文件在關(guān)鍵函數(shù)入口添加Debug.Log。打包后日志會(huì)寫(xiě)入到output_log.txt文件。這是排查運(yùn)行時(shí)問(wèn)題最重要的工具。分步測(cè)試不要一次性實(shí)現(xiàn)所有功能。先確保能成功移除邊框再添加拖動(dòng)功能最后再加控制按鈕。備份原始樣式在SetBorderlessWindow函數(shù)中可以在修改前將currentStyle保存下來(lái)。這樣你可以在運(yùn)行時(shí)提供一個(gè)“恢復(fù)默認(rèn)”的按鈕方便調(diào)試和用戶選擇?？紤]使用現(xiàn)有插件如果你覺(jué)得直接操作Windows API太復(fù)雜或者需要更穩(wěn)定、功能更全的解決方案如完整的窗口縮放、陰影、跨平臺(tái)支持可以考慮Asset Store上的成熟插件如“Standalone Window Manager”、“Borderless Window”等。它們封裝了底層細(xì)節(jié)并提供更友好的編輯器接口。但理解本文的原理能幫助你更好地使用和調(diào)試這些插件。從Unity播放器到擁有自定義外觀的獨(dú)立exe這最后一步的打磨是區(qū)分業(yè)余作品與專業(yè)產(chǎn)品的關(guān)鍵細(xì)節(jié)之一。它要求開(kāi)發(fā)者跳出舒適區(qū)與操作系統(tǒng)底層進(jìn)行交互。這個(gè)過(guò)程雖然充滿挑戰(zhàn)但當(dāng)你看到自己的應(yīng)用以完全符合設(shè)計(jì)意圖的形態(tài)呈現(xiàn)在桌面上時(shí)那種成就感是巨大的。希望這篇指南不僅能提供代碼更能幫你理解背后的“為什么”讓你在遇到問(wèn)題時(shí)能自己找到答案。記住在PC端窗口就是你的應(yīng)用給用戶的第一張臉值得你花心思把它打扮好。 Unity PC應(yīng)用窗口自定義：徹底擺脫播放器感，實(shí)現(xiàn)專業(yè)級(jí)無(wú)邊框窗口
1. 項(xiàng)目概述從播放器到專業(yè)應(yīng)用的最后一步如果你用Unity開(kāi)發(fā)過(guò)PC游戲或者工具應(yīng)用大概率經(jīng)歷過(guò)這個(gè)階段在編輯器里跑得飛快畫(huà)面炫酷交互流暢一切都那么完美。然后你滿懷期待地點(diǎn)擊“Build”生成一個(gè).exe文件雙擊打開(kāi)——一個(gè)帶著默認(rèn)Windows標(biāo)題欄、可能還有難看邊框的窗口彈了出來(lái)。那一刻感覺(jué)就像精心準(zhǔn)備的晚宴最后端上來(lái)的主菜卻用了一次性塑料餐盒裝著。項(xiàng)目的專業(yè)感瞬間崩塌。這就是我們今天要啃的硬骨頭Unity打包PC端應(yīng)用時(shí)如何徹底擺脫那個(gè)“播放器感”十足的默認(rèn)窗口實(shí)現(xiàn)隱藏標(biāo)題欄和深度自定義窗口外觀。這不僅僅是“看起來(lái)更酷”對(duì)于很多工具類、演示類、信息展示類應(yīng)用來(lái)說(shuō)一個(gè)干凈、無(wú)干擾、甚至形狀獨(dú)特的窗口是產(chǎn)品體驗(yàn)的核心組成部分。我見(jiàn)過(guò)太多優(yōu)秀的Unity項(xiàng)目最終卡在了這“最后一公里”的交付體驗(yàn)上要么是窗口無(wú)法置頂要么是隱藏標(biāo)題欄后窗口沒(méi)法拖動(dòng)或者自定義邊框帶來(lái)了詭異的點(diǎn)擊穿透問(wèn)題。網(wǎng)上的資料零散且坑多有的只講調(diào)用Windows API卻不提Unity不同渲染管線下的差異有的實(shí)現(xiàn)了無(wú)邊框但窗口再也無(wú)法移動(dòng)更常見(jiàn)的是代碼在編輯器里運(yùn)行良好一打包就失效?；谖疫@些年踩過(guò)的坑和項(xiàng)目實(shí)戰(zhàn)經(jīng)驗(yàn)這篇指南將系統(tǒng)性地拆解從標(biāo)準(zhǔn)“播放器窗口”到“專業(yè)級(jí)應(yīng)用窗口”的完整路徑。我們會(huì)深入原理提供可直接復(fù)制粘貼的健壯代碼并重點(diǎn)分享那些官方文檔不會(huì)告訴你的“避坑秘籍”。無(wú)論你是想做一個(gè)無(wú)邊框的儀表盤(pán)、一個(gè)可自定義形狀的創(chuàng)意工具還是一個(gè)需要隱藏所有系統(tǒng)UI的Kiosk模式應(yīng)用這里都有你需要的答案。2. 核心需求解析為什么以及何時(shí)需要自定義窗口在動(dòng)手寫(xiě)任何一行代碼之前我們必須先厘清需求。盲目地隱藏標(biāo)題欄或修改窗口樣式可能會(huì)引入意想不到的交互問(wèn)題。通常驅(qū)動(dòng)我們進(jìn)行窗口自定義的需求可以歸結(jié)為以下幾類每一種都對(duì)應(yīng)著不同的技術(shù)實(shí)現(xiàn)深度和潛在風(fēng)險(xiǎn)。2.1 提升視覺(jué)沉浸感與產(chǎn)品專業(yè)度這是最常見(jiàn)也是最直接的需求。Unity默認(rèn)的窗口帶有標(biāo)準(zhǔn)的Windows標(biāo)題欄包含圖標(biāo)、標(biāo)題、最小化、最大化、關(guān)閉按鈕和可調(diào)整大小的邊框。對(duì)于游戲而言全屏模式可以解決這個(gè)問(wèn)題。但對(duì)于非游戲應(yīng)用尤其是以下場(chǎng)景數(shù)字標(biāo)牌與信息展示屏在商場(chǎng)、展廳、會(huì)議室應(yīng)用需要長(zhǎng)時(shí)間全屏顯示任何系統(tǒng)UI都是干擾。創(chuàng)意工具與藝術(shù)裝置例如音樂(lè)可視化軟件、交互式藝術(shù)投影窗口本身需要成為畫(huà)布的一部分而非一個(gè)容器。模擬器與專業(yè)控制面板追求極致的界面還原模仿真實(shí)設(shè)備的屏幕不允許有多余的邊框。在這些場(chǎng)景下隱藏標(biāo)題欄和邊框是剛需。目標(biāo)是將Unity渲染的內(nèi)容直接作為“窗口”本身呈現(xiàn)給用戶實(shí)現(xiàn)應(yīng)用與操作系統(tǒng)桌面環(huán)境的視覺(jué)剝離讓用戶完全聚焦于內(nèi)容。2.2 實(shí)現(xiàn)特殊的窗口交互邏輯標(biāo)準(zhǔn)窗口的交互是由Windows系統(tǒng)管理的。當(dāng)你隱藏了標(biāo)題欄就意味著失去了系統(tǒng)提供的窗口移動(dòng)、縮放、關(guān)閉等標(biāo)準(zhǔn)交互方式。這時(shí)自定義需求就出現(xiàn)了自定義拖拽區(qū)域你可能希望點(diǎn)擊應(yīng)用的某個(gè)特定UI區(qū)域比如一個(gè)自定義的頂部工具欄來(lái)拖動(dòng)窗口而不是整個(gè)窗口客戶區(qū)。實(shí)現(xiàn)非矩形窗口通過(guò)透明通道和鼠標(biāo)點(diǎn)擊檢測(cè)創(chuàng)造出圓形、圓角矩形或其他任意形狀的窗口。這在制作桌面寵物、個(gè)性化小部件時(shí)非常流行。禁用或改寫(xiě)系統(tǒng)菜單右鍵點(diǎn)擊標(biāo)題欄彈出的系統(tǒng)菜單還原、移動(dòng)、大小、最小化、最大化、關(guān)閉可能不符合應(yīng)用邏輯需要禁用或替換為自定義菜單。這類需求要求我們不僅改變窗口的外觀還要接管一部分窗口消息處理邏輯技術(shù)復(fù)雜度更高。2.3 滿足特定的部署與運(yùn)行環(huán)境要求在一些受限或特殊的部署環(huán)境中對(duì)窗口有硬性規(guī)定Kiosk模式/信息亭模式應(yīng)用需要鎖定前臺(tái)防止用戶切換到其他程序。通常需要結(jié)合無(wú)邊框、全屏、以及屏蔽系統(tǒng)快捷鍵如AltF4, AltTab來(lái)實(shí)現(xiàn)。多顯示器拼接與控制在虛擬現(xiàn)實(shí)、環(huán)幕投影等系統(tǒng)中應(yīng)用可能需要跨多個(gè)顯示器顯示一個(gè)無(wú)縫的巨大畫(huà)面這就要求窗口能夠無(wú)邊框且精準(zhǔn)定位。與其他桌面應(yīng)用的窗口層級(jí)管理需要確保你的應(yīng)用窗口始終位于某些窗口之上或之下這涉及到窗口置頂Top-most屬性的管理而自定義窗口樣式是精細(xì)控制這些屬性的前提。理解你的核心需求屬于哪一類是選擇正確技術(shù)方案的第一步。例如如果僅僅是為了全屏沉浸或許Screen.fullScreen true就夠了但如果需要在窗口模式下無(wú)邊框且可移動(dòng)就必須深入Windows API的層面。3. 技術(shù)方案選型與原理剖析Unity本身提供了一些基礎(chǔ)的窗口設(shè)置但對(duì)于深度自定義則力有不逮。這時(shí)我們需要尋求外部力量的幫助主要是通過(guò)平臺(tái)原生插件Native Plugin來(lái)調(diào)用操作系統(tǒng)提供的API。對(duì)于Windows平臺(tái)這就是一系列來(lái)自u(píng)ser32.dll和dwmapi.dll的函數(shù)。3.1 Unity內(nèi)置設(shè)置的能力與局限首先看看不寫(xiě)代碼能做什么。在Player SettingsResolution and PresentationPC Mac Linux Standalone下有一些相關(guān)設(shè)置Fullscreen ModeExclusive Fullscreen獨(dú)占全屏、Fullscreen Window無(wú)邊框窗口全屏、Maximized Window最大化窗口、Windowed窗口化。Fullscreen Window模式會(huì)創(chuàng)建一個(gè)無(wú)邊框、覆蓋整個(gè)顯示器的窗口是實(shí)現(xiàn)無(wú)邊框最簡(jiǎn)單的方式但你失去了對(duì)窗口位置和尺寸的精確控制。Allow Fullscreen Switch允許通過(guò)AltEnter切換全屏。Resolution設(shè)置默認(rèn)窗口尺寸。在腳本中你可以通過(guò)Screen類動(dòng)態(tài)設(shè)置// 切換到無(wú)邊框全屏窗口 Screen.SetResolution(1920, 1080, FullScreenMode.FullScreenWindow); // 獲取當(dāng)前窗口句柄后續(xù)API調(diào)用需要 IntPtr hwnd GetActiveWindow(); // 需要自己聲明外部方法局限內(nèi)置設(shè)置無(wú)法實(shí)現(xiàn)真正的、可移動(dòng)的“無(wú)邊框窗口化”模式。FullScreenWindow是全屏的而Windowed模式一定有標(biāo)題欄和邊框。你無(wú)法創(chuàng)建一個(gè)在桌面任意位置、大小可調(diào)、且沒(méi)有標(biāo)題欄的窗口。這就是我們需要調(diào)用原生API的根本原因。3.2 Windows API我們的核心工具包為了實(shí)現(xiàn)高級(jí)窗口控制我們需要與Windows系統(tǒng)的窗口管理器直接對(duì)話。關(guān)鍵API函數(shù)來(lái)自u(píng)ser32.dllSetWindowLongPtr用于設(shè)置窗口的擴(kuò)展樣式GWL_EXSTYLE和普通樣式GWL_STYLE。這是我們隱藏標(biāo)題欄、邊框、菜單的關(guān)鍵。GetWindowLongPtr獲取當(dāng)前的窗口樣式。SetWindowPos設(shè)置窗口的位置、大小、Z序置頂?shù)纫约坝|發(fā)樣式更新。ReleaseCapture,SendMessage用于實(shí)現(xiàn)無(wú)標(biāo)題欄窗口的拖動(dòng)。當(dāng)用戶在沒(méi)有標(biāo)題欄的區(qū)域點(diǎn)擊并拖動(dòng)時(shí)我們需要向Windows發(fā)送WM_NCLBUTTONDOWN消息并附帶HTCAPTION參數(shù)欺騙系統(tǒng)認(rèn)為用戶正在拖動(dòng)標(biāo)題欄。FindWindow/GetActiveWindow用于獲取當(dāng)前Unity窗口的句柄HWND。句柄是操作系統(tǒng)識(shí)別每個(gè)窗口的唯一標(biāo)識(shí)所有API調(diào)用都離不開(kāi)它。一個(gè)關(guān)鍵概念窗口樣式Window StylesWindows窗口的外觀和行為由一系列樣式位標(biāo)志控制。例如WS_CAPTION包含標(biāo)題欄。WS_THICKFRAME可調(diào)整大小的邊框。WS_SYSMENU有關(guān)閉按鈕的系統(tǒng)菜單。WS_MAXIMIZEBOX/WS_MINIMIZEBOX最大化/最小化按鈕。 要隱藏它們我們的思路是先獲取當(dāng)前窗口的樣式然后用位操作 ~移除我們不需要的樣式位最后將新樣式設(shè)置回去。3.3 方案對(duì)比從簡(jiǎn)單到復(fù)雜根據(jù)需求復(fù)雜度我們可以選擇不同層級(jí)的方案方案A簡(jiǎn)易無(wú)邊框全屏方法使用Unity內(nèi)置FullScreenMode.FullScreenWindow。優(yōu)點(diǎn)零代碼最簡(jiǎn)單。缺點(diǎn)窗口必須鋪滿整個(gè)屏幕無(wú)法窗口化運(yùn)行。不適合需要同時(shí)查看其他應(yīng)用的工具軟件。方案B可移動(dòng)的無(wú)邊框窗口主流需求方法在Windowed模式下使用Windows API移除WS_CAPTION和WS_THICKFRAME樣式并自己實(shí)現(xiàn)窗口拖動(dòng)邏輯。優(yōu)點(diǎn)實(shí)現(xiàn)了真正意義上的、可自由移動(dòng)的“無(wú)邊框窗口”平衡了美觀與實(shí)用性。缺點(diǎn)需要編寫(xiě)并管理原生插件交互代碼實(shí)現(xiàn)拖動(dòng)邏輯。方案C完全自定義的非客戶區(qū)方法在方案B的基礎(chǔ)上進(jìn)一步處理WM_NCCALCSIZE消息允許你完全定義窗口的非客戶區(qū)邊框、標(biāo)題欄區(qū)域甚至可以繪制自定義的窗口控件最小化、關(guān)閉按鈕。優(yōu)點(diǎn)自由度最高可以實(shí)現(xiàn)任何視覺(jué)設(shè)計(jì)。缺點(diǎn)復(fù)雜度急劇上升需要處理大量的Windows消息容易引入穩(wěn)定性問(wèn)題且與Unity的UI系統(tǒng)整合困難。對(duì)于90%的需求方案B是最佳平衡點(diǎn)。接下來(lái)我們將重點(diǎn)深入方案B的實(shí)現(xiàn)細(xì)節(jié)與避坑要點(diǎn)。4. 核心實(shí)現(xiàn)移除標(biāo)題欄與實(shí)現(xiàn)窗口拖動(dòng)這是整個(gè)流程中最核心、也最容易出錯(cuò)的環(huán)節(jié)。我們將分步拆解并提供經(jīng)過(guò)項(xiàng)目驗(yàn)證的健壯代碼。4.1 第一步聲明與獲取窗口句柄首先我們需要在C#腳本中聲明將要使用的Windows API函數(shù)。建議創(chuàng)建一個(gè)單獨(dú)的類如WindowsWindowManager.cs。using System; using System.Runtime.InteropServices; using UnityEngine; public class WindowsWindowManager : MonoBehaviour { // 引入必要的Windows API函數(shù) [DllImport(user32.dll)] private static extern IntPtr GetActiveWindow(); [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); [DllImport(user32.dll)] private static extern bool SetWindowPos(IntPtr hWnd, IntPtr hWndInsertAfter, int X, int Y, int cx, int cy, uint uFlags); [DllImport(user32.dll)] private static extern bool ReleaseCapture(); [DllImport(user32.dll)] private static extern IntPtr SendMessage(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam); // 窗口樣式索引 private const int GWL_STYLE -16; // 窗口樣式常量 private const int WS_CAPTION 0x00C00000; private const int WS_THICKFRAME 0x00040000; private const int WS_SYSMENU 0x00080000; private const int WS_MAXIMIZEBOX 0x00010000; private const int WS_MINIMIZEBOX 0x00020000; // SetWindowPos 標(biāo)志 private const uint SWP_FRAMECHANGED 0x0020; private const uint SWP_NOMOVE 0x0002; private const uint SWP_NOSIZE 0x0001; private const uint SWP_NOZORDER 0x0004; // 消息常量 private const uint WM_NCLBUTTONDOWN 0xA1; private const int HTCAPTION 2; private IntPtr _windowHandle; void Start() { // 獲取當(dāng)前Unity窗口的句柄 _windowHandle GetActiveWindow(); if (_windowHandle IntPtr.Zero) { Debug.LogError(Failed to get window handle.); return; } // 可以在此處調(diào)用移除標(biāo)題欄的函數(shù) // RemoveWindowTitleBar(); } }注意132位與64位兼容性上面的代碼使用了GetWindowLong和SetWindowLong。在64位系統(tǒng)上更嚴(yán)謹(jǐn)?shù)淖龇ㄊ鞘褂肎etWindowLongPtr和SetWindowLongPtr因?yàn)樗鼈兲幚淼氖侵羔槾笮〉臄?shù)據(jù)。Unity的Mono/IL2CPP腳本后端在64位下是安全的但為了絕對(duì)兼容你可以使用IntPtr版本或條件編譯。一個(gè)更簡(jiǎn)單的辦法是確保你的項(xiàng)目Player Settings中“Architecture”設(shè)置為x86_64并使用GetWindowLong/SetWindowLong在大多數(shù)情況下是可行的。注意2獲取句柄的時(shí)機(jī)在Start()或Awake()中獲取句柄通常是安全的。但有時(shí)特別是窗口初始化的早期句柄可能還未就緒。一個(gè)更穩(wěn)健的做法是在OnApplicationFocus(true)時(shí)再執(zhí)行樣式修改或者使用Invoke延遲一小段時(shí)間。4.2 第二步移除標(biāo)題欄和邊框現(xiàn)在我們有了句柄可以編寫(xiě)移除樣式的核心函數(shù)。public void RemoveWindowTitleBar() { if (_windowHandle IntPtr.Zero) return; // 1. 獲取當(dāng)前的窗口樣式 int currentStyle GetWindowLong(_windowHandle, GWL_STYLE); // 2. 移除我們不需要的樣式 // 移除標(biāo)題欄(WS_CAPTION)它包含了WS_BORDER, WS_DLGFRAME, WS_SYSMENU, WS_THICKFRAME等的一部分 // 為了更精確控制我們分別移除相關(guān)樣式 int newStyle currentStyle; newStyle ~WS_CAPTION; // 移除標(biāo)題欄 newStyle ~WS_THICKFRAME; // 移除可調(diào)整大小的邊框同時(shí)會(huì)移除最大/最小化按鈕 // newStyle ~WS_SYSMENU; // 謹(jǐn)慎移除系統(tǒng)菜單會(huì)同時(shí)移除關(guān)閉按鈕通常保留。 // newStyle ~WS_MAXIMIZEBOX; // 移除最大化按鈕 // newStyle ~WS_MINIMIZEBOX; // 移除最小化按鈕 // 3. 應(yīng)用新的窗口樣式 SetWindowLong(_windowHandle, GWL_STYLE, newStyle); // 4. 關(guān)鍵步驟強(qiáng)制Windows重新計(jì)算窗口的非客戶區(qū)邊框、標(biāo)題欄區(qū)域 // 如果不調(diào)用SetWindowPos樣式更改可能不會(huì)立即生效或者窗口大小會(huì)出錯(cuò)。 SetWindowPos(_windowHandle, IntPtr.Zero, 0, 0, 0, 0, SWP_FRAMECHANGED | SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER); Debug.Log(Window title bar and thick frame removed.); }原理剖析為什么需要SetWindowPos當(dāng)你修改GWL_STYLE后Windows并不會(huì)自動(dòng)重新繪制窗口的非客戶區(qū)。SetWindowPos函數(shù)即使不改變窗口位置和大小通過(guò)SWP_NOMOVE | SWP_NOSIZE只要攜帶SWP_FRAMECHANGED標(biāo)志就會(huì)通知系統(tǒng)“窗口框架變了請(qǐng)重新計(jì)算和繪制”。這是讓無(wú)邊框效果生效的關(guān)鍵一步很多教程遺漏了這一點(diǎn)導(dǎo)致修改無(wú)效或窗口尺寸異常。4.3 第三步實(shí)現(xiàn)無(wú)標(biāo)題欄窗口的拖動(dòng)移除了標(biāo)題欄窗口就無(wú)法拖動(dòng)了。我們需要在Unity的UI或3D對(duì)象上監(jiān)聽(tīng)拖動(dòng)事件然后發(fā)送Windows消息來(lái)模擬標(biāo)題欄拖動(dòng)。// 在WindowsWindowManager類中添加此方法 public void DragWindow() { if (_windowHandle IntPtr.Zero) return; // 釋放Unity可能持有的鼠標(biāo)捕獲 ReleaseCapture(); // 發(fā)送消息告訴系統(tǒng)“用戶在標(biāo)題欄上按下了鼠標(biāo)左鍵并開(kāi)始拖動(dòng)” SendMessage(_windowHandle, WM_NCLBUTTONDOWN, (IntPtr)HTCAPTION, IntPtr.Zero); }現(xiàn)在你需要將這個(gè)拖動(dòng)邏輯綁定到某個(gè)可交互的UI元素上。例如你可以創(chuàng)建一個(gè)作為“自定義標(biāo)題欄”的UI Panel。在Unity中創(chuàng)建一個(gè)Image或Panel作為你的自定義標(biāo)題欄。為其添加Event Trigger組件。在Event Trigger中添加PointerDown事件。將WindowsWindowManager實(shí)例的DragWindow方法拖拽到事件回調(diào)中。實(shí)操心得拖動(dòng)區(qū)域設(shè)計(jì)你的自定義標(biāo)題欄最好有一定高度如30像素并放置在窗口頂部符合用戶習(xí)慣。雙擊最大化如果你保留了最大化功能可以嘗試監(jiān)聽(tīng)雙擊事件然后調(diào)用SendMessage發(fā)送WM_NCLBUTTONDBLCLK消息。但實(shí)現(xiàn)起來(lái)更復(fù)雜且與Unity UI事件可能沖突。一個(gè)更簡(jiǎn)單的替代方案是自己寫(xiě)代碼切換窗口大小。鼠標(biāo)光標(biāo)反饋當(dāng)鼠標(biāo)懸停在你的自定義標(biāo)題欄上時(shí)光標(biāo)不會(huì)自動(dòng)變成“移動(dòng)”形狀。你可以通過(guò)Cursor.SetCursor來(lái)設(shè)置自定義光標(biāo)提升體驗(yàn)。4.4 第四步處理關(guān)閉、最小化、最大化按鈕移除了系統(tǒng)標(biāo)題欄你還需要提供替代的窗口控制按鈕。關(guān)閉最簡(jiǎn)單直接調(diào)用Application.Quit()。但要注意在編輯器模式下這可能會(huì)停止播放?？梢约訔l件編譯#if UNITY_EDITOR UnityEditor.EditorApplication.isPlaying false; #else Application.Quit(); #endif最小化使用APIShowWindow傳入SW_MINIMIZE參數(shù)。最大化/還原這是最棘手的。你不能簡(jiǎn)單地移除WS_MAXIMIZEBOX然后自己實(shí)現(xiàn)因?yàn)樽畲蠡?還原涉及到窗口狀態(tài)管理和尺寸計(jì)算。一個(gè)相對(duì)穩(wěn)定的方案是保留WS_MAXIMIZEBOX樣式即不把它從樣式位中移除。隱藏系統(tǒng)提供的最大化按鈕通過(guò)將窗口客戶區(qū)擴(kuò)大覆蓋掉按鈕或者創(chuàng)建一個(gè)無(wú)標(biāo)題欄但保留邊框的樣式變體比較復(fù)雜。在自己的UI按鈕中調(diào)用ShowWindow傳入SW_MAXIMIZE或SW_RESTORE。由于最大化/還原的完全自定義實(shí)現(xiàn)非常復(fù)雜且容易出bug對(duì)于許多應(yīng)用我建議直接禁用最大化功能移除WS_MAXIMIZEBOX或者使用“切換到一個(gè)預(yù)設(shè)的較大尺寸”來(lái)模擬最大化而不是真正的系統(tǒng)最大化狀態(tài)。5. 高級(jí)主題與深度避坑指南完成了基礎(chǔ)功能我們來(lái)看看那些容易讓人栽跟頭的高級(jí)問(wèn)題和解決方案。5.1 坑點(diǎn)一DPI縮放與高分辨率屏幕在高DPI縮放比例 100%的顯示器上Windows會(huì)進(jìn)行DPI虛擬化。Unity 2017.4及以后版本對(duì)DPI感知有更好的支持但結(jié)合自定義窗口API可能會(huì)遇到坐標(biāo)錯(cuò)亂的問(wèn)題。現(xiàn)象你調(diào)用SetWindowPos設(shè)置的窗口位置和大小與實(shí)際顯示的位置大小不符。你的自定義拖動(dòng)區(qū)域點(diǎn)擊位置和實(shí)際拖動(dòng)響應(yīng)位置有偏移。原因Windows API使用的坐標(biāo)可能是“邏輯像素”而Unity和屏幕是“物理像素”。DPI縮放因子在其中作祟。解決方案確保Unity DPI感知在Player Settings中檢查Resolution and Presentation下的Use DXGI Flip Model...和DPI Awareness相關(guān)設(shè)置不同Unity版本位置可能不同。對(duì)于現(xiàn)代Unity版本通常設(shè)置為“Per Monitor”或“Per Monitor v2”更好。API調(diào)用使用物理坐標(biāo)在獲取鼠標(biāo)位置用于拖動(dòng)計(jì)算時(shí)使用Input.mousePosition屏幕坐標(biāo)是沒(méi)問(wèn)題的因?yàn)閁nity已經(jīng)處理了DPI縮放。但在通過(guò)API如SetWindowPos設(shè)置窗口矩形時(shí)如果你是從其他邏輯尺寸轉(zhuǎn)換而來(lái)需要小心。一個(gè)實(shí)用的方法是在修改窗口樣式和位置時(shí)盡量使用相對(duì)值或基于當(dāng)前屏幕分辨率的比例值而非絕對(duì)像素值。對(duì)于拖動(dòng)功能由于我們只是發(fā)送HTCAPTION消息系統(tǒng)會(huì)自己處理DPI所以通常沒(méi)有問(wèn)題。5.2 坑點(diǎn)二與Unity UIuGUI的輸入沖突當(dāng)你創(chuàng)建了一個(gè)覆蓋全窗口的可點(diǎn)擊UI作為拖動(dòng)區(qū)域時(shí)它可能會(huì)攔截掉其下方其他UI元素的點(diǎn)擊事件。解決方案確保你的“自定義標(biāo)題欄”UI元素上除了Event Trigger用于拖動(dòng)不要添加Graphic Raycaster組件或者將其Raycast Target屬性勾選掉。這樣它就不會(huì)阻擋射線投射下方按鈕的點(diǎn)擊事件就能正常觸發(fā)。拖動(dòng)事件依賴于IPointerDownHandler這不需要Graphic Raycaster。5.3 坑點(diǎn)三窗口陰影丟失移除WS_THICKFRAME樣式后Windows 10/11為窗口添加的默認(rèn)漂亮陰影也會(huì)消失窗口看起來(lái)像一張“紙片”貼在桌面上缺乏層次感。解決方案使用DWMDesktop Window ManagerAPI來(lái)為窗口重新添加陰影。這需要用到dwmapi.dll中的DwmExtendFrameIntoClientArea函數(shù)但用法較為晦澀。一個(gè)更簡(jiǎn)單、跨Unity版本兼容性更好的方案是創(chuàng)建一個(gè)比內(nèi)容區(qū)域稍大的、半透明的、帶模糊背景的UI作為窗口邊框。但這會(huì)消耗額外的渲染開(kāi)銷。折中方案對(duì)于很多應(yīng)用沒(méi)有陰影是可以接受的。如果你需要陰影可以搜索“Unity Windows drop shadow”尋找社區(qū)插件或更完整的原生插件解決方案。5.4 坑點(diǎn)四多平臺(tái)兼容性與未來(lái)維護(hù)本文所有代碼都只針對(duì)Windows平臺(tái).dll導(dǎo)入。如果你的項(xiàng)目需要發(fā)布到macOS或Linux這些代碼會(huì)編譯失敗。解決方案使用平臺(tái)依賴編譯。#if UNITY_STANDALONE_WIN [DllImport(user32.dll)] private static extern IntPtr GetActiveWindow(); // ... 其他Windows API聲明 #endif public void RemoveWindowTitleBar() { #if UNITY_STANDALONE_WIN // Windows平臺(tái)的實(shí)現(xiàn)代碼 #else Debug.LogWarning(Custom window styling is only supported on Windows standalone builds.); #endif }對(duì)于macOS自定義窗口需要使用Cocoa APILinux則可能需要X11相關(guān)庫(kù)實(shí)現(xiàn)復(fù)雜度更高通常需要專門(mén)的插件。5.5 坑點(diǎn)五殺毒軟件或系統(tǒng)安全軟件的誤報(bào)頻繁調(diào)用底層Windows API修改窗口屬性尤其是涉及SetWindowLong和SendMessage有時(shí)會(huì)被一些過(guò)于敏感的安全軟件標(biāo)記為可疑行為?，F(xiàn)象打包后的exe運(yùn)行時(shí)被攔截或功能被禁用。應(yīng)對(duì)措施代碼簽名為你的最終exe購(gòu)買(mǎi)代碼簽名證書(shū)并簽名這能極大增加軟件的可信度。減少敏感API組合調(diào)用避免在程序啟動(dòng)時(shí)立即進(jìn)行大量窗口樣式修改。可以考慮在用戶進(jìn)行某個(gè)操作如點(diǎn)擊“進(jìn)入演示模式”后再觸發(fā)。提交給安全軟件廠商白名單如果你的軟件是正規(guī)商業(yè)軟件可以向各大安全軟件廠商提交樣本申請(qǐng)加入白名單。清晰的用戶告知在軟件首次運(yùn)行時(shí)或設(shè)置中說(shuō)明本軟件會(huì)修改窗口外觀以獲得更好體驗(yàn)如果安全軟件報(bào)警請(qǐng)選擇允許。6. 完整示例與最佳實(shí)踐整合讓我們將上面的知識(shí)點(diǎn)整合成一個(gè)更健壯、更易用的管理器類并附上在Unity中的設(shè)置步驟。6.1 完整的Windows窗口管理器腳本// WindowsWindowManager.cs using System; using System.Runtime.InteropServices; using UnityEngine; using UnityEngine.EventSystems; public class WindowsWindowManager : MonoBehaviour { #if UNITY_STANDALONE_WIN [DllImport(user32.dll)] private static extern IntPtr GetActiveWindow(); [DllImport(user32.dll)] private static extern int GetWindowLong(IntPtr hWnd, int nIndex); [DllImport(user32.dll, SetLastError true)] private static extern int SetWindowLong(IntPtr hWnd, int nIndex, int dwNewLong); [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); [DllImport(user32.dll)] [return: MarshalAs(UnmanagedType.Bool)] private static extern bool ReleaseCapture(); [DllImport(user32.dll)] private static extern IntPtr SendMessage(IntPtr hWnd, uint Msg, IntPtr wParam, IntPtr lParam); // 常量定義 private const int GWL_STYLE -16; private const int WS_CAPTION 0x00C00000; private const int WS_THICKFRAME 0x00040000; private const uint SWP_FRAMECHANGED 0x0020; private const uint SWP_NOMOVE 0x0002; private const uint SWP_NOSIZE 0x0001; private const uint SWP_NOZORDER 0x0004; private const uint WM_NCLBUTTONDOWN 0xA1; private const int HTCAPTION 2; private IntPtr _windowHandle; private bool _isBorderless false; #endif [Header(Settings)] [Tooltip(是否在啟動(dòng)時(shí)移除標(biāo)題欄和邊框)] public bool removeBorderOnStart true; [Tooltip(用于拖動(dòng)的自定義標(biāo)題欄RectTransform可選)] public RectTransform dragHandleArea; void Start() { #if UNITY_STANDALONE_WIN // 延遲獲取句柄確保窗口已創(chuàng)建 Invoke(nameof(InitializeWindowHandle), 0.1f); #else Debug.Log(Windows window styling is only applicable in Windows standalone builds.); #endif } #if UNITY_STANDALONE_WIN private void InitializeWindowHandle() { _windowHandle GetActiveWindow(); if (_windowHandle IntPtr.Zero) { Debug.LogError(Could not retrieve window handle. Borderless mode disabled.); return; } if (removeBorderOnStart) { SetBorderlessWindow(true); } // 為拖動(dòng)區(qū)域設(shè)置事件如果已指定 SetupDragHandle(); } /// summary /// 設(shè)置或取消無(wú)邊框窗口。 /// /summary /// param nameborderlesstrue為無(wú)邊框false為恢復(fù)默認(rèn)。/param public void SetBorderlessWindow(bool borderless) { if (_windowHandle IntPtr.Zero || _isBorderless borderless) return; int currentStyle GetWindowLong(_windowHandle, GWL_STYLE); int newStyle currentStyle; if (borderless) { // 移除標(biāo)題欄和厚邊框 newStyle ~WS_CAPTION; newStyle ~WS_THICKFRAME; } else { // 恢復(fù)標(biāo)題欄和厚邊框注意這不一定能完全恢復(fù)到初始默認(rèn)狀態(tài) newStyle | WS_CAPTION; newStyle | WS_THICKFRAME; } SetWindowLong(_windowHandle, GWL_STYLE, newStyle); // 強(qiáng)制刷新窗口框架 SetWindowPos(_windowHandle, IntPtr.Zero, 0, 0, 0, 0, SWP_FRAMECHANGED | SWP_NOMOVE | SWP_NOSIZE | SWP_NOZORDER); _isBorderless borderless; Debug.Log($Window borderless set to: {borderless}); } /// summary /// 使窗口可被拖動(dòng)。應(yīng)由UI事件觸發(fā)。 /// /summary public void StartDragWindow() { if (_windowHandle IntPtr.Zero || !_isBorderless) return; ReleaseCapture(); SendMessage(_windowHandle, WM_NCLBUTTONDOWN, (IntPtr)HTCAPTION, IntPtr.Zero); } private void SetupDragHandle() { if (dragHandleArea ! null) { EventTrigger trigger dragHandleArea.gameObject.GetComponentEventTrigger(); if (trigger null) trigger dragHandleArea.gameObject.AddComponentEventTrigger(); EventTrigger.Entry entry new EventTrigger.Entry(); entry.eventID EventTriggerType.PointerDown; entry.callback.AddListener((data) { StartDragWindow(); }); trigger.triggers.Add(entry); // 重要確保拖動(dòng)區(qū)域不阻擋其下UI的點(diǎn)擊 var graphic dragHandleArea.GetComponentUnityEngine.UI.Graphic(); if (graphic ! null) graphic.raycastTarget true; // 需要接收事件所以設(shè)為true // 其下的UI元素應(yīng)正常設(shè)置raycastTarget } } #endif // 提供給UI按鈕的簡(jiǎn)單控制方法 public void CloseApplication() { #if UNITY_EDITOR UnityEditor.EditorApplication.isPlaying false; #else Application.Quit(); #endif } }6.2 Unity場(chǎng)景中的設(shè)置步驟創(chuàng)建管理器在場(chǎng)景中創(chuàng)建一個(gè)空的GameObject命名為“WindowManager”。掛載腳本將WindowsWindowManager腳本掛載上去。創(chuàng)建自定義標(biāo)題欄在Canvas下創(chuàng)建一個(gè)Image或Panel命名為“CustomTitleBar”。將其錨點(diǎn)Anchors設(shè)置為頂部拉伸Top Stretch調(diào)整高度如30。設(shè)置一個(gè)醒目的背景色以便調(diào)試。連接引用將“CustomTitleBar”的RectTransform拖拽到WindowsWindowManager組件的Drag Handle Area字段。創(chuàng)建控制按鈕可選在“CustomTitleBar”內(nèi)創(chuàng)建“關(guān)閉”按鈕。為按鈕的OnClick()事件添加監(jiān)聽(tīng)選擇WindowManager-WindowsWindowManager.CloseApplication方法。測(cè)試在編輯器中運(yùn)行由于API只在Windows Standalone生效你可能看不到變化。但可以測(cè)試按鈕點(diǎn)擊事件。關(guān)鍵的一步構(gòu)建項(xiàng)目Build Settings - PC, Mac Linux Standalone - Target Platform: Windows。運(yùn)行生成的.exe文件你將看到標(biāo)題欄和邊框已經(jīng)消失并且可以通過(guò)頂部的自定義標(biāo)題欄拖動(dòng)窗口。6.3 構(gòu)建設(shè)置檢查清單在打包前請(qǐng)確認(rèn)以下設(shè)置Player Settings Resolution and Presentation:Fullscreen Mode: 設(shè)置為Windowed。我們的API修改是基于窗口模式的。WidthHeight: 設(shè)置你期望的初始窗口分辨率。Allow Fullscreen Switch: 根據(jù)需求勾選。如果啟用用戶按AltEnter會(huì)切換到真正的全屏可能會(huì)覆蓋我們的無(wú)邊框效果。Player Settings Other Settings:Api Compatibility Level*: 保持.NET Standard 2.1或.NET Framework根據(jù)你的需求。Scripting Backend: Mono或IL2CPP均可。IL2CPP更推薦用于發(fā)布。構(gòu)建路徑確保輸出路徑?jīng)]有中文或特殊字符。7. 常見(jiàn)問(wèn)題排查與調(diào)試技巧即使按照指南操作你可能還是會(huì)遇到一些問(wèn)題。這里是一個(gè)快速排查清單。7.1 問(wèn)題打包后運(yùn)行窗口樣式?jīng)]有任何變化。可能原因1腳本中的平臺(tái)編譯指令#if UNITY_STANDALONE_WIN沒(méi)有生效。檢查確保你在構(gòu)建時(shí)選擇的目標(biāo)平臺(tái)是“Windows”。在編輯器中運(yùn)行不會(huì)調(diào)用這些API?？赡茉?獲取窗口句柄失敗。調(diào)試在InitializeWindowHandle函數(shù)中添加Debug.Log($Window Handle: {_windowHandle});。打包后運(yùn)行查看日志文件通常位于%USERPROFILE%\AppData\LocalLow\[CompanyName]\[ProductName]\output_log.txt。如果句柄是0說(shuō)明獲取失敗。嘗試將初始化延遲更長(zhǎng)的時(shí)間例如在Start()中用Invoke(nameof(InitializeWindowHandle), 0.5f)。可能原因3SetWindowPos沒(méi)有攜帶SWP_FRAMECHANGED標(biāo)志。檢查確認(rèn)調(diào)用SetWindowPos時(shí)包含了SWP_FRAMECHANGED。7.2 問(wèn)題窗口可以無(wú)邊框但無(wú)法拖動(dòng)?？赡茉?拖動(dòng)區(qū)域UI的Raycast Target未開(kāi)啟或EventTrigger設(shè)置不正確。檢查確認(rèn)自定義標(biāo)題欄的Image組件Raycast Target已勾選。確認(rèn)EventTrigger的PointerDown事件已正確綁定到StartDragWindow方法?？赡茉?ReleaseCapture()或SendMessage()調(diào)用失敗。調(diào)試在StartDragWindow方法開(kāi)始處添加Debug.Log(Dragging...);打包后測(cè)試看日志是否有輸出。確保_windowHandle有效且_isBorderless為true。7.3 問(wèn)題窗口位置或大小在移除邊框后變了?？赡茉蛞瞥齏S_CAPTION和WS_THICKFRAME后窗口的客戶區(qū)Client Area大小計(jì)算方式變了。SetWindowPos調(diào)用時(shí)如果之前窗口是標(biāo)準(zhǔn)樣式系統(tǒng)會(huì)基于包含標(biāo)題欄的窗口矩形來(lái)定位。移除后同樣的矩形參數(shù)可能導(dǎo)致窗口顯示位置偏移。解決方案在調(diào)用SetBorderlessWindow(true)之前先記錄當(dāng)前窗口的位置和大小可以通過(guò)Screen.width和Screen.height但這是整個(gè)窗口的尺寸。然后在設(shè)置無(wú)邊框后再用SetWindowPos將其設(shè)置回原來(lái)的位置和大小?；蛘吒?jiǎn)單的方法是在窗口初始就是無(wú)邊框的狀態(tài)下啟動(dòng)?？梢栽赟tart()中立刻調(diào)用SetBorderlessWindow這樣窗口創(chuàng)建時(shí)就是無(wú)邊框的位置由Player Settings中的設(shè)置決定。7.4 問(wèn)題在無(wú)邊框窗口下如何實(shí)現(xiàn)窗口縮放這是一個(gè)高級(jí)功能。標(biāo)準(zhǔn)做法是處理WM_NCHITTEST消息當(dāng)鼠標(biāo)移動(dòng)到窗口邊緣時(shí)返回HTLEFT,HTRIGHT,HTTOP,HTTOPLEFT等值告訴系統(tǒng)可以在此處調(diào)整大小。但這需要在C插件中實(shí)現(xiàn)復(fù)雜的消息循環(huán)鉤子并將其傳遞給Unity實(shí)現(xiàn)門(mén)檻很高。實(shí)用替代方案在你的應(yīng)用界面角落放置幾個(gè)透明的、可拖動(dòng)的UI元素。當(dāng)用戶拖動(dòng)這些元素時(shí)通過(guò)SetWindowPos動(dòng)態(tài)改變窗口的寬度和高度。這需要你手動(dòng)計(jì)算鼠標(biāo)移動(dòng)的偏移量并轉(zhuǎn)換為窗口尺寸的變化。雖然不如系統(tǒng)原生的邊緣縮放流暢但可以實(shí)現(xiàn)基本功能。7.5 調(diào)試建議使用日志文件在關(guān)鍵函數(shù)入口添加Debug.Log。打包后日志會(huì)寫(xiě)入到output_log.txt文件。這是排查運(yùn)行時(shí)問(wèn)題最重要的工具。分步測(cè)試不要一次性實(shí)現(xiàn)所有功能。先確保能成功移除邊框再添加拖動(dòng)功能最后再加控制按鈕。備份原始樣式在SetBorderlessWindow函數(shù)中可以在修改前將currentStyle保存下來(lái)。這樣你可以在運(yùn)行時(shí)提供一個(gè)“恢復(fù)默認(rèn)”的按鈕方便調(diào)試和用戶選擇?？紤]使用現(xiàn)有插件如果你覺(jué)得直接操作Windows API太復(fù)雜或者需要更穩(wěn)定、功能更全的解決方案如完整的窗口縮放、陰影、跨平臺(tái)支持可以考慮Asset Store上的成熟插件如“Standalone Window Manager”、“Borderless Window”等。它們封裝了底層細(xì)節(jié)并提供更友好的編輯器接口。但理解本文的原理能幫助你更好地使用和調(diào)試這些插件。從Unity播放器到擁有自定義外觀的獨(dú)立exe這最后一步的打磨是區(qū)分業(yè)余作品與專業(yè)產(chǎn)品的關(guān)鍵細(xì)節(jié)之一。它要求開(kāi)發(fā)者跳出舒適區(qū)與操作系統(tǒng)底層進(jìn)行交互。這個(gè)過(guò)程雖然充滿挑戰(zhàn)但當(dāng)你看到自己的應(yīng)用以完全符合設(shè)計(jì)意圖的形態(tài)呈現(xiàn)在桌面上時(shí)那種成就感是巨大的。希望這篇指南不僅能提供代碼更能幫你理解背后的“為什么”讓你在遇到問(wèn)題時(shí)能自己找到答案。記住在PC端窗口就是你的應(yīng)用給用戶的第一張臉值得你花心思把它打扮好。