Wrapper 샘플

​

샘플 콘텐츠

• Wrapper—PlayFab 게임 서버 SDK(GSDK)용 최신 NuGet 패키지를 게임 서버와 통합합니다. 이 Wrapper 애플리케이션은 프로덕션 용도로 사용할 수 없습니다.
• Fakegame—GSDK에 대한 지식이 없는 기본 게임 서버입니다. PlayFab 멀티플레이어 서버를 사용하기 전에 가지고 있었을 일반적인 게임 서버와 유사합니다. TCP 포트 80을 수신 대기하는 ASP.NET Core 웹 서버 Kestrel을 시작합니다. GSDK에 대한 지식이 전혀 없는 게임 서버를 시뮬레이션하기 위한 것입니다. 자체 게임 서버가 없는 경우 사용할 수 있습니다. 간단한 응답을 가져오는 /hello와 서버를 종료할 수 있는 /hello/terminate라는 두 개의 GET 경로가 있습니다.

​

요구 사항

• .NET Core 3.1 x64 SDK

​

연습

​

Wrapper 실행 파일 획득 및 빌드

• 표준 Git 방법이나 zip 파일로 다운로드하여 GSDK wrapper 샘플을 가져옵니다.
• 명령 프롬프트를 열고 cd 명령을 사용하여 wrapper.csproj 파일 위치로 디렉터리 경로를 변경합니다. 예: cd C:/ReplaceWithYourFilePath/wrappingGsdk/wrapper
• 그런 다음, 다음 .NET Core CLI 명령을 실행합니다.

dotnet publish --self-contained -r win-x64 /p:PublishSingleFile=true /p:PublishTrimmed=true

​

게임 서버 자산 만들기

​

Wrapper와 함께 Fakegame 게임 서버 사용

• PowerShell 열기
• cd 명령을 사용하여 build.ps1 스크립트 위치로 디렉터리 경로를 변경합니다. 예: cd C:/ReplaceWithYourFilePath/wrappingGsdk/
• \build.ps1 실행
• 스크립트가 성공적으로 실행되면 ..\wrappingGsdk\drop\ 폴더로 이동합니다. 가짜 게임 서버 빌드, wrapper 실행 파일(이전 단계에서 빌드됨) 및 기타 필수 파일을 포함하는 gameassets.zip 파일이 생성된 것을 확인할 수 있습니다.

​

Wrapper와 함께 자체 게임 서버 파일 사용

• Wrapper 실행 파일 빌드 지침을 따르세요.
• ..\wrappingGsdk\wrapper\bin\Debug\netcoreapp3.1\win-x64\publish의 wrapper 게시 위치로 이동합니다.
• 다른 창에서 게임 서버 빌드 및 게임 서버 빌드를 실행하는 데 필요한 파일로 이동합니다. 어떤 파일이 필요한지 확실하지 않은 경우 필요한 DLL 파일 결정을 참조하세요.
• 게임 서버 빌드와 모든 필수 파일을 wrapper 게시 위치에 복사합니다.
• wrapper 게시 위치의 모든 파일을 선택합니다.
• 모든 파일을 선택한 상태에서 마우스 오른쪽 버튼을 클릭한 다음 보내기 > 압축(zip) 파일 을 선택하여 압축합니다. wrapper 게시 폴더를 선택하여 zip에 추가하지 마세요. 이는 잘못된 매핑을 유발합니다.

​

Linux 컨테이너 이미지 만들기 및 업로드(Linux 서버 전용)

1. Windows 개발 디바이스 설정(선택 사항)
2. PlayFab 컨테이너 레지스트리 로그인 자격 증명 가져오기
3. 기존 Dockerfile 사용/자체 만들기 이 단계는 FakeGame 또는 자체 게임 서버를 사용하는지 여부에 따라 다릅니다.
   • FakeGame을 사용하는 경우 Dockerfile이 있는지 확인합니다.
   • 자체 게임을 사용하거나 Dockerfile을 만들어야 하는 경우 Dockerfile 만들기를 참조하세요. FakeGame용 Dockerfile을 시작점으로 사용할 수 있습니다.
4. Ubuntu와 같이 Docker가 설치된 Linux 터미널을 엽니다. TAG 및 ACR 변수의 값을 사용자 값으로 바꿉니다. 그런 다음 아래 명령을 실행합니다.

TAG="0.1"
ACR="customer5555555.azurecr.io"
docker login ${ACR}

5. 이전 단계에서 얻은 사용자 이름과 암호를 입력합니다.
6. Linux 컨테이너 이미지를 빌드하고 업로드합니다.

docker build -t ${ACR}/wrapper:${TAG} .
docker push ${ACR}/wrapper:${TAG}

​

Game Manager 또는 API를 사용하여 빌드 배포

​

Windows 게임 서버 배포

• Game Manager를 사용하여 서버 배포 및 구성
• PowerShell/API를 사용하여 서버 배포 및 구성

• 시작 명령:
  • C:\Assets\wrapper.exe -g C:\Assets\fakegame.exe arg1 arg2 사용
  • 게임 서버 빌드를 사용하는 경우 fakegame.exe를 게임 서버 실행 파일 이름으로 바꿉니다.
• 네트워크 구성: 이름: gameport, 포트: 80, 프로토콜: TCP
• 자산: FakeGame을 사용하는 경우 gameassets.zip 을 자산으로 업로드합니다.

​

Linux 게임 서버 배포

• Game Manager를 사용하여 서버 배포 및 구성
• PowerShell/API를 사용하여 서버 배포 및 구성

• 업로드한 컨테이너를 선택합니다.
• 네트워크 구성: 이름: gameport, 포트: 80, 프로토콜: TCP
• 자산 업로드 및 시작 명령 설정 필요 없음

​

LocalMultiplayerAgent를 사용하여 Wrapper 실행

"AssetDetails": [
    {
        "MountPath": "C:\\Assets",
        "SasTokens": null,
        "LocalFilePath": "C:\\projects\\gsdkSamples\\wrappingGsdk\\drop\\gameassets.zip"
    }
],
"StartGameCommand": "C:\\Assets\\wrapper.exe -g C:\\Assets\\fakegame.exe",

// if you are using fakegameserver you should also configure port mapping for port 80
"PortMappingsList": [
            [
                {
                    "NodePort": 56100,
                    "GamePort": {
                        "Name": "gameport",
                        "Number": 80,
                        "Protocol": "TCP"
                    }
                }
            ]
        ]

​

MPS의 게임 서버에 연결하는 방법

​

Game Manager 사용

1. Game Manager에 로그인
2. Multiplayer => Servers 페이지로 이동하여 빌드를 선택합니다.
3. Servers 페이지로 이동하여 “Request server” 버튼을 클릭합니다.
4. 다음 페이지에서 공용 IPv4 주소와 포트를 기록해 둡니다.
5. curl을 사용하여 http://[IPV4Address]:[Ports->Num]/Hello 에서 연결합니다.”

​

MPS Allocator 샘플 사용

1. MPS Allocator 샘플을 컴파일하고 실행합니다.
2. “ListBuildSummaries” 명령을 적용하여 사용 가능한 빌드 및 해당 빌드 ID를 확인합니다.
3. “RequestMultiplayerServer”를 호출하여 게임 서버 인스턴스에 대한 요청을 시작합니다.
4. 선택한 빌드 ID를 “ListMultiplayerServers” 명령에 입력하여 사용 가능한 서버 목록을 생성합니다.
5. 활성 게임 서버 인스턴스를 선택한 다음 이전 단계에서 얻은 빌드 및 세션 ID와 함께 “GetMultiplayerServerDetails”를 사용합니다.
6. 응답에 표시된 IPV4Address 및 Ports->Num을 기록해 둡니다.
7. curl을 사용하여 http://[IPV4Address]:[Ports->Num]/Hello 에서 연결합니다.

​

참고 항목

• 첫 번째 서버 만들기
• 리소스 및 샘플
• PlayFab 멀티플레이어 서버 SDK
• API 참조