question

dylan-1 avatar image
dylan-1 asked

More doc inconsistencies for matchmaking events?

Some docs say for event notifications to use SignalR, while others say a matchmaking sdk completely separate from the client sdk. For example, if we look at the latest + greatest matchmaking doc:

https://learn.microsoft.com/en-us/gaming/playfab/features/multiplayer/matchmaking/quickstart

  1. According to this doc, I can either poll every 6s (not ideal) or... no mention of signalr, but the Multiplayer SDK (separate from client sdk) with a link:

https://learn.microsoft.com/en-us/gaming/playfab/features/multiplayer/matchmaking/quickstart-client-sdk

  1. ...but this link calls it the Matchmaking Client SDK, NOT the Multiplayer SDK.

  2. Scrolling down jumps back to calling it a Multiplayer SDK and says to download it here:

https://learn.microsoft.com/en-us/gaming/playfab/features/multiplayer/lobby/lobby-matchmaking-sdks/lobby-matchmaking-sdks

  1. ...which only has the same Game SDK, which is also called the Client SDK, and apparently also called the Multiplayer SDK AND the Matchmaking SDK;

  2. If you dive into the rabbit hole even further, you'll find recommendations to use the OSS with links that eventually (and unexpectedly) revolve back to the same links above, all frustratingly using different keywords of which SDK/APIs to use).


What a wild goose chase of confusion! Please:

  1. What is the difference between these 4 SDKs?

  2. For Unreal users, what is "the" turn-to for matchmaking events so we don't have to poll that's allegedly built-in?

  3. Another link randomly leads to OSS, which is neither signalR OR


For other Googlers, here are some facts discovered along my journey:

  1. The "Matchmaker" API is obsolete and broken (since early 2021 without letting users know).

  2. The "Client/Matchmaking" API is also obsolete and broken (since early 2021 without letting users know).

  3. The "Multiplayer/Matchmaking" API is the one to use for non-events, but for some reason (and confusingly), does not contain callback events -- unlike the deprecated APIs (hinting that this API may actually be a 2-year-old beta that no one seems to have updated).

  4. There is some OSS implementation somewhere, but the docs about OSS all seem to vaguely loop back to the list of SDKs (where only 1 is listed for Unreal).

apissdksunrealdocumentation
10 |1200

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

1 Answer

·
Xiao Zha avatar image
Xiao Zha answered

The first doc link: Matchmaking quickstart - PlayFab | Microsoft Learn you mention is teaching you how to use REST API to matchmaking.

The second doc link: Matchmaking quickstart - client SDK - PlayFab | Microsoft Learn you mention is teaching you how to use Multiplayer SDK(which has built-in real time notification feature).

>> What is the difference between these 4 SDKs?

There is no big difference between these names you mention of the SDKs. All SDK of playfab can be called as Game SDK. And since the Multiplayer SDK used on client and contains 2 parts: Lobby and Matchmaking. So, the Multiplayer Client SDK and Matchmaking Client SDK are all represent the same SDKs which is the SDKs in the doc: Azure PlayFab Lobby SDKs - PlayFab | Microsoft Learn.

>>For Unreal users, what is "the" turn-to for matchmaking events so we don't have to poll that's allegedly built-in? 3.Another link randomly leads to OSS, which is neither signalR OR

Multiplayer SDK for Unreal is the OSS, you can refer to PlayFab Online Subsystem (OSS) Quickstart - PlayFab | Microsoft Learn to set the OSS for Unreal, then refer to Matchmaking quickstart - client SDK - PlayFab | Microsoft Learn.

10 |1200

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.

Write an Answer

Hint: Notify or tag a user in this post by typing @username.

Up to 2 attachments (including images) can be used with a maximum of 512.0 KiB each and 1.0 MiB total.