PlayFab Multiplayer C++ SDK release notes

1.7.2

March 7, 2024

Bug fixes

  • Fixed an issue where the internal PubSub notification WebSocket was slow to detect and react to disconnects, which could lead to errors to create or join lobbies and matchmaking tickets.
  • Fixed an issue where failure of PubSub to establish connection with the SignalR service would not trigger a failed state change and would not allow subsequent Multiplayer API calls to subscribe to PubSub.
  • Improved internal diagnostics.

1.7.1

February 14, 2024

New Features

1.6.5

November 15, 2023

New Features

Bug fixes

  • Improved internal diagnostics.

1.6.4

August 16, 2023

Bug fixes

  • Fixes a bug where the GDK DLL was not being codesigned. This is a GDK-only release.

1.6.3

August 14, 2023

Bug fixes

  • Fixed an issue where the library may crash while handling a change notification.
  • Added new PFLobbyMemberCountRemainingSearchKey constant to make it easier to search for and sort lobbies based on their remaining member counts.

1.6.2

July 14, 2023

Bug fixes

  • Fixed an issue where matchmaking operations started by PFMultiplayerJoinMatchmakingTicketFromId timed out prematurely.
  • Fixed an issue where PFMatchmakingTicketGetTicketId could provide a null value if called shortly after starting a matchmaking operation. Now, an empty string is provided as expected.
  • Fixed an issue where the macOS library was identifying as iOS via web request headers. This identification is primarily used for diagnostics.
  • Improved internal diagnostics.

1.6.1

June 14, 2023

  • On PlayStation®4 and, PlayStation®5, PlayFab Multiplayer cleans up all resources associated with it and reinitialize if the title enters and remains in background mode for more than 10 minutes.

“PlayStation” is a registered trademark or trademark of Sony Interactive Entertainment Inc.

1.6.0

June 14, 2023

New Features

1.5.3

April 25, 2023

Bug fixes

  • Fix a linker error specific to iOS and macOS where HttpClient.framework would not be found during runtime.

1.5.2

April 4, 2023

Bug fixes

  • Introduce the PFMultiplayerPal.h header, which provides support for non-MSVC compilers. This header defines SAL and HRESULTs for non-MSVC compiled platforms.

1.5.1

March 20, 2023

New features

  • PlayFab Multiplayer v1.5.1 brings support for Linux and Windows Subsystem for Linux (WSL).

1.5.0

March 16, 2023

New Features

For more information on using server-owned lobbies, see Game servers and lobbies.

Bug fixes

  • Mitigation to reduce unexpected PubSub disconnects due to background thread contention

1.4.3

November 15, 2022

New features

  • PlayFab Multiplayer v1.4.3 brings support for iOS and macOS.

1.4.2

October 26, 2022

Bug fixes

  • Fixed a bug where PubSub reconnects could cause future PubSub unsubscribe requests to fail.

1.4.1

October 25, 2022

Bug fixes

  • Fixed a bug where unnecessary, short-lived threads would spawn.
  • On Windows, Xbox, and Android, fixed a bug where the library may attempt web requests before a previously recorded retry-after period expires.
  • Improve the error message if a web server can’t be reached.

1.4.0

October 11, 2022

New features

  • PlayFab Multiplayer v1.4.0 brings support for Android.

1.3.1

September 20, 2022

Bug fixes

  • Fixed a bug that caused websocket resources to leak memory when PFMultiplayerUninitialize was called or when the library internally handled app suspension on Xbox consoles.

1.3.0

September 9, 2022

New features

  • Implemented a new function, PFLobbyGetMemberConnectionStatus, which can be used to detect whether a user is connected to the PubSub notification service. When a user's connection status changes, you receive a PFLobbyUpdatedStateChange with a PFLobbyMemberUpdateSummary where the connectionStatusUpdated field is true.
  • Updated the protocol used to exchange messages with the PubSub notification service from JSON to MessagePack, decreasing the message sizes. This change has no impact on the API surface.

Bug fixes

1.2.0

August 17, 2022

New features

  • The match details now report server details associated with the multiplayer server allocated when a match is found, if the matchmaking queue is configured to allocate multiplayer servers. For more information, see PFMatchmakingMatchDetails.
  • A new constant, PFLobbyAmOwnerSearchKey, is defined for the lobby/amOwner search key. For more information on using search keys, see PFLobbySearchConfiguration.

Bug fixes

  • Improved the message reported by PFMultiplayerGetErrorCode for several error codes.
  • Fixed a bug where entities weren't unsubscribed from the notification service under some failure conditions.

1.1.5

July 13, 2022

Bug fixes

  • Fixed incorrect constant string values for PFLobbyMemberCountSearchKey and PFLobbyAmMemberSearchKey in the PFLobby.h header
  • Fixed a bug, which could cause PFMultiplayerUninitialize() to block indefinitely if a websocket closes unexpectedly
  • Fixed a bug, which caused PubSub notifications to become unusable and Lobby/Matchmaking API operations to stall out indefinitely after an unexpected websocket disconnect

1.1.4

June 24, 2022

Bug fixes

  • GDK: Fixed a bug where operations involving network communication would silently fail if performed too soon following suspend/resume.
  • Fixed a bug where the SDK crashes when resuming execution after being broken into the debugger for 10+ seconds.

1.1.3

June 10, 2022

New features

  • The SDK is now more responsive to unexpected disconnections (detected 2-3x faster than previously).
  • Unexpected Lobby disconnections will now result in automatic reconnect attempts - the disconnect is communicated to the client only after these reconnect attempts fail.
  • GDK/Win32: Web service failure responses (429, 503, etc.) will now result in automatic retries - a failure is communicated to the client only after these retries fail.

Bug fixes

  • Fixed a bug where matchmaking failed after 10 consecutive matches.
  • Fixed a bug where GetErrorMessage(...) functionality didn't provide error messages related to matchmaking.
  • Fixed a bug where two fields in the LobbySearchResult struct weren't correctly populated (maxMemberCount and currentMemberCount).
  • Fixed various bugs related to behavior/reliability following suspend/resume.

1.1.1

April 13, 2022

Bug fixes

  • Switch: Provides a new PAL header required to build against PlayFab Multiplayer.

1.1.0

March 4, 2022

API changes

  • PFMultiplayerGetErrorMessage's API signature changed. Previously this function returned an HRESULT and used an output parameter to return the error message string. Now the function returns the string directly.

New features

  • GDK: Added support for automatically handling suspend and resume on Xbox.

Bug fixes

  • Fixed a bug where using initial member data passed to PFMultiplayerJoinLobby would be ignored if the player was rejoining a lobby.

1.0.0

November 23, 2021

PlayFab Multiplayer is now available in private preview. For an overview of Matchmaking and Lobby features, check out: