ロビーの heartbeat
Send heartbeat requests to keep a lobby active and prevent it from being marked as inactive or deleted.
読み終わるまでの所要時間 1 分最終更新 2ヶ月前
特定の継続時間内にロビーが更新されず、ホストによって heartbeat リクエストも送信されない場合、そのロビーは 非アクティブ としてマークされます。ロビーのデフォルトのアクティブ生存期間は 30 秒です。プロジェクト内のロビーの activelifespan を設定 できます。
注
ロビーのプロパティが変更された場合にのみ更新がカウントされます。これには、ホストのプレイヤーデータに対する変更は含まれず、no-op 更新は含まれません。
注
非アクティブロビーは、LastUpdated フィールドのフィルターを使用してクエリから自動的に除外されます。LastUpdated フィルターを含めると、デフォルトのフィルターがオーバーライドされ、クエリ結果に非アクティブロビーが含まれる可能性があります。Get Lobby API は非アクティブステータスの影響を受けません。
ホストは、ロビーの使用中は heartbeat を定期的に送信する必要がありますが、それらのロビーに気を配り、後で削除する必要もあります。これを行う非常にシンプルな方法は、作成したロビーをシャットダウン中にループ処理することです。 以下のコードサンプルは、MonoBehavior の OnApplicationQuit() 関数を利用して、作成したロビーを削除する方法を示しています。 C#async Task<Lobby> CreateLobbyWithHeartbeatAsync(){ string lobbyName = "test lobby"; int maxPlayers = 4; CreateLobbyOptions options = new CreateLobbyOptions(); // Lobby parameters code goes here... // See 'Creating a Lobby' for example parameters var lobby = await LobbyService.Instance.CreateLobbyAsync(lobbyName, maxPlayers, options); // Heartbeat the lobby every 15 seconds. StartCoroutine(HeartbeatLobbyCoroutine(lobby.Id, 15)); return lobby;}IEnumerator HeartbeatLobbyCoroutine(string lobbyId, float waitTimeSeconds){ var delay = new WaitForSecondsRealtime(waitTimeSeconds); while (true) { LobbyService.Instance.SendHeartbeatPingAsync(lobbyId); yield return delay; }
ConcurrentQueue<string> createdLobbyIds = new ConcurrentQueue<string>();void OnApplicationQuit(){ while (createdLobbyIds.TryDequeue(out var lobbyId)) { LobbyService.Instance.DeleteLobbyAsync(lobbyId); }}