Tratar erros do SDK de Lobby e Matchmaking
Esta página pretende servir como uma referência rápida com orientações sobre como os SDKs de Lobby e Matchmaking do PlayFab expõem erros e como você deve tratá-los. Os seguintes tópicos são abordados:Erros síncronos e assíncronos
Muitas APIs do SDK são assíncronas. Você inicia uma operação chamando uma API como PFMultiplayerCreateAndJoinLobby e, mais tarde, essa operação assíncrona é concluída com uma “alteração de estado” como PFLobbyCreateAndJoinLobbyCompletedStateChange. Isso significa que, ao usar as APIs assíncronas de cliente de Lobby e Matchmaking, há dois tipos de erros que você precisa tratar:- erros síncronos
- erros assíncronos
Erros síncronos
“Erros síncronos” são HRESULTs fornecidos como valor de retorno de uma chamada de API. Esses erros geralmente se devem a chamar a API com parâmetros incorretos, chamar a API enquanto a biblioteca está em um estado inválido ou a falhas internas da biblioteca ao alocar memória. Todos os parâmetros de saída fornecidos pela API devem ser considerados inválidos se a API retornar um erro síncrono. Ao chamar APIs assíncronas (por exemplo, PFMultiplayerCreateAndJoinLobby), o valor de erro síncrono só representa se a operação solicitada pôde ser iniciada. Para obter informações sobre como entender o resultado de uma operação assíncrona, consulte a seção Erros assíncronos.Erros assíncronos
Os “erros assíncronos” são fornecidos como HRESULTs na alteração de estado associada à conclusão assíncrona de cada operação, no campo result. Esses erros normalmente são mais relevantes para os títulos do que os erros síncronos. Uma lista não exaustiva de alguns dos tipos de erros relatados de forma assíncrona inclui:- erros de limitação do serviço
- erros de parâmetro inválido que não podem ser validados de forma síncrona no cliente
- erros na interação com o serviço de mensagens em tempo real
- erros de conectividade