Gamepad API

API Gamepad - это простой и последовательный способ для разработчиков получать доступ к сигналам с геймпадов и других игровых контроллеров и реагировать на них. Он содержит три интерфейса, два события и одну специализированную функцию, чтобы реагировать на подключение и отключение геймпадов, а также получать доступ к другой информации о самих геймпадах и о том, какие кнопки и другие элементы управления в настоящее время нажимаются.

Интерфейсы

Gamepad: Представляет собой геймпад/контроллер, подключенный к компьютеру.
GamepadButton: Представлят собой кнопку одного из подлюченных контроллеров
GamepadEvent: Объект события, представляющий запущенные события, связанные с геймпадами.

Экспериментальные расширения геймпада

GamepadHapticActuator: Представляет собой аппаратное обеспечение в контроллере, предназначенное для обеспечения тактильной обратной связи с пользователем (если таковая имеется), чаще всего вибрационное оборудование.
GamepadPose: Представляет собой позу контроллера (например, положение и ориентацию в трехмерном пространстве) в случае контроллера WebVR. Это не используется в более новом стандарте WebXR.

Сморите также extensions to the Gamepad interface (расширения интерфейса геймпада) для функций, которые позволяют получить доступ к вышеуказанной информации.

Расширения для других интерфейсов

Навигатор

Navigator.getGamepads(): Расширение объекта Navigator, возвращающее масссив объектов Gamepad по одному для каждого подключенного геймпада.

События окна

Window.ongamepadconnected: Представляет собой обработчик событий, который будет выполняться при подключении геймпада (когда срабатывает событие gamepadconnected).
Window.ongamepaddisconnected: Представляет собой обработчик событий, который будет выполняться при отключении геймпада (когда срабатывает событие gamepaddisconnected).

Учебные пособия и руководства

Технические характеристики

Спецификация	Статус	Примечание
Gamepad Extensions	Редакторский черновик	Определяет Experimental Gamepad extensions.
Gamepad Определение 'The Gamepad API specification' в этой спецификации.	Рабочий черновик	Первононачальное определение

Совместимость браузера

Update compatibility data on GitHub

	Компьютеры						Мобильные
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome для Android	Firefox для Android	Opera для Android	Safari on iOS	Samsung Internet
`Gamepad`	Chrome Полная поддержка 35 Полная поддержка 35 Нет поддержки 21 — 34 С префиксом С префиксом Требует вендорный префикс: webkit	Edge Полная поддержка ≤18	Firefox Полная поддержка 29 Полная поддержка 29 Нет поддержки 24 — 28 Отключено Отключено From version 24 until version 28 (exclusive): this feature is behind the `dom.gamepad.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE Нет поддержки Нет	Opera Полная поддержка 22 Полная поддержка 22 Нет поддержки 15 — 21 С префиксом С префиксом Требует вендорный префикс: webkit	Safari Полная поддержка 10.1	WebView Android Нет поддержки Нет	Chrome Android Полная поддержка 35 Полная поддержка 35 Нет поддержки 25 — 34 С префиксом С префиксом Требует вендорный префикс: webkit	Firefox Android Полная поддержка 32	Opera Android Полная поддержка 22 Полная поддержка 22 Нет поддержки 14 — 21 С префиксом С префиксом Требует вендорный префикс: webkit	Safari iOS Полная поддержка 10.3	Samsung Internet Android Полная поддержка 4.0 Полная поддержка 4.0 Нет поддержки 2.0 — 3.0 С префиксом С префиксом Требует вендорный префикс: webkit
`Gamepad()` constructor	Chrome Полная поддержка 35	Edge Полная поддержка 12	Firefox Полная поддержка 29 Полная поддержка 29 Нет поддержки 24 — 28 Отключено Отключено From version 24 until version 28 (exclusive): this feature is behind the `dom.gamepad.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE Нет поддержки Нет	Opera Полная поддержка 22	Safari Полная поддержка 10.1	WebView Android Нет поддержки Нет	Chrome Android Полная поддержка 35	Firefox Android Полная поддержка 32	Opera Android Полная поддержка 22	Safari iOS Полная поддержка 10.3	Samsung Internet Android Полная поддержка 4.0
`axes`	Chrome Полная поддержка 35 Полная поддержка 35 Нет поддержки 21 — 34 С префиксом С префиксом Требует вендорный префикс: webkit	Edge Полная поддержка 12	Firefox Полная поддержка 29 Полная поддержка 29 Нет поддержки 24 — 28 Отключено Отключено From version 24 until version 28 (exclusive): this feature is behind the `dom.gamepad.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE Нет поддержки Нет	Opera Полная поддержка 22 Полная поддержка 22 Нет поддержки 15 — 21 С префиксом С префиксом Требует вендорный префикс: webkit	Safari Полная поддержка 10.1	WebView Android Нет поддержки Нет	Chrome Android Полная поддержка 35 Полная поддержка 35 Нет поддержки 25 — 34 С префиксом С префиксом Требует вендорный префикс: webkit	Firefox Android Полная поддержка 32	Opera Android Полная поддержка 22 Полная поддержка 22 Нет поддержки 14 — 21 С префиксом С префиксом Требует вендорный префикс: webkit	Safari iOS Полная поддержка 10.3	Samsung Internet Android Полная поддержка 4.0 Полная поддержка 4.0 Нет поддержки 2.0 — 3.0 С префиксом С префиксом Требует вендорный префикс: webkit
`buttons`	Chrome Полная поддержка 35 Полная поддержка 35 Нет поддержки 21 — 34 С префиксом С префиксом Требует вендорный префикс: webkit	Edge Полная поддержка 12	Firefox Полная поддержка 29 Полная поддержка 29 Нет поддержки 24 — 28 Отключено Отключено From version 24 until version 28 (exclusive): this feature is behind the `dom.gamepad.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE Нет поддержки Нет	Opera Полная поддержка 22 Полная поддержка 22 Нет поддержки 15 — 21 С префиксом С префиксом Требует вендорный префикс: webkit	Safari Полная поддержка 10.1	WebView Android Нет поддержки Нет	Chrome Android Полная поддержка 35 Полная поддержка 35 Нет поддержки 25 — 34 С префиксом С префиксом Требует вендорный префикс: webkit	Firefox Android Полная поддержка 32	Opera Android Полная поддержка 22 Полная поддержка 22 Нет поддержки 14 — 21 С префиксом С префиксом Требует вендорный префикс: webkit	Safari iOS Полная поддержка 10.3	Samsung Internet Android Полная поддержка 4.0 Полная поддержка 4.0 Нет поддержки 2.0 — 3.0 С префиксом С префиксом Требует вендорный префикс: webkit
`connected`	Chrome Полная поддержка 35 Полная поддержка 35 Нет поддержки 25 — 34 С префиксом С префиксом Требует вендорный префикс: webkit	Edge Полная поддержка 12	Firefox Полная поддержка 29 Полная поддержка 29 Нет поддержки 24 — 28 Отключено Отключено From version 24 until version 28 (exclusive): this feature is behind the `dom.gamepad.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE Нет поддержки Нет	Opera Полная поддержка 22 Полная поддержка 22 Нет поддержки 15 — 21 С префиксом С префиксом Требует вендорный префикс: webkit	Safari Полная поддержка 10.1	WebView Android Нет поддержки Нет	Chrome Android Полная поддержка 35 Полная поддержка 35 Нет поддержки 25 — 34 С префиксом С префиксом Требует вендорный префикс: webkit	Firefox Android Полная поддержка 32	Opera Android Полная поддержка 22 Полная поддержка 22 Нет поддержки 14 — 21 С префиксом С префиксом Требует вендорный префикс: webkit	Safari iOS Полная поддержка 10.3	Samsung Internet Android Полная поддержка 4.0 Полная поддержка 4.0 Нет поддержки 2.0 — 3.0 С префиксом С префиксом Требует вендорный префикс: webkit
`displayId` ЭкспериментальнаяУстаревшая	Chrome Нет поддержки ? — 80 Замечания Отключено Нет поддержки ? — 80 Замечания Отключено Замечания Only works on desktop in an experimental version of Chrome (other builds won't return any devices when `Navigator.getVRDisplays()` is invoked). Отключено Until version 80 (exclusive): this feature is behind the `WebVR` preference. To change preferences in Chrome, visit chrome://flags.	Edge Полная поддержка 15	Firefox Полная поддержка 55 Замечания Полная поддержка 55 Замечания Замечания Windows support was enabled in Firefox 55. Полная поддержка 64 Замечания Замечания macOS support was enabled in Firefox 64.	IE Нет поддержки Нет	Opera ?	Safari Нет поддержки Нет	WebView Android Нет поддержки Нет	Chrome Android Нет поддержки ? — 80 Замечания Нет поддержки ? — 80 Замечания Замечания Currently supported only by Google Daydream.	Firefox Android Полная поддержка 55	Opera Android ?	Safari iOS Нет поддержки Нет	Samsung Internet Android Полная поддержка Да Замечания Полная поддержка Да Замечания Замечания Currently supported only by Google Daydream.
`hand` Экспериментальная	Chrome Нет поддержки Нет	Edge Нет поддержки 15 — 79	Firefox Полная поддержка Да Замечания Отключено Полная поддержка Да Замечания Отключено Замечания The flag is enabled by default in Firefox Nightly and Beta, versions 55 and above. Отключено This feature is behind the `dom.gamepad-extensions.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE Нет поддержки Нет	Opera Нет поддержки Нет	Safari Нет поддержки Нет	WebView Android Нет поддержки Нет	Chrome Android Нет поддержки Нет	Firefox Android Нет поддержки Нет	Opera Android Нет поддержки Нет	Safari iOS Нет поддержки Нет	Samsung Internet Android Нет поддержки Нет
`hapticActuators` Экспериментальная	Chrome Нет поддержки Нет	Edge Нет поддержки 15 — 79	Firefox Полная поддержка Да Замечания Отключено Полная поддержка Да Замечания Отключено Замечания The flag is enabled by default in Firefox Nightly and Beta, versions 55 and above. Отключено This feature is behind the `dom.gamepad-extensions.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE Нет поддержки Нет	Opera Нет поддержки Нет	Safari Нет поддержки Нет	WebView Android Нет поддержки Нет	Chrome Android Нет поддержки Нет	Firefox Android Нет поддержки Нет	Opera Android Нет поддержки Нет	Safari iOS Нет поддержки Нет	Samsung Internet Android Нет поддержки Нет
`id` Экспериментальная	Chrome Полная поддержка 35 Полная поддержка 35 Нет поддержки 21 — 34 С префиксом С префиксом Требует вендорный префикс: webkit	Edge Полная поддержка 12	Firefox Полная поддержка 29 Полная поддержка 29 Нет поддержки 24 — 28 Отключено Отключено From version 24 until version 28 (exclusive): this feature is behind the `dom.gamepad.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE Нет поддержки Нет	Opera Полная поддержка 22 Полная поддержка 22 Нет поддержки 15 — 21 С префиксом С префиксом Требует вендорный префикс: webkit	Safari Нет поддержки Нет	WebView Android Нет поддержки Нет	Chrome Android Полная поддержка 35 Полная поддержка 35 Нет поддержки 25 — 34 С префиксом С префиксом Требует вендорный префикс: webkit	Firefox Android Полная поддержка 32	Opera Android Полная поддержка 22 Полная поддержка 22 Нет поддержки 14 — 21 С префиксом С префиксом Требует вендорный префикс: webkit	Safari iOS Нет поддержки Нет	Samsung Internet Android Полная поддержка 4.0 Полная поддержка 4.0 Нет поддержки 2.0 — 3.0 С префиксом С префиксом Требует вендорный префикс: webkit
`index` Экспериментальная	Chrome Полная поддержка 35 Полная поддержка 35 Нет поддержки 21 — 34 С префиксом С префиксом Требует вендорный префикс: webkit	Edge Полная поддержка 12	Firefox Полная поддержка 29 Полная поддержка 29 Нет поддержки 24 — 28 Отключено Отключено From version 24 until version 28 (exclusive): this feature is behind the `dom.gamepad.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE Нет поддержки Нет	Opera Полная поддержка 22 Полная поддержка 22 Нет поддержки 15 — 21 С префиксом С префиксом Требует вендорный префикс: webkit	Safari Полная поддержка 10.1	WebView Android Нет поддержки Нет	Chrome Android Полная поддержка 35 Полная поддержка 35 Нет поддержки 25 — 34 С префиксом С префиксом Требует вендорный префикс: webkit	Firefox Android Полная поддержка 32	Opera Android Полная поддержка 22 Полная поддержка 22 Нет поддержки 14 — 21 С префиксом С префиксом Требует вендорный префикс: webkit	Safari iOS Полная поддержка 10.3	Samsung Internet Android Полная поддержка 4.0 Полная поддержка 4.0 Нет поддержки 2.0 — 3.0 С префиксом С префиксом Требует вендорный префикс: webkit
`mapping`	Chrome Полная поддержка 35 Полная поддержка 35 Нет поддержки 21 — 34 С префиксом С префиксом Требует вендорный префикс: webkit	Edge Полная поддержка 12	Firefox Полная поддержка 29 Полная поддержка 29 Нет поддержки 24 — 28 Отключено Отключено From version 24 until version 28 (exclusive): this feature is behind the `dom.gamepad.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE Нет поддержки Нет	Opera Полная поддержка 22 Полная поддержка 22 Нет поддержки 15 — 21 С префиксом С префиксом Требует вендорный префикс: webkit	Safari Полная поддержка 10.1	WebView Android Нет поддержки Нет	Chrome Android Полная поддержка 35 Полная поддержка 35 Нет поддержки 25 — 34 С префиксом С префиксом Требует вендорный префикс: webkit	Firefox Android Полная поддержка 32	Opera Android Полная поддержка 22 Полная поддержка 22 Нет поддержки 14 — 21 С префиксом С префиксом Требует вендорный префикс: webkit	Safari iOS Полная поддержка 10.3	Samsung Internet Android Полная поддержка 4.0 Полная поддержка 4.0 Нет поддержки 2.0 — 3.0 С префиксом С префиксом Требует вендорный префикс: webkit
`pose` Экспериментальная	Chrome Нет поддержки Нет	Edge Нет поддержки 15 — 79	Firefox Полная поддержка Да Замечания Отключено Полная поддержка Да Замечания Отключено Замечания The flag is enabled by default in Firefox Nightly and Beta, versions 55 and above. Отключено This feature is behind the `dom.gamepad-extensions.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE Нет поддержки Нет	Opera Нет поддержки Нет	Safari Нет поддержки Нет	WebView Android Нет поддержки Нет	Chrome Android Нет поддержки Нет	Firefox Android Нет поддержки Нет	Opera Android Нет поддержки Нет	Safari iOS Нет поддержки Нет	Samsung Internet Android Нет поддержки Нет
`timestamp`	Chrome Полная поддержка 35 Полная поддержка 35 Нет поддержки 21 — 34 С префиксом С префиксом Требует вендорный префикс: webkit	Edge Полная поддержка 12	Firefox Полная поддержка 29 Полная поддержка 29 Нет поддержки 24 — 28 Отключено Отключено From version 24 until version 28 (exclusive): this feature is behind the `dom.gamepad.enabled` preference (needs to be set to `true`). To change preferences in Firefox, visit about:config.	IE Нет поддержки Нет	Opera Полная поддержка 22 Полная поддержка 22 Нет поддержки 15 — 21 С префиксом С префиксом Требует вендорный префикс: webkit	Safari Полная поддержка 10.1	WebView Android Нет поддержки Нет	Chrome Android Полная поддержка 35 Полная поддержка 35 Нет поддержки 25 — 34 С префиксом С префиксом Требует вендорный префикс: webkit	Firefox Android Полная поддержка 32	Opera Android Полная поддержка 22 Полная поддержка 22 Нет поддержки 14 — 21 С префиксом С префиксом Требует вендорный префикс: webkit	Safari iOS Полная поддержка 10.3	Samsung Internet Android Полная поддержка 4.0 Полная поддержка 4.0 Нет поддержки 2.0 — 3.0 С префиксом С префиксом Требует вендорный префикс: webkit

Легенда

Полная поддержка: Полная поддержка
Нет поддержки: Нет поддержки
Совместимость неизвестна: Совместимость неизвестна
Экспериментальная. Ожидаемое поведение может измениться в будущем.: Экспериментальная. Ожидаемое поведение может измениться в будущем.
Устаревшая. Не следует использовать в новых веб-сайтах: Устаревшая. Не следует использовать в новых веб-сайтах
Смотрите замечания реализации.: Смотрите замечания реализации.
Пользователь должен сам включить эту возможность.: Пользователь должен сам включить эту возможность.
Требует вендорный префикс или другое имя для использования.: Требует вендорный префикс или другое имя для использования.

Прочтите также

The Gamepad API, авторы: Тед Мельчарек и Роберт Найман
Simple API demo page (source)