Class UMatchmakerClientBlueprintApi
Review the Matchmaker Client Blueprint API reference for creating and managing matchmaking tickets.
Read time 2 minutesLast updated 2 days ago
Important
Unity Matchmaker currently supports Multiplay hosting, or a client-hosted solution provided by Unity, such as Relay and Distributed Authority. The team is working on extending support to third party hosting providers (including Multiplay by Rocket Science and others), and is aiming to deliver this support in advance of March 31st, 2026. Matchmaker will continue to work with Relay and Distributed Authority.
Declaration
Inherits from UBlueprintFunctionLibraryUCLASS()class UMatchmakerClientBlueprintApi : public UBlueprintFunctionLibrary
Delegates
FCreateTicketResponseDelegate
Declaration
DECLARE_DYNAMIC_DELEGATE_OneParam(FCreateTicketResponseDelegate, FCreateTicketResponse, Response)
Return Type
FCreateTicketResponseFDeleteTicketResponseDelegate
Declaration
DECLARE_DYNAMIC_DELEGATE_OneParam(FDeleteTicketResponseDelegate, FDeleteTicketResponse, Response)
Return Type
FDeleteTicketResponseFGetTicketStatusResponseDelegate
Declaration
DECLARE_DYNAMIC_DELEGATE_OneParam(FGetTicketStatusResponseDelegate, FGetTicketStatusResponse, Response)
Return Type
FGetTicketStatusResponseMethods
CreateTicket
Creates a matchmaking ticket effectively starting matchmaking.Declaration
UFUNCTION(BlueprintCallable, Category = "Unity Gaming Services | Matchmaker", meta = (WorldContext = "WorldContextObject"))static void CreateTicket(TArray<FMatchmakerPlayer> Players, FCreateTicketOptions Options, FCreateTicketResponseDelegate ResponseHandler, const UObject* WorldContextObject)
Parameters
Name | Type | Description |
|---|---|---|
| TArray | List of players to be added to the ticket (should include at least 1 player). |
| FCreateTicketOptions | Options for creating the ticket. |
| FCreateTicketResponseDelegate | The response callback to use once CreateTicket has finished. |
| |
DeleteTicket
Deletes a matchmaking ticket, ending the matchmaking process. This is called when the client wants to cancel matchmaking for the client.Declaration
UFUNCTION(BlueprintCallable, Category = "Unity Gaming Services | Matchmaker", meta = (WorldContext = "WorldContextObject"))static void DeleteTicket(FGuid TicketId, FDeleteTicketResponseDelegate ResponseHandler, const UObject* WorldContextObject)
Parameters
Name | Type | Description |
|---|---|---|
| FGuid | ID of the ticket to delete. |
| FDeleteTicketResponseDelegate | The response callback to use once DeleteTicket has finished. |
| |
GetTicketStatus
Gets the status of a ticket assignment in the matchmaker. Poll until the assignment is fulfilled. For more information about polling speed and rate limits, refer to Matchmaker limitations.Declaration
UFUNCTION(BlueprintCallable, Category = "Unity Gaming Services | Matchmaker", meta = (WorldContext = "WorldContextObject"))static void GetTicketStatus(FGuid TicketId, FGetTicketStatusResponseDelegate ResponseHandler, const UObject* WorldContextObject)
Parameters
Name | Type | Description |
|---|---|---|
| FGuid | ID of the ticket to access. |
| FGetTicketStatusResponseDelegate | The response callback to use once CreateTicket has finished. |
| |