다음을 통해 공유


Windows Runner C# 샘플

이 자습서에서는 PlayFab 멀티 플레이어 서버를 사용할 수 있도록 샘플을 설정하는 단계를 나열합니다.

참고 항목

PlayFab 멀티 플레이어 서버를 사용하고 보려면 게임 관리자에서 기능을 사용하도록 설정해야 합니다. 자세한 내용은 PlayFab 서버 기능 사용을 참조하세요.

  1. API 기능 옵션 구성
  2. PlayFab 멀티 플레이어 게임 서버 빌드 만들기: 서버 설정
  3. 빌드를 배포하여 서버 만들기
  4. 멀티 플레이어 서버 요청: 클라이언트 설정. 서버에 연결하는 클라이언트를 시작할 수 있도록 이 작업이 필요합니다.

API 기능 옵션 구성

참고 항목

이 단계는 이 샘플을 실행하는 경우에만 필요합니다. 타이틀에 이 설정이 필요하지 않으면 클라이언트가 게임을 시작하도록 허용할 필요가 없습니다.

  • PlayFab.com에서 개발자 계정에 로그인하여 게임 관리자 포털 사용
  • 게임 타이틀 선택
  • 아래 이미지와 같이 설정 아이콘 >API 기능을 선택합니다.

게임 관리자의 API 기능 탭

  • 옵션에서 아래 이미지와 같이 클라이언트가 게임을 시작할 수 있도록 허용을 선택합니다.

게임 관리자에서 클라이언트가 게임을 시작할 수 있도록 허용 선택

서버 설정

PlayFab 멀티 플레이어 게임 서버 빌드를 가져오는 방법을 설명합니다.

  • Windows Runner 샘플용 PlayFab 멀티 플레이어 서버 빌드의 PlayFab 게임 서버 SDK입니다.

  • 직접 빌드하려면 다음을 수행합니다.

    • 표준 Git 메서드를 사용하거나 zip 파일로 다운로드하여 Windows Runner C# 샘플을 가져옵니다.
    • Visual Studio 2017 이상을 사용하여 프로젝트를 엽니다. 이 작업 후에는 다운로드할 수 있는 최신 PlayFab 게임 서버 SDK(GSDK) NuGet 패키지와 같은 종속성이 자동으로 트리거됩니다.
    • 릴리스 x64 구성에서 WindowsRunnerCSharp.csproj를 컴파일하고 빌드합니다. GSDK와 통합된 게임 서버 빌드를 가져와서 유효한 PlayFab 멀티 플레이어 게임 서버 빌드로 만듭니다.
    • bin 폴더로 이동하여 모든 x64 릴리스 이진 파일을 압축합니다. 내부 폴더 구조가 없으므로 아래 이미지와 같이 zip 파일은 단순 파일 컬렉션이어야 합니다.

    GSDK 샘플 출력

이중으로 확인하려면 빌드 출력과 위의 링크에 제공된 컴파일된 버전을 비교할 수 있습니다.

zip 파일이 있는 경우 빌드 배포를 시작할 준비가 된 것입니다.

빌드를 배포하여 서버 만들기

다음 방법 중 하나를 사용하여 빌드를 배포할 수 있습니다.

일부 설정의 경우 웹 인터페이스게임 관리자를 사용하여 구성하는 것이 더 쉬울 수 있습니다.

다음으로, 클라이언트를 설정하고 실행하여 배포된 서버에 연결합니다.

클라이언트 설정

PlayFab 멀티 플레이어 서버를 사용하여 만든 게임 서버에 연결하도록 Windows Runner 클라이언트 애플리케이션을 가져오는 방법을 설명합니다. 이 설정은 대기 중인 서버가 있는 경우에만 설정할 수 있습니다.

  • 빌드를 배포한 후 대기 서버를 사용할 수 있을 때까지 기다립니다.

  • 빌드의 titleIdbuildId를 가져옵니다.

    • 게임 관리자 사용:

      • 내 스튜디어 및 타이틀 페이지로 이동하여 게임 타이틀을 찾습니다. 해당 페이지에 나열된 ID 값을 복사하여 나중에 액세스할 수 있는 편리한 위치에 붙여넣습니다. titleId입니다.
      • 대시보드를 보려면 게임 타이틀을 선택합니다.
      • 멀티 플레이어>서버>빌드로 이동합니다.
      • 사용하려는 빌드의 ID를 복사하여 편리한 위치에 붙여넣습니다. buildId입니다.
    • PowerShell을 사용하여 이 정보는 빌드가 성공적으로 배포된 후 출력에 있습니다.

      • titleIdbuildId를 복사하고 편리한 곳에 붙여넣습니다.
  • 표준 Git 메서드를 사용하거나 zip 파일로 다운로드하여 Windows Runner C# 샘플을 가져옵니다. 이전에 이 작업을 수행한 경우 건너뜁니다.

  • Visual Studio 2017 이상을 사용하여 프로젝트를 엽니다. 이 작업 후에는 다운로드할 수 있는 최신 게임 서버 SDK NuGet 패키지와 같은 종속성이 자동으로 트리거됩니다.

  • 릴리스 x64 구성에서 WindowsRunnerCSharpClient.csproj를 컴파일하고 빌드합니다.

  • 명령 프롬프트를 열고 이 프로젝트의 출력 폴더로 이동합니다.

  • 이 명령줄을 사용하여 WindowsRunnerCSharpClient를 실행하여 <TitleId> and <BuildID>를 위의 값으로 바꿉니다. dotnet WindowsRunnerCSharpClient.dll --titleId <TitleId> --buildId <BuildId>

예:

cd C:\Users\UserName\Documents\GitHub\MpsSamples\WindowsRunnerCSharp\WindowsRunnerCSharpClient\bin\Release\netcoreapp3.1

dotnet WindowsRunnerCSharpClient.dll --titleId CBE66 --buildId 36083326-3bd5-4b8f-a97d-7e82f066aa40 --verbose

클라이언트가 서버에 성공적으로 연결되면 명령 프롬프트에 서버가 IP 주소로 할당되었다는 로그 메시지가 표시됩니다.

참고 항목