> 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/playfab-spaceedge.md).

# PlayFab SpaceEdge

PlayFab 매치메이킹으로 플레이어를 매칭하고, Azure Functions 두 개를 사용해 매 경기마다 플레이어와 가까운 곳에 Edgegap 전용 서버를 시작하는 Unity 우주 슈팅 게임입니다.

다음 방법을 알아보세요: **PlayFab 매치메이킹을** 유지하고 각 매치를 별도로 실행하는 **Edgegap** 전용 서버를 사용하여 [SpaceEdge PlayFab 샘플](https://github.com/edgegap/backend-game-sample-unity-playfab-matchmaker-fishnet-spaceedge). FishNet을 사용하는 소규모 Unity 우주 슈팅 게임입니다.

플레이어는 PlayFab에 로그인한 다음 **게임 시작**을 누릅니다. PlayFab이 플레이어를 매칭하면 Azure Function이 플레이어와 가까운 Edgegap 서버를 시작하고, 두 번째 Azure Function이 각 플레이어에게 주소와 참가 토큰을 전달합니다. 서버는 매칭된 플레이어만 입장시키며, 플레이어가 나가면 스스로 종료됩니다.

이 샘플에서는 다음을 확인할 수 있습니다.

* **Unity 2021.3.45f2** 기반 **FishNet 3.11.14** (Tugboat, UDP 7770) 프로젝트를 Linux 전용 서버로 빌드하며, [Edgegap Unity 플러그인](https://github.com/edgegap/buildtool-unity-plugin),
* **PlayFab 매치메이킹** : 서버 할당 기능을 끈 상태에서 PlayFab이 매치를 구성하고 Edgegap이 호스팅합니다.
* **두 개의 Azure Functions** (Node.js 22, SDK 없음): 하나는 `match_found`에서 서버를 배포하고, 다른 하나는 Edgegap의 준비 완료 웹후크를 수신해 각 플레이어의 읽기 전용 데이터에 주소를 기록합니다.
* **참가 토큰**: 서버는 PlayFab이 매칭한 플레이어만 입장시키며, PlayFab 비밀 키를 보유하지 않습니다.
* **서버 자체 종료**: 아무도 참가하지 않거나 모든 플레이어가 나가면 서버가 자체 배포를 종료합니다.

{% hint style="info" %}
2026년 10월 21일, Windows 클라이언트와 2명으로 구성된 PlayFab 대기열을 사용해 Edgegap에서 처음부터 끝까지 검증했습니다. 함수 호출 후 약 8초 만에 두 플레이어 모두 주소를 받았습니다. 참가 토큰과 플러그인 빌드는 이후에 추가했으며, 단위 테스트와 로컬 서버 컨테이너로 테스트했습니다.
{% endhint %}

{% hint style="success" %}
[PlayFab에서 배포](https://docs.edgegap.com/ko/docs/tools-and-integrations/playfab-bridge.md) 에서는 각 단계를 설명하고, 자체 PlayFab 게임에 Edgegap을 추가하는 방법을 안내합니다.
{% endhint %}

## ✔️ 사전 준비

{% hint style="info" %}
이 샘플은 Unity `2021.3.45f2` 에서 개발하고 테스트했습니다. 동일한 버전을 사용하세요.
{% endhint %}

시작하기 전에, 반드시 [Edgegap에서 무료 계정을 생성하세요](https://app.edgegap.com/auth/register) (신용카드 정보는 필요하지 않습니다). 다음을 할 수 있습니다 [그 후 팀원을 초대할 수 있습니다](https://app.edgegap.com/user-settings?tab=organizations), 아직 Edgegap 계정이 없어도 됩니다.

**개발 환경에서 몇 가지 필수 항목을 구성하세요:**

<details>

<summary>Unity Linux 빌드 지원 모듈 설치</summary>

* Unity Hub를 사용하여 탭 선택 **설치합니다**, 액세스 **설정** 지역화된 인터넷 서비스 제공업체(ISP)가 일시적으로 사고를 해결하고 있을 수 있습니다, **모듈 추가** Edgegap 플랫폼에서 사용하려는 각 Unity 버전에 대해:

<figure><img src="https://1562312210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FylRG4r8orenZrw5ijjpJ%2Fimage.png?alt=media&amp;token=fb981825-8a15-4c07-9180-0f79a6a77a91" alt=""><figcaption></figcaption></figure>

* 아래로 스크롤하여 다음 Unity 모듈을 선택하고 설치하세요:
  * **Linux 빌드 지원 (IL2CPP),**
    * **Linux 빌드 지원 (Mono),**
    * **Linux 전용 서버 빌드 지원**

<figure><img src="https://1562312210-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR0dHSFv9ymoC0DO5G8J%2Fuploads%2FuXtyqoLhBOk8CZJ4WdzA%2Fimage.png?alt=media&amp;token=19e956ed-a731-420d-b911-130c334794fc" alt=""><figcaption></figcaption></figure>

</details>

<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>

* a [PlayFab](https://developer.playfab.com) 타이틀, Title ID 및 비밀 키,
* Azure 구독 및 [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli),
* 의 Edgegap API 토큰 [Dashboard → User Settings → Tokens](https://app.edgegap.com/user-settings?tab=tokens)에서 발급합니다. 이 토큰은 Function App 설정에만 저장하고 게임에는 절대 포함하지 마세요.

## ⚡ 샘플 실행

### 1. 게임 서버

{% hint style="info" %}
이 단계에 관한 자세한 안내는 [Unity](https://docs.edgegap.com/ko/unity.md) 시작 가이드
{% endhint %}

를 참조하세요. Unity에서 `SpaceEdge_project` 를 연 다음 **Tools → Edgegap Server Hosting**:

1. **를 선택하고 Edgegap 계정으로 로그인합니다.**, 그런 다음 **서버 빌드**.
2. **Docker로 컨테이너화**: 이미지 이름 `playfab-fishnet`, 이미지 태그는 비워 둡니다(플러그인이 현재 UTC 시간을 사용합니다).
3. **Edgegap에 업로드**: 애플리케이션 `playfab-fishnet`, 그런 다음 **이미지 업로드 및 앱 버전 생성**. 열리는 버전 양식에서 포트 하나를 설정합니다. 이름은 `gameport`, 포트 번호는 7770, 프로토콜은 UDP, 리소스는 0.5 vCPU / 1 GB로 설정합니다. 제안된 버전 이름은 그대로 사용하세요. Azure Functions에서 이 이름이 필요합니다.

{% hint style="info" %}
서버에는 환경 변수나 비밀 키가 필요하지 않습니다. 함수가 배포된 매치 정보를 전달합니다.
{% endhint %}

### 2. PlayFab 타이틀

1. 매치메이킹 큐 생성 `edgegap-fishnet`, 매치 인원은 2\~2명으로 설정하고 **서버 할당 활성화** 는 끕니다.
2. 에서 **타이틀 설정 → API 기능**, 다음 항목의 체크를 해제합니다. **Client/LoginWithCustomId를 사용한 플레이어 생성 사용 안 함**.
3. 다음에서 비밀 키를 생성합니다. **타이틀 설정 → 비밀 키**.

### 3. Azure Functions

샘플의 `azure-functions` 폴더를 Node.js 22를 사용하는 Flex Consumption Function App에 배포하고, 앱 설정을 구성합니다. 자세한 내용은 다음을 참조하세요. [PlayFab에서 배포](https://docs.edgegap.com/ko/docs/tools-and-integrations/playfab-bridge.md). 애플리케이션 `playfab-fishnet` 과 1단계에서 사용한 버전 이름을 지정합니다. 그런 다음 PlayFab에 `StartEdgegapDeployment` 을 등록하고 다음에 규칙을 추가합니다. `playfab.matchmaking.match_found`.

### 4. 매치 플레이

1. 씬을 엽니다. `Assets/SpaceEdge/Scenes/MainMenu`, 그리고 `PlayfabRestApiService` 오브젝트에서 **타이틀 ID**를 설정합니다. 큐 이름은 이미 `edgegap-fishnet`.
2. Windows 테스트 클라이언트를 빌드합니다(Mono 사용, Windows IL2CPP 모듈 불필요). 그런 다음 PlayFab 플레이어 두 명으로 클라이언트를 각각 실행합니다.

```bash
"<Unity>" -batchmode -projectPath SpaceEdge_project -executeMethod EdgegapPluginBuild.BuildClient -logFile build-client.log
SpaceEdge_project/Builds/Client/win64/Game.exe -playfabCustomId player-a
SpaceEdge_project/Builds/Client/win64/Game.exe -playfabCustomId player-b
```

3. 누르세요 **게임 시작** 두 클라이언트 모두에서 실행합니다. PlayFab에서 일치 항목을 찾으면 매치 ID의 시작 부분이 태그로 지정된 배포가 [Edgegap 대시보드](https://app.edgegap.com/deployment-management/deployments/list)에 표시되고, 몇 초 후 두 클라이언트가 모두 연결됩니다.
4. 두 클라이언트를 모두 종료하세요. 서버는 1분 이내에 자동으로 중지됩니다.

{% hint style="info" %}
무료 티어에서는 한 번에 하나의 배포만 실행할 수 있습니다. 테스트 전에 다른 배포를 중지하세요.
{% endhint %}

## 🔧 알려진 제한 사항

* **매치당 플레이어 2명.** 2명으로 구성된 대기열만 테스트했습니다. 더 큰 규모의 매치를 진행하려면 대기열의 매치 규모를 늘리고 다시 테스트하세요.
* **Windows 클라이언트만 테스트했습니다.** 클라이언트 코드는 `UnityWebRequest` 및 `JsonUtility`만 사용하므로 WebGL에서 실행할 수도 있지만, 웹 빌드에는 WebSocket 전송 방식과 포트도 필요합니다.
