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

瀏覽器相容性

另見