Richiedi il matchmaking per i giocatori

Aggiungi codice al servizio di backend del gioco per gestire le richieste di matchmaking a un FlexMatch matchmaker. Il processo di richiesta FlexMatch il matchmaking è identico per i giochi che utilizzano FlexMatch con Amazon GameLift Servers hosting e per giochi che utilizzano FlexMatch come soluzione autonoma.

Per creare una richiesta di matchmaking:

Chiama il Amazon GameLift Servers API StartMatchmaking. Ogni richiesta deve contenere le seguenti informazioni.

Matchmaker

Il nome della configurazione di matchmaking da utilizzare per la richiesta. FlexMatch inserisce ogni richiesta nel pool per il matchmaker specificato, e la richiesta viene elaborata in base a come è configurato il matchmaker. Questo include l'applicazione di un limite di tempo, l'indicazione se richiedere l'accettazione degli abbinamenti ai giocatori, la coda da utilizzare durante il posizionamento di una sessione di gioco risultante e così via. Ulteriori informazioni sui matchmaker e sui set di regole sono disponibili in Progetta un FlexMatch paraninfo.

ID del ticket

Un ID ticket univoco assegnato alla richiesta. Tutti gli elementi correlati alla richiesta, tra cui gli eventi e le notifiche, fanno riferimento all'ID ticket.

Dati dei giocatori

L'elenco dei giocatori per cui vuoi creare un abbinamento. Se uno qualsiasi dei giocatori nella richiesta non soddisfa i requisiti di corrispondenza, in base alle regole di corrispondenza e ai minimi di latenza, la richiesta di abbinamento non produrrà mai una corrispondenza con esito positivo. È possibile includere fino a dieci giocatori in una richiesta di abbinamento. Quando ci sono più giocatori in una richiesta, FlexMatch cerca di creare una singola partita e assegnare tutti i giocatori alla stessa squadra (selezionata casualmente). Se una richiesta contiene troppi giocatori da inserire in una delle squadre di abbinamento, la richiesta non verrà abbinata. Ad esempio, se hai configurato il matchmaker per creare corrispondenze 2v2 (due squadre di due giocatori), non puoi inviare una richiesta di abbinamento contenente più di due giocatori.

Nota

Un giocatore (identificato dal proprio ID giocatore) può essere incluso solo in una richiesta di abbinamento attiva alla volta. Quando crei una nuova richiesta per un giocatore, qualsiasi ticket di abbinamento attivo con lo stesso ID giocatore viene automaticamente annullato.

Per ogni giocatore elencato, sono inclusi i seguenti dati:

• ID giocatore: ogni giocatore deve avere un ID giocatore univoco, generato dall'utente. Vedi Generare un giocatore IDs.

• Attributi del giocatore: se il matchmaker in uso richiede gli attributi del giocatore, la richiesta deve fornire tali attributi per ogni giocatore. Gli attributi di giocatore richiesti sono definiti nel set di regole del matchmaker, che specifica anche il tipo di dati per l'attributo. L'attributo di un giocatore è facoltativo solo quando il set di regole specifica un valore predefinito per l'attributo. La richiesta di abbinamento non potrà mai essere completata se non fornisce gli attributi richiesti per tutti i giocatori. Per ulteriori informazioni sul set di regole del matchmaker e sugli attributi di giocatore, consulta Costruisci un FlexMatch set di regole e FlexMatch esempi di set di regole.

• Latenze dei giocatori: se il matchmaker in uso ha una regola di latenza del giocatore, la richiesta deve riportare la latenza per ogni giocatore. I dati di latenza del giocatore sono un elenco di uno o più valori per giocatore. Rappresenta la latenza che il giocatore prova per le regioni nella coda del matchmaker. Se nella richiesta non sono inclusi valori di latenza per un giocatore, il giocatore non può essere abbinato e la richiesta non riesce.

Per recuperare i dettagli della richiesta di partita

Dopo l'invio di una richiesta di incontro, puoi visualizzare i dettagli della richiesta chiamando DescribeMatchmakingcon l'ID del ticket della richiesta. Questa chiamata restituisce le informazioni sulla richiesta, incluso lo stato corrente. Una volta che una richiesta è stata completata, il ticket contiene anche le informazioni necessarie a un client di gioco per connettersi all'abbinamento.

Per annullare una richiesta di abbinamento

Puoi annullare una richiesta di matchmaking in qualsiasi momento chiamando StopMatchmakingcon l'ID del ticket della richiesta.