Sintaxe
Parâmetros
handle PFMultiplayerHandle
O identificador da instância da API PFMultiplayer.
server PFEntityKey*
A entidade de servidor.
configuration PFMatchmakingServerBackfillTicketConfiguration*
A configuração do tíquete de preenchimento de vagas.
asyncContext void*opcional Um valor de contexto opcional, definido pelo aplicativo e do tamanho de um ponteiro, que pode ser usado para associar a alteração de estado de conclusão a esta chamada.
ticket PFMatchmakingTicketHandle*saída alocada pela biblioteca O objeto de tíquete resultante.
Valor retornado
Tipo: HRESULTS_OK se a chamada tiver êxito ou um código de erro caso contrário. A forma legível do código de erro pode ser obtida por meio de PFMultiplayerGetErrorMessage().
Comentários
Para usar este recurso, você precisa definir PFMULTIPLAYER_INCLUDE_SERVER_APIS antes de incluir PFMatchmaking.h.A biblioteca envia automática e assincronamente um tíquete de preenchimento de vagas do servidor ao serviço de matchmaking. Sempre que o status do tíquete muda, uma PFMatchmakingTicketStatusChangedStateChange é fornecida. O status do tíquete pode ser consultado a qualquer momento por meio de PFMatchmakingTicketGetStatus(). O tíquete começa imediatamente no estado
PFMatchmakingTicketStatus::Creating. Quando o tíquete é concluído, uma PFMatchmakingTicketStatusChangedStateChange é fornecida. Nesse ponto, uma partida para o tíquete de preenchimento de vagas foi encontrada ou o tíquete parou devido a uma falha. Em caso de êxito, a partida encontrada pode ser consultada por meio de PFMatchmakingTicketGetMatch(). O
regionPreferences em PFMatchmakingMatchDetails contém apenas a região em que o servidor está localizado. Se a criação do tíquete falhar porque já existem tíquetes demais para os usuários especificados na configuração, a biblioteca cancelará de forma transparente esses tíquetes pendentes e tentará criar o tíquete novamente.
Esta função exige que uma chamada anterior a PFMultiplayerSetEntityToken() tenha sido feita para definir o token de entidade do servidor de jogo.