Skip to main content

Throttle

一种仅带 Y 轴的操纵杆的专用版本,专为驾驶游戏设计。

属性

type - “throttle” axisUp - string。控件上部映射到的扳机键。必须为 "leftTrigger" 或 "rightTrigger"。 axisDown - string。控件下部映射到的扳机键。必须为 "leftTrigger" 或 "rightTrigger"。 relative - boolean,可选。控制油门如何计算其值。若为 true,值将根据用户的初始触摸位置计算。若为 false,值将根据控件的中心点计算。默认为 true。 sticky - boolean,可选。控制用户停止触摸控件时的行为。若为 true,油门将保持在最后一个值。若为 false,将重置为 0。默认为 false。 enabled - boolean,可选。默认为 true。将控件的可视状态设置为启用/禁用。禁用的控件仍会接收玩家的输入,但不会根据输入更改其可视样式。 visible - boolean,可选。默认为 true。确定该控件是否显示给玩家进行交互。要在游戏过程中更改此项,请参阅使用游戏状态更改触控布局。 styles - object,可选。控件视觉表示的自定义。样式表示为每个可样式化状态对应的一个对象。 油门控件可以为以下状态设置样式。
  • default - 基本样式。
  • activated - 玩家触摸旋钮且旋钮恰好位于轴上 0 值时应用。
  • activatedDown - 玩家触摸旋钮并将旋钮移动到油门轴的负(下)部分时应用。
  • activatedUp - 玩家触摸旋钮并将旋钮移动到油门轴的正(上)部分时应用。
  • idle - 玩家未与控件交互且旋钮也未处于 sticky 上部时应用。
  • idleUp - 玩家未与控件交互且旋钮已被移到上部并 sticky 被设置为 true 时应用。
每个状态的样式属性 opacity - number,可选。应用于控件的不透明度。除 disabled 外的所有状态默认为 1.0。 axisUp - object,可选。指定油门正(上)部分样式的 axis 对象。 axisDown - object,可选。指定油门负(下)部分样式的 axis 对象。 knob - object,可选。指定油门旋钮部分样式的 knob 对象。 indicator - object,可选。一个 stroke,指定连接旋钮到轴上当前位置的组件的样式。 资源尺寸 对于接受图像资源的每个样式对象,给定的资源以基础分辨率提供,并以该基础分辨率的 1.5x、2.0x、3.0x 和 4.0x 缩放提供。给定图像的分辨率必须小于或等于以下最大分辨率。

备注

throttle 控件允许玩家通过触摸控件提供扳机键的可变压力。 throttle 控件设计为放在方向盘的中心位置—并且是该位置与屏幕边缘之间唯一的控件。 如果玩家可能希望对扳机键施加恒定压力以设置该值,然后用手指进行不同操作,请将 sticky 设置为 true。 样式备注
通过 Windows 版本的内容测试应用程序进行串流时,并非所有样式都会正确显示。

示例

示例 1:基本油门

图 1. 油门控件 用户与油门交互 这使用默认样式。

示例 2:具有样式化轮廓和显式定义图标的油门

图 1. 自定义油门控件 用户与自定义油门交互

要求

布局版本: 1.0+(样式功能自布局版本 3.2+ 起可用)
Last modified on October 19, 2026