PlayFab GSDK を Unity に統合する - XBOX Game Development Documentation

Multiplayer Servers プラットフォームは、Unity ゲームサーバーに統合できる GSDK ライブラリを提供します。このライブラリはオープンソースで、GitHub 上の GSDK リポジトリにあります。

インストール

Assets/PlayFabSdk フォルダーを Unity プロジェクトにコピーできます。その後、Unity ビルド設定でスクリプティングディレクティブ ENABLE_PLAYFABSERVER_API を有効にする必要があります（例）。または、提供されている Unity package ファイルを使用することもできます。サンプルコードは MultiplayerServerSample プロジェクトにあります。

使用方法

少なくとも、PlayFabMultiplayerAgentAPI.Start() メソッドを実装し、以下のコードのように PlayFabMultiplayerAgentAPI.ReadyForPlayers() メソッド用のコルーチンを開始する必要があります

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

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

また、次の例のように、PlayFabMultiplayerAgentAPI.OnServerActiveCallback を使用して、ゲームサーバーが Active 状態に遷移したときに登録することもできます:

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

ゲームサーバーの状態に関する詳細は、「Basics of a PlayFab game server」セクションこちらを参照してください

さらに、ゲームサーバー上で次のコールバックを実装できます:

PlayFabMultiplayerAgentAPI.OnMaintenanceCallback は、Azure が VM でメンテナンスを実行する必要があるときにトリガーされます
PlayFabMultiplayerAgentAPI.OnShutDownCallback は、終了通知を受信したときにトリガーされます
PlayFabMultiplayerAgentAPI.OnAgentErrorCallback は、ゲームサーバーと PlayFab VM Agent との通信でエラーが発生した場合にトリガーされます

GSDK サンプルの詳細については、MPS Samples リポジトリこちらをご覧ください

​インストール

​使用方法

インストール

使用方法