Web Gamepad API daje stronie dostęp do obiektów kontrolerów, które przeglądarka decyduje się udostępnić. Jest to szeroko przydatne, ale dostępność nie gwarantuje identycznych nazw urządzeń, kolejności przycisków, kolejności osi ani obsługi funkcji na różnych platformach.
Aktywacja przez użytkownika i wykrywanie
Przeglądarki mogą czekać na naciśnięcie przycisku na gamepadzie przed ujawnieniem podłączonego urządzenia. Zmniejsza to pasywne fingerprinting i oznacza, że kontroler może być fizycznie podłączony, podczas gdy navigator.getGamepads() początkowo zwraca puste wpisy. Keymap Labs zachęca użytkownika do naciśnięcia przycisku i nasłuchuje zdarzeń połączenia, kontynuując inspekcję bieżącej listy.
Kilka funkcji urządzeń przeglądarkowych wymaga bezpiecznego połączenia. Użyj https://keymap.io, dbaj o aktualność przeglądarki i unikaj skopiowanych lub osadzonych wersji strony podczas porównywania wyników.
Standardowe i ogólne mapowania
Obiekt gamepada może zadeklarować standardowe mapowanie, które daje wspólne pozycje dla przycisków twarzy, bumperów, triggerów, drążków i przycisków kierunkowych. Urządzenia ogólne mogą dostarczać puste mapowanie i ujawniać surowe tablice w kolejności specyficznej dla urządzenia.
Keymap Labs zawsze pokazuje surowe indeksy przycisków i wartości osi. Dzięki temu narzędzie pozostaje użyteczne nawet wtedy, gdy kontroler nie pasuje do znanego schematu. Nie zmienia nazwy ogólnego wejścia z nieuzasadnioną pewnością.
Analogi triggerów mogą pojawiać się jako przyciski z wartościami ułamkowymi, osobne osie lub przyciski cyfrowe w zależności od stosu technologicznego. Dodatkowe funkcje, takie jak touchpady, żyroskop, stan baterii, diody LED i haptics, nie są stale dostępne za pośrednictwem głównego mapowania i znajdują się poza standardowym zakresem diagnostycznym.
Zachowanie połączenia i indeksów
Gamepady otrzymują indeks w ramach sesji przeglądarki. Odłączenie i ponowne podłączenie może zmienić aktywny wpis. Live lab wybiera dostępne urządzenie i reaguje na zmiany połączenia; użyj selektora urządzeń, gdy wykrytych jest kilka kontrolerów.
Tryb bezprzewodowy może ujawnić inny identyfikator lub zestaw funkcji niż tryb USB. Tę różnicę należy odnotować podczas rozwiązywania problemów. Widoczny dla przeglądarki identyfikator może być również ogólny ze względów prywatności lub sterowników.
Macierz walidacji
Poważne porównanie kompatybilności wymaga fizycznych urządzeń w różnych systemach operacyjnych i silnikach przeglądarek. Keymap Labs korzysta ze standardowego API i defensywnie obsługuje brakujące przyciski lub osie, ale test online nie jest w stanie emulować każdego sterownika kontrolera.
Przydatny zapis porównawczy obejmuje:
- System operacyjny i wersja
- Silnik przeglądarki i wersja
- Model kontrolera i oprogramowanie układowe
- Połączenie przewodowe, Bluetooth lub dedykowany odbiornik
- Zgłoszony ID, mapowanie, osie i liczba przycisków
- Reprezentacja triggerów i kolejność gałek
- Zachowanie przy łączeniu, ponownym łączeniu i aktywności okna
Wyniki należy traktować jako przestarzałe obserwacje, a nie wieczną etykietę „działa wszędzie”. Aktualizacje przeglądarki i systemu operacyjnego mogą z czasem zmieniać mapowania.
Interpretacja pustego wyniku
Brak kontrolera na stronie może oznaczać brak urządzenia, brak aktywacji przez użytkownika, ograniczenie przeglądarki, konkurującą aplikację, warstwę sterownika lub problem z połączeniem. Poradnik dotyczący wykrywania gamepadata omawia te warstwy w kontrolowanej kolejności.
Jeśli urządzenie się pojawia, ale wizualna etykieta jest błędna, zmiany surowego indeksu nadal potwierdzają, że sygnał dotarł do przeglądarki. Jeśli osie nie wracają do środka, Test dryfu gałki dodaje próbkę czasową, ale wynik ten pozostaje powiązany z bieżącym mapowaniem i kalibracją.
Obietnica zgodności
Keymap Labs obsługuje nowoczesne przeglądarki udostępniające Gamepad API i zapewnia jawny stan awaryjny, gdy żaden nie jest dostępny. Nie wymaga konta, rozszerzenia przeglądarki ani sterownika. Nie gwarantuje zaawansowanych funkcji kontrolera ani uniwersalnych etykiet.
Ta obietnica jest celowo precyzyjna. Użytkownicy otrzymują działającą surową diagnozę tam, na co pozwala platforma, oraz użyteczne wyjaśnienie tam, gdzie to niemożliwe.
