触摸板

模拟控件支持玩家进行类似于笔记本触控板的交互。

属性

type -“触控板”

axis - 对象或数组。 一个描述此触摸板控件的映射的单一轴或轴数组。

action - 对象， 可选。 除轴映射之外，还将在触控时调用的一个操作。

renderAsButton - 布尔， 可选。 默认为 false。 设置为 true 将触控板直观呈现为按钮。

enabled - 布尔， 可选。 默认为 true。 将控件的可视状态设置为已启用/禁用。 禁用的控件仍将接收玩家的输入，但不会根据输入更改视觉样式。

visible - 布尔， 可选。 默认为 true。 确定控件是否显示给玩家进行交互。 若要在游戏期间进行更改，请参阅使用游戏状态更改触控布局。

styles - 对象， 可选。 自定义控件的可视化表示形式。 样式表示为每个可以设置样式的状态的对象。

按钮控件可以具有以下样式状态：

• default - 基本样式。
• disabled - 禁用控件时的样式。 如果未指定，则禁用控件时，将对默认样式应用转换，使其显示为禁用。
• idle - 在玩家未与控件交互时应用。
• moving - 当玩家触摸控件且未定义 action 时应用。
• activated - 当玩家触摸控件并定义 action 时应用。

每个状态的样式属性

opacity - 数字，可选。 要应用于控件的不透明度。 对于除 disabled 之外的所有状态默认为 1.0。

background - 对象， 可选。 可以是颜色或图像资产。

faceImage - 对象， 可选。 可以是图标或图像资产。

资产维度

对于接受图像资产的每个样式对象，给定资产以基分辨率为底层，以该基分辨率的 1.5x、2.0x、3.0x 和 4.0x 比例提供。 给定映像的分辨率必须小于或等于以下最大分辨率：

对象	@1.0x	@1.5x	@2.0x	@3.0x	@4.0x
faceImage	60x60	90x90	120x120	180x180	240x240
background (renderAsButton = true)	60x60	90x90	120x120	180x180	240x240
background (renderAsButton = false)	120x120	90x90	240x240	360x360	480x480

备注

touchpad 最适合用于非粘滞、无死区输出（通常是第一/第三人称游戏中的查看镜头）。

对于支持鼠标输入的游戏，可通过相对鼠标使用 touchpad，以提供更优化的视野查看体验。

样式设置备注

当 renderAsButton 为 true 时：

• 处于 activated 状态时，faceImage 以缩小 25% 的形式显示。
• 对于不使用自定义资产且具有单个操作 gamepadX、gamepadY、gamepadA 或 gamepadB 的按钮，按钮背景色有标签和默认样式。

示例

示例 1：带有查看图标的触控板

图 1. 触控板控件

{
    "type": "touchpad",
    "axis": {
        "input": "axisXY",
        "output": "rightJoystick",
        "sensitivity": 3
    },
    "styles": {
        "default" : {
            "faceImage" : {
                "type": "icon",
                "value": "look"
            }
        }
    }
}

示例 2：呈现为按钮的带有查看图标的触控板

图 1. 按钮触控板控件

{
    "type": "touchpad",
    "renderAsButton": true,
    "axis": {
        "input": "axisXY",
        "output": "rightJoystick",
        "sensitivity": 3
    },
    "styles": {
        "default" : {
            "faceImage" : {
                "type": "icon",
                "value": "look"
            }
        }
    }
}

要求

布局版本：1.0+（从布局版本 3.0+ 开始提供样式）