Compatibilità e ottimizzazione con PC per Google Play Giochi su PC

Google Play Giochi su PC richiede la creazione di PC modifiche a compatibilità e ottimizzazione del tuo gioco. Queste modifiche assicurano può essere eseguito su PC e l'esperienza utente è ottimizzata per la piattaforma.

Inoltre, Google Play Giochi su PC offre grafica, input del dispositivo e di gioco cross-device. Per ulteriori informazioni, consulta Guida introduttiva.

Quando apporti modifiche alla compatibilità e all'ottimizzazione del PC (diverse da x86-64) assistenza), puoi configurare il gioco rileva Google Play Giochi su PC e poi disattiva o attiva specifiche della piattaforma. In questo modo puoi usare lo stesso APK o app bundle per le release per dispositivi mobili e PC di Android.

Ecco un riepilogo dei requisiti e dei consigli in questa pagina:

di Gemini Advanced.

Includere l'architettura ABI x86-64

Obbligatorio per la procedura di rilascio

Tutte le librerie incluse nel gioco richiedono versioni compatibili con ABI x86-64 per garantire le migliori prestazioni e stabilità sulla piattaforma.

Se non è tecnicamente impossibile per il gioco inviare un eseguibile x86 a 64 bit, Per un'eccezione, devi contattare il team di revisione. Impossibile raggiungere il gioco certificazione completa con un eccezione, ma può essere inserito nel catalogo come "riproducibile" per giocare.

Compilazione della raccolta

Per garantire la massima compatibilità con i processori x86-64, non usare atom di un set di istruzioni durante la compilazione delle librerie. Ad esempio, se utilizzi gcc evita di usare -march=atom e usa -march=x86-64.

Architettura di destinazione in Unity

Alcune versioni di Unity 2019 e 2020 non supportano l'architettura x86-64 su Android. Assicurati di utilizzare Unity 2019.4.31f1, 2020.3.19f1 o versioni successive.

Se il tuo gioco utilizza una versione compatibile del motore grafico Unity, procedi nel seguente modo: di seguito per attivare i target Android x86-64:

  1. Vai a Impostazioni del player > Altre impostazioni > Configurazione > Creazione di script Backend e seleziona IL2CPP dal menu a discesa per attivare Backend di scripting IL2CPP.

  2. Attiva i target Android x86-64 per la tua versione di Unity:

    • Unity 2018 e precedenti: vai a Impostazioni del player > Altre impostazioni > Architettura di destinazione e seleziona la casella di controllo x86. Dal momento che Unity 2018 supporta solo i target x86, non sarai in grado di creare x86-64. Questa build richiederà un'eccezione da parte del team di revisione. Rivolgiti al tuo contatto Google per richiedere un'eccezione x86.

    • Release di Unity 2019 a lungo termine (LTS) e successive: vai a Player Impostazioni > Altre impostazioni > Architetture di destinazione e attiva x86-64 (ChromeOS).

Rileva Google Play Giochi su PC

Puoi rilevare la piattaforma Google Play Giochi su PC in fase di runtime, consentendoti per attivare o disattivare nel tuo gioco funzionalità specifiche della piattaforma.

Verifica la presenza della funzionalità di sistema com.google.android.play.feature.HPE_EXPERIENCE per per stabilire se il tuo gioco è in esecuzione sulla piattaforma Google Play Giochi su PC:

Kotlin

    var isPC = packageManager.hasSystemFeature("com.google.android.play.feature.HPE_EXPERIENCE")

Java

    PackageManager pm = getPackageManager();
    boolean isPC = pm.hasSystemFeature("com.google.android.play.feature.HPE_EXPERIENCE")

C#

var unityPlayerClass = new AndroidJavaClass("com.unity3d.player.UnityPlayer");
var currentActivity = unityPlayerClass.GetStatic<AndroidJavaObject>("currentActivity");
var packageManager = currentActivity.Call<AndroidJavaObject>("getPackageManager");
var isPC = packageManager.Call<bool>("hasSystemFeature", "com.google.android.play.feature.HPE_EXPERIENCE");

Gestire gli eventi del ciclo di vita di Android

È importante gestire onPause (C++) nell'ambiente Google Play Giochi su PC. Il tuo gioco è visibile quando un player attiva l'overlay dell'emulatore, quindi non riesce a ascoltare il onPause evento può comportare un'esperienza utente scadente.

Aggiorna l'interfaccia utente

Alcuni gesti e alcuni elementi dell'interfaccia utente non sono adatti su PC e devono essere aggiornati.

Obbligatorio:

  • Sostituisci le azioni dell'interfaccia utente che richiedono due o più dita (gesti multi-touch). Per Ad esempio, devi sostituire Pizzica per eseguire lo zoom e altri gesti multi-touch con il corrispondente input del mouse e della tastiera. Per i dettagli sul dispositivo modifiche all'input, consulta Supporto dell'input.

Consigliato:

  • Tutto il testo visibile all'utente deve essere "fai clic" anziché "tocca".
  • Gli elenchi scorrevoli devono avere barre di scorrimento.
  • Le aree che gli utenti possono eseguire la panoramica devono avere barre di scorrimento o in qualche altro modo attraversare velocemente grandi distanze.
  • Non mostrare sullo schermo una tastiera cliccabile per l'inserimento di testo.
  • Tutte le voci di testo devono rientrare nei limiti del campo di testo.
  • I clic sugli elementi visibili devono:
    • Accettare un clic in qualsiasi punto all'interno dei limiti visibili dell'elemento.
    • Non accettare un clic nell'area esterna all'elemento visibile.
  • Le finestre di dialogo devono avere un pulsante di chiusura visibile. Non rilevare un clic al di fuori di limiti della finestra di dialogo.

Disattiva la maggior parte delle finestre di dialogo delle autorizzazioni

Google Play Giochi su PC, ad eccezione dell'autorizzazione di accesso al microfono non mostra le finestre di dialogo delle autorizzazioni, quindi non dovresti tentare di visualizzarle o richiedere le autorizzazioni in fase di runtime. Se finestre di dialogo di autorizzazione visualizzate in precedenza, dovresti aggiornare il gioco in modo che non lo visualizzi più sui PC.

Funzionalità e autorizzazioni di Android non supportate

Obbligatorio per la procedura di rilascio

Alcune funzionalità hardware comuni dei cellulari e dei tablet non sono disponibili sui . Sono incluse funzionalità hardware come la fotocamera o la posizione di un giocatore. I giochi che richiedono funzionalità mancanti non possono essere scaricati e installati su un sul PC del lettore. Le richieste per eventuali funzionalità mancanti su un PC non vanno a buon fine.

Puoi visualizzare un elenco completo delle funzionalità disponibili digitando:

adb shell pm list features

Per rendere il gioco compatibile con i PC, sono necessarie le seguenti modifiche:

  • Contrassegna le funzionalità come facoltative nel file manifest dell'app aggiungendo android:required="false" alla dichiarazione <uses-feature>. Solo questo si applica alle funzionalità già dichiarate nel file manifest dell'app.

  • Non tentare di utilizzare le funzionalità mancanti in fase di runtime. Se utilizzi stesso APK sia sui canali mobile che su quelli PC, rileva l'ambiente PC all'indirizzo tempo di esecuzione ed evitare il deployment percorsi di codice.

  • Non richiedere autorizzazioni Android non supportate in fase di runtime. Se utilizzi lo stesso APK sui canali per PC e dispositivi mobili, rileva l'ambiente PC all'indirizzo tempo di esecuzione ed evitare il deployment percorsi di codice. Non è necessario aggiornare il file manifest.

Per ulteriori informazioni sulla compatibilità dei file manifest delle app, consulta Guida alla compatibilità del file manifest delle app per Chromebook.

Requisiti per i test funzionali

Rimuovi queste funzionalità hardware prima di inviare la prima testa build su Google Play Console

  • android.hardware.wifi
  • android.hardware.bluetooth
  • android.hardware.camera
  • android.hardware.location

Alcune di queste funzionalità potrebbero essere indicate come supportate durante l'esecuzione pm list features per motivi di compatibilità, ma non completamente implementati. Per ulteriori informazioni su come rimuovere la funzionalità android.hardware.wifi, consulta Monitorare lo stato della connettività e la misurazione della connessione. Per un un elenco completo delle funzionalità non supportate, consulta la guida alla compatibilità del file manifest dell'app per Chromebook.

Requisiti dei test di qualità

Queste funzionalità hardware di uso comune non sono compatibili con i PC, quindi devi rimuovili prima l'invio finale a Google Play Console

  • android.hardware.audio.pro
  • android.hardware.bluetooth
  • android.hardware.camera
  • android.hardware.consumerir
  • android.hardware.location
  • android.hardware.nfc
  • android.hardware.sensor.light
  • android.hardware.sensor.accelerometer
  • android.hardware.sensor.barometer
  • android.hardware.sensor.compass
  • android.hardware.sensor.gyroscope
  • android.hardware.sensor.proximity
  • android.hardware.telephony
  • android.hardware.touchscreen
  • android.hardware.usb.accessory
  • android.hardware.usb.host
  • android.hardware.wifi
  • android.software.midi

Autorizzazioni non supportate

Le seguenti autorizzazioni di uso comune non sono supportate sui PC, quindi il tuo gioco devi disattivarle per Google Play Giochi su PC:

  • android.permission.ACCESS_COARSE_LOCATION
  • android.permission.ACCESS_FINE_LOCATION
  • android.permission.ACCESS_WIFI_STATE
  • android.permission.BLUETOOTH
  • android.permission.CAMERA
  • android.permission.FOREGROUND_SERVICE
  • android.permission.GET_ACCOUNTS
  • android.permission.INSTALL_PACKAGES
  • android.permission.READ_CONTACTS
  • android.permission.READ_EXTERNAL_STORAGE
  • android.permission.READ_PHONE_STATE
  • android.permission.RECEIVE_BOOT_COMPLETED
  • android.permission.REQUEST_INSTALL_PACKAGES
  • android.permission.SYSTEM_ALERT_WINDOW
  • android.permission.USE_CREDENTIALS
  • android.permission.WRITE_EXTERNAL_STORAGE
  • android.permission.WRITE_SETTINGS
  • com.google.android.gms.permission.ACTIVITY_RECOGNITION

Siti web esterni e WebView

Un intent del browser viene caricato nel browser web nativo del PC anziché in uno nell'ambiente Google Play Giochi su PC. È un'esperienza ideale per i giocatori nella maggior parte delle situazioni.

Per facilitare il trasferimento, Google Play Giochi su PC supporta WebView. Dal giorno si apre nell'ambiente Google Play Giochi su PC, non avrà il tipico un browser per desktop. Se in precedenza utilizzavi WebView per condividere i tuoi Termini del Servizio, le Norme sulla privacy o altri contenuti simili, richiamare un intent del browser.

Disattiva le API di Google Play Service non supportate

Obbligatorio per la procedura di rilascio

Google Play Giochi su PC offre una variante di Google Play Services che contiene solo un sottoinsieme delle API Google Play Services. Conferma che la tua applicazione non dipende fortemente da moduli omessi o non supportato su PC. Consideriamo che alcuni moduli potrebbero essere disponibili, ma che non è sempre supportata. Ad esempio, Firebase Cloud I messaggi non funzioneranno quando Google Play Giochi su PC è chiuso.

Moduli supportati

Questi moduli sono attualmente disponibili e supportati da Google Play Giochi su PC, con piani per il supporto di funzionalità aggiuntive:

Supporto limitato

I seguenti moduli sono parzialmente funzionanti. Faremo del nostro meglio per supportare su Google Play Giochi su PC, ma non possiamo garantirne la funzionalità.

Non supportato

Questi moduli non sono supportati in Google Play Giochi su PC, ma non problemi in Google Play Giochi su PC in caso di errore:

Non funzionante

Obbligatorio per la procedura di rilascio

Non è consentito utilizzare questi moduli sui PC perché possono causare in Google Play Giochi su PC.

Abilita archiviazione con ambito

Obbligatorio per la procedura di rilascio

Questa sezione è valida se il gioco legge o scrive sulla memoria esterna. Ambito spazio di archiviazione è necessario come metodo alternativo per leggere e scrivere archiviazione. In questo modo non sarà più necessario chiedere al player autorizzazioni:

  • android.permission.READ_EXTERNAL_STORAGE
  • android.permission.WRITE_EXTERNAL_STORAGE

Per saperne di più sull'archiviazione con ambito, vedi:

Analytics

I prodotti Google Analytics precedenti non funzionano in Google Play Giochi su PC. Se per i tuoi giochi, devi eseguirne la migrazione Google Analytics 4

Questa operazione dovrebbe interessare il gioco solo se stai utilizzando Google Analytics 360 Se stai utilizzando l'SDK Firebase per monitorare gli eventi di analisi nel gioco e puoi visualizzarlo come proprietà nel Console Google Analytics, allora non c'è di intraprendere ulteriori azioni.