> For the complete documentation index, see [llms.txt](https://docs.edgegap.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.edgegap.com/ko/docs/sample-projects/unity-netcodes/photon-bolt-on-arbitrium.md).

# Photon Bolt

네트워킹 솔루션으로 Photon Bolt를 사용하는 프로젝트를 위해 Edgegap에 헤드리스 Unity 게임 서버를 생성하세요.

이 가이드는 Photon Bolt를 네트워킹 솔루션으로 사용하는 Unity 프로젝트를 위해 Edgegap에 헤드리스 서버를 만드는 방법을 도와줍니다.

이 가이드에서는 예시로 맞춤형 데모 프로젝트를 사용하겠습니다.

### Unity 프로젝트 준비

### Unity 프로젝트 복제

첫 번째 단계는 git에서 Edgegap 데모 게임 프로젝트를 복제하는 것입니다. 명령 프롬프트에서 다음 명령을 사용하면 됩니다:

이 명령은 원본 Unity 프로젝트가 들어 있는 폴더를 생성하며, 이름은 `demo-game`.

입니다. 과정이 끝나면 Unity Hub를 열고 `추가` 버튼을 Projects 탭에서 눌러 프로젝트의 폴더를 컴퓨터에서 찾아 추가할 수 있습니다:

프로젝트를 열려면 올바른 버전의 Unity가 설치되어 있어야 합니다. 이 경우에는 Unity `2020.3.3`를 사용할 것입니다. Unity 다운로드 아카이브에서 찾을 수 있습니다: <https://unity3d.com/get-unity/download/archive>.

설치가 완료되면, Unity Hub에서 프로젝트 이름 옆의 드롭다운 메뉴를 통해 새 Unity 버전을 선택할 수 있습니다:

이제 Unity 프로젝트를 열어 다음 단계로 진행할 수 있습니다.

### 게임 설정

### Photon Bolt 설정

#### Photon App ID 추가 및 Bolt 컴파일

게임이 Photon의 서비스와 통신하려면 Photon 대시보드에 앱을 추가해야 합니다. 아직 [Photon 계정](https://id.photonengine.com/Account/) 이 없다면 쉽게 만들 수 있습니다.

로그인한 후에는 앱을 생성하고 이름을 지정할 수 있습니다. 각 앱에는 고유한 `앱 ID`가 있습니다. 이 ID를 복사하여 Unity 프로젝트 내의 `Bolt Settings` 창에 붙여넣어야 합니다:

<figure><img src="https://1562312210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-85755915f46bb51ed45784518d86ce278e998650%2Funity_photon_bolt_settings.png?alt=media" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1562312210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-fccf1cdf65056d42522cd4405f5a5dfbc5265106%2Funity_photon_bolt_app_id.png?alt=media" alt=""><figcaption></figcaption></figure>

ID를 입력한 후에는 Bolt Settings 창을 닫을 수 있습니다. 이전과 같은 `Bolt` 메뉴에서 다음 두 작업을 수행해야 합니다: `Prefab 데이터베이스 업데이트` 및 `어셈블리 컴파일`을 각각 수행합니다.

<figure><img src="https://1562312210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-93c9dc4b160db8a4b12142313da2c48bdb6a05cb%2Funity_photon_bolt_compile.png?alt=media" alt=""><figcaption></figcaption></figure>

이 시점에서 게임의 `StartScene` 씬을 디버그 콘솔에서 오류나 경고 없이 실행할 수 있어야 합니다. 그러나 아직 서버에서 플레이를 시작할 수는 없습니다.

이것으로 Photon Bolt가 동작하는 데 필요한 일반적인 변경 사항은 끝났습니다. 이러한 변경 사항은 게임의 클라이언트와 서버 모두에 적용됩니다.

### 헤드리스 서버 준비

앱이 컨테이너와 효율적으로 작동하려면 "헤드리스 서버" 빌드를 만들기 위해 게임에 몇 가지 변경을 해야 합니다. 대부분의 프로젝트에서는 몇 가지 간단한 단계만 필요합니다.

#### Unity 프로젝트 요구 사항

먼저, Photon Bolt의 헤드리스 서버 모드에는 `HeadlessServerManager`.

라는 스크립트가 포함된 씬을 로드해야 한다는 점을 반드시 알아두어야 합니다.

{% code collapsedlinecount="10" %}

```cs
using System;
using Bolt.Matchmaking;
using Bolt.Photon;
using UnityEngine;
using UnityEngine.SceneManagement;

namespace Bolt.Samples.HeadlessServer
{
    public class HeadlessServerManager : Bolt.GlobalEventListener
    {
        public string Map = "";
        public string GameType = "";
        public string RoomID = "";

        public override void BoltStartBegin(" alt=""><figcaption></figcaption></figure>
        {
            // 사용 중인 모든 Protocol Token을 등록합니다
            BoltNetwork.RegisterTokenClass<PhotonRoomProperties>();
        }

        public override void BoltStartDone()
        {
            if (BoltNetwork.IsServer)
            {
                // 일부 방 사용자 지정 속성을 생성합니다
                PhotonRoomProperties roomProperties = new PhotonRoomProperties();

                roomProperties.AddRoomProperty("t", GameType); // 예: 게임 유형
                roomProperties.AddRoomProperty("m", Map); // 예: 맵 ID

                roomProperties.IsOpen = true;
                roomProperties.IsVisible = true;

                // RoomID가 설정되지 않았다면 무작위로 생성합니다
                if (RoomID.Length == 0)
                {
                    RoomID = Guid.NewGuid().ToString();
                }

                // Photon 방을 생성합니다
                BoltMatchmaking.CreateSession(
                    sessionID: RoomID,
                    token: roomProperties,
                    sceneToLoad: Map
                );
            }
        }

        // 초기화용
        void Start()
        {
            // 명령줄에서 사용자 지정 인수를 가져옵니다
            Map = GetArg("-m", "-map") ?? Map;
            GameType = GetArg("-t", "-gameType") ?? GameType; // 예: 명령줄에서 게임 유형 가져오기
            RoomID = GetArg("-r", "-room") ?? RoomID;

            // 요청된 레벨을 검증합니다
            var validMap = false;

            foreach (string value in BoltScenes.AllScenes)
            {
                if (SceneManager.GetActiveScene().name != value)
                {
                    if (Map == value)
                    {
                        validMap = true;
                        break;
                    }
                }
            }

            if (!validMap)
            {
                BoltLog.Error("잘못된 구성: 레벨 이름을 확인해 주세요");
                Application.Quit();
            }

            // 서버를 시작합니다
            BoltLauncher.StartServer();
            DontDestroyOnLoad(this);
        }

        /// <summary>
        /// 게임 인스턴스가 헤드리스 모드로 시작되었는지 감지하는 유틸리티 함수입니다.
        /// </summary>
        /// <returns><c>true</c>는 헤드리스 모드가 사용되었음을, <c>false</c>는 그렇지 않음을 의미합니다.</returns>
        public static bool IsHeadlessMode()
        {
            return Environment.CommandLine.Contains("-batchmode") && Environment.CommandLine.Contains("-nographics");
        }

        static string GetArg(params string[] names)
        {
            var args = Environment.GetCommandLineArgs();
            for (int i = 0; i < args.Length; i++)
            {
                foreach (var name in names)
                {
                    if (args[i] == name && args.Length > i + 1)
                    {
                        return args[i + 1];
                    }
                }
            }

            return null;
        }
    }
}
```

{% endcode %}

일반적으로 이는 빈 씬의 빈 GameObject에 의해 유지되며(헤드리스 서버 빌드에만 사용됨),

이 스크립트는 프로젝트 구조에 맞추기 위해 이 데모에서 약간 수정되었으며, 현재 다음 위치의 씬에 있는 빈 GameObject에 배치되어 있습니다 `Assets/Scenes/BoltHeadlessServer`.

#### 게임에 헤드리스 서버 검사 추가

위의 스크립트에는 `IsHeadlessMode`라는 정적 유틸리티 메서드가 포함되어 있으며, 실행 중인 게임이 헤드리스인지 여부를 확인하는 데 사용됩니다. 기존 프로젝트를 업데이트하는 경우, 플레이어 캐릭터 생성을 방지하는 것처럼 헤드리스 서버용 기능을 제거하거나 추가하기 위해 이 검사를 추가하고 싶을 수 있습니다.

#### 빌드 설정

프로젝트의 `빌드 설정` 에서 `BoltHeadlessServer` 씬을 맨 위에 추가하여 서버가 가장 먼저 로드하도록 합니다.

다음으로 `Linux` 를 대상 플랫폼으로 선택하고 `서버 빌드`.

<figure><img src="https://1562312210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-119e3c54e779d1120313d9dbba22037fbe3670ca%2Funity_photon_bolt_build_settings.png?alt=media" alt=""><figcaption></figcaption></figure>

를 체크합니다. 이제 위 설정으로 Linux에서 게임을 빌드할 수 있습니다.

에 대해서는 **클라이언트 빌드**에서는 `BoltHeadlessServer` 씬과 `IsServer` 옵션의 체크를 해제하여 게임이 올바르게 작동하도록 하십시오.

Photon Bolt용 헤드리스 서버를 만드는 각 단계에 대한 자세한 내용은 [Photon Bolt 헤드리스 서버 문서](https://doc.photonengine.com/en-us/bolt/current/demos-and-tutorials/headless-server).

### 서버용 컨테이너 만들기

Docker나 컨테이너에 익숙하지 않다면 다음 내용을 확인하여 더 자세히 알아볼 수 있습니다 [Docker란 무엇인가요?](https://docs.edgegap.com/ko/docs/tools-and-integrations/docker.md)

Unity 프로젝트에서 컨테이너를 만들려면 다음을 참조하세요 [Docker에서 Unity](broken://pages/02a2e8d85c674170b16164e93c101d8b88dce78d).

### 앱을 Edgegap에 추가하기

이제 컨테이너를 Edgegap에 추가하여 플레이어가 있는 모든 곳에서 호스팅할 수 있습니다.

앱을 Edgegap에 추가하는 방법을 모르겠다면 다음을 참조하세요 [앱 및 버전](https://docs.edgegap.com/ko/learn/orchestration/application-and-versions.md).

다만 앱 이름이 `demo-game` 이어야 하고, `v1`라는 버전이 있어야 합니다. 그렇지 않으면 `Assets/Scripts/StaginController.cs`.

에 있는 스크립트에서 이 값들을 업데이트해야 합니다. `Assets/Scripts/StaginController.cs` 스크립트에서도 `API_TOKEN`라는 상수 변수를 찾을 수 있습니다. Edgegap 계정에서 토큰을 생성하여 이 변수에 문자열로 붙여넣어야 합니다. 이 토큰은 Edgegap으로 보내는 API 요청을 인증하는 데 사용됩니다.

다음은 문제의 스크립트이며, Edgegap의 토큰은 파란색으로, 앱 매개변수는 빨간색으로 표시되어 있습니다:

<figure><img src="https://1562312210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-356f4d51a5c114024fea432e8fcd9b677d3c9e98%2Funity_photon_bolt_staging_controller.png?alt=media" alt=""><figcaption></figcaption></figure>

## 데모 게임 플레이하기

마지막으로, 플레이할 데모 게임 클라이언트 빌드를 시작할 수 있습니다. 게임의 클라이언트 버전을 빌드하여 실행하거나 Unity 인터페이스에서 직접 플레이할 수 있습니다. 다만 반드시 `StartScene` 씬에서 시작해야 합니다.

실행되면 인터페이스가 나타납니다. 상단에는 텍스트 필드가 있고, 큰 버튼 두 개와 화면 왼쪽 아래에는 Bolt의 현재 상태를 보여주는 레이블이 있습니다.

<figure><img src="https://1562312210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fgit-blob-3ace5ac3f2d80112f7564e85fdcf8c65d844bf34%2Funity_photon_bolt_demo_game.png?alt=media" alt=""><figcaption></figcaption></figure>

Edgegap의 API 토큰을 상단의 텍스트 필드에 복사할 수 있습니다. 토큰을 붙여넣은 후에는 이제 `서버 요청` 버튼을 눌러 Edgegap에 API 호출을 보내 서버를 시작할 수 있습니다.

몇 초 후에는 인터페이스 하단의 레이블에 사용 가능한 서버 수가 표시되는 것을 볼 수 있습니다. 이제 `무작위 서버에 연결` 버튼을 눌러 게임에 참가하고 플레이를 시작하면 됩니다.
