Gamepad

.Input.Gamepad. Gamepad

一个游戏手柄. 这些是由游戏手柄插件创建,更新和管理的.

Constructor

new Gamepad(manager, pad)

Since:
  • 3.0.0
Parameters:
Name Type Description
manager Phaser.Input.Gamepad.GamepadPlugin 游戏手柄插件的参考.
pad Phaser.Types.Input.Gamepad.Pad 游戏手柄对象,从游戏手柄事件中提取.

Extends

Members

A :boolean

Since:
  • 3.10.0
右按钮集群中游戏手柄的底部按钮被按下了吗? 如果游戏手柄没有这个按钮,它将总是返回假. 在双电击控制器上,它是X按钮. 在XBox控制器上,它是一个按钮.
Type:
  • boolean

axes :Array.<Phaser.Input.Gamepad.Axis>

Since:
  • 3.0.0
一组游戏手柄轴对象,对应游戏手柄上的不同轴,如果有的话.
Type:

B :boolean

Since:
  • 3.10.0
右按钮集群中游戏手柄的右按钮是否被按下? 如果游戏手柄没有这个按钮,它将总是返回假. 在双电击控制器上,是圆形按钮. 在XBox控制器上,它是B按钮.
Type:
  • boolean

buttons :Array.<Phaser.Input.Gamepad.Button>

Since:
  • 3.0.0
一组游戏手柄按钮对象,对应游戏手柄上的不同按钮.
Type:

connected :boolean

Since:
  • 3.0.0
Default Value:
  • true
这款游戏手柄目前是否连接?
Type:
  • boolean

down :boolean

Since:
  • 3.10.0
游戏手柄的向下按钮被按下了吗? 如果游戏手柄没有这个按钮,它将总是返回假. 这是标准Gamepad映射下的d-pad向下按钮.
Type:
  • boolean

id :string

Since:
  • 3.0.0
包含关于控制器的一些信息的字符串. 这不是严格指定的,但是在Firefox中它将包含三条信息 用破折号(-)分隔:两个4位十六进制字符串,包含USB供应商和 控制器的产品id,以及驱动程序提供的控制器名称. 在Chrome中,它将包含驱动程序提供的控制器名称, 后跟供应商和产品4位十六进制字符串.
Type:
  • string

index :number

Since:
  • 3.0.0
当前连接到系统的每个游戏手柄唯一的整数. 这可以用来区分多个控制器. 请注意,断开一个设备然后连接一个新设备可能会重复使用以前的索引.
Type:
  • number

L1 :number

Since:
  • 3.10.0
返回游戏手柄左上肩按钮的值. 如果游戏手柄没有这个按钮,它将总是归零. 该值是一个介于0和1之间的浮点数,对应于按钮被按下的程度. 在双电击控制器上,它是L1按钮. 在XBox控制器上,它是LB按钮.
Type:
  • number

L2 :number

Since:
  • 3.10.0
返回游戏手柄左下角按钮的值. 如果游戏手柄没有这个按钮,它将总是归零. 该值是一个介于0和1之间的浮点数,对应于按钮被按下的程度. 在双电击控制器上,它是L2按钮. 在XBox控制器上,它是LT按钮.
Type:
  • number

left :boolean

Since:
  • 3.10.0
游戏手柄的左键被按下了吗? 如果游戏手柄没有这个按钮,它将总是返回假. 这是标准Gamepad映射下的d-pad左按钮.
Type:
  • boolean

leftStick :Phaser.Math.Vector2

Since:
  • 3.10.0
一个矢量2,包含游戏手柄左轴杆的最新值. 这是作为游戏手柄更新周期的一部分自动更新的. H轴映射到 `Vector2.x` 属性,V轴映射到 `Vector2.y` 属性. 这些值基于轴阈值. 如果游戏手柄没有左轴杆,数值将始终为零.
Type:

manager :Phaser.Input.Gamepad.GamepadPlugin

Since:
  • 3.0.0
游戏手柄插件的参考.
Type:

pad :any

Since:
  • 3.10.0
连接到浏览器的本机游戏手柄对象的引用.
Type:
  • any

R1 :number

Since:
  • 3.10.0
返回游戏手柄右上肩按钮的值. 如果游戏手柄没有这个按钮,它将总是归零. 该值是一个介于0和1之间的浮点数,对应于按钮被按下的程度. 在双电击控制器上,它是R1按钮. 在XBox控制器上,它是RB按钮.
Type:
  • number

R2 :number

Since:
  • 3.10.0
返回游戏手柄底部右肩按钮的值. 如果游戏手柄没有这个按钮,它将总是归零. 该值是一个介于0和1之间的浮点数,对应于按钮被按下的程度. 在双电击控制器上,它是R2按钮. 在XBox控制器上,它是实时按钮.
Type:
  • number
Since:
  • 3.10.0
游戏手柄的右键被按下了吗? 如果游戏手柄没有这个按钮,它将总是返回假. 这是标准Gamepad映射下的d-pad右键.
Type:
  • boolean

rightStick :Phaser.Math.Vector2

Since:
  • 3.10.0
一个矢量2,包含游戏手柄右轴杆的最新值. 这是作为游戏手柄更新周期的一部分自动更新的. H轴映射到 `Vector2.x` 属性,V轴映射到 `Vector2.y` 属性. 这些值基于轴阈值. 如果游戏手柄没有右轴杆,数值将始终为零.
Type:

timestamp :number

Since:
  • 3.0.0
包含此游戏手柄最近更新时间的时间戳.
Type:
  • number

up :boolean

Since:
  • 3.10.0
游戏手柄的向上按钮被按下了吗? 如果游戏手柄没有这个按钮,它将总是返回假. 这是标准Gamepad映射下的d-pad up按钮.
Type:
  • boolean

vibration :GamepadHapticActuator

Since:
  • 3.10.0
游戏手柄的触觉执行器(振动/隆隆声支持). 这是高度实验性的,并且仅当两者都存在于设备上时才设置, 并且被硬件和浏览器暴露.
Type:
  • GamepadHapticActuator

X :boolean

Since:
  • 3.10.0
游戏手柄在右按钮组中的左按钮被按下了吗? 如果游戏手柄没有这个按钮,它将总是返回假. 在双电击控制器上,它是方形按钮. 在XBox控制器上,它是X按钮.
Type:
  • boolean

Y :boolean

Since:
  • 3.10.0
游戏手柄在右按钮组的顶部按钮是否被按下? 如果游戏手柄没有这个按钮,它将总是返回假. 在双电击控制器上,它是三角形按钮. 在XBox控制器上,它是Y按钮.
Type:
  • boolean

Methods

addListener(event, fn, contextopt) → {this}

Since:
  • 3.0.0
Inherited From:
为给定事件添加侦听器.
Parameters:
Name Type Attributes Default Description
event string | symbol 事件名称.
fn function 侦听器函数.
context * <optional>
this 用来调用侦听器的上下文.
Returns:
`this`.
Type
this

destroy()

Since:
  • 3.10.0
Overrides:
销毁这个游戏手柄实例,它的按钮和轴,并释放它持有的外部参考.

emit(event, …argsopt) → {boolean}

Since:
  • 3.0.0
Inherited From:
调用为给定事件注册的每个侦听器.
Parameters:
Name Type Attributes Description
event string | symbol 事件名称.
args * <optional>
<repeatable>
将传递给事件处理程序的附加参数.
Returns:
`true` 如果事件有侦听器,则为 `false` .
Type
boolean

eventNames() → {Array.<(string|symbol)>}

Since:
  • 3.0.0
Inherited From:
返回一个数组,列出发射器已注册侦听器的事件.
Returns:
Type
Array.<(string|symbol)>

getAxisTotal() → {number}

Since:
  • 3.10.0
获取游戏手柄声称支持的轴总数.
Returns:
游戏手柄声称支持的轴总数.
Type
number

getAxisValue(index) → {number}

Since:
  • 3.10.0
基于给定的索引获取轴的值. 索引必须在游戏手柄支持的轴范围内有效. 返回值将是一个介于0和1之间的浮点数.
Parameters:
Name Type Description
index number 要获取其值的轴的索引.
Returns:
轴的值,介于0和1之间.
Type
number

getButtonTotal() → {number}

Since:
  • 3.10.0
获取游戏手柄声称拥有的按钮总数.
Returns:
这个游戏手柄声称拥有的按钮总数.
Type
number

getButtonValue(index) → {number}

Since:
  • 3.10.0
基于给定的索引获取按钮的值. 该索引必须在此游戏手柄支持的按钮范围内有效. 对于模拟按钮,返回值将是0或1,或者是介于0和1之间的浮点数 用于压敏数字按钮,如双电击上的肩按钮.
Parameters:
Name Type Description
index number 要获取其值的按钮的索引.
Returns:
按钮的值,介于0和1之间.
Type
number

isButtonDown(index) → {boolean}

Since:
  • 3.10.0
返回按钮是否被按下. 该索引必须在此游戏手柄支持的按钮范围内有效.
Parameters:
Name Type Description
index number 要获取其值的按钮的索引.
Returns:
`true` 如果该按钮被视为按下,则为 `afus` .
Type
boolean

listenerCount(event) → {number}

Since:
  • 3.0.0
Inherited From:
返回监听给定事件的侦听器数量.
Parameters:
Name Type Description
event string | symbol 事件名称.
Returns:
侦听器的数量.
Type
number

listeners(event) → {Array.<function()>}

Since:
  • 3.0.0
Inherited From:
返回为给定事件注册的侦听器.
Parameters:
Name Type Description
event string | symbol 事件名称.
Returns:
注册的听众.
Type
Array.<function()>

off(event, fnopt, contextopt, onceopt) → {this}

Since:
  • 3.0.0
Inherited From:
移除给定事件的侦听器.
Parameters:
Name Type Attributes Description
event string | symbol 事件名称.
fn function <optional>
仅移除与此函数匹配的侦听器.
context * <optional>
仅移除具有此上下文的侦听器.
once boolean <optional>
仅删除一次性侦听器.
Returns:
`this`.
Type
this

on(event, fn, contextopt) → {this}

Since:
  • 3.0.0
Inherited From:
为给定事件添加侦听器.
Parameters:
Name Type Attributes Default Description
event string | symbol 事件名称.
fn function 侦听器函数.
context * <optional>
this 用来调用侦听器的上下文.
Returns:
`this`.
Type
this

once(event, fn, contextopt) → {this}

Since:
  • 3.0.0
Inherited From:
为给定事件添加一次性侦听器.
Parameters:
Name Type Attributes Default Description
event string | symbol 事件名称.
fn function 侦听器函数.
context * <optional>
this 用来调用侦听器的上下文.
Returns:
`this`.
Type
this

removeAllListeners(eventopt) → {this}

Since: