文档

​
​

Development

User Acquisition

Monetization

工业

Multiplayer Services SDK

All Services

Multiplayer Services SDK

此页面不支持所选语言。
Multiplayer
​
​
Multiplayer Services SDK
  • Overview
  • Get started
  • Use multiplayer sessions
    • Integrate Multiplayer sessions
      • Initialize UGS and authenticate the player
      • Create a session
      • Create sessions in the Editor
      • Find and join a session
      • Matchmaking
        • Match make with the Quick Join API
        • Advanced matchmaking
      • Migrate session host
      • Leave a session
      • Get a list of joined sessions
      • Delete a session
      • Session configuration options
    • Game server hosting support
  • Manage sessions
  • Connect players through a relay
  • Networking
  • Matchmaking
  • Monitor and debug sessions
  • Tutorials
  • Reference
  1. Multiplayer Services SDK

Match make with the Quick Join API

Quickly match make players using Lobby's Quick Join.
阅读时间1 分钟
最后更新于 4 个月前

Use the Lobby service to have a player randomly join any session that's compatible with the parameters and filters passed to the
MatchmakeSessionAsync
method.
The following example demonstrates how to find and join a session in a single operation:
var quickJoinOptions = new QuickJoinOptions(){ Filters = new List<FilterOption> { new(FilterField.AvailableSlots, "1", FilterOperation.GreaterOrEqual), new (FilterField.StringIndex1, "map 1", FilterOperation.Equal) }, Timeout = TimeSpan.FromSeconds(5), CreateSession = true};var sessionOptions = new SessionOptions(){ MaxPlayers = 2, Type = "Session",}.WithRelayNetwork();ISession session = await MultiplayerService.Instance.MatchmakeSessionAsync(quickJoinOptions, sessionOptions);
This code tries to join a session that has at least
1
available slot and the property
map 1
.
MatchmakeSessionAsync
continues searching for a session until the set timeout of
5 seconds
is reached.
At this point, if the player can't join a session for any reason, such as all available sessions being full, the quick join operation can optionally create a new session using the
CreateSession
parameter. Note that the new session is only created after the set timeout has expired, if set.
When the quick join operation finds or creates a session, it configures networking to use Relay connections.

Copyright © 2026 Unity Technologies
法律信息隐私政策CookiesDocumentation Terms of Use请勿出售或分享我的个人信息您的隐私选择(Cookie 设置)

“Unity”、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属公司在美国和其他地方的商标或注册商标(此处查看更多信息)。其他名称或品牌是其各自所有者的商标。

为方便起见,一些页面是机器翻译的,可能包含不准确的内容。如有信息不一致的情况,以英文版本为准。


    报告此页面的问题