搖桿
行為類似搖桿的類比控制項。屬性
type - “joystick”
axis - object 或 array。單一軸或軸陣列，描述此搖桿控制項的對應。
action - object、選用。除了軸對應之外要叫用的動作。
actionThreshold - number、選用。叫用動作所需的正規化最小搖桿值 (徑向)。預設值為 0。
enabled - boolean、選用。預設為 true。將控制項的視覺狀態設定為啟用/停用。停用的控制項仍會接收玩家的輸入，但「不會」根據輸入變更視覺樣式。
expand - boolean、選用。預設值為 true。放置在中央控制項插槽時，擴展搖桿範圍以符合使用者的人體工學偏好。設定為 false 可使用標準化的固定搖桿大小。
relative - boolean、選用。
根據預設 (true)，搖桿會根據使用者的初始觸控位置，以相對計算方式計算其值。將此值設定為 false 則會改為根據控制項的中心點計算其值。
visible - boolean、選用。預設為 true。決定是否向玩家顯示控制項以供互動。若要在遊戲過程中變更，請參閱使用遊戲狀態變更觸控配置。
styles - object、選用。自訂控制項的視覺呈現。樣式以每個可設定樣式之狀態的物件來表示。
按鈕控制項可設定下列狀態的樣式：
default- 基本樣式。disabled- 控制項停用時的樣式。如果未指定，則控制項停用時，會對預設樣式套用轉換，使其呈現停用外觀。idle- 玩家「未」與控制項互動時套用。moving- 搖桿旋鈕正被互動時套用，不論定義的死區為何。activated- 已定義action且旋鈕移出臨界值而執行動作時套用。
opacity - number、選用。要套用至控制項的不透明度。除了 disabled 以外，所有狀態的預設值皆為 1.0。
background - object、選用。可以是色彩或影像資產。
knob - object、選用。knob 物件指定玩家可互動之搖桿類按鈕部分的樣式。
outline - object、選用。outline 物件指定與搖桿互動時所呈現之外框和指示器的樣式。
資產尺寸
對於每個接受影像資產的樣式物件，指定的資產會以基本解析度，以及該基本解析度的 1.5x、2.0x、3.0x 和 4.0x 比例提供。指定影像的解析度必須小於或等於下列最大解析度：
備註
joystick 控制項可用來提供對應至不同實體控制器搖桿的類比控制。
如果 joystick 是主要的移動方式，建議放在左側中央位置並將 expand 設定為 true，為玩家提供最佳體驗。
請考慮自訂 faceImage，向玩家提示搖桿將控制的內容 (如果您的遊戲使用多個搖桿，這點尤其重要)。
對於只依賴 1 個軸的動作，請使用單軸搖桿以將可玩性最大化。
樣式備註
如果使用 background 資產且 expand 為 true，background 資產「不會」縮放至完整的中央插槽大小。
根據預設，outline 只會在玩家與控制項互動時顯示。
如果使用自訂 background 資產且 expand 設定為 true，請注意資產「不會」隨著玩家的控制項自訂而擴展。
範例
範例 1：簡單搖桿
以 1:1 方式對應至搖桿，並帶有些微死區。實體控制器上的類比搖桿是透過旋轉計算其值。 圖 1. 搖桿控制項
範例 2：超過臨界值時從走路切換為衝刺的搖桿。
超過臨界值 (0.75) 時，leftTrigger 會與搖桿移動一起傳送。圖示會從 ‘walk’ 變更為 ‘sprint’ 圖 1. 具有動作臨界值的搖桿控制項
範例 3：看起來像方向盤的單軸 (水平) 搖桿
圖 1. 水平方向盤搖桿控制項
範例 4：具有自訂色彩的搖桿
圖 1. 自訂搖桿控制項