XblMultiplayerManagerFindMatch
Envía una solicitud de emparejamiento al servidor.Sintaxis
Parámetros
hopperName _In_z_Tipo: char* El nombre del hopper para esta solicitud. attributesJson _In_opt_z_
Tipo: char* Opcional. Los atributos del ticket de partida para esta solicitud, como una cadena JSON. timeoutInSeconds _In_
Tipo: uint32_t El tiempo máximo, en segundos, que se debe esperar a que los usuarios se unan a la partida.
Valor devuelto
Tipo: HRESULT Código de retorno HRESULT para esta operación de API.Comentarios
Esta función envía una solicitud de emparejamiento para la sesión de sala a Multiplayer Manager (MPM). Antes de poder usar esta función, primero debe configurar los hoppers en la configuración del servicio de su título. Un hopper define las reglas que SmartMatch usa para emparejar a los jugadores. Para obtener más información sobre los hoppers, consulte Información general del emparejamiento. Si no existe una sesión de sala, probablemente porque no se llamó a XblMultiplayerManagerInitialize, o si no se agregaron usuarios locales a la sesión de sala antes de llamar a esta función, se produce un error. También se produce un error si el emparejamiento ya está en curso.El resultado de esta función se entrega como un evento multijugador con un tipo de evento establecido en
XblMultiplayerEventType::FindMatchCompleted. Puede llamar a XblMultiplayerManagerDoWork para recuperar los eventos multijugador.
Requisitos
Encabezado: multiplayer_manager_c.h Biblioteca: Microsoft.Xbox.Services.14x.GDK.C.libConsulte también
multiplayer_manager_cXblMultiplayerManagerEstimatedMatchWaitTime