Démarrage rapide Java pour Java natif et Android Studio

• Obtenir les fichiers JAR nécessaires.
• Ajouter les fichiers JAR au classpath.
• Créer une application console Java minimale qui exécute l’appel d’API de connexion par ID personnalisé.

​

Obtenir les fichiers JAR nécessaires

​

Configuration du projet avec Intellij Idea

​

Configuration du projet avec n’importe quel IDE

​

Configurer votre premier appel d’API

import java.util.concurrent.*;
import java.util.*;

import com.playfab.PlayFabErrors.*;
import com.playfab.PlayFabSettings;
import com.playfab.PlayFabClientModels;
import com.playfab.PlayFabClientAPI;

public class Main
{
    private static boolean _running = true;

    public static void main(String[] args) {
        PlayFabSettings.TitleId = "144";

        PlayFabClientModels.LoginWithCustomIDRequest request = new PlayFabClientModels.LoginWithCustomIDRequest();
        request.CustomId = "GettingStartedGuide";
        request.CreateAccount = true;

        FutureTask<PlayFabResult<com.playfab.PlayFabClientModels.LoginResult>> loginTask = PlayFabClientAPI.LoginWithCustomIDAsync(request);
        loginTask.run();

        while (_running) {
            if (loginTask.isDone()) { // You would probably want a more sophisticated way of tracking pending async API calls in a real game
                OnLoginComplete(loginTask);
            }

            // Presumably this would be your main game loop, doing other things
            try {
                Thread.sleep(1);
            } catch(Exception e) {
                System.out.println("Critical error in the example main loop: " + e);
            }
        }
    }

    private static void OnLoginComplete(FutureTask<PlayFabResult<com.playfab.PlayFabClientModels.LoginResult>> loginTask) {
        PlayFabResult<com.playfab.PlayFabClientModels.LoginResult> result = null;
        try {
            result = loginTask.get(); // Wait for the result from the async call
        } catch(Exception e) {
            System.out.println("Exception in PlayFab api call: " + e); // Did you assign your PlayFabSettings.TitleId correctly?
        }

        if (result != null && result.Result != null) {
            System.out.println("Congratulations, you made your first successful API call!");
        } else if (result != null && result.Error != null) {
            System.out.println("Something went wrong with your first API call.");
            System.out.println("Here's some debug information:");
            System.out.println(CompileErrorsFromResult(result));
        }

        _running = false; // Because this is just an example, successful login triggers the end of the program
    }

    // This is a utility function we haven't put into the core SDK yet. Feel free to use it.
    private static <RT> String CompileErrorsFromResult(PlayFabResult<RT> result) {
        if (result == null || result.Error == null)
            return null;

        String errorMessage = "";
        if (result.Error.errorMessage != null)
            errorMessage += result.Error.errorMessage;
        if (result.Error.errorDetails != null)
            for (Map.Entry<String, List<String>> pair : result.Error.errorDetails.entrySet() )
                for (String msg : pair.getValue())
                    errorMessage += "\n" + pair.getKey() + ": " + msg;
        return errorMessage;
    }
}

​

Terminer et exécuter

1. Sélectionnez la flèche de lecture > dans le coin supérieur droit. Cela démarre l’exécution du programme et le panneau de sortie s’affiche.
2. Repérez le message de débogage. Il indique que l’appel d’API a réussi.

​

Analyse du code

• Imports
  • Il s’agit de l’ensemble minimal d’imports utilisés pour effectuer des appels d’API PlayFab.
• public static void main(String[] args) {
  • Une simple boucle qui lance un appel d’API et attend qu’il se termine.
  • PlayFabSettings.TitleId = "xxxx";
    • Chaque développeur PlayFab crée un titre dans Game Manager. Lorsque vous publiez votre jeu, vous devez coder ce titleId dans votre jeu. Cela permet au client de savoir comment accéder aux bonnes données dans PlayFab. Pour la plupart des utilisateurs, considérez simplement qu’il s’agit d’une étape obligatoire pour que PlayFab fonctionne.
  • PlayFabClientModels.LoginWithCustomIDRequest request = new PlayFabClientModels.LoginWithCustomIDRequest();
    • La plupart des méthodes de l’API PlayFab nécessitent des paramètres d’entrée, et ces paramètres d’entrée sont regroupés dans un objet de requête.
    • Chaque méthode d’API nécessite un objet de requête unique, avec un mélange de paramètres facultatifs et obligatoires.
      • Pour LoginWithCustomIDRequest, il existe un paramètre obligatoire CustomId, qui identifie un joueur de façon unique, et CreateAccount, qui permet de créer un nouveau compte avec cet appel.
    • Pour la connexion, la plupart des développeurs voudront utiliser une méthode de connexion plus appropriée.
      • Consultez la documentation sur la connexion PlayFab pour obtenir la liste de toutes les méthodes de connexion et de leurs paramètres d’entrée. Les choix courants sont :
        • LoginWithAndroidDeviceID
        • LoginWithIOSDeviceID
        • LoginWithEmailAddress
  • FutureTask<PlayFabResult<com.playfab.PlayFabClientModels.LoginResult>> loginTask = PlayFabClientAPI.LoginWithCustomIDAsync(request);
    • Cette ligne lance la requête asynchrone vers LoginWithCustomID à l’aide du framework FutureTask de Java.
  • While (running) { if (loginTask.isDone()) { OnLoginComplete(loginTask); } }
    • Exécute une boucle principale triviale et attend de façon asynchrone que loginTask se termine.
    • Une fois terminé, appelle OnLoginComplete.
• OnLoginComplete (loginTask)
  • result = loginTask.get();
    • Récupère le résultat asynchrone (cela ne provoque pas de blocage, car nous avons confirmé que la FutureTask est déjà terminée).
  • Si (result.Result != null), l’appel d’API a réussi.
    • En cas de réussite, l’objet result.Result de nombreux rappels d’API contient les informations demandées.
    • LoginResult contient plus précisément des informations de base sur le joueur. Mais pour la plupart des utilisateurs, la connexion est simplement une étape obligatoire avant d’appeler d’autres API.
  • Si (result.Error != null), l’appel d’API a échoué.
    • Les appels d’API peuvent échouer pour de nombreuses raisons, et vous devez toujours essayer de gérer les échecs.
    • Raisons pour lesquelles les appels d’API échouent (par ordre de probabilité)
      • PlayFabSettings.TitleId n’est pas défini. Si vous oubliez de définir TitleId sur votre titre, rien ne fonctionnera.
      • Paramètres de la requête. Si vous n’avez pas fourni les informations correctes ou requises pour un appel d’API particulier, celui-ci échouera. Consultez error.errorMessage, error.errorDetails ou error.GenerateErrorReport() pour plus d’informations.
      • Problème de connectivité de l’appareil. Les téléphones portables perdent et retrouvent constamment la connectivité. Ainsi, n’importe quel appel d’API peut échouer de façon aléatoire à tout moment, puis fonctionner immédiatement après. Entrer dans un tunnel peut vous déconnecter complètement.
      • Problème de serveur PlayFab. Comme pour tout logiciel, des problèmes peuvent survenir. Consultez nos notes de publication pour connaître les mises à jour.
      • Internet n’est pas fiable à 100 %. Parfois, le message est corrompu ou n’atteint pas le serveur PlayFab.
  • Si vous avez des difficultés à déboguer un problème et que les informations d’erreur ne suffisent pas, rendez-vous sur nos forums.