Skip to main content

XblMultiplayerManagerFindMatch

Envia uma solicitação de matchmaking ao servidor.

Sintaxe

Parâmetros

hopperName   _In_z_
Tipo: char*
O nome do hopper desta solicitação. attributesJson   _In_opt_z_
Tipo: char*
Opcional. Os atributos do tíquete de partida desta solicitação, como uma cadeia de caracteres JSON. timeoutInSeconds   _In_
Tipo: uint32_t
O tempo máximo, em segundos, de espera para que os usuários ingressem na partida.

Valor retornado

Tipo: HRESULT Código de retorno HRESULT para esta operação de API.

Comentários

Esta função envia uma solicitação de matchmaking da sessão de lobby ao Multiplayer Manager (MPM). Antes de usar esta função, você deve primeiro configurar hoppers na configuração de serviço do seu título. Um hopper define as regras que o SmartMatch usa para combinar jogadores. Para obter mais informações sobre hoppers, consulte Visão geral do matchmaking. Se não existir uma sessão de lobby, provavelmente porque XblMultiplayerManagerInitialize não foi chamada, ou se os usuários locais não tiverem sido adicionados à sessão de lobby antes de chamar esta função, ocorrerá um erro. Também ocorrerá um erro se o matchmaking já estiver em andamento.
O resultado desta função é entregue como um evento multijogador com o tipo de evento definido como XblMultiplayerEventType::FindMatchCompleted. Você pode chamar XblMultiplayerManagerDoWork para recuperar eventos multijogador.

Requisitos

Cabeçalho: multiplayer_manager_c.h Biblioteca: Microsoft.Xbox.Services.14x.GDK.C.lib

Confira também

multiplayer_manager_c
XblMultiplayerManagerEstimatedMatchWaitTime
Last modified on October 6, 2026