Plugin per Unity: installa e configura i componenti del plug-in

Questa sezione descrive come aggiungere il plugin a un progetto Unity. Dopo l'installazione del plug-in, la funzionalità del plug-in è disponibile quando il progetto è aperto nell'editor Unity.

Prima di iniziare

Ecco cosa ti serve per utilizzare il GameLift plug-in Amazon per Unity:

• Unity per Windows 2022 LTS o Unity per macOS

• Download GameLift del plug-in Amazon per Unity. [Sito di download] Il download include due pacchetti:

  • GameLift Plugin Amazon autonomo per Unity

  • SDK per server Amazon GameLift C# per Unity

• Microsoft Visual Studio 2019 o versione successiva.

• Un progetto di gioco multiplayer con codice di gioco C#.

• Il registro con ambito di terze parti. UnityNuGet Questo strumento gestisce DLL di terze parti. Per ulteriori informazioni, consulta il UnityNuGetrepository Github.

Aggiungi il plugin al tuo progetto di gioco

Completa le seguenti attività, utilizzando l'editor di Unity e i file di progetto del gioco.

Passo 1: Aggiungilo UnityNuGet al tuo progetto di gioco

Se non hai UnityNuGet configurato il tuo progetto di gioco, usa i seguenti passaggi per installare lo strumento utilizzando il gestore di pacchetti Unity. In alternativa, puoi utilizzare la NuGet CLI per scaricare manualmente le DLL. Per ulteriori informazioni, consulta l'SDK per server Amazon GameLift C# for Unity. README

1. Con il progetto aperto nell'editor Unity, vai al menu principale e seleziona Modifica, Impostazioni del progetto. Dalle opzioni, scegli la sezione Package Manager e apri il gruppo Scoped Registries.

2. Scegli il pulsante + e inserisci i seguenti valori per il UnityNuGet registro con ambito:

   Name: Unity NuGet
   URL: https://unitynuget-registry.azurewebsites.net
   Scope(s): org.nuget

Per gli utenti della versione Unity 2021:

Dopo la configurazione UnityNuGet, verifica la presenza di Assembly Version Validation errori nella console Unity. Questi errori si verificano se i reindirizzamenti di associazione per gli assembly con nomi forti nei NuGet pacchetti non si risolvono correttamente nei percorsi all'interno del progetto Unity. Per risolvere questo problema, configura la convalida della versione dell'assembly di Unity:

1. Nell'editor Unity, vai al menu principale e seleziona Modifica, Impostazioni progetto e apri la sezione Player.

2. Deselezionate l'opzione di convalida della versione dell'assieme.

Passaggio 2: aggiungere il plug-in e i pacchetti SDK del server C#

1. Decomprimi il GameLift plug-in Amazon per il download di Unity, che contiene entrambi i pacchetti.

2. Con il progetto aperto in Unity Editor, vai al menu principale e seleziona Window, Package Manager.

3. Scegli il pulsante + per aggiungere un nuovo pacchetto. Scegli l'opzione Aggiungi pacchetto da tarball.

4. In Seleziona pacchetti su disco, individua il plug-in Amazon GameLift C# Server SDK per i file di download di Unity e scegli il com.amazonaws.gameliftserver.sdk-<version>.tgz file. Scegli Apri per installare il plugin.

5. In Seleziona pacchetti su disco, individua il plug-in GameLift standalone Amazon per i file di download di Unity e scegli il filecom.amazonaws.gamelift-<version>.tgz. Scegli Apri per installare il plugin.

6. Verifica che il plugin standalone sia aggiunto al tuo progetto. Torna alla finestra dell'editor di Unity. Controlla il menu principale per il nuovo pulsante del GameLift menu Amazon.

Passaggio 3: Importa il gioco di esempio (opzionale)

Il plugin per Unity include una serie di risorse di gioco di esempio, tra cui scene, che puoi aggiungere al tuo progetto di gioco. L'importazione del gioco di esempio ti offre un percorso rapido per testare, creare e distribuire un semplice gioco multiplayer con Amazon. GameLift Il gioco di esempio è già completamente integrato con GameLift gli SDK di Amazon, quindi puoi saltare le attività di integrazione e completare le restanti attività del flusso di lavoro.

Quando usi il gioco di esempio, puoi configurare e unirti a una flotta Amazon GameLift Anywhere ospitata localmente in pochi minuti. Puoi distribuire il gioco su Amazon GameLift e partecipare a una partita live ospitata sul cloud in meno di un'ora.

Per importare il gioco di esempio:

1. Con il progetto di gioco aperto in Unity Editor, vai al GameLift menu Amazon e seleziona Sample Game, Import Sample Game.

2. Dopo aver importato i file, vai nuovamente al GameLift menu Amazon e seleziona Sample Game, Initialize Settings. Questo passaggio configura il tuo progetto per la creazione del client e del server di gioco.

Una volta completata l'installazione, vedrai due nuove scene aggiunte al progetto del gioco. Vedrai anche alcune risorse aggiuntive del progetto, inclusa una GameLiftClientSettingsrisorsa.

Per maggiori dettagli sull'interfaccia utente e sul gameplay dell'esempio, consulta il file readme del gioco di esempio.