Démarrage rapide des tâches planifiées

Ce démarrage rapide vous montre comment créer une tâche qui s’exécute selon un horaire. De nombreuses routines d’exploitation d’un jeu peuvent être automatisées à l’aide d’une tâche planifiée, par exemple :

Modifier les prix d’une boutique selon le moment de la journée.
Mettre à jour les données de titre pour refléter les changements liés à un événement en cours.
Injecter quotidiennement des monnaies virtuelles dans l’économie du jeu, etc.

Dans l’exemple utilisé dans ce démarrage rapide, nous vous montrerons comment modifier une variable de jeu appelée rareDropRate dans les données de titre à 12 h UTC, et uniquement les jours de fin de semaine.

Étape 1 - Préparer le CloudScript

Dans Game Manager :

Sélectionnez Automation dans le menu de gauche.
Dans l’onglet CloudScript Revisions, ajoutez une nouvelle fonction CloudScript appelée adjustRareDropRate avec un simple appel à l’API SetTitleData, comme le montrent l’extrait de code et l’image ci-dessous.

Pour les plus attentifs, ne vous inquiétez pas : il y a un bogue intentionnel. Assurez-vous de déployer la nouvelle révision afin qu’elle soit active dans votre jeu.

Vous pouvez en apprendre davantage sur l’utilisation de CloudScript dans notre démarrage rapide de CloudScript, ainsi que dans la documentation de la méthode ExecuteCloudScript.

handlers.adjustRareDropRate = function(args) {
    // Tutorial demo CloudScript
    serverAPI.SetTitleData({
        "Key": "rareDropRate",
        "Value": args.dropRate
    });
}

Game Manager - CloudScript - Déployer une nouvelle révision

Étape 2 - Créer une tâche planifiée

Sélectionnez maintenant Servers dans le menu de gauche.

Allez à l’onglet Scheduled Tasks.
Sélectionnez New Scheduled Task dans le coin supérieur droit de votre écran.
La vue Create Task s’affiche.
Dans le champ Type of task, choisissez Run a CloudScript function.
En dessous, vous pourrez choisir une fonction dans la révision de CloudScript actuellement déployée et préciser les arguments à transmettre.
Choisissez le gestionnaire adjustRareDropRate que vous avez écrit à l’étape précédente.

Pour définir l’horaire de cette tâche :

Sélectionnez On a schedule (UTC) sous l’en-tête SCHEDULE.
Un générateur d’horaire simple vous permet de choisir quand la tâche doit s’exécuter (toutes les heures, tous les jours, toutes les semaines, etc.).
Pour cet exemple, nous voulons un horaire avancé, dans lequel nous pouvons préciser les jours de la semaine où exécuter la tâche.
Sélectionnez donc CRON EXPRESSION.

L’expression cron, hautement personnalisable, vous permet de créer un horaire très complexe; il est toutefois important de noter que nous autorisons actuellement uniquement les horaires dont les occurrences tombent sur des multiples de 5 minutes dans l’heure. Par exemple, vous pouvez définir une tâche pour qu’elle s’exécute à la 5e, 10e, 25e ou 50e minute de l’heure, mais vous ne pouvez pas définir une tâche pour qu’elle s’exécute à la 3e, 11e ou 46e minute de l’heure. Si vous souhaitez en apprendre davantage sur les expressions cron, crontab.guru offre des renseignements détaillés et un générateur d’expressions interactif. Dans ce cas, nous voulons que la tâche s’exécute à 12 h UTC les samedis et dimanches, ce qui donnerait 00 12 * * 0,6 (zéro minute après midi, tous les dimanches et samedis). Enfin, assurez-vous d’enregistrer la nouvelle tâche avant de passer à l’étape suivante.

Game Manager - Tasks - Nouvelle tâche planifiée

Étape 3 - Tester la tâche

Dans la vue Tasks (Servers -> Tasks), nous pouvons voir que la prochaine exécution de la tâche nouvellement créée aura lieu le samedi suivant, comme prévu. Donc, si nous sommes actuellement mardi, la prochaine exécution planifiée aurait lieu dans 4 jours. Pour tester la tâche maintenant, sélectionnez la tâche Adjust rare drop rate et choisissez RUN TASKS.

Game Manager - Tasks - Exécuter les tâches

Étape 4 - Vérifier les résultats de l’exécution de test

Malheureusement, l’exécution de la tâche a échoué. Sélectionnez l’instance de la tâche pour voir ce qui n’a pas fonctionné.

Game Manager - Tasks - Exécutions récentes de tâches - Échec

La vue Task Instance Details fournit des renseignements de diagnostic sur la raison de l’échec de la tâche. Dans ce cas, elle indique que l’appel à serverAPI.SetTitleData est incorrect. Il devrait plutôt s’agir de server.SetTitleData (pour une explication, consultez la section Intermediate: Calling the Server APIs du tutoriel Écriture de CloudScript personnalisé). La vue Task Instance Details contient également d’autres renseignements importants, comme les heures de début et de fin, la fonction appelée, les arguments transmis, le résultat complet de l’exécution de CloudScript, et plus encore.

Game Manager - Tasks - Détails de l'instance de tâche

Étape 5 - Tester de nouveau (avec succès)

Corrigez l’erreur que nous avons trouvée à l’étape 4. L’extrait de code correct est présenté ci-dessous.

handlers.adjustRareDropRate = function(args) {
    // Tutorial demo CloudScript
    server.SetTitleData({
        "Key": "rareDropRate",
        "Value": args.dropRate
    });
}

Maintenant, en répétant l’étape 3, votre exécution de test finale réussit.

Game Manager - Tasks - Exécutions récentes de tâches - Réussite

Pour confirmer la réussite :

Sélectionnez Content dans le menu de gauche.
Allez à l’onglet Title Data.
Vérifiez que l’entrée Title Data a bien été définie.

XBOX Services

PlayFab

Étape 1 - Préparer le CloudScript

Étape 2 - Créer une tâche planifiée

Étape 3 - Tester la tâche

Étape 4 - Vérifier les résultats de l’exécution de test

Étape 5 - Tester de nouveau (avec succès)

​Étape 1 - Préparer le CloudScript

​Étape 2 - Créer une tâche planifiée

​Étape 3 - Tester la tâche

​Étape 4 - Vérifier les résultats de l’exécution de test

​Étape 5 - Tester de nouveau (avec succès)

Étape 1 - Préparer le CloudScript

Étape 2 - Créer une tâche planifiée

Étape 3 - Tester la tâche

Étape 4 - Vérifier les résultats de l’exécution de test

Étape 5 - Tester de nouveau (avec succès)