Gestion des erreurs du SDK Lobby et Matchmaking
Cette page sert de référence rapide sur la façon dont les SDK PlayFab Lobby et Matchmaking signalent les erreurs et sur la manière de les gérer. Les sujets suivants sont abordés :Erreurs synchrones et asynchrones
De nombreuses API du SDK sont asynchrones. Vous démarrez une opération en appelant une API telle que PFMultiplayerCreateAndJoinLobby, puis cette opération asynchrone se termine plus tard par un « changement d’état » tel que PFLobbyCreateAndJoinLobbyCompletedStateChange. Cela signifie que, lorsque vous utilisez les API clientes asynchrones Lobby et Matchmaking, vous devez gérer deux types d’erreurs :- les erreurs synchrones
- les erreurs asynchrones
Erreurs synchrones
Les « erreurs synchrones » sont des HRESULT fournis comme valeur de retour d’un appel d’API. Ces erreurs sont généralement dues à l’appel de l’API avec des paramètres incorrects, à l’appel de l’API alors que la bibliothèque se trouve dans un état non valide, ou à des échecs internes d’allocation de mémoire de la bibliothèque. Tous les paramètres de sortie fournis par l’API doivent être considérés comme non valides si l’API renvoie une erreur synchrone. Lors de l’appel d’API asynchrones (par exemple PFMultiplayerCreateAndJoinLobby), la valeur d’erreur synchrone indique uniquement si l’opération demandée a pu démarrer. Pour savoir comment interpréter le résultat d’une opération asynchrone, consultez la section Erreurs asynchrones.Erreurs asynchrones
Les « erreurs asynchrones » sont fournies sous forme de HRESULT dans le changement d’état associé à l’achèvement asynchrone de chaque opération, dans le champ result. Ces erreurs sont généralement plus intéressantes pour les titres que les erreurs synchrones. Voici une liste non exhaustive de types d’erreurs signalées de manière asynchrone :- erreurs de limitation du service
- erreurs de paramètres non valides qui ne peuvent pas être validées de manière synchrone sur le client
- erreurs d’interaction avec le service de messages en temps réel
- erreurs de connectivité