2. Configurar o Photon Unity Networking2. Setting up Photon Unity Networking

Neste tutorial, você vai se preparar para criar uma experiência compartilhada usando o PUN (Photon Unity Networking).In this tutorial, you will prepare for creating a shared experience using Photon Unity Networking (PUN). Você aprenderá a criar um aplicativo PUN, importar ativos PUN para seu projeto do Unity e conectar seu projeto do Unity ao aplicativo 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

  • Saiba como criar um aplicativo PUNLearn how to create a PUN app
  • Saber como encontrar e importar os ativos PUNLearn how to find and import the PUN assets
  • Saiba como conectar seu projeto do Unity ao aplicativo PUNLearn how to connect your Unity project to the PUN app

Como criar e preparar o projeto do UnityCreating and preparing the Unity project

Nesta seção, você criará um projeto do Unity e o deixará pronto para o desenvolvimento do MRTK.In this section, you will create a new Unity project and get it ready for MRTK development.

Primeiro, siga Como inicializar o seu projeto e implantar o primeiro aplicativo, excluindo as instruções Criar o seu aplicativo para o dispositivo, que incluem as seguintes etapas: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. Criar um projeto do Unity e dar a ele um nome adequado, por exemplo, Tutoriais do MRTKCreating the Unity project and give it a suitable name, for example, MRTK Tutorials
  2. Como alternar a plataforma de buildSwitching the build platform
  3. Como importar os Recursos Essenciais do TextMeshProImporting the TextMeshPro Essential Resources
  4. Como importar o Kit de Ferramentas de Realidade MisturadaImporting the Mixed Reality Toolkit
  5. Como configurar o projeto do UnityConfiguring the Unity project
  6. Criar e configurar a cena e dar um nome adequado à cena, por exemplo, MultiUserCapabilitiesCreating and configuring the scene and give the scene a suitable name, for example, MultiUserCapabilities

Em seguida, siga as instruções em Alterar a opção de exibição de reconhecimento espacial para:Then follow the Changing the Spatial Awareness Display Option instructions to:

  1. Alterar o perfil de configuração do MRTK para DefaultHoloLens2ConfigurationProfileChange the MRTK configuration profile for to the DefaultHoloLens2ConfigurationProfile
  2. Alterar as opções de exibição da malha de reconhecimento espacial para Oclusão.Change the spatial awareness mesh display options to Occlusion.

Como habilitar funcionalidades adicionaisEnabling additional capabilities

No menu do Unity, selecione Editar > Configurações de projeto... para abrir a janela Configurações do Player, então localize a seção Player > Configurações de Publicação:In the Unity menu, select Edit > Project Settings... to open the Player Settings window, then locate the Player > Publishing Settings section:

Configurações de Player do Unity

Em Configurações de publicação, role para baixo até a seção Funcionalidades e verifique novamente se as funcionalidades InternetClient, Microfone, SpatialPerception e GazeInput, que você habilitou durante a etapa Como configurar o projeto Unity acima estão 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.

Em seguida, habilite as seguintes funcionalidades adicionais:Then enable the following additional capabilities:

  • Funcionalidade InternetClientServerInternetClientServer capability
  • Funcionalidade PrivateNetworkClientServerPrivateNetworkClientServer capability

Configurações de funcionalidades do Unity

Instalar pacotes internos do UnityInstalling inbuilt Unity packages

No menu do Unity, selecione Janela > Gerenciador de Pacotes para abrir a janela Gerenciador de Pacotes e selecione AR Foundation e clique no botão Instalar para instalar o pacote: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:

Janela Gerenciador de Pacotes do Unity com o AR Foundation selecionado

Observação

Você está instalando o pacote do AR Foundation porque ele é exigido pelo SDK de Âncoras Espaciais do Azure que você importará na próxima seção.You are installing the AR Foundation package because it is required by the Azure Spatial Anchors SDK you will import in the next section.

Como importar os ativos do tutorialImporting the tutorial assets

Baixe e importe os seguintes pacotes personalizados do Unity na ordem em que estão listados:Download and import the following Unity custom packages in the order they are listed:

Depois de importar os ativos do tutorial, a janela do projeto deverá ser semelhante a esta:After you have imported the tutorial assets your Project window should look similar to this:

Janelas Hierarquia, Cena e Projeto do Unity após a importação dos ativos do tutorial

Dica

Para obter um lembrete sobre como importar um pacote personalizado do Unity, você pode consultar as instruções em Como importar o Kit de Ferramentas de Realidade Misturada.For a reminder on how to import a Unity custom package, you can refer to the Importing the Mixed Reality Toolkit instructions.

Observação

Depois de importar o pacote de ativos do tutorial de MultiUserCapabilities, você verá vários erros CS0246 na janela do console informando que o tipo ou o namespace está ausente.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. Isso deve ser esperado e será resolvido na próxima seção quando você importar os ativos PUN.This is expected and will be resolved in the next section when you import the PUN assets.

Como importar os ativos PUNImporting the PUN assets

No menu do Unity, selecione Janela > Asset Store para abrir a janela da Asset Store, pesquise e selecione PUN 2 – GRATUITO em Sair dos Jogos e clique no botão Baixar para baixar o pacote de ativos para a sua conta do 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.

Quando o download for concluído, clique no botão Importar para abrir a janela Importar Pacote do Unity:When the download is complete, click the Import button to open the Import Unity Package window:

Unity Asset Store com o PUN 2 – Gratuito

Na janela Importar Pacote do Unity, clique no botão Todos para garantir que todos os ativos sejam selecionados e clique no botão Importar para importar os ativos: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:

Janela de importação do Unity com o PUN 2

Depois que o Unity concluir o processo de importação, a janela do Assistente do PUN será exibida com o menu Instalação do PUN carregado; ignore ou feche essa janela por enquanto: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:

Janela de Instalação do Unity com o PUN

Como criar o aplicativo PUNCreating the PUN application

Nesta seção, você criará uma conta do Photon, se ainda não tiver uma, e criará um aplicativo PUN.In this section, you will create a Photon account, if you don't already have one, and create a new PUN app.

Navegue até o painel do Photon e entre nele caso já tenha uma conta que deseja usar; caso contrário, clique no link Criar Uma e siga as instruções para registrar uma nova conta: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 logon do Photon

Depois que estiver conectado, clique no botão Criar um Aplicativo:Once signed in, click the Create a New App button:

Página inicial do painel do Photon

Na página Criar um Aplicativo, insira os seguintes valores:On the Create a New Application page, enter the following values:

  • Para o tipo Photon, selecione PUNFor Photon Type, select PUN
  • Em Nome, insira um nome adequado, por exemplo, Tutoriais do MRTKFor Name, enter a suitable name, for example, MRTK Tutorials
  • Em Descrição, opcionalmente, insira uma descrição adequadaFor Description, optionally enter a suitable description
  • Em URL, deixe o campo vazioFor Url, leave the field empty

Em seguida, clique no botão Criar para criar o aplicativo:Then click the Create button to create the new app:

Página Criar aplicativo do Photon

Depois que o Photon tiver concluído o processo de criação, o novo aplicativo PUN será exibido no painel:Once Photon has finished the creation process, the new PUN app will appear on your dashboard:

Página do aplicativo do Photon

Como conectar o projeto do Unity ao aplicativo PUNConnecting the Unity project to the PUN application

Nesta seção, você conectará seu projeto do Unity ao aplicativo PUN criado na seção anterior.In this section, you will connect your Unity project to the PUN app you created in the previous section.

No painel do Photon, clique no campo ID do Aplicativo para revelar a ID do aplicativo e, em seguida, copie-o para a área de transferência:On the Photon dashboard, click the App ID field to reveal the app ID, then copy it to your clipboard:

Página do aplicativo do Photon com a ID do aplicativo selecionada

No menu do Unity, selecione Janela > Photon Unity Networking > Assistente do PUN para abrir a janela do Assistente do PUN, clique no botão Projeto de Instalação para abrir o menu Instalação do PUN e configure-o da seguinte maneira: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:

  • No campo ID do Aplicativo ou Email, cole a ID do aplicativo PUN copiado na etapa anteriorIn the AppId or Email field, paste the PUN app ID you copied in the previous step

Em seguida, clique no botão Projeto de Instalação para aplicar a ID do aplicativo:Then click the Setup Project button to apply the app ID:

Janela de Instalação do Unity com o PUN com a ID do aplicativo preenchida

Depois que o Unity concluir o processo de configuração do PUN, o menu Instalação do PUN exibirá a mensagem Concluído!Once Unity has finished the PUN setup process, the PUN Setup menu will display the message Done! e selecionará automaticamente o ativo PhotonServerSettings na janela Projeto, de modo que as propriedades sejam exibidas na janela Inspetor:and automatically select the PhotonServerSettings asset in the Project window, so its properties are displayed in the Inspector window:

Janela de Instalação do Unity com o PUN com Projeto de Instalação aplicado

ParabénsCongratulations

Você criou um aplicativo PUN com êxito e o conectou ao seu projeto do Unity.You have successfully created a PUN app and connected it to your Unity project. A próxima etapa será permitir conexões com outros usuários para que vários usuários possam ver uns aos outros.Your next step is to allow connections with other users so that multiple users can see each other.