方向键

项目
07/04/2024

方向键控件始终映射到游戏板的方向键。

属性

type - "directionalPad"。指定控件类型。

scale - 数字，可选。默认值为 1。尺寸倍数是很有用的，因为方向键像按钮一样放置，它不会像游戏杆那样自动缩放。

deadzone - 数字，可选。一个介于 0 到 1 之间的值，用于指定死区的大小（以控件百分比表示）。注意，与游戏杆的死区不同，方向键的死区始终是轴向的。

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

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

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

interaction - 对象，可选。可以使用控件更改用户交互机制的属性定义

交互

activationType - 字符串，可选。定义方向件交互上任何给定方向允许的激活类型。默认为 allowNeighboring。设置为 exclusive时，一次只能在方向键上激活单个方向（即，只能为"向上"、"向右"、"向下"或"向左"其中之一）。设置为 allowNeighboring时，可以通过在两个方向之间点击以同时激活一个方向及其相邻方向（即，除了可以激活每个单独方向外，用户还可以通过在两个方向之间点击来激活"向上+向右"、"向右+向下"、"向下+向左"或"向左+向上"）。

状态和样式设置属性

方向键控件可以具有以下样式状态：

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

以下属性可用于设置方向键控件的样式：

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

fill - 对象，可选。一个对象，其颜色定义为激活方向键时要使用的渐变。

gradient - 对象，可选。一个对象，其颜色定义为激活方向键时要使用的渐变。

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

stroke - 对象，可选。要在方向键轮廓上使用的颜色。必须是笔划对象。

资产维度

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

对象	@1.0x	@1.5x	@2.0x	@3.0x	@4.0x
background	75x75	112x112	150x150	225x225	300x300

备注

方向键用于提供类似于物理控制器上的方向键的体验。

如果将此功能用作玩家的主要移动机制（通常在leftinner槽中），则建议使用尺度 2。

样式设置备注

如果对 background 使用自定义图像资产，则引用的最大分辨率为 scale=1.0。如果使用不同的缩放，最大分辨率将等于分辨率和缩放的乘积。例如，scale=1.5 表示 @1.0x DPI 背景图像的最大分辨率可以为 90x90。

警告

通过 Windows 版内容测试应用程序进行流式处理时，并非所有样式都会正确显示。

示例

示例 1：默认方向键

图 1. 方向键

用户与方向键交互

{
    "type": "directionalPad",
    "scale": 1.0
}

示例 2：具有自定义颜色的较大方向键。

图 1. 自定义方向键

用户与自定义方向键交互

{
    "type": "directionalPad" ,
    "scale": 2.0,
    "styles" : {
        "default" : {
            "fill" : "#0e7a0d10",
            "gradient" : {
                "color": "#0e7a0d10"
            },
            "stroke" : {
                "type": "solid",
                "color" : "#0e7a0dff"
            }
        }
    }
}

通过

方向键

属性

备注

示例

示例 1：默认方向键

示例 2：具有自定义颜色的较大方向键。

要求

其他资源