Quick Join
Find and join an available lobby that matches your criteria without manually browsing results from a list.
読み終わるまでの所要時間 1 分最終更新 2ヶ月前
Quick Join API を使用すると、プレイヤーは、クエリから特定のロビーを手動で選択する必要なしにロビーをすばやく検索して参加できます。プレイヤーは自分のクエリフィルターを設定し、Quick Join API を呼び出します。その後 Lobby サービスが条件に一致し容量のあるロビーにそれらを配置しようとします。 Quick Join は、プレイヤーが手動でクエリを実行して結果を参照し、ロビーを選択して参加を試み、参加を試みる時点までにロビーが満員になったため参加に繰り返し失敗するという一般的な問題を解決するように設計されています。基本的なマッチメイキングのフォームとして使用することもできます (ただし、既存のロビー内のみで、新規ロビーは作成しません)。
推奨ガイド
Quick Join では、リクエストが履行されることは保証されません。クエリ条件に一致するロビーがない場合や、参加が試行されて失敗した場合は失敗します。これらのシナリオでは、クライアントが 404 Not Found エラーを受け取ることを想定する必要があります。失敗が発生した場合、クライアントは再度 Quick Join を試行するか (レート制限 を参照)、新規ロビーの作成にフォールバックし、ホストロールを引き継ぐことができます。 以下のコードサンプルは、Quick Join の設定方法を示しています。 C#try{ // Quick-join a random lobby with a maximum capacity of 10 or more players. QuickJoinLobbyOptions options = new QuickJoinLobbyOptions(); options.Filter = new List<QueryFilter>() { new QueryFilter( field: QueryFilter.FieldOptions.MaxPlayers, op: QueryFilter.OpOptions.GE, value: "10") }; var lobby = await LobbyService.Instance.QuickJoinLobbyAsync(options); // ...}catch (LobbyServiceException e){ Debug.Log(e);}