SDK di input

L'SDK Input fornisce un'interfaccia unificata che consente ai giocatori di visualizzare e modificare le associazioni del mouse e della tastiera per qualsiasi gioco che vogliono giocare su Google Play Giochi su PC. In qualsiasi momento durante il gameplay, un giocatore può richiamare il riquadro in overlay di Google Play Giochi su PC, come mostrato in questo screenshot:

Uno screenshot che mostra l'SDK di input visualizzato su un gioco di esempio

Questo SDK è obbligatorio per i giochi che utilizzano la tastiera su Google Play Giochi su PC perché i giochi mobile per Android sono progettati per l'input del giocatore tramite un touchscreen. Quando sviluppi per PC, i giochi devono supportare invece un mouse e una tastiera. Tu dovrebbe attivare questo SDK solo su Google Play Giochi su PC.

L'SDK Input è un elemento importante per mantenere i giocatori soddisfatti e coinvolti nel tuo gioco su piattaforme diverse. L'esperienza offerta da un mouse e una tastiera è diversa da quella dei touchscreen. Quando integri il tuo gioco con l'SDK di input potrai consentire ai player di rimappare i controlli predefiniti in Google Play Giochi su PC.

Per un'esperienza più immersiva, puoi sfruttare al meglio la funzionalità di rimappatura offerta da Google Play Giochi su PC impostando diversi controlli dello schema per i menu, il gioco principale e i minigiochi oppure aggiornando l'interfaccia utente in base alle mappe di controllo personalizzate dell'utente. Puoi disattivare o attivare la rimappatura per singoli di tasti o gruppi di tasti, oppure di decidere quali tasti rimappare per giocare.

Quando si utilizza la funzionalità di rimappatura, Android rileva quando l'utente sta digitando il testo in un campo di testo e disattivare la rimappatura, in modo che il gioco non debba disattivare manualmente la rimappatura per questi scenari.

Per ulteriori informazioni, consulta le best practice e le limitazioni dell'SDK Input per creare la migliore esperienza PC possibile per il tuo gioco.

Guida all'integrazione

Per informazioni sull'integrazione dell'SDK Input, consulta Iniziare a utilizzare l'SDK Input.

Esempi di giochi

Per esempi di come eseguire l'integrazione con l'SDK Input, consulta AGDK Tunnel per i giochi Kotlin o Java e Trivial Kart per i giochi Unity.

Scarica l'SDK di input

Prima di scaricare l'SDK di input, leggi i seguenti Termini di servizio di Google Input SDK e i requisiti per la raccolta dei dati.

Termini di servizio delle API di Google

I Termini di servizio delle API di Google regolano il tuo utilizzo dell'SDK Google Input.

Raccolta dei dati

L'SDK Google Input potrebbe raccogliere dati sul rendimento e sulla stabilità per migliorare il nostro prodotto, inclusi i seguenti dati:

  • Numero di chiamate ai metodi dell'SDK Input.
  • Numero di chiamate non riuscite ai metodi dell'SDK di input.
  • Dati aggregati di InputMap quali:
    • Numero di azioni e gruppi definiti.
    • Numero di azioni con un tasto, con più tasti e con il mouse definite.
    • Numero di azioni del mouse definite.
    • Numero di azioni e gruppi rimappabili.
    • Numero di chiavi riservate alla rimappatura.
    • Opzione di rimappatura di InputMap (attivata/disattivata).
  • Nome del pacchetto del gioco.
  • Il numero di versione del gioco.
  • Nome della versione del gioco.
  • Versione SDK di input.
  • Varianti di client come Google Play Giochi su PC o altri client.

L'SDK Input è disponibile nel repository Maven di Google. Consulta la Guida introduttiva per istruzioni su come creare il tuo progetto Java o Kotlin.

Scarica l'SDK di input per Unity dal Repository dei plug-in Unity di Play.