> 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/small-network-relay.md).

# Lightnet 소규모 네트워크 릴레이

Edgegap에서 작고 확장 가능한 네트워크 릴레이를 호스팅하고, Mirror, FishNet, PurrNet 또는 Netcode for Game Objects에서 이를 통해 Tanks를 플레이하세요. 방 코드 또는 Edgegap 매치메이킹을 사용할 수 있습니다.

Edgegap에서 자체 소형 네트워크 릴레이를 실행하는 방법을 알아보세요. 이 Unity 게임 샘플은 다음을 사용해 이를 통해 플레이합니다: [Mirror](https://mirror-networking.com/), [FishNet](https://fish-networking.gitbook.io/docs), [PurrNet](https://purrnet.dev/) 또는 [Netcode for GameObjects(NGO)](https://docs-multiplayer.unity3d.com/netcode/current/about/).

릴레이는 다음을 기반으로 구축된 작은 .NET 서버입니다: [LightNet](https://github.com/edgegap/server-sample-unity-smart-relays). Edgegap은 이를 다른 서버와 마찬가지로 호스팅하고 오케스트레이션합니다: 하나의 배포가 플레이어 가까이에서 시작됩니다. 한 플레이어가 방을 호스트하고 6자리 코드를 받으며, 다른 플레이어들은 그 코드로 참여합니다. 어떤 플레이어도 포트를 열지 않습니다. 호스트를 포함한 모두가 릴레이의 클라이언트입니다.

이 샘플은 다음을 보여줍니다:

* **릴레이 서버** 다음의 `linux/amd64` Docker 이미지로, 포트에서 수신합니다 `7777` TCP(신뢰성 메시지)와 UDP(비신뢰성 메시지) 모두에 대해,
* **참가 코드가 있는 방** - 여러 방이 하나의 릴레이 배포를 공유할 수 있습니다,
* **네 가지 네트코드에서의 Tanks 샘플** - 하나의 Unity 프로젝트, 하나의 빌드에서 Mirror, FishNet, PurrNet 및 NGO
* **네트코드를 전환하는 하나의 설정** - 설정 에셋, 에디터 메뉴, 게임 내 연결 전, 또는 명령줄에서
* **선택적 Edgegap 매치메이킹** - 기본적으로 꺼져 있습니다: **매치 찾기** 가까운 플레이어들을 그들 근처의 릴레이에 모으고, 방마다 한 명의 플레이어가 이를 호스트하며, 나중에 검색한 플레이어들은 실행 중인 방에 참여하고, 방이 가득 찬 릴레이는 다른 릴레이가 시작되기 전에 새 방을 엽니다,
* **선택적 암호화 연결** - `wss://` Edgegap의 TLS Upgrade를 통해, 일반 TCP 및 UDP와 함께,
* **자동화된 테스트** - 게임 클라이언트는 각 네트코드에서 릴레이를 통해, 방 코드 또는 매치메이커를 통해 플레이합니다.

{% hint style="success" %}
**이것은 클라이언트-호스트 구성입니다**: 호스트 플레이어의 게임이 서버로 실행되고 릴레이가 플레이어 간 바이트를 전달합니다.
{% endhint %}

{% hint style="info" %}
대안 - [전용 서버](https://docs.edgegap.com/ko/learn/orchestration/deployments.md#orchestration) 호스트 플레이어의 이점을 방지하고, 호스트가 나가도 매치가 지속됩니다.
{% endhint %}

## ✔️ 준비

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

* [Small Network Relay 샘플 프로젝트](https://github.com/edgegap/server-sample-lightnet-relay),
* [Unity `6000.0.54f1`](https://unity.com/releases/editor/archive), 게임을 열고 빌드하기 위해,
* [.NET 8 SDK](https://dotnet.microsoft.com/download/dotnet/8.0) (선택 사항), Docker 외부에서 릴레이를 실행할 때만 필요합니다.

<details>

<summary><a href="https://www.docker.com/products/docker-desktop/">Docker Desktop(또는 Docker CLI) 설치</a></summary>

* [공식 소스에서 Docker Desktop을 설치하세요](https://www.docker.com/products/docker-desktop/) (계정이 필요하지 않습니다).
* 설치를 완료한 후 컴퓨터를 다시 시작하세요.

</details>

저장소는 네 부분으로 구성됩니다:

| 폴더                       | 내용                                                             |
| ------------------------ | -------------------------------------------------------------- |
| `LightNet`               | Unity 패키지로 제공되는 LightNet 네트워킹 코어와 릴레이 프로토콜 및 네트코드에 독립적인 클라이언트. |
| `relay-server`           | Relay Server - 동일한 소스에서 빌드된 .NET 8 콘솔 앱과 그 Dockerfile.         |
| `tanks`                  | Unity 프로젝트: Mirror, FishNet, PurrNet 및 NGO용 Mirror의 Tanks 예제.  |
| `matchmaker-config.json` | 선택적 매치메이커 구성, 다음을 참조하세요: [선택적 매치메이킹](#optional-matchmaking).   |

## 🔀 네트코드 선택

네트코드는 다음의 `네트코드` 필드입니다: `tanks/Assets/Tanks/Resources/TanksSettings.asset`: `Mirror`, `FishNet`, `PurrNet` 또는 `NGO`. 같은 에셋에 릴레이 주소와 포트가 들어 있습니다.

또한 다음과 같이 전환할 수 있습니다:

* Unity 에디터에서 다음을 사용해 **Tanks > Netcode** 메뉴 - 이 작업은 해당 네트코드의 씬도 엽니다,
* 게임 내에서, 호스트 또는 참가 전에 화면 상단의 네트코드 버튼으로
* 명령줄에서 다음으로 `-netcode FishNet`.

| 네트코드    | 버전     | 탱크 동기화                                                                      |
| ------- | ------ | --------------------------------------------------------------------------- |
| Mirror  | 66.0.9 | `SyncVar`, `Command`, `ClientRpc`, 클라이언트 권한 `NetworkTransform`              |
| FishNet | 4.7.4  | `SyncVar<int>`, `ServerRpc`, `ObserversRpc`, 클라이언트 권한 `NetworkTransform`    |
| PurrNet | 1.24.1 | `SyncVar<int>`, `ServerRpc`, `ObserversRpc`, 소유자 권한 `NetworkTransform`      |
| NGO     | 1.13.0 | `NetworkVariable<int>`, `ServerRpc`, `ClientRpc`, 소유자 권한 `NetworkTransform` |

{% hint style="warning" %}
**호스트와 모든 플레이어는 같은 네트코드를 사용해야 합니다.** 릴레이는 네트코드 호환성을 확인하지 않습니다.
{% endhint %}

각 네트코드에는 동일한 릴레이 클라이언트를 기반으로 구축된 자체 릴레이 전송이 있습니다(`RelayPeer`): `MirrorRelayTransport`, `FishNetRelayTransport`, `PurrNetRelayTransport` 그리고 `NgoRelayTransport`. 자신의 게임에서 릴레이를 사용하려면 다음을 복사하세요: `LightNet` 패키지와 네트코드용 전송을.

## ⚡ 배포 및 연결

### 1. 릴레이를 로컬에서 실행하기

☑️ 저장소 루트에서 릴레이 이미지를 빌드하고 실행합니다:

{% code collapsedlinecount="10" %}

```bash
docker build --platform linux/amd64 -f relay-server/Dockerfile -t lightnet-relay:dev .
docker run -p 7777:7777/tcp -p 7777:7777/udp -p 7778:7778/tcp lightnet-relay:dev
```

{% endcode %}

☑️ 열기 `tanks` Unity에서 네트코드를 선택하고 다음으로 빌드합니다: **Tanks > Build Windows client**, 또는 다음에서 Play를 누릅니다: `Assets/Tanks/Scenes/Boot.unity`.

☑️ 첫 번째 게임에서 다음을 누릅니다: **호스트**: 방 코드가 화면에 표시됩니다. 두 번째 게임에서 코드를 입력하고 다음을 누릅니다: **방 참가**.

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

### 2. 릴레이 이미지 푸시하기

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

☑️ 다음을 찾으세요: [Container Registry](https://docs.edgegap.com/ko/learn/advanced-features/edgegap-container-registry.md) 프로젝트 이름과 자격 증명.

☑️ 레지스트리 프로젝트 이름, 사용자 이름, 토큰을 사용해 Docker로 Edgegap의 Container Registry에 로그인합니다:

{% tabs %}
{% tab title="Bash (리눅스)" %}

```bash
project='<REGISTRY_PROJECT>';
username='robot$<REGISTRY_ORGANIZATION_ID>+client-push';
token='<REGISTRY_TOKEN>';

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}

{% tab title="PowerShell (윈도우)" %}

```powershell
$project = '<REGISTRY_PROJECT>'
$username = 'robot$<REGISTRY_ORGANIZATION_ID>+client-push'
$token = '<REGISTRY_TOKEN>'

echo "$token" | docker login registry.edgegap.com -u "$username" --password-stdin 2>&1
```

{% endtab %}
{% endtabs %}

☑️ 매 빌드마다 새 태그를 사용해 릴레이 이미지를 태그하고 푸시합니다:

{% code collapsedlinecount="10" %}

```bash
docker tag lightnet-relay:dev registry.edgegap.com/<project>/lightnet-relay:<tag>
docker push registry.edgegap.com/<project>/lightnet-relay:<tag>
```

{% endcode %}

{% hint style="danger" %}
:x: **절대 하지 마세요 - 기존 태그를 덮어쓰거나 다음을 사용하지 마세요: `latest` 태그** - 이렇게 하면 오래된 캐시가 배포됩니다.\
:white\_check\_mark: **반드시 - 버전 태그를 항상 증가시키고** 새 빌드를 배포하세요.
{% endhint %}

{% hint style="warning" %}
각 조직은 자체 레지스트리 프로젝트를 받습니다, **자신의 프로젝트에 맞게 명령을 수정하세요.**
{% endhint %}

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

### 3. 앱 버전 만들기

☑️ [애플리케이션 만들기](https://app.edgegap.com/application-management/applications/list) 이름: `lightnet-relay`, 그리고 다음 설정의 버전:

* 이미지 `registry.edgegap.com/<project>/lightnet-relay` 그리고 태그,
* Edgegap이 이미지를 가져올 수 있도록 Container Registry 사용자 이름과 토큰,
* 리소스 0.25 vCPU 및 512 MB 메모리,
* 하나의 [포트](https://docs.edgegap.com/ko/learn/orchestration/application-and-versions.md) `7777`, 이름: `relay`, 프로토콜 **TCP/UDP**,
* 선택 사항, 다음에 사용: [암호화된 연결](#encrypted-connection): 두 번째 포트 `7778`, 이름: `relay-ws`, 프로토콜 **WS**, 다음과 함께 **TLS Upgrade** 활성화,
* [최대 기간](https://docs.edgegap.com/ko/learn/orchestration/application-and-versions.md) 테스트용 30분.

{% hint style="warning" %}
프로토콜이 다음인 하나의 포트 항목을 사용하세요: **TCP/UDP**, 분리된 `7777` TCP 및 `7777` UDP 항목이 아닙니다. 그러면 Edgegap이 TCP와 UDP에 동일한 외부 포트를 할당하므로 플레이어는 포트 번호 하나만 있으면 됩니다.
{% endhint %}

선택적 릴레이 설정, 다음과 같은 형태로 [앱 버전의 환경 변수로](https://docs.edgegap.com/ko/learn/orchestration/application-and-versions.md#injected-variables):

| 변수                        | 기본값    | 기능                                                                       |
| ------------------------- | ------ | ------------------------------------------------------------------------ |
| `RELAY_TCP_PORT`          | `7777` | 신뢰성 메시지용 포트                                                              |
| `RELAY_UDP_PORT`          | `7777` | 비신뢰성 메시지용 포트                                                             |
| `RELAY_MAX_PEERS`         | `256`  | 모든 방을 합친 최대 동시 연결 수                                                      |
| `RELAY_IDLE_EXIT_SECONDS` | `600`  | 이 시간 동안 어떤 방도 없으면 릴레이를 중지합니다, `0` = 없음(매치메이커가 시작한 릴레이는 마지막 방이 끝나면 중지됩니다) |
| `RELAY_WS_PORT`           | `7778` | WebSocket 연결용 포트, `0` = 끔                                                |
| `RELAY_MATCH_MAX_PLAYERS` | `4`    | 매치메이커가 시작한 릴레이의 방당 플레이어 수; 백필은 이 수까지 채웁니다                                |
| `RELAY_MAX_ROOMS`         | `4`    | 매치메이커가 시작한 릴레이당 방 수                                                      |
| `RELAY_SOLO_ROOM_SECONDS` | `120`  | 호스트가 이 시간 동안 혼자인 방을 닫습니다. 그러면 게임이 다시 검색합니다                               |
| `MATCHMAKER_URL`          |        | 매치메이커 API URL, 다음에 사용: [백필](#optional-matchmaking)                       |
| `MATCHMAKER_TOKEN`        |        | 매치메이커 인증 토큰, 백필용                                                         |

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

### 4. 배포하고 플레이하기

☑️ [새 앱 버전을 배포하세요](https://app.edgegap.com/deployment-management/deployments/create) 플레이어 근처에. 준비되면 호스트 이름을 기록하세요(`<id>.pr.edgegap.net`)와 다음의 외부 포트 `relay`.

☑️ 두 게임 모두에서, **연결 전에 화면에서 릴레이 주소와 포트를 설정하세요**, 또는 명령줄에서 시작합니다(대안):

{% code collapsedlinecount="10" %}

```bash
Tanks.exe -netcode NGO -relay <id>.pr.edgegap.net -relayPort <external port> -host
Tanks.exe -netcode NGO -relay <id>.pr.edgegap.net -relayPort <external port> -join <code>
```

{% endcode %}

☑️ 첫 번째 게임에서 방을 호스트하고 두 번째 게임의 코드로 참여하세요.

{% hint style="info" %}
릴레이 로그에는 배포가 시작되자마자 연결했다가 나가는 플레이어가 표시됩니다. 이는 플레이어가 아니라 Edgegap의 준비 상태 확인입니다.
{% endhint %}

<figure><img src="https://1562312210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2Fz9xjzvZwKSIp9IeC9qo8%2Fimage.png?alt=media&amp;token=e3f345ac-848d-4469-b66f-3655cd393cf3" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Edgegap 클라우드에서 배포의 외부 포트는 임의로 선택되어 잠재적 공격자(해커)가 피해를 일으키기 전에 속도가 느려지고 탐지되도록 합니다.
{% endhint %}

{% hint style="warning" %}
**테스트 시 VPN 비활성화** 보다 현실적인 조건을 위해 그리고 [저지연 배포를 받으려면](https://docs.edgegap.com/ko/learn/orchestration/deployments.md#server-placement).
{% endhint %}

☑️ 배포에 문제없이 연결할 수 있음을 확인하고 테스트를 마쳤다면, **배포 중지** 다음 빌드를 위해 계정의 용량을 확보하려면.

* 문제가 발생한 경우, [배포의 대시보드 로그를 검사하세요](https://app.edgegap.com/deployment-management/deployments/list).
* 문제를 해결할 수 없다면, 저희는 [커뮤니티 디스코드](https://discord.gg/NgCnkHbsGp) 에서 도와드릴 수 있으며 기꺼이 지원하겠습니다.

🙌 Edgegap에서의 첫 배포를 축하합니다! 더 알아보고 싶다면 계속 읽어보세요.

## 🎯 선택적 매치메이킹

방 코드는 친구들끼리 사용할 수 있습니다. 서로 모르는 플레이어를 매칭하려면 Edgegap을 켜세요 [매치메이킹](https://docs.edgegap.com/ko/learn/matchmaking.md): 플레이어가 다음을 누르면 **매치 찾기**, 매치메이커가 서로 가까운 2\~4명의 플레이어를 그룹화하고 그들의 매치를 위한 릴레이를 가까운 곳에서 시작합니다. 그러면 릴레이가 한 플레이어를 호스트로 선택하고 나머지에게 방 코드를 주어 아무도 코드를 입력하지 않게 합니다. 다음을 누른 플레이어들은 **매치 찾기** 나중에 빈 자리가 있는 방에 참여하고, 방이 가득 찬 릴레이는 매치메이커가 다른 릴레이를 시작하기 전에 새 방을 엽니다. 기본적으로 꺼져 있으며, 코드로 호스트하고 참여하는 기능은 옆에서 계속 작동합니다.

매치가 시작되는 방법:

1. 각 플레이어의 게임은 Edgegap의 비콘까지의 지연 시간을 측정하고 매치메이킹 티켓을 만듭니다.
2. 매치메이커가 티켓을 그룹화하고 앱 버전에서 릴레이를 배포합니다. Edgegap은 그 릴레이에 매칭된 티켓 목록을 제공합니다(`MM_TICKET_IDS`).
3. 각 게임은 자신의 티켓 ID로 릴레이에 연결합니다. 요청한 첫 번째 매칭 플레이어가 매치 방을 호스트하고, 나머지는 그 방에 참여합니다. 매치에 포함되지 않은 티켓은 거부됩니다.
4. 방에 빈 자리가 있는 동안 릴레이는 매치메이커에 백필로 추가 플레이어를 요청합니다. 모든 방이 꽉 차면 대신 새 방을 제공합니다. 아래의 3단계를 참조하세요.
5. 마지막 방이 끝나면 릴레이는 백필을 삭제하고 자체 배포를 중지하므로 종료된 매치에 비용이 들지 않습니다.

매치메이커 없이 배포된 릴레이는 이전과 같이 방 코드로 동작합니다.

### 1. 매치메이커 만들기

☑️ 열기 `matchmaker-config.json` 저장소에서 다음을 설정하고 `application.name` 그리고 `version` 3단계의 앱 버전으로 설정합니다:

{% code title="matchmaker-config.json" lineNumbers="true" expandable="true" collapsedlinecount="10" %}

```json
{
  "version": "3.3.3",
  "inspect": true,
  "max_deployment_retry_count": 3,
  "profiles": {
    "casual": {
      "ticket_expiration_period": "30s",
      "ticket_removal_period": "1m",
      "group_inactivity_removal_period": "5m",
      "application": {
        "name": "lightnet-relay",
        "version": "<your version>"
      },
      "rules": {
        "initial": {
          "match_size": {
            "type": "player_count",
            "attributes": {
              "team_count": 1,
              "min_team_size": 9999,
              "max_team_size": 9999
            }
          },
          "beacons": {
            "type": "latencies",
            "attributes": {
              "difference": 100,
              "max_latency": 150
            }
          }
        },
        "expansions": {
          "10": {
            "match_size": {
              "team_count": 1,
              "min_team_size": 2,
              "max_team_size": 4
            }
          }
        }
      }
    }
  }
}
```

{% endcode %}

티켓은 처음 10초 동안 방이 있는 릴레이에만 참여할 수 있습니다(`min_team_size` `9999` 충족할 수 없음). 10초 후에는 일반 규칙이 적용되며, 대기 중인 2\~4명의 플레이어가 새 릴레이를 받습니다.

다음 `비콘` 규칙은 플레이어를 가까운 플레이어들과 함께 유지합니다. 플레이어의 해당 비콘까지의 지연 시간이 150ms 미만이면 비콘이 카운트되며, 매칭된 플레이어들의 해당 비콘 지연 시간은 서로 100ms 이내여야 합니다. 게임은 모든 티켓에 지연 시간을 보냅니다(**매치메이커 지연 시간 비콘** 다음에 `TanksSettings.asset`, 기본적으로 켜져 있습니다).

{% hint style="warning" %}
**브라우저는 비콘에 ping을 보낼 수 없습니다.** WebGL 빌드의 경우 다음이 없는 프로필을 사용하세요: `비콘` 규칙을 사용하지 말고 다음을 끄세요: **매치메이커 지연 시간 비콘** 끔.
{% endhint %}

☑️ 대시보드에서 다음을 엽니다: [매치메이커](https://app.edgegap.com/matchmaker-management-v2/matchmakers/list), 클릭합니다: **매치메이커 만들기**, 파일을 업로드한 다음 **Create and Start**.

☑️ 매치메이커가 **온라인**, 다음을 복사하세요: **API URL** 그리고 **Auth Token**.

{% hint style="info" %}
Auth Token은 게임에 포함해도 안전합니다. 플레이어가 티켓을 만들 수 있게 해 주지만 Edgegap 계정에는 접근 권한을 주지 않습니다.
{% endhint %}

☑️ 이를 앱 버전에 환경 변수로 추가하세요 `MATCHMAKER_URL` 그리고 `MATCHMAKER_TOKEN`, 그래야 릴레이가 빈 자리를 채울 수 있습니다(3단계).

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

### 2. 매치 찾기

☑️ 다음에서 `tanks/Assets/Tanks/Resources/TanksSettings.asset`, 다음을 켭니다: **매치메이커 사용** 를 켜고 다음을 붙여넣습니다: **매치메이커 URL** 그리고 **매치메이커 토큰**. 프로필(`casual`)과 포트 이름(`relay`)은 이미 위의 구성과 일치합니다.

☑️ 게임을 빌드하고 두 개를 실행한 다음 다음을 누릅니다: **매치 찾기** 두 개 모두에서. 또는 명령줄에서 시작합니다:

{% code collapsedlinecount="10" %}

```bash
Tanks.exe -netcode NGO -matchmaker https://<id>.edgegap.net -matchmakerToken <token> -findMatch
```

{% endcode %}

☑️ 두 게임 모두 매치 상태를 보여주고, 그다음 한쪽이 호스트하고 다른 쪽이 참여합니다. 두 게임 모두에 탱크가 표시됩니다.

{% hint style="warning" %}
**두 플레이어로 테스트하세요.** 매치에는 최소 2명의 플레이어가 필요하므로 단일 티켓은 계속 검색하다가 30초 후 만료됩니다.
{% endhint %}

매치메이킹 클라이언트는 `Assets/Tanks/Core/TanksMatchmaker.cs`, 다음을 기반으로 구축되었습니다: [Edgegap Unity SDK](https://github.com/edgegap/sdk-unity-sessions-matchmaker-server-browser). 네트코드에 의존하지 않습니다. 설정에 릴레이 주소를 넣고 다음과 같이 게임을 호스트 또는 플레이어로 시작합니다: **호스트** 그리고 **방 참가** 버튼처럼.

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

### 3. 하나의 릴레이, 여러 방

매치메이커가 시작한 릴레이는 첫 매치가 시작된 후에도 백필을 통해 계속 작동합니다. 백필은 릴레이가 소유한 티켓으로, 자체 주소를 담고 있습니다. 매치메이커가 플레이어의 티켓을 그 안에 넣으면, 해당 플레이어는 릴레이의 주소를 받고 다른 플레이어들과 마찬가지로 자신의 역할을 요청한 뒤 방에 참여하거나 호스트합니다. 게임에는 추가로 필요한 것이 없습니다. 이는 동일한 **매치 찾기** 흐름입니다.

* **빈 자리가 있는 방이 우선입니다.** 방의 인원이 다음보다 적은 동안 `RELAY_MATCH_MAX_PLAYERS` (기본값 `4`)명의 플레이어가 방 안에 있거나 오는 중일 때, 릴레이는 그 방에 대해 최대 3개의 백필을 열어 둡니다. 거기에 배치된 플레이어는 해당 방에 참여합니다.
* **그다음 새 방들.** 모든 방이 가득 차고 릴레이에 다음보다 적은 수의 `RELAY_MAX_ROOMS` (기본값 `4`)개의 방이 남아 있으면, 새 방 하나를 제공합니다. 그곳에 배치된 플레이어가 호스트가 되고, 방은 다른 방들과 마찬가지로 채워집니다.
* **가까운 플레이어만.** 릴레이는 백필과 함께 그 방의 플레이어들의 티켓을 보내므로, `비콘` 규칙이 새 플레이어를 그것들과 대조해 확인합니다.
* **홀로 남겨진 호스트는** 동안 `RELAY_SOLO_ROOM_SECONDS` (기본값 `120`)에게 방이 닫혔다는 알림이 가고, 게임은 자동으로 다른 매치를 찾습니다.
* **릴레이는 마지막 방이 끝날 때 중지됩니다**, 호스트 하나가 떠날 때가 아닙니다. 먼저 백필을 삭제하므로, 사라진 릴레이로 플레이어가 전송되지 않습니다.
* **속도 제한.** 릴레이당 최대 5개의 백필이 열려 있으며, 생성 간격은 최소 0.3초입니다.

☑️ 두 게임 사이에서 매치가 진행 중일 때, 다음을 누르세요 **매치 찾기** 세 번째 게임에서 누르면: 진행 중인 방에 참여하며, 세 게임 모두 탱크 3대를 보게 됩니다.

☑️ 4개 게임으로 방을 채운 다음, 다음을 누르세요 **매치 찾기** 두 개 더에서: 첫 번째는 같은 릴레이에서 새 방을 호스트하고, 두 번째는 그 방에 참여합니다.

{% hint style="info" %}
없으면 `MATCHMAKER_URL` 그리고 `MATCHMAKER_TOKEN` 앱 버전에 적용되지 않으면, 릴레이는 다음을 기록합니다 `백필: 끔`: 방은 새 플레이어를 받지 않으며 새 방도 열지 않습니다.
{% endhint %}

릴레이의 백필 코드는 다음에 있습니다 `relay-server/MatchBackfill.cs` 그리고 `relay-server/RelayServer.cs`.

## 🔒 암호화된 연결

기본적으로 릴레이를 통과하는 게임 트래픽은 **암호화되지 않습니다**: 일반 TCP와 UDP로 전송됩니다. 플레이어를 보호하는 것은 다른 플레이어의 IP 주소를 아무도 볼 수 없다는 점이며, 매치메이커에서는 매칭된 플레이어만 방 코드가 제공된다는 점입니다. 매치메이커 호출은 HTTPS를 사용합니다.

암호화를 위해 플레이어는 대신 WebSocket으로 연결할 수 있습니다. 다음과 같이 하면 **TLS Upgrade** 포트에서 `relay-ws` 포트(3단계), Edgegap이 인증서를 보유하며 연결은 `wss://`: 각 플레이어와 Edgegap 사이의 트래픽이 암호화되며, 릴레이에는 인증서가 필요하지 않습니다.

☑️ 게임에 다음을 제공하세요 `wss://` 호스트 이름 대신 릴레이 주소를, 다음의 외부 포트와 함께 `relay-ws`: 화면에서, `TanksSettings.asset` 또는 명령줄에서:

{% code collapsedlinecount="10" %}

```bash
Tanks.exe -netcode NGO -relay wss://<id>.pr.edgegap.net:<relay-ws external port> -host
```

{% endcode %}

☑️ 매치메이커에서는 다음을 켜세요 **매치메이커 Web Socket 사용** 다음에 `TanksSettings.asset` (또는 `-matchmakerWebSocket`): 게임이 매치 릴레이의 `relay-ws` 포트에 연결합니다.

{% hint style="warning" %}
**WebSocket은 TCP에서만 실행됩니다**: "비신뢰성" 메시지는 신뢰성 있게 순서대로 도착하므로, 연결이 좋지 않을 때 지연이 늘어납니다. 이는 빠른 슈팅 게임보다 협동 및 턴제 게임에 더 적합하므로, TCP와 UDP 옆의 하나의 옵션입니다. TCP와 UDP의 플레이어와 WebSocket의 플레이어가 같은 방을 공유할 수 있습니다.
{% endhint %}

{% hint style="info" %}
호스트 이름(`<id>.pr.edgegap.net`), IP 주소가 아니라 연결하세요: 인증서는 호스트 이름용입니다. 암호화는 Edgegap에서 끝납니다. 릴레이와 호스트의 게임은 다른 릴레이와 마찬가지로 전달하는 내용을 여전히 볼 수 있습니다.
{% endhint %}

## 🌐 브라우저에서 플레이

게임의 WebGL 빌드는 같은 릴레이를 통해 다음으로 플레이합니다 `wss://`. 브라우저의 플레이어는 네 가지 네트코드 모두에서 방을 호스트하거나 참가할 수 있으며, 데스크톱 빌드의 플레이어와 공유할 수 있습니다.

브라우저에는 TCP 또는 UDP 소켓이 없고, WebGL 빌드에는 .NET이 없습니다 `ClientWebSocket` 그리고 스레드도 없습니다. 따라서 WebGL 빌드에서는 샘플의 LightNet이 작은 브리지인 브라우저 자체의 WebSocket을 사용합니다, `LightNet/Runtime/Relay/RelayWebSocket.jslib`. 네트코드 전송 방식은 데스크톱과 동일합니다.

☑️ Unity에서 다음을 선택하세요 **Tanks > Build WebGL client**. 빌드는 다음 위치로 생성됩니다 `tanks/Builds/WebGL`, 압축되지 않으므로 어떤 정적 파일 서버로도 제공할 수 있습니다.

☑️ 릴레이의 다음을 포함한 페이지를 여세요 `wss://` URL의 주소를 사용하고, 다음의 외부 포트를 사용하세요 `relay-ws`. WebGL 빌드에는 명령줄이 없으므로, 페이지 주소에서 동일한 옵션을 읽습니다. 릴레이 필드와 **호스트** 그리고 **방 참가** 화면의 버튼도 작동합니다.

{% code collapsedlinecount="10" %}

```
index.html?netcode=FishNet&relay=wss://<id>.pr.edgegap.net:<relay-ws external port>&host
index.html?netcode=FishNet&relay=wss://<id>.pr.edgegap.net:<relay-ws external port>&join=<room code>
```

{% endcode %}

{% hint style="warning" %}
**호스트의 탭을 앞에 두세요.** 브라우저는 백그라운드 탭의 페이지를 일시 중지하므로, 브라우저에서 호스트된 방은 탭이 숨겨져 있는 동안 멈춥니다. 데스크톱 빌드가 더 안정적인 호스트를 만듭니다.
{% endhint %}

{% hint style="info" %}
HTTPS로 제공되는 페이지는 다음만 열 수 있습니다 `wss://`, 다음은 아니고 `ws://`. 브라우저에서는 모든 트래픽이 다른 WebSocket 연결과 마찬가지로 신뢰성 있게 순서대로 전달됩니다. 매치메이커를 사용할 때 브라우저는 비콘에 ping을 보낼 수 없으므로, 다음이 없는 프로필을 사용하세요 `비콘` 규칙.
{% endhint %}

## 🧪 자동화 테스트

Windows 빌드와 실행 중인 릴레이(로컬 또는 Edgegap)가 있으면, `e2e.sh` 각 네트코드에서 호스트와 클라이언트를 시작합니다:

{% code collapsedlinecount="10" %}

```bash
./e2e.sh <id>.pr.edgegap.net <external port>
./e2e.sh 127.0.0.1 7777 FishNet NGO
./e2e.sh wss://<id>.pr.edgegap.net:<relay-ws external port> 0
```

{% endcode %}

클라이언트가 이동하고 발사합니다. 두 게임 모두 탱크 2대를 보고, 둘 다 신뢰성 및 비신뢰성 채널에서 데이터를 수신하고, 둘 다 발사체 생성이 보이고, 호스트가 클라이언트의 탱크가 움직이는 것을 보면 해당 네트코드는 통과입니다.

매치메이커를 사용하면, `e2e-matchmaker.sh` 이를 통해 같은 테스트를 실행합니다: 각 네트코드에서 두 게임이 다음을 누르고 **매치 찾기** 매치메이커가 시작한 릴레이에서 매치를 플레이합니다. 다음과 같이 하면 `BACKFILL=1`, 세 번째 게임이 다음을 누르고 **매치 찾기** 매치가 시작되면 참여해야 하며 백필을 통해 들어가야 합니다. 다음과 같이 하면 `MULTIROOM=1`, 네 게임이 한 방을 채우고, 다섯 번째가 같은 릴레이에서 새 방을 호스트해야 하며 여섯 번째가 그 방에 참여해야 합니다. 다음과 같이 하면 `MM_WEBSOCKET=1`, 게임은 다음을 통해 연결됩니다 `wss://`.

{% code collapsedlinecount="10" %}

```bash
./e2e-matchmaker.sh https://<id>.edgegap.net <token>
./e2e-matchmaker.sh https://<id>.edgegap.net <token> FishNet NGO
BACKFILL=1 ./e2e-matchmaker.sh https://<id>.edgegap.net <token>
MM_WEBSOCKET=1 BACKFILL=1 ./e2e-matchmaker.sh https://<id>.edgegap.net <token>
MULTIROOM=1 ./e2e-matchmaker.sh https://<id>.edgegap.net <token>
```

{% endcode %}

## 💡 알아두면 좋은 점

* **릴레이가 데이터를 전달하는 방식** - 호스트의 메시지는 한 플레이어에게만 가고, 각 플레이어의 메시지는 호스트에게만 갑니다. 플레이어끼리는 직접 통신하지 않습니다. 신뢰성 메시지는 TCP로, 비신뢰성 메시지는 UDP로 전달되며, 또는 둘 다 하나의 WebSocket으로 전달됩니다.
* **메시지 크기** - 비신뢰성 메시지는 최대 1,177바이트, 신뢰성 메시지는 최대 16KB입니다. 전송 계층은 이러한 제한을 네트코드에 보고합니다.
* **호스트가 떠날 때** - 방이 닫히고 릴레이가 플레이어들의 연결을 끊습니다. 이 샘플의 네트코드는 호스트를 이전하지 않습니다.
* **하나의 릴레이 또는 여러 개** - 플레이어가 방 코드를 사용할 때 하나의 배포로 많은 방을 서비스합니다. 다음과 같이 하면 [매치메이커](#optional-matchmaking), 각 릴레이는 최대 `RELAY_MAX_ROOMS` 개의 방을 플레이어 가까이에 호스팅하며, 가까운 릴레이가 모두 찼을 때만 새 릴레이가 시작됩니다.
* **LightNet의 변경 사항** - 샘플의 LightNet은 NAT 및 포트 매핑 뒤에서도 작동합니다: 릴레이는 각 플레이어의 UDP 트래픽에 그 트래픽이 들어온 주소로 응답합니다. 전체 목록은 저장소의 README를 참조하세요.
