Game Server SDK (GSDK) とゲーム サーバー プロセスのライフサイクル
PlayFab Multiplayer Servers (MPS) のゲーム サーバー ライフサイクルは、ゲーム サーバーが呼び出す GSDK メソッド、およびゲーム サーバー プロセスの状態と密接に関連しています。ゲーム サーバーの GSDK 統合について詳しくは、ドキュメント こちら を参照してください。
ゲーム サーバーの状態
以下は MPS におけるゲーム サーバーの主な状態です:- Initializing: ゲーム サーバーが Start() GSDK メソッドを呼び出すと、この状態に遷移します。この状態では、ゲーム サーバーは必要なアセットの読み込みを開始します。この状態で、GSDK は MPS にハートビートを送信し始めます。
- StandingBy: ゲーム サーバーが ReadyForPlayers() GSDK メソッドを呼び出すと、この状態に遷移します。このメソッドは、必要なゲーム アセットがすべて読み込まれたときに呼び出す必要があります。基本的に、この状態は、ゲーム サーバーが割り当て可能な状態であり、プレイヤーが接続できることを MPS に通知します。
- Active: RequestMultiplayerServer API 呼び出しを使用して割り当てられたときに、ゲーム サーバーはこの状態に遷移します。この状態は、プレイヤーがゲーム サーバーに接続してゲームを楽しめることを意味します。ゲーム サーバーがアクティブであるという事実は、ビルドのスケールダウン（つまり standingBy 数が減った場合）中に停止されないことを意味します。
- Terminating: ShutDownMultiplayerServer API が呼び出されたときに、ゲーム サーバーが遷移する状態です。この状態は、ゲーム サーバーがシャットダウン中で、プレイヤーが接続できなくなることを意味します。
- このゲーム サーバーを実行しているコンテナー/プロセスを削除する
- アーカイブ用にゲーム ログを収集してアップロードする（詳細）
- 終了したものを置き換えるために、新しいコンテナー/プロセスを作成する
ゲーム サーバーは、Active 状態にあるときに StandingBy 状態に戻ることは決してありません。ゲームの状態が Active に設定されると、新しいゲーム サーバーを StandingBy 状態にする唯一の方法は、ゲーム サーバー プロセスが終了することです。
サーバーの最大有効期間
MPS サーバーをホストする仮想マシンは、最大 10 日間の有効期間を持ちます。したがって、サーバーの有効期間はその有効期間により制約されます。サーバーの有効期間は少なくとも 23 時間保証されます。MPS は、残り 23 時間未満の VM 上にサーバーを割り当てることはありません。GSDK は、VM が強制終了される 23 時間前に OnMaintenanceScheduled イベントを発火するので、VM 上で実行中のサーバーは時間内に正常にシャットダウンできます。VM が最大 10 日間の有効期間に達したときにサーバーがまだ VM 上で実行中の場合、サーバーは強制終了され、ログはアップロードされません。サーバーが強制終了されないようにするには、セッションが常に 23 時間未満になるようにするか、GSDK の OnMaintenanceScheduled イベントを使用して期限前にサーバーを正常にシャットダウンし、プレイヤーを別のサーバーに移行してください。ゲーム サーバー プロセスの終了
ゲーム セッションが終了したら、新しいゲーム サーバーを取得できるように、ゲーム サーバー プロセスを正常に終了する必要があります。ゲーム サーバー プロセスがクラッシュした場合、MPS はクラッシュしたものを置き換える新しいゲーム サーバー プロセスを作成します。ゲーム サーバーがスタックまたはフリーズした場合には、ShutDownMultiplayerServer API を呼び出して手動でゲーム サーバー プロセスを終了することができます。この API は、ゲーム サーバー プロセスが自身で終了できない場合にのみ呼び出す必要があります。この API を呼び出すと、ゲーム サーバーが “Terminating” および “Terminated” 状態に遷移するのがわかります。また、terminating または terminated 状態でスタックしているサーバーは、一定期間後にシステムによって置き換えられます。GSDK にはメソッド呼び出しがあり、これを使用するとゲーム サーバーが Unhealthy としてマークされます。現時点では MPS によって無視されていますが、将来変更される可能性があります。この機能が重要な場合は、GSDK リポジトリ こちら にメモを残してください。