Skip to main content

觸控板

可讓玩家以類似筆記型電腦觸控板方式互動的類比控制項。

屬性

type - “touchpad” axis - object 或 array。單一軸或軸陣列,描述此觸控板控制項的對應。 action - object、選用。除了軸對應之外,在觸控時要叫用的動作。 renderAsButton - boolean、選用。預設為 false。設定為 true 可將觸控板在視覺上呈現為按鈕。 enabled - boolean、選用。預設為 true。將控制項的視覺狀態設定為啟用/停用。停用的控制項仍會接收玩家的輸入,但「不會」根據輸入變更視覺樣式。 visible - boolean、選用。預設為 true。決定是否向玩家顯示控制項以供互動。若要在遊戲過程中變更,請參閱使用遊戲狀態變更觸控配置。 styles - object、選用。自訂控制項的視覺呈現。樣式以每個可設定樣式之狀態的物件來表示。 按鈕控制項可設定下列狀態的樣式:
  • default - 基本樣式。
  • disabled - 控制項停用時的樣式。如果未指定,則控制項停用時,會對預設樣式套用轉換,使其呈現停用外觀。
  • idle - 玩家「未」與控制項互動時套用。
  • moving - 玩家觸控控制項且未定義 action 時套用。
  • activated - 玩家觸控控制項且已定義 action 時套用。
每個狀態的樣式屬性 opacity - number、選用。要套用至控制項的不透明度。除了 disabled 以外,所有狀態的預設值皆為 1.0。 background - object、選用。可以是色彩或影像資產。 faceImage - object、選用。可以是圖示或影像資產。 資產尺寸 對於每個接受影像資產的樣式物件,指定的資產會以基本解析度,以及該基本解析度的 1.5x、2.0x、3.0x 和 4.0x 比例提供。指定影像的解析度必須小於或等於下列最大解析度:

備註

touchpad 最適合用於非固定、無死區的輸出,通常是第一人稱/第三人稱視角遊戲中的視角攝影機。 對於支援滑鼠輸入的遊戲,touchpad 可與相對滑鼠搭配使用,以提供經過更精細調整的視角攝影機體驗。 樣式備註 當 renderAsButton 為 true 時:
  • 處於 activated 狀態時,faceImage 會縮小 25% 顯示。
  • 對於未使用自訂資產且只有單一 gamepadX、gamepadY、gamepadA 或 gamepadB 動作的按鈕,會有標籤和背景色彩的預設樣式。

範例

範例 1:具有視角圖示的觸控板

圖 1. 觸控板控制項 使用者與觸控板互動

範例 2:具有視角圖示並呈現為按鈕的觸控板

圖 1. 按鈕觸控板控制項 使用者與呈現為按鈕的觸控板互動

需求

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