다음을 통해 공유

PlayFab GSDK를 Unity에 통합

  • 아티클

멀티 플레이어 서버 플랫폼은 Unity 게임 서버에 통합할 수 있는 GSDK 라이브러리를 제공합니다. 라이브러리는 오픈 소스이며 GitHub의 GSDK 리포지토리에서 찾을 수 있습니다.

설치

Assets/PlayFabSdk 폴더를 Unity 프로젝트에 복사할 수 있습니다. 그런 다음, Unity 빌드 설정(예제)에서 ENABLE_PLAYFABSERVER_API 스크립트 지시어를 사용하도록 설정해야 합니다. 또는 제공된 Unity 패키지 파일을 사용할 수 있습니다. MultiplayerServerSample 프로젝트에서 샘플 코드를 찾을 수 있습니다.

사용법

최소한 PlayFabMultiplayerAgentAPI.Start() 메서드를 구현하고 아래 코드와 같이 PlayFabMultiplayerAgentAPI.ReadyForPlayers() 메서드의 coroutine을 시작해야 합니다.

//...
StartCoroutine(ReadyForPlayers());
//...

private IEnumerator ReadyForPlayers()
{
    yield return new WaitForSeconds(.5f);
    PlayFabMultiplayerAgentAPI.ReadyForPlayers();
}

또한 아래 예제와 같이 PlayFabMultiplayerAgentAPI.OnServerActiveCallback을(를) 사용하여 게임 서버가 활성으로 전환될 때 등록합니다.

PlayFabMultiplayerAgentAPI.OnServerActiveCallback += OnServerActive;
// ...
private void OnServerActive()
{
    Debug.Log("Server Started From Agent Activation");
    // players can now connect to the server
}

참고 항목

게임 서버 상태에 대한 자세한 내용은 여기에서 PlayFab 게임 서버 섹션의 기본 사항을 확인하세요.

또한 게임 서버에서 다음 콜백을 구현할 수 있습니다.

  • Azure가 VM에서 유지 관리를 수행해야 할 때 PlayFabMultiplayerAgentAPI.OnMaintenanceCallback이 트리거됨
  • 종료 알림을 받을 때 PlayFabMultiplayerAgentAPI.OnShutDownCallback이 트리거됨
  • 게임 서버와 PlayFab VM 에이전트 통신 사이에 오류가 있는 경우 PlayFabMultiplayerAgentAPI.OnAgentErrorCallback이 트리거됨

참고 항목

더 많은 GSDK 샘플을 보려면 여기에서 MPS 샘플 리포지토리를 확인할 수 있습니다.