次の方法で共有

PlayFabGSDK を Unity に統合する

  • [アーティクル]

マルチプレイヤー サーバー プラットフォームには、Unity ゲーム サーバーに統合できる GSDK ライブラリが用意されています。 ライブラリはオープン ソースであり、GitHub の GSDK リポジトリにあります。

インストール

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

使用方法

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

//...
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 ゲーム サーバーの基本」セクションを参照してください。

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

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

注意

その他の GSDK サンプルについては、こちらの MPS サンプル リポジトリを参照してください。