我開始學Unity的時候，NGUI就已經是3.6.8版本了，對於有一些NGUI的外掛，我至今都不太清楚它的用處

現在我整理了網上搜來的一些控制元件說明，希望對大家有用：

UIRoot總是放在NGUI UI層級的最上層。

它用來使UI的縮放變得更容易。widget通常使用的是以畫素為單位的座標，但是一個800*400（dimensions的值）的widget會佔用800*400個單位（Unity中的單位），這相當大。UIRoot通過螢幕高度的反比來進行縮放，因此widgets都會很小，並且操作起來更容易。



UIRoot有幾種縮放方式。最常見的就是PixelPerfect。這種方式下，你的UI一直都是以畫素為基礎，一個300*200的widget在螢幕上永遠佔用300*200畫素。這就意味著，你的UI在低解析度的機器上會顯得非常大，在高解析度的機器上就會顯得很小。這個設定就是一直保持你的UI清晰。

UIWidget是NGUI的基礎元件。簡單來說，就是一個你可以放在螢幕任意位置的矩形框。widget會有一定的面積（如下圖的白色框範圍），但是在執行的時候（Game View）是完全不可見的，所以非常適合當做其他元件的容器（讓所有的sprite或者label等以它進行各種對齊）。

• 把滑鼠放到矩形框裡面來移動它的位置。
• 拖動藍色圓點進行縮放。
• 滑鼠放在藍色原點外面一些，就可以旋轉widget。按住shift可以微調（windows上是ctrl）。
• 加入collider就可以讓這個區域接受事件。可以在這個widget上定位其他widgets，具體檢視UIAnchor。
• 在給widget加了box collider之後，widget的inspector上會有一個新的選項：Box Collider。預設是勾選的，它會自動調整使得collider的size和widget的尺寸一樣（dimensions）。
• 增加UIWidget的快捷鍵是alt+shift+w。
  

UIPanel用來收集和管理它下面所有widget的元件。通過widget的geometry建立實際的draw call。沒有panel所有東西都不能夠被渲染出來。如果你對Unity熟悉，你可以把UIPanel當做Renderer。



所有panel都有一個Depth值，會影響所有它包含的widget。如果你的UI有很多視窗，那麼最好每個視窗有一個panel。Panel上的depth權重會遠遠高於每一個widget的depth權重，所以保證panel不要使用同樣的depth。如果使用同樣的depth在panel上，那麼draw call會被自動拆分來保證渲染順序，所以會增加更多的draw call。

• Alpha屬性影響所有在panel下面的widget。所以可以用它來淡出整個視窗。
• 如果你的UI需要被燈光影響，需要勾選上Normals。
• 如果建立了一個有很多geometry的scrollable panel，你需要勾選Cull選項來減少三角形的數目。這樣也可能降低效能，因為widget的可視性需要每次update都檢驗一次。
• 勾選Static選項來告訴NGUI這個panel下面的widget不會被移動，這樣可以提高效能。NGUI會忽略所有的position/rotation/scale改變。所以在執行時移動widget不會有效——所以小心使用。
• 如果要除錯由panel建立的draw calls，Show All選項可能幫助到你。你會看到由panel建立的所有draw call，以渲染順序排序。每個draw call會包括它使用到material的詳細資訊，那個widget用的這個material，甚至可以讓你關閉某些draw call來讓你查詢某些問題。
  

預設情況下anchor只會執行一次。如果要在每個update裡面都執行，那勾選掉Run Only Once選項。

這個元件在NGUI的3.0.7及以後版本中不建議使用. .

UIStretch用來讓widget相對於其他widget或者相機視窗的矩形進行縮放。用它和UIAnchor來在NGUI的3.0.6及以前的版本中建立模組化的UI。



你是否有個一個讓widget根據其他的widget的大小來進行大小調整的需求？比如在button裡面的label，現在你可以這麼做了！

還是以button為例子，你有一個button，背景是sliced sprite，子節點是label，你可以把UIStretch掛到label上，選擇背景當做Container，之後設定Style為“Both”。加入一些Border Padding，就實現了這個功能。現在你調整背景的大小，這個label也會隨之改變。

UIPlayAnimation通過你選擇的事件條件去觸發其他的動畫。它和UIPlayTween的區別就是它處理的是動畫。



給widget增加動畫的最好好發就是點選ctrl+6來開啟Animation視窗。

如果你只是試驗一下，你可以直接用NGUI提供的Checkmark動畫。無論用哪種方法，你需要勾選掉Play Automatically選項，否則在你點選Play的時候，這個動畫就會被執行。

為了觸發其他動畫，掛一個UIPlayAnimation元件（Attach -> Play Animation）。你會很樂意看到有這麼多可以選擇的選項。

先選擇Clip Name，就是動畫裡面會播放的clip的名字。如果你的動畫裡面只有一個動畫，那麼這裡可以為空。

Trigger Condition讓你選擇動畫的觸發方式，Play Direction可以控制動畫播放的方向。還可以控制Selected Object。這個是考慮到當開發一個基於控制器的遊戲，一些東西需要一直被選中，但是當用動畫隱藏一個視窗，彈出了另外的一個，你可能更像讓當前的選擇變到另外的按鍵上。 

如果target是disabled狀態，你可以選擇activate它或者讓它保持disabled。一個動畫是淡出一個視窗和淡入一個視窗，你需要為淡出視窗的When finished指定為Disable，為淡入的指定為Enable then play。這會保證在淡出的時候被disabled但在淡入的時候又被enabled。

動畫已經開始的話，可以選擇restart讓動畫從頭開始播放。

最後如果想要在動畫完成後執行一些函式，你可以把目標game object拖拽到Notify屬性裡並且選擇合適的函式在下拉列表裡面。函式的宣告需要是“public void FuncName (void)”這樣的。比如：

• 可以通過程式碼直接播放動畫，使用函式ActiveAnimation.Play()：
  

UICamera這個名字不是很合適，保留的原因僅僅是為了相容以前的版本。

UICamera真正做的事情是傳送NGUI事件給所有被當前camera渲染的object，camera是UICamera指令碼所在的那個。 其實這個指令碼做的事情和UI無關。事實上如果你想讓遊戲裡面的object接收OnPress、OnClick、OnDrag等這類事件，你需要把UICamera掛在你的主相機上。

遊戲場景裡面可以有多個UICamera。大多數遊戲一個掛在渲染widget的相機上，一個掛在渲染遊戲的相機上。



UICamera的選項Event Type用來決定指令碼如何排序mouse或者touch觸發的事件。如果是UI模式，這些事件順序基於widget的depth——和渲染順序一樣。如果UICamera掛到了Main Camera上，那麼就需要把這個選項修改成World模式。這樣就會根據與相機的距離來排序點選到的object。

Event Mask用來決定哪些層會接收事件。大多數情況下你需要的就是“Everything”，這個值會與UnityEngine.Camera's Culling Mask進行邏輯與運算，有需要的話你可以微調這個值。如果你修改了UI的game object的Layer，記得調整Event Mask，否則你可能會發現UI不響應事件。

Debug選項用來顯示當前在滑鼠下面的是什麼。如果你不知道是什麼東西接收了滑鼠事件，勾選上這個選項你就可以在右上角看到了。

Allow Multi-Touch選項用來控制是否支援多點觸碰。如果勾選掉，多點觸碰也會當做單點觸碰。

Sticky Tooltip選項用來微調tooltip的行為。如果關掉，當滑鼠再次移動的時候就會立即關掉tooltip。如果開啟，只要滑鼠一直在這個game object上，tooltip就會移至顯示。

Tooltip Delay用來控制當滑鼠停在某個object上時，經過多長時間OnTooltip訊息會被髮送到這個object上。以秒為單位。

Raycast Range控制raycast的長度，大多數情況下這個值可以被忽略。這個值是世界座標系的值，所以如果你的攝像機的near clip是0.3、far clipping是 1000，比較遠的物體可能不會響應click事件，比如可以把這個值設定為2000（比far和near clipping大的值。）



Event Sources用來確定哪些事件型別會被處理。被勾選掉的事件就不會被處理。有些平臺會強制關閉一些事件。比如使用手柄時會自動關掉滑鼠和touch時事件。



Thresholds可以調整click、drag和tap事件的閾值來微調滑鼠和touch事件的行為。以畫素為單位。



Axes和Keys部分用來控制哪個軸控制哪個方向的移動。這些名字需要和Input Manager裡面的一致。

小貼士

UICamera傳送以下事件給collider：

• OnHover (isOver) 傳送時機為滑鼠懸停（只觸發一次）或者離開collider。
• OnPress (isDown) 傳送時機為滑鼠在collider上按下。
• OnSelect (selected)傳送時機為滑鼠點選和鬆開的時候都在同一個object上。
• OnClick ()傳送時機和OnSelect一樣，但是要求滑鼠沒有移動特別多。UICamera.currentTouchID表示按下的滑鼠哪個鍵。
• OnDoubleClick ()傳送時機為當在四分之一秒內click兩次的時候。UICamera.currentTouchID表示按下的滑鼠哪個鍵。
• OnDragStart ()傳送時機為OnDrag()事件之前。
• OnDrag (delta) 傳送時機為一個object被拖拽。
• OnDragOver (draggedObject)傳送時機為其他的object拖拽到他的上面。
• OnDragOut (draggedObject)傳送時機為其他的object拖拽出他的上面。
• OnDragEnd ()傳送時機為drag事件結束。傳送給被拖拽的object。
• OnInput (text)傳送時機為輸入的時候（在點選選擇了一個collider之後）。
• OnTooltip (show) 傳送時機為滑鼠懸停在一個collider上一段時間沒有移動。
• OnScroll (float delta)傳送時機為滑鼠滾輪滾動。
• OnKey (KeyCode key)傳送時機為鍵盤或者輸入控制器被使用的時候。