Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.

Интерфейс Gamepad Gamepad API определяет отдельный геймпад или контроллер, предоставляющий доступ к такой информации, как: нажатие кнопок, позиции осей, и id.

Объект Gamepad может быть возвращен в одном из двух случаев: как свойство gamepad событий gamepadconnected и gamepaddisconnected, или считыванием любой позиции в массиве, возвращенном методом Navigator.getGamepads().

Свойства

Gamepad.displayId Только для чтения
Возвращает VRDisplay.displayId связанный с VRDisplay (при необходимости) — VRDisplay отображаемая область которого управляется геймпадом.
Gamepad.id Только для чтения
DOMString содержит идентификационную информацию о контроллере.
Gamepad.index Только для чтения
Целое автоинкрементируемое значение, уникальное для каждого устройства, подключенного в данный момент к системе.
Gamepad.mapping Только для чтения
Строка, указывающая, переназначил ли браузер элементы управления устройства на уже известный шаблон.
Gamepad.connected Только для чтения
Логическое свойство показывающее, подключен ли геймпад к системе в данный момент.
Gamepad.buttons Только для чтения
Массив объектов gamepadButton представляющих кнопки устройства.
Gamepad.axes Только для чтения
Массив, представляющий элементы управления осями устройства (например, аналоговые стики).
Gamepad.timestamp Только для чтения
DOMHighResTimeStamp представляет время последнего обновления данных геймпада.

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

Следующие интерфейсы определены в спецификации Gamepad Extensions, и предоставляют доступ к экспериментальным возможностям, таким как тактильная обратная связь (haptic feedback) и информация о положении WebVR контроллера.

Gamepad.hand Только для чтения
Перечисляемое значение, которое определяет в какой руке находится контроллер.
Gamepad.hapticActuators Только для чтения
Массив, содержащий объекты GamepadHapticActuator, каждый из которых представляет собой аппаратные средства тактильной обратной связи (haptic feedbac) доступные для контроллера.
Gamepad.pose Только для чтения
Объект GamepadPose представляет информацию о положении WebVR контроллера (например, позиция и ориентация в 3D пространстве).

Пример

window.addEventListener("gamepadconnected", function(e) {
  console.log("Gamepad connected at index %d: %s. %d buttons, %d axes.",
  e.gamepad.index, e.gamepad.id,
  e.gamepad.buttons.length, e.gamepad.axes.length);
});

Спецификации

Спецификация Статус Комментарий
Gamepad
Определение 'Gamepad' в этой спецификации.
Рабочий черновик Первоначальное определение
WebVR 1.1
Определение 'displayId' в этой спецификации.
Черновик Определено свойство Gamepad.displayId.
Gamepad Extensions
Определение 'Gamepad extensions' в этой спецификации.
Редакторский черновик Определены Экспериментальные расширения для Gamepad

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

Update compatibility data on GitHub
КомпьютерыМобильные
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome для AndroidEdge MobileFirefox для AndroidOpera для AndroidiOS SafariSamsung Internet
Базовая поддержкаChrome Полная поддержка 35
Полная поддержка 35
Нет поддержки 21 — 34
С префиксом
С префиксом Требует вендорный префикс: webkit
Edge Полная поддержка Да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
Edge Mobile Полная поддержка ДаFirefox Android Полная поддержка 32Opera Android Полная поддержка 22
Полная поддержка 22
Нет поддержки 15 — 21
С префиксом
С префиксом Требует вендорный префикс: webkit
Safari iOS Нет поддержки НетSamsung Internet Android Полная поддержка Да
Gamepad() constructorChrome Полная поддержка 35Edge Полная поддержка 12Firefox Полная поддержка 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 Полная поддержка 22Safari Нет поддержки НетWebView Android Нет поддержки НетChrome Android Полная поддержка 35Edge Mobile Полная поддержка ДаFirefox Android Полная поддержка 32Opera Android Полная поддержка 22Safari iOS Нет поддержки НетSamsung Internet Android Полная поддержка Да
axesChrome Полная поддержка 35
Полная поддержка 35
Нет поддержки 21 — 34
С префиксом
С префиксом Требует вендорный префикс: webkit
Edge Полная поддержка 12Firefox Полная поддержка 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
Edge Mobile Полная поддержка ДаFirefox Android Полная поддержка 32Opera Android Полная поддержка 22
Полная поддержка 22
Нет поддержки 15 — 21
С префиксом
С префиксом Требует вендорный префикс: webkit
Safari iOS Нет поддержки НетSamsung Internet Android Полная поддержка Да
buttonsChrome Полная поддержка 35
Полная поддержка 35
Нет поддержки 21 — 34
С префиксом
С префиксом Требует вендорный префикс: webkit
Edge Полная поддержка 12Firefox Полная поддержка 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
Edge Mobile Полная поддержка ДаFirefox Android Полная поддержка 32Opera Android Полная поддержка 22
Полная поддержка 22
Нет поддержки 15 — 21
С префиксом
С префиксом Требует вендорный префикс: webkit
Safari iOS Нет поддержки НетSamsung Internet Android Полная поддержка Да
connectedChrome Полная поддержка 35
Полная поддержка 35
Нет поддержки 25 — 34
С префиксом
С префиксом Требует вендорный префикс: webkit
Edge Полная поддержка 12Firefox Полная поддержка 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
Edge Mobile Полная поддержка ДаFirefox Android Полная поддержка 32Opera Android Полная поддержка 22
Полная поддержка 22
Нет поддержки 15 — 21
С префиксом
С префиксом Требует вендорный префикс: webkit
Safari iOS Нет поддержки НетSamsung Internet Android Полная поддержка Да
displayId
Экспериментальная
Chrome Полная поддержка Да
Замечания Отключено
Полная поддержка Да
Замечания Отключено
Замечания Only works on desktop in an experimental version of Chrome (other builds won't return any devices when Navigator.getVRDisplays() is invoked).
Отключено This feature is behind the WebVR preference. To change preferences in Chrome, visit chrome://flags.
Edge Полная поддержка 15Firefox Полная поддержка 56
Замечания
Полная поддержка 56
Замечания
Замечания Currently only Windows support is enabled by default. Mac support is available in Firefox Nightly.
IE Нет поддержки НетOpera ? Safari ? WebView Android Нет поддержки НетChrome Android Полная поддержка Да
Замечания
Полная поддержка Да
Замечания
Замечания Currently supported only by Google Daydream.
Edge Mobile ? Firefox Android ? Opera Android ? Safari iOS ? Samsung Internet Android Полная поддержка Да
hand
Экспериментальная
Chrome Нет поддержки НетEdge Полная поддержка 15Firefox Полная поддержка Да
Замечания Отключено
Полная поддержка Да
Замечания Отключено
Замечания 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 Нет поддержки НетEdge Mobile Нет поддержки НетFirefox Android Нет поддержки НетOpera Android Нет поддержки НетSafari iOS Нет поддержки НетSamsung Internet Android Нет поддержки Нет
hapticActuators
Экспериментальная
Chrome Нет поддержки НетEdge Полная поддержка 15Firefox Полная поддержка Да
Замечания Отключено
Полная поддержка Да
Замечания Отключено
Замечания 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 Нет поддержки НетEdge Mobile Нет поддержки НетFirefox Android Нет поддержки НетOpera Android Нет поддержки НетSafari iOS Нет поддержки НетSamsung Internet Android Нет поддержки Нет
id
Экспериментальная
Chrome Полная поддержка 35
Полная поддержка 35
Нет поддержки 21 — 34
С префиксом
С префиксом Требует вендорный префикс: webkit
Edge Полная поддержка 12Firefox Полная поддержка 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
Edge Mobile Полная поддержка ДаFirefox Android Полная поддержка 32Opera Android Нет поддержки НетSafari iOS Нет поддержки НетSamsung Internet Android Полная поддержка Да
index
Экспериментальная
Chrome Полная поддержка 35
Полная поддержка 35
Нет поддержки 21 — 34
С префиксом
С префиксом Требует вендорный префикс: webkit
Edge Полная поддержка 12Firefox Полная поддержка 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
Edge Mobile Полная поддержка ДаFirefox Android Полная поддержка 32Opera Android Нет поддержки НетSafari iOS Нет поддержки НетSamsung Internet Android Полная поддержка Да
mappingChrome Полная поддержка 35
Полная поддержка 35
Нет поддержки 21 — 34
С префиксом
С префиксом Требует вендорный префикс: webkit
Edge Полная поддержка 12Firefox Полная поддержка 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
Edge Mobile Полная поддержка ДаFirefox Android Полная поддержка 32Opera Android Полная поддержка 22
Полная поддержка 22
Нет поддержки 15 — 21
С префиксом
С префиксом Требует вендорный префикс: webkit
Safari iOS Нет поддержки НетSamsung Internet Android Полная поддержка Да
pose
Экспериментальная
Chrome Нет поддержки НетEdge Полная поддержка 15Firefox Полная поддержка Да
Замечания Отключено
Полная поддержка Да
Замечания Отключено
Замечания 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 Нет поддержки НетEdge Mobile Нет поддержки НетFirefox Android Нет поддержки НетOpera Android Нет поддержки НетSafari iOS Нет поддержки НетSamsung Internet Android Нет поддержки Нет
timestampChrome Полная поддержка 35
Полная поддержка 35
Нет поддержки 21 — 34
С префиксом
С префиксом Требует вендорный префикс: webkit
Edge Полная поддержка 12Firefox Полная поддержка 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
Edge Mobile Полная поддержка ДаFirefox Android Полная поддержка 32Opera Android Полная поддержка 22
Полная поддержка 22
Нет поддержки 15 — 21
С префиксом
С префиксом Требует вендорный префикс: webkit
Safari iOS Нет поддержки НетSamsung Internet Android Полная поддержка Да

Легенда

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

Смотрите также

Метки документа и участники

Внесли вклад в эту страницу: eof273
Обновлялась последний раз: eof273,