Démarrage rapide Python

• Comme outil d’administration autonome en console pour la maintenance de votre jeu.
• Intégré à un moteur de jeu existant basé sur Python.
  • Pour obtenir la liste des moteurs de jeu Python, consultez PythonGameLibraries sur le site web python.org.

​

Prérequis

• Un compte de développeur PlayFab.
• Python 3 installé sur votre système.
  • Le module requests doit également être installé.

​

Configuration du projet Python

1. Depuis une invite de commandes, installez le package PlayFab à l’aide de la commande suivante.

pip install playfab

python -m pip install playfab

2. Dans le répertoire de votre projet, créez un script Python appelé playfab_test.py.

​

Configurer votre premier appel d’API

from playfab import PlayFabClientAPI, PlayFabSettings

PlayFabSettings.TitleId = "144"

request = {
    "CustomId": "GettingStartedGuide",
    "CreateAccount": True
}

def callback(success, failure):
    if success:
        print("Congratulations, you made your first successful API call!")
    else:
        print("Something went wrong with your first API call.  :(")
        if failure:
            print("Here's some debug information:")
            print(failure.GenerateErrorReport())
PlayFabClientAPI.LoginWithCustomID(request, callback)

​

Terminer et exécuter

python playfab_test.py

​

Analyse du code

• Imports
  • Les imports PlayFab vous donnent accès aux API.
• PlayFabSettings.TitleId = "144"
  • 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.
• request
  • 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 dictionnaire.
    • LoginWithCustomIDRequest accepte un paramètre obligatoire CustomId, qui identifie un joueur de manière unique et renvoie le jeton d’entité associé, ainsi que 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
• Rappel
  • Réussite
    • Si l’appel d’API a réussi, success contient les informations demandées et failure vaut None.
    • Pour les requêtes de connexion, success contient 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.
  • Échec
    • Si l’appel d’API a échoué, failure contient des informations sur l’erreur et success vaut None.
    • Les appels d’API peuvent échouer pour de nombreuses raisons, et vous devez toujours essayer de gérer l’échec.
    • 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.
      • 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 manière 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.
• PlayFabClientAPI.LoginWithCustomID
  • Déclenche l’appel d’API de manière synchrone. Une fois terminé, le rappel est invoqué.