2. Configuración de Photon Unity Networking2. Setting up Photon Unity Networking

En este tutorial, se preparará para la creación de una experiencia compartida con Photon Unity Networking (PUN).In this tutorial, you will prepare for creating a shared experience using Photon Unity Networking (PUN). Obtendrá información sobre cómo crear una aplicación de PUN, importar recursos de PUN en el proyecto de Unity y conectar el proyecto de Unity a la aplicación de 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.

ObjetivosObjectives

  • Aprender cómo crear una aplicación de PUNLearn how to create a PUN app
  • Aprender cómo buscar e importar los recursos de PUNLearn how to find and import the PUN assets
  • Aprender a conectar el proyecto de Unity a la aplicación de PUNLearn how to connect your Unity project to the PUN app

Creación y preparación del proyecto de UnityCreating and preparing the Unity project

En esta sección, crearás un nuevo proyecto de Unity y lo prepararás para el desarrollo con MRTK.In this section, you will create a new Unity project and get it ready for MRTK development.

Primero, debe seguir las instrucciones de Inicialización de su proyecto e implementación de su primera aplicación, a excepción de la sección Compilación de la aplicación para el dispositivo, que incluyen los pasos siguientes: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. Crear el proyecto de Unity y asignarle un nombre adecuado; por ejemplo, MRTK TutorialsCreating the Unity project and give it a suitable name, for example, MRTK Tutorials
  2. Cambiar la plataforma de compilaciónSwitching the build platform
  3. Importar los recursos esenciales de TextMeshProImporting the TextMeshPro Essential Resources
  4. Importar Mixed Reality ToolkitImporting the Mixed Reality Toolkit
  5. Configurar el proyecto de UnityConfiguring the Unity project
  6. Crear y configurar la escena y asignar un nombre adecuado a la escena; por ejemplo, MultiUserCapabilitiesCreating and configuring the scene and give the scene a suitable name, for example, MultiUserCapabilities

A continuación, siga las instrucciones de la sección Cambio de la opción de visualización de reconocimiento espacial para:Then follow the Changing the Spatial Awareness Display Option instructions to:

  1. Cambiar el perfil de configuración de MRTK por DefaultHoloLens2ConfigurationProfile.Change the MRTK configuration profile for to the DefaultHoloLens2ConfigurationProfile
  2. Cambiar las opciones de visualización de la malla de reconocimiento espacial a Oclusión.Change the spatial awareness mesh display options to Occlusion.

Habilitación de funcionalidades adicionalesEnabling additional capabilities

En el menú de Unity, selecciona Edit > Project Settings... (Editar > Configuración del proyecto...) para abrir la ventana Player Settings (Configuración del jugador). A continuación, busca la sección Player > Publishing Settings (Jugador > Configuración de publicación):In the Unity menu, select Edit > Project Settings... to open the Player Settings window, then locate the Player > Publishing Settings section:

Player Settings (Configuración del reproductor) de Unity

En Configuración de publicación, desplácese hasta la sección Funcionalidades y compruebe que las funcionalidades InternetClient, Microphone, SpatialPerception y GazeInput que habilitó durante el paso anterior titulado Configuración del proyecto de Unity, estén habilitadas.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.

A continuación, habilite las siguientes funcionalidades adicionales:Then enable the following additional capabilities:

  • Funcionalidad InternetClientServerInternetClientServer capability
  • Funcionalidad PrivateNetworkClientServerPrivateNetworkClientServer capability

Capabilities Settings (Configuración de funcionalidades) de Unity

Instalación de paquetes de Unity integradosInstalling inbuilt Unity packages

En el menú de Unity, seleccione Window > Package Manager (Ventana > Administrador de paquetes) para abrir la ventana Package Manager y, a continuación, seleccione AR Foundation y haga clic en el botón Install (Instalar) para instalar el paquete: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:

Unity Package Manager con AR Foundation seleccionado

Nota

Se instalará el paquete de AR Foundation porque así lo requiere el SDK de Azure Spatial Anchors que se importará en la siguiente sección.You are installing the AR Foundation package because it is required by the Azure Spatial Anchors SDK you will import in the next section.

Importación de los recursos del tutorialImporting the tutorial assets

Descarga e importa los siguientes paquetes personalizados de Unity en el orden en que aparecen:Download and import the following Unity custom packages in the order they are listed:

Después de importar los recursos del tutorial, la ventana Project (Proyecto) debería tener un aspecto similar al siguiente:After you have imported the tutorial assets your Project window should look similar to this:

Ventanas Hierarchy (Jerarquía), Scene (Escena) y Project (Proyecto) después de importar los recursos del tutorial

Sugerencia

Para obtener un recordatorio sobre cómo importar un paquete personalizado de Unity, consulte las instrucciones de Importación de 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

Después de importar el paquete de recursos del tutorial de MultiUserCapabilities, verás varios errores con el código CS0246 en la ventana de la consola en los que se indicará que falta el tipo o el espacio de nombres.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. Este comportamiento es el esperado y se resolverá en la sección siguiente cuando importes los recursos de PUN.This is expected and will be resolved in the next section when you import the PUN assets.

Importación de recursos de PUNImporting the PUN assets

En el menú de Unity, seleccione Ventana > Asset Store (Almacén de recursos) para abrir la ventana del almacén de recursos, busque y seleccione PUN 2 - FREE de Exit Games y haga clic en el botón Descargar para descargar el paquete de recursos en su cuenta de 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.

Una vez completada la descarga, haz clic en el botón Importar para abrir la ventana Import Unity Package (Importar paquete de Unity):When the download is complete, click the Import button to open the Import Unity Package window:

Asset Store (Almacén de recursos) de Unity con PUN 2 - Free

En la ventana Import Unity Package (Importar paquete de Unity), haz clic en el botón All (Todos) para asegurarte de que todos los recursos están seleccionados y, a continuación, haz clic en el botón Import (Importar) para importar los recursos: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:

Ventana de importación de Unity con PUN 2

Una vez que Unity haya completado el proceso de importación, se mostrará la ventana Pun Wizard (Asistente para PUN) con el menú de configuración de PUN cargado. Por ahora, puedes omitir o cerrar esta ventana: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:

Ventana de importación de Unity con PUN Setup (Instalación de PUN)

Creación de la aplicación de PUNCreating the PUN application

En esta sección, creará una cuenta de Photon, si aún no tiene ninguna, y creará una nueva aplicación de PUN.In this section, you will create a Photon account, if you don't already have one, and create a new PUN app.

Ve al panel de Photon e inicia sesión si ya tienes una cuenta que quieras usar. De lo contrario, haz clic en el vínculo Crear una y sigue las instrucciones para registrar una cuenta nueva: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:

Página de inicio de sesión de Photon

Una vez que hayas iniciado sesión, haz clic en el botón Crear una nueva aplicación:Once signed in, click the Create a New App button:

Página de bienvenida del panel de Photon

En la página Crear una nueva aplicación, escribe los valores siguientes:On the Create a New Application page, enter the following values:

  • En Photon Type (Tipo de Photon), seleccione PUN.For Photon Type, select PUN
  • En Nombre, escribe un nombre adecuado, por ejemplo, Tutoriales de MRTK.For Name, enter a suitable name, for example, MRTK Tutorials
  • En Descripción, puedes escribir una descripción adecuada.For Description, optionally enter a suitable description
  • En URL, deja el campo vacío.For Url, leave the field empty

A continuación, haga clic en el botón Crear para crear la nueva aplicación:Then click the Create button to create the new app:

Página de creación de aplicaciones de Photon

Una vez que Photon haya finalizado el proceso de creación, la nueva aplicación de PUN se mostrará en el panel:Once Photon has finished the creation process, the new PUN app will appear on your dashboard:

Página de la aplicación de Photon

Conexión del proyecto de Unity con la aplicación de PUNConnecting the Unity project to the PUN application

En esta sección, conectará el proyecto de Unity a la aplicación de PUN que creó en la sección anterior.In this section, you will connect your Unity project to the PUN app you created in the previous section.

En el panel de Photon, haz clic en el campo Id. de la aplicación para mostrar el identificador de la aplicación y, a continuación, cópialo en el portapapeles:On the Photon dashboard, click the App ID field to reveal the app ID, then copy it to your clipboard:

Página de la aplicación de Photon con el identificador de aplicación seleccionado

En el menú de Unity, selecciona Ventana > Photon Unity Networking > Pun Wizard (Asistente para PUN) para abrir la ventana del asistente para PUN, haz clic en el botón Proyecto de instalación para abrir el menú de configuración de PUN y configúralo de la siguiente manera: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:

  • En el campo AppId or Email (Id. de la aplicación o correo electrónico), pega el identificador de la aplicación de PUN que copiaste en el paso anteriorIn the AppId or Email field, paste the PUN app ID you copied in the previous step

A continuación, haz clic en el botón Proyecto de instalación para aplicar el id. de la aplicación:Then click the Setup Project button to apply the app ID:

Ventana PUN Setup (Instalación de PUN) de Unity con AppId rellenado

Una vez que Unity termine el proceso de configuración de PUN, se mostrará el mensaje Listo en el menú de configuración de PUN.Once Unity has finished the PUN setup process, the PUN Setup menu will display the message Done! Asimismo, se seleccionará automáticamente el recurso PhotonServerSettings en la ventana Proyecto para que sus propiedades se muestren en la ventana Inspector:and automatically select the PhotonServerSettings asset in the Project window, so its properties are displayed in the Inspector window:

Ventana PUN Setup (Instalación de PUN) de Unity con el proyecto de instalación aplicado

EnhorabuenaCongratulations

Creó correctamente una aplicación de PUN y la conectó al proyecto de Unity.You have successfully created a PUN app and connected it to your Unity project. El siguiente paso consiste en permitir las conexiones con otros usuarios para que varios usuarios puedan verse entre sí.Your next step is to allow connections with other users so that multiple users can see each other.