2. Photon Unity 네트워킹 설정2. Setting up Photon Unity Networking

이 자습서에서는 PUN(Photon Unity Networking)을 사용하여 공유 환경을 만들기 위해 준비합니다.In this tutorial, you will prepare for creating a shared experience using Photon Unity Networking (PUN). PUN 앱을 만들고 PUN 자산을 Unity 프로젝트로 가져오고 Unity 프로젝트를 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.

목표Objectives

  • PUN 앱을 만드는 방법 알아보기Learn how to create a PUN app
  • PUN 자산을 찾아서 가져오는 방법 알아보기Learn how to find and import the PUN assets
  • Unity 프로젝트를 PUN 앱에 연결하는 방법 알아보기Learn how to connect your Unity project to the PUN app

Unity 프로젝트 만들기 및 준비Creating and preparing the Unity project

이 섹션에서는 새 Unity 프로젝트를 만들고 MRTK 개발을 준비합니다.In this section, you will create a new Unity project and get it ready for MRTK development.

먼저 프로젝트 초기화 및 첫 번째 애플리케이션 배포를 수행합니다. 단, 디바이스에 애플리케이션 빌드 지침은 제외합니다. 단계는 다음과 같습니다.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. Unity 프로젝트 만들기 및 적절한 이름(예: MRTK Tutorials) 지정Creating the Unity project and give it a suitable name, for example, MRTK Tutorials
  2. 빌드 플랫폼 전환Switching the build platform
  3. TextMeshPro 필수 리소스 가져오기Importing the TextMeshPro Essential Resources
  4. Mixed Reality Toolkit 가져오기Importing the Mixed Reality Toolkit
  5. Unity 프로젝트 구성Configuring the Unity project
  6. 장면 만들기 및 구성 및 장면에 적절한 이름(예: MultiUserCapabilities) 지정Creating and configuring the scene and give the scene a suitable name, for example, MultiUserCapabilities

그런 다음, 공간 인식 표시 옵션 변경 지침에 따라 다음을 수행합니다.Then follow the Changing the Spatial Awareness Display Option instructions to:

  1. MRTK 구성 프로필DefaultHoloLens2ConfigurationProfile 로 변경Change the MRTK configuration profile for to the DefaultHoloLens2ConfigurationProfile
  2. 공간 인식 메시 표시 옵션폐색 으로 변경Change the spatial awareness mesh display options to Occlusion.

추가 기능 사용Enabling additional capabilities

Unity 메뉴에서 편집 > 프로젝트 설정... 을 차례로 선택하여 [플레이어 설정] 창을 연 다음, 플레이어 > 게시 설정 섹션을 차례로 찾습니다.In the Unity menu, select Edit > Project Settings... to open the Player Settings window, then locate the Player > Publishing Settings section:

Unity Player 설정

게시 설정 에서 기능 섹션까지 아래로 스크롤하여 위의 Unity 프로젝트 구성 단계 중에 사용하도록 설정한 InternetClient, Microphone, SpatialPerceptionGazeInput 기능이 사용하도록 설정되어 있는지 다시 확인합니다.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.

그런 다음, 다음과 같은 추가 기능을 사용하도록 설정합니다.Then enable the following additional capabilities:

  • InternetClientServer 기능InternetClientServer capability
  • PrivateNetworkClientServer 기능PrivateNetworkClientServer capability

Unity Capabilities 설정

기본 제공 Unity 패키지 설치Installing inbuilt Unity packages

Unity 메뉴에서 > 패키지 관리자 를 차례로 선택하여 패키지 관리자 창을 연 다음, AR Foundation 을 선택하고, 설치 단추를 클릭하여 패키지를 설치합니다.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:

AR Foundation이 선택된 Unity Package Manager

참고

Azure Spatial Anchors SDK에 필요하므로 AR Foundation 패키지를 설치합니다. 이 패키지는 다음 섹션에서 가져옵니다.You are installing the AR Foundation package because it is required by the Azure Spatial Anchors SDK you will import in the next section.

자습서 자산 가져오기Importing the tutorial assets

AzurespatialAnchors SDK V2.7.1을 Unity 프로젝트에 추가합니다. 패키지를 추가하려면 이 자습서를 따르세요.Add AzurespatialAnchors SDK V2.7.1 into your unity project, to add the packages please follow this tutorial

다음 Unity 사용자 지정 패키지를 나열된 순서대로 다운로드하여 가져옵니다.Download and import the following Unity custom packages in the order they are listed:

자습서 자산을 가져오면 [프로젝트] 창이 다음과 같이 표시됩니다.After you have imported the tutorial assets your Project window should look similar to this:

자습서 자산을 가져온 후의 Unity 계층 구조, 장면 및 프로젝트 창

Unity 사용자 지정 패키지를 가져오는 방법을 미리 알아보려면 자습서 자산 가져오기 지침을 참조할 수 있습니다.For a reminder on how to import a Unity custom package, you can refer to the Importing the tutorial assets instructions.

참고

MultiUserCapabilities 자습서 자산 패키지를 가져오면 유형 또는 네임스페이스가 누락되었음을 나타내는 CS0246 오류가 Console 창에 보입니다.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. 이것은 예상한 오류이며, 다음 섹션에서 PUN 자산을 가져오면 해결됩니다.This is expected and will be resolved in the next section when you import the PUN assets.

PUN 자산 가져오기Importing the PUN assets

Unity 메뉴에서 Window > Asset Store 를 선택하여 Asset Store 창을 열고 Exit Games에서 PUN 2 - FREE 를 검색하여 선택하고, Download 단추를 클릭하여 자산 패키지를 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.

다운로드가 완료되면 Import 단추를 클릭하여 Import Unity Package 창을 엽니다.When the download is complete, click the Import button to open the Import Unity Package window:

PUN 2가 있는 Unity Asset Store - 무료

Import Unity Package(Unity 패키지 가져오기) 창에서 All(모두) 단추를 클릭하여 모든 자산이 선택되었는지 확인한 다음, Import(가져오기) 단추를 클릭하여 자산을 가져옵니다.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:

PUN 2 가져오기 창이 있는 Unity

Unity에서 Import(가져오기) 프로세스가 완료되면 Pun Wizard 창이 PUN Setup 메뉴가 로드된 상태로 나타납니다. 지금은 이 창을 무시하거나 닫으면 됩니다.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:

PUN Setup 창이 있는 Unity

PUN 애플리케이션 만들기Creating the PUN application

이 섹션에서는 Photon 계정이 없으면 만들고 새 PUN 앱을 만듭니다.In this section, you will create a Photon account, if you don't already have one, and create a new PUN app.

Photon 대시보드로 이동하여 로그인하고(사용할 계정이 있는 경우) 그렇지 않으면 Create One 링크를 클릭하여 지침에 따라 새 계정을 등록합니다.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:

Photon 로그인 페이지

로그인되면 Create a New App 단추를 클릭합니다.Once signed in, click the Create a New App button:

Photon 대시보드 시작 페이지

Create a New Application(새 애플리케이션 만들기) 페이지에서 다음 값을 입력합니다.On the Create a New Application page, enter the following values:

  • Photon 유형의 경우 PUN을 선택합니다.For Photon Type, select PUN
  • 이름에는 적절한 이름(예: MRTK Tutorials)을 입력합니다.For Name, enter a suitable name, for example, MRTK Tutorials
  • 설명에는 적절한 설명(선택 사항)을 입력합니다.For Description, optionally enter a suitable description
  • URL 필드는 비워둡니다.For Url, leave the field empty

그런 다음, 만들기 단추를 클릭하여 새 앱을 만듭니다.Then click the Create button to create the new app:

Photon 애플리케이션 페이지 만들기

Photon에서 만들기 프로세스가 완료되면 새 PUN 앱이 대시보드에 나타납니다.Once Photon has finished the creation process, the new PUN app will appear on your dashboard:

Photon 애플리케이션 페이지

Unity 프로젝트를 PUN 애플리케이션에 연결Connecting the Unity project to the PUN application

이 섹션에서는 Unity 프로젝트를 이전 섹션에서 만든 PUN 앱에 연결합니다.In this section, you will connect your Unity project to the PUN app you created in the previous section.

Photon 대시보드에서 App ID 필드를 클릭하고 앱 ID 필드를 표시하여 클립보드에 복사합니다.On the Photon dashboard, click the App ID field to reveal the app ID, then copy it to your clipboard:

App ID가 선택된 Photon 애플리케이션 페이지

Unity 메뉴에서 Window > Photon Unity Networking > PUN Wizard 를 선택하여 Pun Wizard 창을 열고 Setup Project 창을 클릭하여 PUN Setup 메뉴를 열어서 다음과 같이 구성합니다.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:

  • AppId or Email 필드에 이전 단계에서 복사한 PUN App ID를 붙여넣습니다.In the AppId or Email field, paste the PUN app ID you copied in the previous step

그런 다음, Setup Project 단추를 클릭하여 App ID를 적용합니다.Then click the Setup Project button to apply the app ID:

App ID가 채워진 Unity PUN Setup 창

Unity에서 PUN 설정 프로세스가 완료되면 PUN Setup 메뉴에 Done! 이라는 메시지가 표시되고Once Unity has finished the PUN setup process, the PUN Setup menu will display the message Done! Project 창에 PhotonServerSettings 자산이 자동으로 선택되고 해당 속성이 Inspector 창에 표시됩니다.and automatically select the PhotonServerSettings asset in the Project window, so its properties are displayed in the Inspector window:

Setup Project가 적용된 Unity PUN Setup 창

축하합니다.Congratulations

PUN 앱을 만들어서 Unity 프로젝트에 연결하는 데 성공했습니다.You have successfully created a PUN app and connected it to your Unity project. 다음 단계에서는 여러 사용자가 서로 볼 수 있도록 다른 사용자와 연결을 허용할 수 있습니다.Your next step is to allow connections with other users so that multiple users can see each other.