Touchpad
一种模拟控件,使玩家能够以类似笔记本触控板的方式进行交互。属性
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. 按钮式触控板控件
