Skip to main content

油門

僅限 Y 軸之搖桿的特殊版本。專為賽車遊戲設計。

屬性

type - “throttle” axisUp - string。控制項上半部對應的扳機。必須是 "leftTrigger" 或 "rightTrigger"。 axisDown - string。控制項下半部對應的扳機。必須是 "leftTrigger" 或 "rightTrigger"。 relative - boolean、選用。控制油門計算其值的方式。如果為 true,值會根據使用者初始觸控的位置而定。如果為 false,值會根據控制項的中心點而定。預設為 true。 sticky - boolean、選用。控制使用者停止觸控控制項時的行為。如果為 true,油門會停留在最後的值。如果為 false,則會重設為 0。預設為 false。 enabled - boolean、選用。預設為 true。將控制項的視覺狀態設定為啟用/停用。停用的控制項仍會接收玩家的輸入,但不會根據輸入變更視覺樣式。 visible - boolean、選用。預設為 true。決定是否向玩家顯示控制項以供互動。若要在遊戲過程中變更此設定,請參閱使用遊戲狀態變更觸控配置。 styles - object、選用。自訂控制項的視覺呈現。樣式以每個可設定樣式之狀態的物件來表示。 油門控制項可設定下列狀態的樣式。
  • default - 基本樣式。
  • activated - 玩家觸控旋鈕且旋鈕剛好位於軸上 0 值時套用。
  • activatedDown - 玩家觸控旋鈕並將其移至油門軸的負值 (下方) 區段時套用。
  • activatedUp - 玩家觸控旋鈕並將其移至油門軸的正值 (上方) 區段時套用。
  • idle - 玩家未與控制項互動,且旋鈕也未 sticky 停留在軸的上方區段時套用。
  • idleUp - 玩家未與控制項互動,且旋鈕已移至上方區段並且 sticky 已設定為 true 時套用。
每個狀態的樣式屬性 opacity - number、選用。要套用至控制項的不透明度。除了 disabled 以外,所有狀態的預設值皆為 1.0。 axisUp - object、選用。axis 物件,指定油門正值 (上方) 部分的樣式。 axisDown - object、選用。axis 物件,指定油門負值 (下方) 部分的樣式。 knob - object、選用。knob 物件,指定油門旋鈕部分的樣式。 indicator - object、選用。stroke,指定要套用至連接旋鈕與軸上目前位置之元件的樣式。 資產尺寸 對於每個接受影像資產的樣式物件,指定的資產會以基本解析度,以及該基本解析度的 1.5x、2.0x、3.0x 和 4.0x 比例提供。指定影像的解析度必須小於或等於下列最大解析度。

備註

throttle 控制項可讓玩家使用觸控控制項提供扳機的可變壓力。 throttle 控制項設計為放置在轉盤的中央位置,並且是該位置與螢幕側邊之間唯一的控制項。 如果玩家可能希望對扳機施加恆定壓力,讓他們設定值後就能用手指執行其他動作,請將 sticky 設定為 true。 樣式備註
透過 Windows 版本的 Content Test Application 進行串流時,並非所有樣式都能正確顯示。

範例

範例 1:基本油門

圖 1. 油門控制項 使用者與油門互動 這會使用預設樣式。

範例 2:具有樣式化外框和明確定義圖示的油門

圖 1. 自訂油門控制項 使用者與自訂油門互動

需求

配置版本: 1.0+ (樣式自配置版本 3.2+ 起提供)
Last modified on October 6, 2026