GamepadHapticActuator

可用性有限

此特性不是基线特性,因为它在一些最广泛使用的浏览器中不起作用。

安全上下文: 此功能仅在安全上下文(HTTPS)中可用,且支持此功能的浏览器数量有限。

GamepadHapticActuator 接口是 Gamepad API 的一部分,用于表示控制器中旨在向用户提供触觉反馈(如果可用)的硬件,最常见的是振动硬件。

可以通过 Gamepad.hapticActuators 属性访问此接口。

实例属性

GamepadHapticActuator.effects 只读 实验性

返回一个表示执行器支持的不同触觉效果的枚举值数组。

GamepadHapticActuator.type 已弃用 只读 非标准

返回一个表示触觉硬件类型的枚举值。此属性已弃用:请使用 GamepadHapticActuator.effects 来检测效果支持。

实例方法

GamepadHapticActuator.playEffect() 只读

使硬件播放特定的振动效果。

GamepadHapticActuator.pulse() 只读

使硬件在指定持续时间内以特定强度脉冲。

GamepadHapticActuator.reset() 只读

停止硬件播放活动的振动效果。

示例

js
const gamepad = navigator.getGamepads()[0];

gamepad.hapticActuators[0].pulse(1.0, 200);

gamepad.vibrationActuator.playEffect("dual-rumble", {
  startDelay: 0,
  duration: 200,
  weakMagnitude: 1.0,
  strongMagnitude: 1.0,
});

规范

规范
Gamepad
# gamepadhapticactuator-interface

浏览器兼容性

另见