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

# Photon Fusion 2

Fusion 2 Asteroids 샘플을 따라 빌드부터 실시간 배포까지 진행하며, Edgegap에서 Unity Photon Fusion 2 게임을 호스팅하세요.

다음의 기술을 사용해 Edgegap에서 Unity 프로젝트를 호스팅하는 방법을 알아보세요. [Fusion 2 Asteroids 샘플](https://doc.photonengine.com/fusion/current/game-samples/fusion-asteroids).

{% embed url="<https://youtu.be/bg41HpPmE3E>" %}

## ✔️ 준비

시작하기 전에 다음이 필요합니다:

* [Unity 6](https://unity.com/releases/unity-6) - Unity Hub를 사용해 다운로드,
* [Fusion 2 Asteroids 샘플 프로젝트](https://github.com/edgegap/netcode-game-sample-photon-fusion2-asteroid) (Edgegap용으로 수정됨).

## ⚡ 배포 및 연결

{% hint style="success" %}
참조 [Unity](https://docs.edgegap.com/ko/unity.md) Unity에서 **서버 빌드 및 커스터마이징 방법 알아보기**.
{% endhint %}

### 1. Edgegap에 서버 배포

☑️ 시작하려면 다음이 필요합니다. [Edgegap에서 무료 계정을 생성하세요](https://app.edgegap.com/auth/register). 신용카드는 필요하지 않습니다.

☑️ [애플리케이션에 대한 새 앱 버전 만들기](https://app.edgegap.com/application-management/applications/fusion-2-asteroids-sample/versions/create), Fusion 2 Asteroids Sample을 선택하세요.

☑️ Unity에서 새 프로젝트를 여세요.

☑️ Tools / Edgegap Hosting으로 이동한 다음 6단계. Edgegap에 서버 배포로 이동하세요.

☑️ Cloud에 배포를 누르고 [새 배포의 세부정보를 열기](https://app.edgegap.com/deployment-management/deployments/list).

☑️ 배포의 고유한 일회성 연결 정보를 찾으세요:

* **호스트 URL** 형식 `780aa4260e83.pr.edgegap.net` .

✅ 이제 다음 단계로 진행할 수 있습니다.

### 2. 에디터에서 연결

☑️ Unity에서 새 프로젝트를 여세요.

☑️ ▶️ 재생 버튼을 눌러 게임 클라이언트를 시작하세요.

☑️ 방 이름으로 호스트 URL(이전 단계의 연결 정보)을 입력하세요.

☑️ Start Edgegap 버튼을 눌러 서버에 연결하세요.

☑️ 다음을 사용해 두 번째 가상 플레이어를 연결하세요. [Multiplayer Play Mode](https://docs-multiplayer.unity3d.com/mppm/current/about/) 또는 [ParrelSync](https://github.com/VeriorPies/ParrelSync).

🙌 Edgegap에서의 첫 배포를 축하합니다!

## ✏️ 서버 빌드 커스터마이징

### Photon에서 앱 만들기

{% hint style="info" %}
초기 데모를 쉽게 만들기 위해 Edgegap이 소유한 무료 등급 Photon Cloud 계정을 사용했습니다.
{% endhint %}

☑️ [Photon에서 무료 계정 만들기](https://dashboard.photonengine.com/).

☑️ [Photon에서 애플리케이션 만들기](https://dashboard.photonengine.com/app/create):

* `멀티플레이어 게임`,
* `Fusion` Photon SDK,
* `Fusion 2` SDK 버전.

☑️ 다음 형식으로 애플리케이션 ID를 찾으세요. `85314a99-56fc-4ab3-ba26-50efca09f303` .

☑️ Tools / Fusion / Fusion Hub (Alt + F)의 Photon Settings에 ID를 입력하세요.

### Fusion 2 프로젝트를 Edgegap과 통합

{% hint style="success" %}
참조 `EdgegapServerManager.cs`  Fusion 2와 Edgegap 통합 예시용 스크립트입니다.
{% endhint %}

{% hint style="warning" %}
당신의 `NetworkProjectConfig`  **는 다음을 사용해야 합니다. `Peer Mode = Single` (Ded. Server)**, 다음이 아니라 `Multiple` (Client-Host)!
{% endhint %}

게임 클라이언트는 다음을 통해 게임 서버에 연결합니다. [Photon Fusion 2 ](https://doc.photonengine.com/fusion/current/manual/connection-and-matchmaking/matchmaking#creating-and-joining-a-game-session)[세션(룸) ](https://doc.photonengine.com/fusion/current/manual/connection-and-matchmaking/matchmaking#creating-and-joining-a-game-session)[기능](https://doc.photonengine.com/fusion/current/manual/connection-and-matchmaking/matchmaking#creating-and-joining-a-game-session).

게임 서버는 호출 시 세션 이름과 함께 IP 주소 및 외부 포트를 등록해야 합니다. `_runnerInstance.StartGame(StartGameArgs args)`:

* 사용 `GameMode.Server`  를 사용해 연결이 Photon Cloud를 통해 릴레이되지 않도록 하세요(지연이 추가됨).
* 사용 `NetAddress.CreateFromIpPort` Fusion의 메서드,
* 서버의 IP 주소를 제공하세요:\
  `Environment.GetEnvironmentVariable("ARBITRIUM_PUBLIC_IP")`
* 서버의 외부 포트를 제공하세요:\
  `Environment.GetEnvironmentVariable("ARBITRIUM_PORT_GAMEPORT_EXTERNAL")`
  * 이것은 다음을 사용하는 경우의 기본 포트 매핑 이름입니다. [서버 패키징을 위한 Unity 플러그인](https://docs.edgegap.com/ko/unity.md).

Edgegap 배포 호스트 URL을 세션 이름으로 사용:

* 게임 서버에서는 다음을 통해 가져옵니다.\
  `$"{Environment.GetEnvironmentVariable("ARBITRIUM_REQUEST_ID")}.pr.edgegap.net"`
* 게임 클라이언트를 테스트할 때는 대시보드 - 배포 세부정보 페이지 / Host URL에서 가져오세요
  * 테스트용 배포를 생성하려면 다음을 사용하세요. [빠른 시작 호스팅 플러그인](https://docs.edgegap.com/ko/unity/developer-tools.md#dedicated-servers-quickstart-plugin),
* 게임 클라이언트에서 라이브 상태일 때는 다음에서 가져옵니다. [매치메이킹 / 티켓 할당 / fqdn](https://docs.edgegap.com/ko/learn/matchmaking/matchmaker-in-depth.md#player-api):
  * 또한 참조 [매치메이킹 시작하기](https://docs.edgegap.com/ko/learn/matchmaking.md).

{% tabs %}
{% tab title="클라이언트 통합" %}
{% code title="EdgegapClientManager.cs" collapsedlinecount="10" %}

```csharp
// fusion 2 네트워크 러너 가져오기
_runnerInstance = FindFirstObjectByType<NetworkRunner>();
_runnerInstance.ProvideInput = true;

// 이 값은 Edgegap Matchmaker Assignment 또는 Fusion 2 Sessions API에서 가져옵니다.
string sessionName = "<requestId.pr.edgegap.net>";

// fusion 2 세션 찾기(세션 이름 사용)
await _runnerInstance.StartGame(
    new StartGameArgs() {
        GameMode = GameMode.Client,
        SessionName = sessionName,
        ObjectProvider = _runnerInstance.GetComponent<NetworkObjectPoolDefault>(),
    }
);

// 이제 fusion이 세션 이름을 기반으로 서버 IP와 포트를 가져와 연결합니다
```

{% endcode %}
{% endtab %}

{% tab title="서버 통합" %}
{% code title="EdgegapServerManager.cs" collapsedlinecount="10" %}

```csharp
// edgegap이 주입한 환경 변수를 읽기
string requestId = Environment.GetEnvironmentVariable("ARBITRIUM_REQUEST_ID");
string listenPortStr = Environment.GetEnvironmentVariable("ARBITRIUM_PORT_GAMEPORT_INTERNAL");
string connectIP = Environment.GetEnvironmentVariable("ARBITRIUM_PUBLIC_IP");
string connectPort = Environment.GetEnvironmentVariable("ARBITRIUM_PORT_GAMEPORT_EXTERNAL");

// fusion 2 네트워크 러너 가져오기
_runnerInstance = FindFirstObjectByType<NetworkRunner>();
_runnerInstance.ProvideInput = true;

// StartGame에서 기대하는 ushort로 listen 포트 파싱
ushort.TryParse(listenPortStr, out ushort listenPort);

// 나중에 클라이언트가 찾을 수 있도록 fusion 2 세션 등록(세션 이름 사용)
await _runnerInstance.StartGame(
    new StartGameArgs() {
        GameMode = GameMode.Server,
        SessionName = $"{requestId}.pr.edgegap.net",
        ObjectProvider = _runnerInstance.GetComponent<NetworkObjectPoolDefault>(),
        Address = NetAddress.Any(listenPort),
        CustomPublicAddress = NetAddress.CreateFromIpPort(connectIP, connectPort),
    }
);

// 초기 씬 로드
if (result.Ok && _runnerInstance.IsServer) {
    await _runnerInstance.LoadScene(sceneName);
}
```

{% endcode %}
{% endtab %}
{% endtabs %}

### 🔌 직접 연결

Fusion의 `IP` 및 `포트` 서버의 주소를 설정하세요 **바인딩합니다** 에. 이 키트는 바인딩합니다 `0.0.0.0:7777`, Fusion이 배포의 공용 주소를 스스로 찾고, 클라이언트는 연결합니다 **직접** - Edgegap이 플레이어에게 다른 [외부 포트](https://docs.edgegap.com/ko/learn/orchestration/application-and-versions.md#port-mapping).

| 서버 `IP`          | 결과                                                                                  |
| ---------------- | ----------------------------------------------------------------------------------- |
| `0.0.0.0` (이 키트) | **직접** Edgegap에서.                                                                   |
| `127.0.0.1`      | 서버는 시작되지만, 클라이언트는 **릴레이됨** Photon을 통해 지연이 추가됩니다. 컨테이너 외부에서는 루프백 주소에 접근할 수 없습니다.     |
| 배포의 공용 IP        | 서버가 **시작되지 않습니다** (`소켓 바인딩 실패`), 컨테이너가 해당 주소를 소유하지 않기 때문입니다. 클라이언트는 `GameNotFound`. |

## 🚨 문제 해결

<details>

<summary><code>MethodAccessException ... CheckInvokeRpc</code> 서버 로그에서</summary>

* 서버가 Mono로 빌드되었습니다. IL2CPP로 다시 빌드하세요.

</details>

<details>

<summary><code>호스트 플랫폼에 대한 툴체인을 찾을 수 없음</code> 또는 <code>Linux sysroot를 찾을 수 없음</code></summary>

* Linux 툴체인 패키지가 없습니다. Window / Package Manager / + / Add package by name:에서 Unity의 Linux 툴체인을 추가하세요.
  * Unity 6000.3 이상: `com.unity.toolchain.win-x86_64-linux` 및 `com.unity.sdk.linux-x86_64`,
  * 이전 버전: `com.unity.toolchain.win-x86_64-linux-x86_64`.

</details>

<details>

<summary>클라이언트가 <code>GameNotFound</code></summary>

* 클라이언트와 서버 간의 App Version 또는 Photon 지역이 다릅니다. 서버의 다음 항목과 비교하세요. `photon_region=` 로그 라인.

</details>

<details>

<summary>클라이언트가 <code>InvalidAuthentication</code></summary>

* Fusion App ID가 잘못되었거나 빌드에 누락되었습니다.

</details>

<details>

<summary>탭 오버레이에 CT Relayed가 표시됨</summary>

* 서버는 바인딩합니다 `127.0.0.1`, 다음을 참조하세요 [직접 연결](#direct-connection).

</details>
