Тест геймпада

Тест геймпада считывает сигналы, которые контроллер передаёт браузеру через W3C Gamepad API, и показывает их в реальном времени: каждое нажатие кнопки, положение аналоговых стиков, глубину нажатия триггеров, направление крестовины и работу вибромоторов. Это самый быстрый способ убедиться, что контроллер исправен перед игрой, диагностировать залипающую кнопку, заметить дрифт стика на поношенном геймпаде или проверить, что работают оба вибромотора. Страница подсвечивает каждое входное действие на экранной раскладке в стиле Xbox, выводит сырые значения осей и триггеров и ведёт короткий журнал событий. Поскольку Gamepad API открывает контроллер только после того, как вы нажмёте на нём любую кнопку, страница сначала попросит вас это сделать — это правило безопасности браузера, а не поломка геймпада. Всё выполняется локально в браузере; никакие вводимые данные не покидают ваше устройство.

Браузер предоставляет доступ к геймпадам через W3C Gamepad API. Контроллер представлен объектом Gamepad, который возвращается функцией navigator.getGamepads() до четырёх слотов. У каждого геймпада есть строка id (производитель и продукт), поле mapping ('standard' для устройств с раскладкой Xbox, иначе пусто), массив buttons и массив axes. При стандартной раскладке buttons содержит 17 элементов: четыре лицевые кнопки (A/B/X/Y), два бампера (LB/RB), два аналоговых триггера (LT/RT), Select/Start, два нажатия стиков (L3/R3), четыре направления крестовины и кнопка Home/Guide. У каждой кнопки есть .pressed (логическое значение) и .value (от 0 до 1 — у триггеров аналоговая шкала, у цифровых кнопок 0 или 1). Массив axes хранит четыре значения в диапазоне от -1 до 1: X/Y левого стика, затем X/Y правого стика. API работает по модели опроса, а не событий, поэтому страница запускает цикл requestAnimationFrame и каждый кадр читает свежий снимок состояния. Чтобы не делать лишних перерисовок в простое, состояние обновляется только при изменении gamepad.timestamp — эта метка продвигается с каждым новым отчётом ввода. Подключение и отключение приходят как оконные события gamepadconnected и gamepaddisconnected. В целях безопасности объект gamepad остаётся null, пока пользователь не нажмёт кнопку на самом геймпаде, поэтому страница не может молча прочитать только что подключённый контроллер. Вибрация опциональна: если существует gamepad.vibrationActuator, вызов playEffect('dual-rumble', { duration, weakMagnitude, strongMagnitude }) приводит в движение оба мотора; Safari и некоторые сборки Chromium её не реализуют, поэтому страница проверяет поддержку и при её отсутствии отключает кнопки.

• navigator.getGamepads() возвращает до четырёх слотов; слот становится не-null только после нажатия кнопки на геймпаде.
• Стандартная раскладка: buttons[0-3] лицевые, [4-5] бамперы, [6-7] аналоговые триггеры, [8-9] Select/Start, [10-11] L3/R3, [12-15] крестовина, [16] Home.
• axes[0-1] — левый стик (X, Y), axes[2-3] — правый стик, диапазон каждого значения от -1 до 1.
• Модель опроса: цикл requestAnimationFrame читает снимки; gamepad.timestamp используется как затвор, чтобы в покое кадры ничего не делали.
• Вибрация через gamepad.vibrationActuator.playEffect('dual-rumble', ...) — требует проверки поддержки, доступна не во всех браузерах.
• События gamepadconnected / gamepaddisconnected сигнализируют о подключении и отключении; поле .index у геймпада задаёт его слот.