2. Configurazione di Photon Unity Networking2. Setting up Photon Unity Networking

In questa esercitazione si preparerà l'ambiente per la creazione di un'esperienza condivisa tramite Photon Unity Networking (PUN).In this tutorial, you will prepare for creating a shared experience using Photon Unity Networking (PUN). Si apprenderà come creare un'app PUN, importare asset di PUN nel progetto Unity e connettere il progetto Unity all'app PUN.You will learn how to create a PUN app, import PUN assets into your Unity project, and connect your Unity project to the PUN app.

ObiettiviObjectives

  • Imparare a creare un'app PUNLearn how to create a PUN app
  • Imparare a trovare e importare gli asset di PUNLearn how to find and import the PUN assets
  • Imparare a connettere il progetto Unity all'app PUNLearn how to connect your Unity project to the PUN app

Creazione e preparazione del progetto UnityCreating and preparing the Unity project

In questa sezione creerai un nuovo progetto Unity per prepararti allo sviluppo con MRTK.In this section, you will create a new Unity project and get it ready for MRTK development.

Seguire prima l'esercitazione Inizializzazione del progetto e distribuzione della prima applicazione, escluse le istruzioni della sezione Compilare l'applicazione nel dispositivo. L'esercitazione include i passaggi seguenti:First, follow the Initializing your project and deploying your first application, excluding the Build your application to your device instructions, which includes the following steps:

  1. Creazione del progetto Unity e assegnazione di un nome appropriato, ad esempio MRTK TutorialsCreating the Unity project and give it a suitable name, for example, MRTK Tutorials
  2. Passaggio a un'altra piattaforma di compilazioneSwitching the build platform
  3. Importazione delle risorse essenziali TextMeshProImporting the TextMeshPro Essential Resources
  4. Importazione di Mixed Reality ToolkitImporting the Mixed Reality Toolkit
  5. Configurazione del progetto UnityConfiguring the Unity project
  6. Creazione e configurazione della scena e assegnazione di un nome appropriato, ad esempio MultiUserCapabilitiesCreating and configuring the scene and give the scene a suitable name, for example, MultiUserCapabilities

Seguire quindi le istruzioni riportate in Modifica delle opzioni di visualizzazione di consapevolezza spaziale per:Then follow the Changing the Spatial Awareness Display Option instructions to:

  1. Impostare MRTK configuration profile (Profilo di configurazione di MRTK) su DefaultHoloLens2ConfigurationProfileChange the MRTK configuration profile for to the DefaultHoloLens2ConfigurationProfile
  2. Impostare le opzioni di visualizzazione mesh di consapevolezza spaziale su Occlusion (Occlusione).Change the spatial awareness mesh display options to Occlusion.

Abilitazione delle funzionalità aggiuntiveEnabling additional capabilities

Dal menu Unity scegli Edit > Project Settings... (Modifica > Impostazioni del progetto) per aprire la finestra Project Settings (Impostazioni del progetto) e quindi individua la sezione Player > Publishing Settings (Lettore > Impostazioni di pubblicazione):In the Unity menu, select Edit > Project Settings... to open the Player Settings window, then locate the Player > Publishing Settings section:

Impostazioni del lettore di Unity

In Publishing Settings (Impostazioni di pubblicazione) scorrere verso il basso fino alla sezione Capabilities (Funzionalità) e verificare che siano abilitate le funzionalità InternetClient, Microphone, SpatialPerception, e GazeInput, abilitate al passaggio Configurazione del progetto Unity precedente.In the Publishing Settings, scroll down to the Capabilities section and double-check that the InternetClient, Microphone, SpatialPerception, and GazeInput capabilities, which you enabled during the Configuring the Unity project step above, are enabled.

Abilitare quindi le funzionalità aggiuntive seguenti:Then enable the following additional capabilities:

  • Funzionalità InternetClientServerInternetClientServer capability
  • Funzionalità PrivateNetworkClientServerPrivateNetworkClientServer capability

Impostazione delle funzionalità di Unity

Installazione di pacchetti di Unity incorporatiInstalling inbuilt Unity packages

Scegliere Window > Package Manager (Finestra > Gestione pacchetti) dal menu Unity per aprire la finestra Package Manager(Gestione pacchetti) e quindi selezionare AR Foundation e fare clic sul pulsante Install (Installa) per installare il pacchetto:In the Unity menu, select Window > Package Manager to open the Package Manager window, then select AR Foundation and click the Install button to install the package:

Package Manager di Unity con AR Foundation selezionato

Nota

Si sta installando il pacchetto AR Foundation richiesto da Azure Spatial Anchors SDK, che verrà importato nella sezione successiva.You are installing the AR Foundation package because it is required by the Azure Spatial Anchors SDK you will import in the next section.

Importazione degli asset dell'esercitazioneImporting the tutorial assets

Scarica e importa i pacchetti personalizzati di Unity seguenti, nell'ordine in cui sono elencati:Download and import the following Unity custom packages in the order they are listed:

Dopo l'importazione degli asset dell'esercitazione, la finestra Project (Progetto) avrà un aspetto simile al seguente:After you have imported the tutorial assets your Project window should look similar to this:

Finestre Hierarchy, Scene e Project di Unity dopo l'importazione degli asset dell'esercitazione

Suggerimento

Per rivedere la procedura di importazione di un pacchetto personalizzato di Unity, è possibile fare riferimento alle istruzioni riportate in Importazione di Mixed Reality Toolkit.For a reminder on how to import a Unity custom package, you can refer to the Importing the Mixed Reality Toolkit instructions.

Nota

Dopo aver importato il pacchetto di asset dell'esercitazione MultiUserCapabilities, nella finestra della console verranno visualizzati alcuni errori CS0246 che indicano che manca il tipo o lo spazio dei nomi.After importing the MultiUserCapabilities tutorial assets package, you will see several CS0246 errors in the Console window stating that the type or namespace is missing. Si tratta di un comportamento previsto, che verrà risolto nella prossima sezione quando verranno importati gli asset di PUN.This is expected and will be resolved in the next section when you import the PUN assets.

Importazione degli asset di PUNImporting the PUN assets

Nel menu di Unity selezionare Window > Asset Store (Finestra > Store degli asset) per aprire la finestra Asset Store (Store degli asset), cercare e selezionare PUN 2 - FREE (PUN 2 - GRATUITO) in Exit Games (Giochi in uscita) e fare clic sul pulsante Download (Scarica) per scaricare il pacchetto di asset nell'account Unity.In the Unity menu, select Window > Asset Store to open the Asset Store window, search for and select PUN 2 - FREE from Exit Games, click the Download button to download the asset package to your Unity account.

Al termine del download, fai clic sul pulsante Import (Importa) per aprire la finestra Import Unity Package (Importa pacchetto Unity):When the download is complete, click the Import button to open the Import Unity Package window:

Unity Asset Store con PUN 2 - Free

Nella finestra Import Unity Package (Importa il pacchetto Unity), fai clic sul pulsante All (Tutti) per assicurarti che vengano selezionati tutti gli asset e quindi fai clic sul pulsante Import (Importa) per importare gli asset:In the Import Unity Package window, click the All button to ensure all the assets are selected, then click the Import button to import the assets:

Unity con la finestra per l'importazione di PUN 2

Dopo che Unity ha completato il processo di importazione, verrà visualizzata la finestra PUN Wizard (Creazione guidata PUN) con il menu PUN Setup (Configurazione PUN) caricato. Per il momento puoi ignorare o chiudere questa finestra:Once Unity has completed the import process, the Pun Wizard window will appear with the PUN Setup menu loaded, you can ignore or close this window for now:

Unity con la finestra per la configurazione di PUN 2

Creazione dell'applicazione PUNCreating the PUN application

In questa sezione si creerà un account Photon, se non esiste già, e una nuova app PUN.In this section, you will create a Photon account, if you don't already have one, and create a new PUN app.

Passa al dashboard di Photon ed esegui l'accesso se hai già un account che vuoi usare. In caso contrario, fai clic sul collegamento Create One (Creane uno) e segui le istruzioni per la registrazione di un nuovo account:Navigate to the Photon dashboard and sign in if you already have an account you want to use, otherwise, click the Create One link and follow the instructions to register a new account:

Pagina di accesso di Photon

Una volta eseguito l'accesso, fai clic sul pulsante Create a New App (Crea una nuova app):Once signed in, click the Create a New App button:

Pagina di benvenuto del dashboard Photon

Nella pagina Create a New Application (Crea una nuova applicazione) immetti i valori seguenti:On the Create a New Application page, enter the following values:

  • In Photon Type (Tipo Photon) selezionare PUNFor Photon Type, select PUN
  • In Name (Nome) immetti un nome appropriato, ad esempio MRTK TutorialsFor Name, enter a suitable name, for example, MRTK Tutorials
  • In Description (Descrizione) immetti facoltativamente una descrizione appropriataFor Description, optionally enter a suitable description
  • In Url lascia il campo vuotoFor Url, leave the field empty

Fare quindi clic sul pulsante Create (Crea) per creare la nuova app:Then click the Create button to create the new app:

Pagina per la creazione dell'applicazione Photon

Al termine del processo di creazione, nel dashboard verrà visualizzata la nuova app PUN:Once Photon has finished the creation process, the new PUN app will appear on your dashboard:

Pagina dell'applicazione Photon

Connessione del progetto Unity all'applicazione PUNConnecting the Unity project to the PUN application

In questa sezione si connetterà il progetto Unity all'app PUN creata nella sezione precedente.In this section, you will connect your Unity project to the PUN app you created in the previous section.

Nel dashboard di Photon fai clic sul campo App ID (ID app) per visualizzare l'ID dell'app e quindi copialo negli Appunti:On the Photon dashboard, click the App ID field to reveal the app ID, then copy it to your clipboard:

Pagina dell'applicazione Photon con App Id selezionato

Nel menu di Unity seleziona Window (Finestra) > Photon Unity Networking > PUN Wizard (Creazione guidata PUN) per aprire la finestra PUN Wizard (Creazione guidata PUN), fai clic sul pulsante Setup Project (Configura progetto) per aprire il menu PUN Setup (Configurazione PUN) ed esegui la configurazione nel modo seguente:In the Unity menu, select Window > Photon Unity Networking > PUN Wizard to open the Pun Wizard window, click the Setup Project button to open the PUN Setup menu, and configure it as follows:

  • Nel campo AppId or Email (ID app o e-mail) incolla l'ID dell'app PUN copiato nel passaggio precedenteIn the AppId or Email field, paste the PUN app ID you copied in the previous step

Fai quindi clic sul pulsante Setup Project (Configura progetto) per applicare l'ID dell'app:Then click the Setup Project button to apply the app ID:

Finestra PUN Setup di Unity con AppId compilato

Dopo che Unity ha terminato il processo di configurazione di PUN, nel menu PUN Setup (Configurazione PUN) verrà visualizzato il messaggio Done! (Fatto)Once Unity has finished the PUN setup process, the PUN Setup menu will display the message Done! e nella finestra Project (Progetto) verrà selezionato automaticamente l'asset PhotonServerSettings, in modo che le relative proprietà siano visualizzate nella finestra Inspector (Controllo):and automatically select the PhotonServerSettings asset in the Project window, so its properties are displayed in the Inspector window:

Finestra PUN Setup di Unity con Setup Project applicato

Lezione completataCongratulations

È stata creata un'app PUN ed è stata connessa al progetto Unity.You have successfully created a PUN app and connected it to your Unity project. Il passaggio successivo consiste nel consentire connessioni con altri utenti, in modo che ogni utente possa visualizzare il lavoro svolto dagli altri.Your next step is to allow connections with other users so that multiple users can see each other.