Test pada (gamepada)

Test pada (gamepada) — czy wszystkie przyciski działają?

Gamepad API w nowoczesnych przeglądarkach odczytuje stan przycisków i drążków kontrolera. Dzięki temu sprawdzisz, czy pad nie ma „martwych” przycisków i czy drążki nie dryfują — bez instalowania sterowników ani programów diagnostycznych.

Jak przeprowadzić test?

1. Podłącz pada przez USB lub Bluetooth.
2. Kliknij „Rozpocznij test”.
3. Naciśnij dowolny przycisk na kontrolerze, aby przeglądarka go wykryła.
4. Sprawdź, czy każde naciśnięcie podświetla właściwy numer, a drążki poruszają wskaźnikami płynnie i wracają do środka.

Co warto sprawdzić?

• Martwe przyciski — brak reakcji na naciśnięcie.
• Dryf drążka — wskaźnik nie wraca do środka po puszczeniu (typowa usterka zużytych analogów).
• Zakres drążka — czy osiąga skrajne wartości −1 i 1 w każdym kierunku.
• Trigger (spusty) — czy działają płynnie, a nie tylko zero/jeden.

Dlaczego pada nie widać?

Nie wszystkie przeglądarki i systemy udostępniają Gamepad API dla danego kontrolera. Na Windows problemem bywa też tryb XInput/DirectInput — niektóre pady działają dopiero po przełączeniu w tryb XInput. Firefox i Chrome najlepiej wspierają tę funkcję.

Jak Gamepad API odczytuje stan pada

Narzędzie nie odczytuje sprzętu bezpośrednio. Korzysta z Gamepad API udostępnianego przez przeglądarkę. Po podłączeniu pada system tworzy obiekt kontrolera, a strona pobiera go przez navigator.getGamepads(). Każdy obiekt ma tablicę buttons oraz axes. Pierwszy aktywny pad staje się źródłem danych.

Przyciski są reprezentowane jako obiekty z wartością pressed oraz value. Dla typowego przycisku cyfrowego value wynosi 0 albo 1. Dla spustów i przycisków analogowych może zmieniać się płynnie od 0 do 1. Drążki trafiają do tablicy axes jako liczby od -1 do 1. Środek to 0, skrajne wychylenie to -1 lub 1. Narzędzie pokazuje te surowe wartości i podświetla elementy, które zmieniły stan.

Odczyt odbywa się w pętli, najczęściej z użyciem requestAnimationFrame. Przeglądarka nie wysyła zdarzenia przy każdym ruchu drążka, więc narzędzie musi regularnie odpytować stan. Dzięki temu widać drgania, dryf i płynność triggerów. Całość działa lokalnie: żadne odczyty nie są przesyłane na serwer.

Przykład: odczyt przycisku i drążka krok po kroku

1. Podłączasz pada i otwierasz test. Zakładasz, że w stanie spoczynku przycisk A ma value 0, a obie osie drążka mają 0. To punkt odniesienia.
2. Naciskasz przycisk A. API zwraca value 1 oraz pressed równe prawda. Różnica względem spoczynku wynosi 1 - 0 = 1, czyli 100% zakresu przycisku. Numer przycisku podświetla się.
3. Puszczasz przycisk A. Odczyt wraca z 1 do 0. Różnica względem spoczynku wynosi 0, więc przycisk nie jest zablokowany.
4. Przesuwasz lewy drążek w prawo do oporu. Oś X zmienia się z 0 na 1. Odległość od środka to 1 - 0 = 1, czyli pełny zakres. Oś Y nadal pokazuje 0.
5. Przesuwasz ten sam drążek w lewo do oporu. Oś X zmienia się z 0 na -1. Wartość bezwzględna wynosi 1, więc zakres również jest pełny.
6. Puszczasz drążek. Oś X wraca do 0. Jeśli zatrzyma się na wartości innej niż 0, test pokaże dryf. Przy pełnym wychyleniu w obu kierunkach i powrocie do 0 drążek przechodzi próbę zakresu.

Tabela referencyjna odczytów Gamepad API

Jak prowadzić test, żeby wychwycić usterki

• Najpierw sprawdź stan spoczynku. Nie dotykaj drążków i nie naciskaj triggerów. Jeśli osie lub spusty pokazują wartości inne niż 0, masz wstępny sygnał dryfu albo zużytego triggera.
• Testuj przyciski pojedynczo. Naciskaj każdy przycisk osobno i patrz na numer oraz wartość. Pozwala to odróżnić martwy przycisk od złego mapowania.
• Ruszaj drążkami po pełnym okręgu. Powoli przechodź przez wszystkie kierunki. Sprawdź, czy wskaźnik nie przeskakuje i czy osiąga skrajne wartości -1 oraz 1.
• Wciskaj triggery stopniowo. Zamiast tylko do oporu, zatrzymuj je w połowie ruchu. Płynna zmiana od 0 do 1 oznacza sprawny spust analogowy.
• Powtórz test w innej przeglądarce. Jeśli pad nie jest widoczny, sprawdź Chrome lub Firefox. Różnice wynikają z obsługi Gamepad API i sterowników systemowych.

Ograniczenia testu pada

• Brak testu wibracji. Narzędzie odczytuje przyciski i drążki, ale nie sprawdza silniczków haptycznych ani siły wibracji.
• Brak pomiaru opóźnienia. Test pokazuje stan z API, a nie czas reakcji pada ani opóźnienie Bluetooth. Do oceny lagu potrzeba innych narzędzi.
• Zależność od przeglądarki i systemu. Nie każdy kontroler jest udostępniany przez Gamepad API. Tryb XInput, DirectInput lub sterownik mogą zmienić widoczność i mapowanie.
• Brak kalibracji. Narzędzie tylko odczytuje wartości. Nie zapisuje korekt, nie zmienia martwej strefy i nie naprawia dryfu.
• Nie testuje dodatkowych czujników. Żyroskop, akcelerometr, touchpad i przyciski dodatkowe mogą nie być widoczne, jeśli przeglądarka nie wystawia ich w obiekcie pada.

Najczęstsze pytania