> 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-fusion-on-edgegap.md).

# Photon Fusion 1

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

### Arbitrium의 Photon Fusion

이 가이드는 Unity 프로젝트에서 다음을 사용하여 헤드리스 서버를 만드는 데 도움이 됩니다. [Photon Fusion](https://doc.photonengine.com/en-us/fusion/current/getting-started/fusion-intro) 네트워킹 솔루션으로 사용합니다.

우리는 샘플 프로젝트 [Photon Fusion의 Tanknarok](https://doc.photonengine.com/en-us/fusion/current/samples/fusion-tanknarok) 를 예시로 사용합니다.

Edgegap은 모든 플레이어가 어디에 있는지 알 때 가장 잘 작동합니다(그래야 최적의 위치에 서버를 배치할 수 있습니다). 따라서 Tanknarok 게임은 먼저 클라이언트 호스트 모드로 시작한 다음, 모든 플레이어가 합류하면 Edgegap 서버로 전환됩니다. 이는 Tanknarok에 플레이어들이 마음대로 들어오고 나갈 수 있는, 매치 시작 전에 실행되는 플레이 가능한 로비가 있기 때문입니다. 따라서 로직의 흐름은 다음과 같습니다:

1. 플레이어들은 다음을 사용하여 같은 방에 연결합니다. `AutoHostOrClient` 모드. 이 모드는 방의 첫 번째 플레이어를 자동으로 호스트로 선택합니다.
2. 모든 플레이어는 합류할 때 호스트에게 자신의 IP 주소를 보냅니다.
3. 플레이어들이 준비 완료되면, 호스트는 이 IP 주소들을 사용해 무작위 방 코드(guid 사용)를 가진 게임의 Edgegap 서버 버전을 시작합니다.
4. 호스트가 Edgegap 인스턴스의 배포가 완료되었음을 확인하면, 다른 플레이어들에게 새 방 코드를 알립니다.
5. 모든 플레이어, 호스트를 포함하여 현재 방에서 연결을 끊고 Edgegap 서버가 호스팅하는 새 방에 클라이언트 모드로 다시 연결합니다.
6. Edgegap 서버가 예상된 모든 플레이어가 합류했음을 확인하면, 매치를 시작합니다.
7. Edgegap 서버가 모두 매치를 떠났음을 확인하면, 스스로 종료합니다.

### 계정 설정

이 애플리케이션을 실행하려면 Photon 계정과 Edgegap 계정이 모두 필요합니다. 먼저 Photon 대시보드에서 Fusion 앱을 만들고 앱 ID를 `PhotonAppSettings` 스크립터블 오브젝트 파일에 설정해야 합니다. 그런 다음 대시보드에서 애플리케이션을 추가하고 API 토큰을 생성해야 합니다. 이 값들은 다음 파일의 App Name, Version, Api Token을 설정하는 데 사용됩니다. `EdgegapConfig` 스크립터블 오브젝트 파일.

{% hint style="info" %}
Edgegap 앱을 만들 때 이 프로그램은 512 CPU 단위와 512 MB의 메모리가 필요합니다.
{% endhint %}

개발을 돕는 플러그인도 두 가지 있습니다: 더 나은 Json 직렬화를 위한 Newtonsoft Json과 [ParrelSync](https://github.com/VeriorPies/ParrelSync) 여러 Unity 에디터로 더 쉽게 테스트하기 위한

### 1단계: 서버 모드 설정

다음을 가져올 수 있습니다. [수정된 Tanknarok 프로젝트](https://github.com/edgegap/netcode-game-sample-unity-photon-fusion-tanknarok) 를 GitHub에서. 또한 다음을 가져와야 합니다. [Photon Fusion SDK](https://doc.photonengine.com/en-us/fusion/current/getting-started/sdk-download) 를 프로젝트에.

Photon Fusion Tanknarok 프로젝트는 서버로 동작하도록 약간 수정해야 했습니다. 이는 주로 매치를 자동으로 시작하고 모드를 설정하는 작업이었습니다.

1. 수정된 `GameLauncher.cs` 시작 시 다음과 함께 실행되도록 `GameMode.Server`.
2. 수정된 `FusionLauncher.cs` 다음을 호출하도록 `_spawnWorldCallback` 게임이 실행된 후 한 번 호출하며, 다음에 의존하지 않습니다. `InstantiatePlayer` (서버에는 플레이어가 인스턴스화되지 않기 때문).
3. 서버인 경우 로비 씬을 건너뛰고, 모든 플레이어가 합류하면 바로 매치로 이동합니다.

이는 이미 다음에서 완료되었습니다. [수정된 Tanknarok 프로젝트](https://github.com/edgegap/netcode-game-sample-unity-photon-fusion-tanknarok).

#### Dockerfile

도커 파일은 꽤 기본적입니다. 우분투 베이스를 사용하고, 컴파일된 Linux 서버 빌드를 복사해오고, 파일 권한을 설정한 다음 실행합니다.

### 2단계: 첫 번째 클라이언트

초기 클라이언트는 호스트 역할과 Edgegap 서버를 관리하는 역할을 맡습니다. 이는 다음을 통해 수행됩니다. `EdgegapManager.cs` 파일이며, 이는 다시 다음 파일을 사용합니다. `EdgegapAPIInterface.cs` 파일은 Edgegap과의 상호 작용을 둘러싼 대부분의 기능을 래핑합니다.

에서 `GameManager.cs`, `OnAllPlayersReady` 호스트용 함수는 매치를 시작하는 대신 Edgegap 서버를 배포합니다. 이는 모든 플레이어의 IP 주소를 기반으로 수행됩니다. Unity 코루틴을 사용하면 이러한 작업을 비동기적으로 수행할 수 있습니다. Deploy 메서드는 콜백 함수를 받으며, 여기에 서버가 사용할 새 방 이름이 전달됩니다. 모든 클라이언트에게 전환을 알리기 위해 Photon RPC 함수가 전송됩니다.

{% code collapsedlinecount="10" %}

```cs
    if (EdgegapManager.EdgegapPreServerMode)
    {
        //호스트인 경우 새 Edgegap 서버를 시작
        //서버가 준비되면, 여기에 연결

        FindObjectOfType<GameLauncher>().ShowMatchStartingUI();

        if (Object.HasStateAuthority)
        {
            string[] ips = PlayerManager.allPlayers.Select(p => p.ipAddress).ToArray();
            StartCoroutine(EdgegapManager.Instance.Deploy(ips, RpcOnEdgegapServerReady));
        }
    }
    else
    {
        LoadLevel(_levelManager.GetRandomLevelIndex(), -1);
    }
```

{% endcode %}

전환은 다음이라는 빈 씬에서 이루어집니다. `TransferringScene`.

EdgegapManager 내부에서는 무작위 방 코드가 생성되어, 배포 API를 통해 새로 생성된 인스턴스에 환경 변수로 플레이어 수와 함께 전달됩니다. 이는 다음과 결합됩니다. `status` API 호출은 인스턴스의 배포가 완료되었는지 확인하기 위해 1초마다 확인을 시작합니다. 다음도 사용할 수 있습니다. [웹훅](broken://pages/994f7fd3b6dbcc4a6d57b26f64d18056f6714e8e) 옵션.

{% code collapsedlinecount="10" %}

```cs
    /// <summary>
    /// 서버를 배포하기 위해 Edgegap API를 호출합니다
    /// </summary>
    /// <param name="clientIpList">클라이언트 IP 주소 목록</param>
    /// <param name="OnDeployed">세션 이름을 매개변수로 받는 콜백 메서드</param>
    public IEnumerator Deploy(string[] clientIpList, Action<string> OnDeployed = null)
    {
        var roomCode = Guid.NewGuid().ToString();
        yield return EdgegapAPIInterface.RequestDeployment(clientIpList,
             new Dictionary<string, string> {
                { "room_code", roomCode },
                { "player_count", clientIpList.Length.ToString() } });

        yield return EdgegapAPIInterface.WaitForDeployment();

        OnDeployed(roomCode);
    }
```

{% endcode %}

### 3단계: 플레이어 합류

지시받아 새 Edgegap 서버로 전환하는 것 외에도, 합류하는 플레이어는 호스트 플레이어에게 자신의 IP 주소를 알려줘야 합니다. Photon이 이 정보를 제공하지 않기 때문에, 다음의 RPC 호출을 사용합니다. `GameManager` 호출되는 `ShareIpAddress` 는 다음에서 호출됩니다. `Player.cs` 클래스의 `Spawned` 메서드.

그런 다음 호스트는 RPC 메시지의 발신자가 누구인지에 따라 모든 플레이어의 플레이어 클래스에 이 IP 주소를 저장합니다:

{% code collapsedlinecount="10" %}

```cs
    [Rpc(sources:RpcSources.All, RpcTargets.StateAuthority)]
    public void RpcShareIpAddress(string ipAddress, RpcInfo info = default)
    {
        if (info.Source == PlayerRef.None)
        {
            // source는 로컬 플레이어의 경우 None이 됩니다
            Player.local.ipAddress = ipAddress;
            return;
        }

        foreach (var player in PlayerManager.allPlayers)
        {
            if (player.playerID == info.Source.PlayerId)
            {
                player.ipAddress = ipAddress;
                break;
            }
        }
    }
```

{% endcode %}

### 4단계: 정리

서버로 돌아가면, 수정된 `GameManager.cs` 는 메인 Update 함수에서 매치에 있는 플레이어 수를 추적합니다. 목표 플레이어 수가 모두 합류했는지 확인하여 매치를 시작할 수 있게 할 뿐만 아니라, 언제 스스로를 종료해야 하는지도 판단합니다. 게임이 1분 이상 실행되었고 남아 있는 플레이어가 없으면, Edgegap API를 호출하여 자체 배포를 중지합니다.

{% code collapsedlinecount="10" %}

```cs
    if (EdgegapManager.IsServer())
    {
        if (GameManager.playState == GameManager.PlayState.LOBBY)
        {
            // 로비에 있고 모든 플레이어가 합류했다면, 매치를 시작
            if (PlayerManager.allPlayers.Count >= EdgegapManager.ExpectedPlayerCount)
            {
                OnAllPlayersReady();
            }
        }

        if(Time.time > 60 && PlayerManager.allPlayers.Count == 0
            && GameManager.playState != GameManager.PlayState.TRANSITION)
        {
            // 1분 이상 지났고 여기 아무도 없으면, 서버를 중지
            Debug.LogWarning("Shutting Down");
            StartCoroutine(EdgegapAPIInterface.StopDeploymentFromServer());
            GameManager.playState = PlayState.TRANSITION;
        }
    }
```

{% endcode %}

이제 필요할 때 배포할 수 있는 Photon Fusion 프로젝트가 준비되었습니다!
