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

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅

Gamepad API