油门

仅限 Y 轴游戏杆的专用版本。 专为驾驶游戏而设计。

属性

type -“throttle”

axisUp - 字符串。 该控件上半部分映射到的扳机键。 必须是 "leftTrigger" 或 "rightTrigger"。

axisDown - 字符串。 该控件下半部分映射到的扳机键。 必须是 "leftTrigger" 或 "rightTrigger"。

relative - 布尔， 可选。 控制油门计算其值的方式。 如果为true，则该值将基于用户初始触摸所在的位置。 如果为false，则该值将基于控件的中心点。 默认为 true。

sticky - 布尔， 可选。 控制当用户停止触摸控件时发生的情况。 如果 true，则限制将留在最后一个值。 如果为false，它将重置为 0。 默认为 false。

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

visible - 布尔， 可选。 默认为 true。 确定是否向要与之交互的玩家显示控件。 若要在玩游戏期间更改此设置，请参阅 使用游戏状态更改触摸布局。

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

限制控件可以设置以下状态的样式。

• default - 基本样式。
• activated - 当玩家触摸旋钮并且它正好在沿轴的 0 值时应用。
• activatedDown - 当玩家触摸旋钮并移动旋钮，使其位于油门轴的下 () 部分时应用。
• activatedUp - 当玩家触摸旋钮并移动旋钮，使其位于节流轴的正 (上) 部分时应用。
• idle - 当玩家 未 与控件交互且旋钮也不 sticky 在轴的上部时应用。
• idleUp - 当玩家 未 与控件交互且旋钮已移动到上部且 sticky 已设置为 时应用 true。

每个状态的样式属性

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

axisUp - 对象， 可选。 axis 对象，指定限制的正（上）部分的样式。

axisDown - 对象， 可选。 axis 对象，指定限制的负（下）部分的样式。

knob - 对象， 可选。 对象 knob ，该对象指定限制的旋钮部分的样式。

indicator - 对象， 可选。 一个笔划，指定要应用于将旋钮连接到轴上当前位置的组件样式。

资产维度

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

备注

控件 throttle 允许玩家使用触摸控件提供触发器的可变压力。

控件 throttle 设计为放置在方向盘的中心位置，并且是该点与屏幕侧之间的唯一控件。

如果玩家希望向扳机键施加持续压力以允许将值固定，然后使用手指执行其他的操作，则将 sticky 设置为 true。

样式设置备注

示例

示例 1：基本限制

图 1. 限制控制

这将使用默认样式。

{
    "type": "throttle",
    "axisUp": "rightTrigger",
    "axisDown": "leftTrigger",
    "sticky": true
}

示例 2：使用带样式的轮廓和显式定义的图标进行限制

图 1. 自定义限制控制

{
    "type": "throttle",
    "axisUp": "rightTrigger",
    "axisDown": "leftTrigger",
    "sticky": true,
    "styles": {
        "default": {
            "knob" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "gasPedal"
                }
            },
            "axisUp": {
                "stroke" : {
                    "type": "solid",
                    "color":  "#107C10"
                },
                "cap" : {
                    "type": "color",
                    "value": "#107C10"
                }
            },
            "axisDown": {
                "stroke" : {
                    "type": "solid",
                    "color":  "#ff0000"
                },
                "cap" : {
                    "type": "color",
                    "value": "#ff0000"
                }
            }
        },
        "idleUp" : {
            "knob" : {
                "stroke" : {
                    "type": "solid",
                    "color":  "#107C10"
                }
            },
            "indicator" : {
                "type": "solid",
                "color":  "#107C10"
            }
        },
        "activatedUp" : {
            "indicator" : {
                "type": "solid",
                "color":  "#107C10"
            }
        },
        "activatedDown": {
            "knob" : {
                "faceImage" : {
                    "type": "icon",
                    "value": "brakePedal"
                }
            },
            "indicator" : {
                "type": "solid",
                "color":  "#ff0000"
            }
        }
    }
}

要求

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