Tutoriel : débogage local de CloudScript avec Azure Functions

Avec Azure Functions, vous pouvez désormais tester et déboguer votre code CloudScript localement. Une fois ce tutoriel terminé, vous pourrez exécuter votre application Azure Functions locale dans le débogueur (par exemple, dans VS Code ou Visual Studio), définir vos points d’arrêt et exécuter votre client de jeu. Dans ce tutoriel, vous allez apprendre à :

[!div class=“checklist”] * Ajouter une implémentation d’ExecuteFunction à votre application Azure Functions locale * Ajouter un fichier de paramètres indiquant au SDK PlayFab d’appeler cette implémentation locale depuis votre jeu

Prérequis

Actuellement, le débogage local est pris en charge dans les SDK suivants :

Ajouter une implémentation locale d’ExecuteFunction

Pour les applications Azure Functions en C#

Pour configurer l’implémentation locale d’ExecuteFunction dans votre application Azure Functions en C#, ajoutez le fichier ExecuteFunction.cs à votre application Azure Functions locale.

Variables d’environnement requises pour l’implémentation locale d’ExecuteFunction

Ajoutez les paramètres suivants à votre fichier local.settings.json :

Nom	Valeur
PLAYFAB_TITLE_ID	L’ID de votre titre, au format hexadécimal
PLAYFAB_DEV_SECRET_KEY	La clé secrète de votre titre. Vous trouverez vos clés secrètes dans Game Manager en cliquant sur l’icône d’engrenage à droite du nom de votre titre, puis en accédant à Title Settings > Secret Keys.

Par exemple :

{
  "IsEncrypted": false,
  "Values": {
    "AzureWebJobsStorage": "...",
    "FUNCTIONS_WORKER_RUNTIME": "dotnet",
    "PLAYFAB_TITLE_ID": "B55D",
    "PLAYFAB_DEV_SECRET_KEY": "AAAABBBBCCCCDDDDEEEEFFFFGGGGHHHHIIIIJJJJKKKKLLLLMM"
  }
}

Configurer le SDK PlayFab pour appeler l’implémentation locale d’ExecuteFunction

Pour indiquer au SDK PlayFab de rediriger les appels d’API ExecuteFunction vers votre implémentation locale, ajoutez un fichier nommé playfab.local.settings.json à l’un des deux emplacements suivants :

Le répertoire temporaire de votre machine
- Sous Windows, il s’agit de la variable d’environnement TEMP
- Sous Linux/Mac, il s’agit de la variable d’environnement TMPDIR
Le répertoire de l’exécutable de votre jeu

Définissez le contenu du fichier comme suit :

{ "LocalApiServer": "http://localhost:<portNumber>/api/<functionName>" }

Lorsque vous souhaitez arrêter les redirections locales et faire en sorte qu’ExecuteFunction appelle le serveur d’API PlayFab, supprimez le fichier playfab.local.settings.json.

Ressources supplémentaires

Azure Functions propose un excellent guide expliquant comment tester et déboguer vos fonctions localement. Voici quelques points importants de ce document.

Assurez-vous qu’Azure Functions Core Tools est installé
Configurez votre fichier de paramètres locaux. Pour plus d’informations, consultez Développer Azure Functions à l’aide de Visual Studio Code
Définissez un point d’arrêt dans votre code
Appuyez sur F5 pour démarrer le débogage

XBOX Services

PlayFab

Débogage local de CloudScript avec Azure Functions

Tutoriel : débogage local de CloudScript avec Azure Functions

Prérequis

Ajouter une implémentation locale d’ExecuteFunction

Pour les applications Azure Functions en C#

Variables d’environnement requises pour l’implémentation locale d’ExecuteFunction

Configurer le SDK PlayFab pour appeler l’implémentation locale d’ExecuteFunction

Ressources supplémentaires

​Tutoriel : débogage local de CloudScript avec Azure Functions

​Prérequis

​Ajouter une implémentation locale d’ExecuteFunction

​Pour les applications Azure Functions en C#

​Variables d’environnement requises pour l’implémentation locale d’ExecuteFunction

​Configurer le SDK PlayFab pour appeler l’implémentation locale d’ExecuteFunction

​Ressources supplémentaires

Tutoriel : débogage local de CloudScript avec Azure Functions

Prérequis

Ajouter une implémentation locale d’ExecuteFunction

Pour les applications Azure Functions en C#

Variables d’environnement requises pour l’implémentation locale d’ExecuteFunction

Configurer le SDK PlayFab pour appeler l’implémentation locale d’ExecuteFunction

Ressources supplémentaires