Beachte bei der Implementierung der Gamepad-Unterstützung die folgenden wichtigen Anforderungen, um Spielern ein reibungsloses, unterbrechungsfreies Gameplay zu ermöglichen.
Nutzer im Google Play Store darüber informieren, dass dein Spiel Controller unterstützt
Wenn du die Gamepad-Funktion in deinem Android-Manifest deklarierst, werden bei Google Play ein Symbol und ein Tag für die Gamepad-Unterstützung angezeigt. Mit dieser Erklärung können mehr Nutzer dein Spiel entdecken und spielen. Eine detaillierte Konfigurationsanleitung und Manifestbeispiele findest du unter Sichtbarkeit im Google Play Store und Gamepad-Hardwarefunktionen.
Spielern den nahtlosen Wechsel zwischen Eingabegeräten ermöglichen
Wenn Spieler zwischen Eingabegeräten wechseln, sollte der Übergang nahtlos sein. Vermeide es, dass Spieler ihre Eingabemethode manuell in einem Einstellungsmenü umschalten oder das Spiel neu starten müssen.
Automatischer Wechsel und Unterstützung von Hot-Plugging
Alle unterstützten Eingabegeräte sollten gleichzeitig aktiv sein, damit Spieler im laufenden Betrieb zwischen ihnen wechseln können. Achte auf Änderungen der Eingabegeräte zur Laufzeit, damit Gamepads sofort nach dem Verbinden funktionieren, ohne dass die App neu gestartet werden muss. Außerdem sollte nahtlos zu anderen verfügbaren Eingabemethoden gewechselt werden, wenn ein aktiver Controller während des Spiels getrennt wird. Informationen zum Erkennen von Controller-Verbindungen und -Trennungen findest du unter Prüfen, ob ein Gamecontroller verbunden ist (Kotlin oder Java) oder Callback für Controller-Status registrieren oder entfernen (C++ Game Controller-Bibliothek). Deklarieren Sie unter Android 16 (API-Level 36) und niedriger auch android:configChanges="keyboard|keyboardHidden|navigation" in Ihrem Manifest, damit Ihre Aktivität beim Verbinden oder Trennen eines Controllers nicht neu gestartet wird (siehe Konfigurationsänderungen verarbeiten).
| Nicht empfohlen | Empfohlen |
|---|---|
|
|
Die Symbolik und die Textanleitungen für die Schaltflächen wurden an das aktive Gerät angepasst.
Schaltflächensymbole und Textanleitungen auf dem Bildschirm werden dynamisch basierend auf dem aktiven Eingabegerät umgeschaltet. Wenn Ihr Spiel beispielsweise eine Gamepad-Eingabe erkennt, sollten Sie eine Anleitung zur Touchbedienung wie „Zum Springen tippen“ in „Zum Springen B drücken“ (oder die entsprechende Taste auf der Plattform) ändern.

Virtuelle Touchbedienung ausblenden, wenn ein Gamepad aktiv ist
Um ein unübersichtliches Display und Verwirrung bei Spielern zu vermeiden, sollten alle virtuellen Touch-UI-Elemente wie virtuelle Joysticks und On-Screen-Tasten ausgeblendet werden, wenn ein Gamepad aktiv ist. Die Touch-Benutzeroberfläche wird sofort wiederhergestellt, wenn der Spieler den Bildschirm berührt.
Vollständige Gamepad-Unterstützung für die gesamte In-Game-Logik
Vermeiden Sie es, die Berührung als Fallback-Mechanismus zu verwenden. Wenn Spieler Menüs per Touchbedienung verlassen oder bestimmte Teile des Spiels per Touchbedienung spielen müssen, kann das die Immersion beeinträchtigen. Implementiere alle Interaktionen im Spiel so, dass Spieler sie vollständig mit einem Gamepad ausführen können.
Alle HUD-Elemente und Dialoge Controller-Eingaben zuordnen
Ermögliche es Spielern, alle Heads-up-Display-Elemente (HUD), Menüs und Dialoge auf dem Bildschirm über den Controller zu öffnen, mit ihnen zu interagieren und sie zu schließen. Verwende dazu dedizierte Tastenkombinationen, Bumper oder die Steuerkreuz-Navigation, damit sie den Bildschirm nicht berühren müssen.
| Nicht empfohlen | Empfohlen |
|---|---|
|
|
Getrennte Eingabekontexte für Gameplay und Benutzeroberfläche
Wenn ein Menü oder Dialogfeld über dem Gameplay geöffnet wird, wechsle den Kontext oder blockiere die Steuerelemente im Hintergrund, damit das Gamepad nur mit der aktiven UI interagiert. Diese Trennung verhindert, dass die Richtungsnavigation oder das Drücken von Tasten in einem Menü versehentlich Bewegungen oder Aktionen der Spielfigur im Hintergrund auslösen.
| Nicht empfohlen | Empfohlen |
|---|---|
|
|
Weisen Sie den ersten Fokus sofort zu, wenn ein Bildschirm geöffnet wird.
Im Gegensatz zur Eingabe per Berührung, bei der Spieler direkt auf Schaltflächen tippen, wird bei der Gamepad-Navigation vom aktuell fokussierten Element zu einem benachbarten Element gewechselt. Wenn ein neues Menü oder ein neuer Dialog ohne ein anfängliches Fokusziel geöffnet wird, reagieren die Eingaben über das Steuerkreuz und die Bestätigungstaste möglicherweise nicht oder bleiben auf Hintergrundelementen hängen. Weisen Sie einer Standardschaltfläche den anfänglichen Fokus zu, sobald ein Bildschirm geöffnet wird.
| Nicht empfohlen | Empfohlen |
|---|---|
|
|