Skip to main content

方向鍵

一律對應至遊戲控制器方向鍵的方向鍵控制項。

屬性

type - “directionalPad”。指定控制項類型。 scale - number、選用。預設值為 1。大小乘數,由於方向鍵的放置方式與按鈕相同,不會像搖桿一樣自動縮放,因此此屬性很實用。 deadzone - number、選用。介於 0 到 1 之間的值,以控制項的百分比指定死區的大小。請注意,與搖桿的死區不同,方向鍵的死區一律為軸向 (方形)。 enabled - boolean、選用。預設為 true。將控制項的視覺狀態設定為啟用/停用。停用的控制項仍會接收玩家的輸入,但「不會」根據輸入變更視覺樣式。 visible - boolean、選用。預設為 true。決定是否向玩家顯示控制項以供互動。若要在遊戲過程中變更,請參閱使用遊戲狀態變更觸控配置。 styles - object、選用。自訂控制項的視覺呈現。樣式以每個可設定樣式之狀態的物件來表示。 interaction - object、選用。可改變使用者與控制項之互動機制的屬性定義 互動 activationType - string、選用。定義方向鍵互動中任何指定方向所允許的啟動類型。預設為 allowNeighboring。設定為 exclusive 時,方向鍵一次只能啟動單一方向 (亦即 ‘Up’、‘Right’、‘Down’ 或 ‘Left’ 其中之一)。設定為 allowNeighboring 時,可藉由點選兩個方向之間的位置,同時啟動一個方向及其任一相鄰方向 (亦即,除了能啟動每個個別方向之外,使用者還可以藉由點選兩者之間的位置來啟動 ‘Up+Right’、‘Right+Down’、‘Down+Left’ 或 ‘Left+Up’)。 狀態和樣式屬性 方向鍵控制項可設定下列狀態的樣式:
  • default - 基本樣式。
  • disabled - 控制項停用時的樣式。如果未指定,則控制項停用時,會對預設樣式套用轉換,使其呈現停用外觀。
  • idle - 玩家「未」與控制項互動時套用。
  • activated - 玩家觸控按鈕時套用。
下列屬性可用來設定方向鍵控制項的樣式: opacity - number、選用。要套用至控制項的不透明度。除了 disabled 以外,所有狀態的預設值皆為 1.0。 fill - object、選用。定義了色彩的物件,用於方向鍵啟動時所使用的漸層。 gradient - object、選用。定義了色彩的物件,用於方向鍵啟動時所使用的漸層。 background - object、選用。可以是色彩或影像資產。 stroke - object、選用。用於方向鍵外框的色彩。必須是 stroke 物件。 資產尺寸 對於每個接受影像資產的樣式物件,指定的資產會以基本解析度,以及該基本解析度的 1.5x、2.0x、3.0x 和 4.0x 比例提供。指定影像的解析度必須小於或等於下列最大解析度:

備註

方向鍵用來提供類似實體控制器上方向鍵的體驗。 如果將其用作玩家的主要移動機制 (通常位於 left inner 位置),建議使用 2 的縮放比例。 樣式備註 如果 background 使用自訂影像資產,所參考的最大解析度是針對 scale=1.0。如果使用不同的縮放比例,最大解析度將等於解析度與縮放比例的乘積。例如,scale=1.5 表示 @1.0x DPI 背景影像的最大解析度可為 90x90。
透過 Windows 版本的 Content Test Application 進行串流時,並非所有樣式都能正確顯示。

範例

範例 1:預設方向鍵

圖 1. 方向鍵 使用者與方向鍵互動

範例 2:具有自訂色彩的較大方向鍵。

圖 1. 自訂方向鍵 使用者與自訂方向鍵互動

需求

配置版本: 1.0+,(樣式支援自 3.0+ 起,互動支援自 3.4+ 起)。
Last modified on October 6, 2026