> 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/fishnet-on-edgegap-webgl.md).

# Fishnet WebGL

FishNet의 Bayou WebSocket 전송을 사용해 Edgegap 게임 서버에서 Unity WebGL 멀티플레이어 게임을 실행하세요.

이 가이드는 다음을 사용하는 데 도움이 됩니다 [FishNet](https://github.com/FirstGearGames/FishNet)의 Websocket Transport, [Bayou](https://fish-networking.gitbook.io/docs/manual/components/transports/bayou), 그리고 Unity 프로젝트용 Edgegap에 헤드리스 서버를 생성합니다.

다음을 찾을 수 있습니다 [최종 예제 프로젝트](https://github.com/edgegap/netcode-game-sample-unity-fishnet-hashgrid) GitHub에서 다음 아래에 `Fishnet_v4.1.6R_WebGL_Matchmaker` 폴더에서 찾을 수 있습니다. 이 가이드는 Bayou의 적절한 버전만 사용한다면 어떤 Fishnet 버전에서도 작동해야 합니다.

그 `게임 시작` 샘플의 버튼에는 두 가지 모드가 있으며, 다음에서 선택됩니다 `MatchmakingSystem` 다음의 gameObject에서 `MainMenu` 씬:

* **직접 연결(기본값)** - 클라이언트는 사용자가 설정한 서버 주소와 포트에 연결합니다. 먼저 로컬 서버로 테스트한 다음, Edgegap 대시보드에서 시작한 배포로 테스트하세요. 매치메이커는 필요하지 않습니다.
* **Edgegap 매치메이커(선택 사항, 기본적으로 비활성화됨)** - [Edgegap Matchmaker](https://docs.edgegap.com/ko/learn/matchmaking.md) 플레이어를 그룹화하면 Edgegap이 그들 근처에 전용 서버를 시작하고, 모든 클라이언트가 자동으로 그 서버에 연결합니다.

{% hint style="info" %}
두 모드 모두에서, **게임 클라이언트는 Edgegap API 토큰을 절대 보유하지 않습니다**. 매치메이커 모드에서는 매치메이커의 `인증 토큰`, 이것은 게임 클라이언트에 포함해 배포해도 안전합니다. 서버는 매치가 비면 자체 배포를 중지합니다.
{% endhint %}

### Unity 요구 사항

이 프로젝트는 Unity 버전 `2021.3.45f2`및 FishNet `4.1.6R`, Bayou 전송 및 Edgegap Unity SDK에서 테스트되었습니다. 함께 설치해야 하는 다음 모듈이 필요합니다:

* WebGL 빌드 지원;
* Linux 전용 서버 빌드 지원;
* Linux 빌드 지원(Mono).

또한 다음이 필요합니다 [Docker](https://docs.docker.com/get-docker/) 서버를 컨테이너화하기 위해서.

{% hint style="warning" %}
샘플에는 Edgegap Unity SDK `3.5.6` 이상 버전이 필요합니다. Unity 2022.3 이전에는 SDK `3.5.5` 및 그 이전 버전은 POST 요청의 JSON 본문을 폼 인코딩하며, 매치메이커는 모든 티켓 요청에 HTTP 400으로 응답합니다. 샘플의 `Packages/manifest.json` SDK의 `main` 브랜치를 추적합니다. 대신 태그를 고정했다면 `#3.5.6` 이상 버전을 사용하세요.
{% endhint %}

### 전송 방식을 전환합니다

샘플은 이미 포트에서 Bayou를 사용합니다 `7770`. 자신의 프로젝트에서 동일하게 하려면 다음을 다운로드하세요 [Bayou Unity 패키지](https://github.com/FirstGearGames/Bayou/releases) 를 GitHub 릴리스에서 가져오세요. 게임 프로젝트에서 다음 아래의 툴바로 패키지를 가져옵니다 `Asset/Import Package/Custom Package...`.

다음을 엽니다 `MainMenu` 다음 아래에 있는 씬을 `Assets/SpaceEdge/Scenes`. 다음에서 `NetworkManager` gameObject에서 다음을 제거합니다 `Tugboat` 전송 컴포넌트입니다. 이를 다음으로 교체합니다 `Bayou` 다음 아래에 있는 전송으로 `Assets/FishNet/Plugins/Bayou`. 설정된 포트 값을 기록해 두세요. 이 경우 `7770`.

FishNet의 `Start On Headless` 옵션은 필요 없으며, 샘플에서도 꺼져 있습니다. 서버 빌드에서는 다음 `EdgegapServerLifecycle` 컴포넌트(다음 아래에 있는 `Assets/Edgegap`)가 FishNet 서버를 시작합니다 `0.0.0.0:7770`, 따라서 동일한 씬이 클라이언트와 서버 빌드 모두에서 작동합니다. Edgegap에서는 120초 안에 아무도 참가하지 않거나 마지막 플레이어가 떠난 후 30초가 지나면 배포도 중지합니다.

### 게임 서버 빌드 및 컨테이너화

다음을 사용해 서버를 빌드합니다 `Tools/Edgegap/Build Linux Dedicated Server` 툴바 메뉴입니다. 출력은 다음으로 저장됩니다 `Builds/EdgegapServer/`, 이를 샘플의 `Dockerfile` 가 이미지에 복사합니다.

로컬에서 테스트하려면 Docker에서 실행하세요:

{% code collapsedlinecount="10" %}

```bash
docker build --platform linux/amd64 -t fishnet-server:local .
docker run -p 7770:7770 fishnet-server:local
```

{% endcode %}

로그에는 다음이 표시됩니다 `Edgegap Server | 0.0.0.0:7770에서 서버 시작 중.` 및 `Edgegap에서 실행 중이 아니므로 자동 중지가 비활성화되었습니다.`

### 클라이언트 테스트

#### 에디터에서 또는 로컬에서

WebGL 클라이언트 빌드를 만듭니다(다음 참조 [Itch.io에서](#on-itch.io) 빌드 설정을 확인하세요), 또는 명령줄에서 빌드하세요:

{% code collapsedlinecount="10" %}

```bash
Unity -batchmode -quit -projectPath . -executeMethod EdgegapServerBuild.BuildClient -edgegapClientTarget webgl
```

{% endcode %}

제공 `Builds/Client/webgl` (예를 들어 다음으로 `python -m http.server 8080`), 연 다음 `http://localhost:8080` 두 탭에서 연 다음, 다음을 클릭합니다 `게임 시작`. `MatchmakingSystem` 기본값(`직접 주소` 다음으로 설정 `localhost`, `직접 포트` 다음으로 설정 `7770`, `직접 WSS 사용` 끔)은 로컬 서버에 연결합니다. 데스크톱 빌드(`-edgegapClientTarget win64`)도 작동합니다. Bayou가 네이티브 클라이언트를 지원하기 때문입니다.

#### Edgegap 서버에서

이미지를 다음으로 푸시합니다 [컨테이너 레지스트리](https://docs.edgegap.com/ko/learn/advanced-features/edgegap-container-registry.md#getting-your-credentials). 레지스트리 프로젝트, 사용자 이름 및 토큰은 대시보드의 `컨테이너 레지스트리` 페이지의 사용자 이름과 토큰을 사용하세요.

{% 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 build --platform linux/amd64 -t registry.edgegap.com/<project>/fishnet-server:v1 .
docker push registry.edgegap.com/<project>/fishnet-server:v1
```

{% endcode %}

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

다음의 [Edgegap 대시보드](https://app.edgegap.com/application-management/applications/list), 해당 이미지에 대한 애플리케이션과 버전을 만듭니다:

* [포트](https://docs.edgegap.com/ko/learn/orchestration/application-and-versions.md#port-mapping): 이름 `gameport`, 포트 `7770`, 프로토콜 `WS`, `TLS 업그레이드` 활성화합니다. Edgegap이 TLS를 종료하므로 브라우저는 다음으로 연결합니다 `wss://` 반면 서버는 일반 `ws` (다음 참조 [웹소켓(WS) 및 보안 웹소켓(WSS)](https://docs.edgegap.com/ko/learn/orchestration/deployments.md#websockets-ws-and-secure-websockets-wss)).
* 컨테이너 레지스트리 사용자 이름 및 토큰: 반드시 설정하세요. 그렇지 않으면 배포가 이미지를 가져오지 못합니다.

대시보드에서 버전을 배포합니다. 다음에서 `MatchmakingSystem` gameObject에서 다음을 설정합니다 `직접 주소` 배포의 호스트로(`<id>.pr.edgegap.net`), `직접 포트` 를 외부 포트로 설정하고 다음을 활성화합니다 `직접 WSS 사용`. 클라이언트를 다시 빌드한 후 다음을 클릭합니다 `게임 시작`.

#### Edgegap 매치메이커 사용(선택 사항)

직접 연결이 작동하면 매치메이커를 켭니다:

1. 샘플의 `matchmaker-config.json`, 다음을 설정합니다 `application.name` 및 `버전` 를 애플리케이션과 버전에 맞추고, WebGL 빌드를 제공하는 모든 출처를 다음에 나열합니다 [`allowed_cors_origins`](https://docs.edgegap.com/ko/learn/matchmaking/matchmaker-in-depth.md#cross-origin-resource-sharing-cors).
2. 대시보드에서 다음을 엽니다 [Matchmaker](https://app.edgegap.com/matchmaker-management-v2/matchmakers/list), 클릭 `매치메이커 만들기`, 파일을 업로드한 다음 다음을 클릭합니다 `만들기 및 시작`.
3. 다음의 `MainMenu` 씬에서 매치메이커의 `API URL` 및 `인증 토큰` 를 다음에 복사합니다 `Base Url` 및 `인증 토큰` 필드에 `Edgegap Matchmaking Client` 다음의 컴포넌트를 `Edgegap` gameObject에 둡니다. 그런 다음 다음을 활성화합니다 `Edgegap 매치메이커 사용` relay-ws `MatchmakingSystem` gameObject.
4. 클라이언트를 다시 빌드한 다음, 다음에 나열된 출처에서 제공합니다 `allowed_cors_origins` (예를 들어 `http://localhost:8080`), 두 탭을 열고 다음을 클릭합니다 `게임 시작` 를 누르세요.

클라이언트는 티켓을 생성하고 서버가 할당되기를 기다린 다음 다음으로 연결합니다 `wss://`. `캐주얼` 프로필은 2\~4명의 플레이어와 일치합니다. 또한 30초 후 최소 인원을 1명으로 낮추지만, 혼자 있는 플레이어는 티켓 만료 5분이 가까워질 때서야 서버를 받을 수 있으므로 두 클라이언트로 테스트하세요.

새 서버 빌드를 배포하려면: 서버를 빌드하고, 새 태그를 푸시하고, 새 앱 버전을 만든 다음, 매치메이커에서 다음을 클릭합니다 `중지`, 편집한 다음 `application.version` 그리고 다음을 클릭합니다 `시작` (다음 참조 [롤링 업데이트](https://docs.edgegap.com/ko/learn/matchmaking/matchmaker-in-depth.md#rolling-updates-and-ab-tests)).

{% hint style="info" %}
WebGL 클라이언트는 다음을 핑할 수 없습니다 [지연 시간 비콘](https://docs.edgegap.com/ko/learn/orchestration/ping-beacons.md), 따라서 샘플의 매치메이커 프로필에는 다음이 없습니다 `지연 시간` 규칙이 없으며, Edgegap은 플레이어의 IP 주소를 기반으로 서버를 배치합니다. 다음을 참조하세요 [매치메이킹](https://docs.edgegap.com/ko/learn/matchmaking.md) 자세한 내용을 알아보세요.
{% endhint %}

#### Itch.io에서

게임 클라이언트가 로컬에서 작동하는 것을 확인했다면 Itch.io에서도 작동해야 합니다. 거기에 게임을 업로드하려면 다음에서 클라이언트 빌드를 만들어야 합니다 `빌드` Unity 에디터 화면에서, `File -> Build Settings`. 다음 옵션을 선택하세요:

* 설정하세요 `플랫폼` 다음으로 `WebGL`;
* 다음을 엽니다 `플레이어 설정`. 다음에서 `플레이어 -> 퍼블리싱 설정`, 다음을 설정합니다 `압축 형식` 다음으로 `Gzip` 그리고 다음이 `Decompression Fallback` 옵션이 선택되어 있는지 확인합니다. 이 설정을 저장하고 창을 닫습니다.

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

그런 다음 빌드를 누르고 다음 이름의 새 빈 폴더를 선택하세요 `빌드` 를 파일 대상 위치로 합니다. 이 `빌드` 폴더의 파일을 ZIP 폴더로 압축하되, 파일들이 ZIP의 루트에 있도록 하세요. 그런 다음 ZIP 폴더를 Itch 프로젝트에 업로드하고, 파일이 브라우저에서 재생되도록 하는 옵션을 선택해야 합니다. 그러면 게임은 로컬과 같은 방식으로 작동해야 합니다. 매치메이커 모드에서는 Itch.io 페이지의 출처를 다음에 추가하세요 `allowed_cors_origins` 먼저.
