Passer au contenu principal

Démarrage rapide des actions et règles

Une règle PlayStream vous permet de réagir en temps réel à un sous-ensemble d’un type d’événements PlayStream.

Exigences

Un bref glossaire des termes pertinents :
  • PlayStream : le groupe de fonctionnalités qui composent le pipeline d’événements PlayFab.
    • Un événement PlayStream est une chaîne au format JSON décrivant un événement concernant un joueur ou un titre.
    • Les événements PlayStream ont une taille maximale qui dépend de votre niveau de fonctionnalité Automation.
  • Règle : exécute une logique supplémentaire en réponse à un type d’événement PlayStream en temps réel.
    • La somme de : un déclencheur d’événement, une liste facultative de conditions et une liste facultative d’actions.
  • Déclencheur : le nom de l’événement qui active cette règle.
  • Condition : un filtre de contenu pour les règles et d’autres fonctionnalités PlayStream.
    • Effectue une évaluation très légère de l’objet JSON de l’événement PlayStream et ignore les événements qui ne répondent pas aux exigences.
  • Action : le travail contextuel à effectuer sur l’entité appropriée.
Une règle comprend exactement un déclencheur, une liste facultative de conditions et généralement au moins une action (ce n’est pas obligatoire, mais une règle est plutôt inutile sans action). Les déclencheurs, les conditions et les actions font également partie d’autres systèmes : les actions en bloc et les classements de tournoi (déconseillés).

Exemple : compter les événements personnalisés provenant du client

Dans l’exemple présenté ci-dessous, nous publions l’événement personnalisé suivant à partir du client.
Dans ce cas, le client signale manuellement un événement personnalisé ForumPostEvent (cela ne correspond actuellement à aucun événement automatique de PlayFab ou des partenaires pris en charge) Nous utiliserons une règle PlayStream pour compter le nombre de fois qu’un joueur signale une publication de forum de cette façon. Exigence : votre jeu doit déjà publier des événements de ce type avant que l’interface graphique de Game Manager vous permette de créer une règle déclenchée par ceux-ci. Accédez à votre Game Manager :
  • Accédez à votre titre.
  • Sélectionnez Automation.
  • Allez à Rules.
  • Sélectionnez New Rule.
Game Manager - automation - nouvelle règle Évaluons la New Rule de cet exemple, élément par élément :
  • title.6195.ForumPostEvent
    • 6195 est le titre utilisé dans ce tutoriel. Votre titleId correspondra à votre propre titre.
    • ForumPostEvent est le nom d’événement utilisé dans le code de cet exemple.
    • Cette ligne ne sera disponible que si vous avez récemment publié au moins un ForumPostEvent dans votre titre.
  • Les Conditions utilisées dans cet exemple ont une utilité minime.
    • Cependant, elles montrent comment filtrer notre événement personnalisé si la clé Body est associée à Invalid string dans notre dictionnaire Body.
    • Les filtres sont facultatifs et devraient retirer les joueurs non pertinents de votre règle.
  • Les Actions choisies dans ce cas incrémentent un compteur de statistique de un.
    • Exigence : la statistique Forum Posts doit être définie sous Leaderboards dans Game Manager.
Dans le PlayStream Debugger de Game Manager (illustré ci-dessous), vous pouvez observer l’effet du déclencheur. Game Manager - PlayStream - débogueur - déclencheur d'événement Comme vous pouvez le constater, l’événement personnalisé ForumPostEvent déclenche automatiquement la statistique que nous avons définie sous Actions pour notre nouvelle règle.

Avancé : actions CloudScript

Bon nombre des actions intégrées de PlayFab sont assez simples et pourraient ne pas vous offrir toute la puissance dont vous avez besoin. C’est pourquoi nous vous permettons de personnaliser entièrement la logique des actions avec CloudScript. Modifions la règle.
  • Supprimez la Condition.
  • Définissez l’Action sur Execute CloudScript.
  • Sélectionnez le bouton Save Action.
Game Manager - automation - modifier la règle Maintenant, si nous publions un nouvel événement ForumPostEvent, nous verrons une exécution de CloudScript. Game Manager - PlayStream - débogueur - exécution de CloudScript L’écriture de CloudScript pour réagir aux règles PlayStream est un sujet avancé abordé dans notre tutoriel : utilisation des actions CloudScript avec PlayStream.
Dernière modification le 6 octobre 2026