Passer au contenu principal
Les notifications push de PlayFab reposent sur la liaison de trois systèmes principaux :
  1. Le système d’exploitation de l’appareil du joueur (Android, iOS, etc.)
  2. Le canal propre au fournisseur (Google, Apple, etc.)
  3. Le routage multiplateforme des messages (PlayFab via Amazon Simple Notification Service (SNS)).
Si l’un de ces systèmes n’est plus lié, les clients cessent de recevoir des notifications. Il est assez facile de modifier accidentellement l’un des trois systèmes et de rompre la liaison. De plus, il est difficile de savoir, à un point donné du flux, si tous les systèmes sont correctement configurés.

Le système de routage push de PlayFab

Chaque titre PlayFab peut activer un canal de notification Google (GCM) et un canal de notification Apple Push (APNS, APNS_SANDBOX) à un moment donné. Ceux-ci peuvent être configurés de l’une des deux manières suivantes :
  1. À l’aide de l’interface utilisateur de Game Manager, sous Settings -> Push Notifications.
  2. À l’aide de l’API Admin PlayFab : SetupPushNotification.
Pour des informations de configuration plus détaillées, lisez ces tutoriels :

Messages push en jeu

Les messages push varient selon le moteur ou la plateforme de développement. Toutefois, le moyen le plus simple de recevoir des notifications push consiste à utiliser un projet Unity avec notre SDK et le plug-in Firebase Cloud Messaging (FCM) pour Android, ou simplement Unity pour iOS.
  • Réception de notifications push sur Android : nécessite un plug-in. Le plug-in le mieux pris en charge est le plug-in FCM natif.
  • Réception de notifications push sur iOS : ne nécessite pas de plug-in pour les messages push de base.
Consultez la documentation FCM pour savoir comment configurer le plug-in FCM Unity ou les notifications push dans Android Studio.

Test de la configuration

Après avoir configuré votre titre et votre client, vous pouvez tester votre configuration à l’aide de l’API serveur PlayFab SendPushNotification. Cette API vous permet d’envoyer autant de notifications push que nécessaire sans frais supplémentaires. Vous pouvez utiliser le service CloudScript de PlayFab comme environnement d’API serveur rapide et sécurisé. Vous pouvez ensuite envoyer des notifications push selon vos besoins. Pour tester votre configuration avec cette méthode, chargez ou ajoutez le code de l’exemple suivant au CloudScript de votre titre.

Exemple

Prenons le scénario suivant :
  • Les joueurs de votre titre peuvent accéder à un classement basé sur des statistiques de rang.
  • Chaque joueur peut payer 1 unité de la monnaie CH et défier un autre joueur situé jusqu’à 5 positions de lui.
Considérez d’abord une monnaie virtuelle comme illustré dans l’exemple de capture d’écran ci-dessous (consultez le tutoriel Monnaies pour savoir comment définir une monnaie virtuelle). PlayFab Economy : monnaies, nouvelle monnaie Considérez maintenant les statistiques suivantes définies pour chaque joueur (consultez le tutoriel Accès aux résultats de tournois archivés pour savoir comment générer un classement de test). Statistiques de joueur PlayFab : rang Une fois ces prérequis configurés, vous pouvez mettre en place un système de défis par notification push. Le code client suivant appelle le CloudScript ChallengePlayer.
Le code CloudScript ChallengePlayer traite la requête, valide l’état du classement et envoie la notification push de défi à la cible.

Utilisation des notifications push

La possibilité d’utiliser des notifications push est un outil formidable. En cas d’abus, toutefois, les utilisateurs peuvent refuser les notifications futures, voire abandonner complètement le jeu. Utilisées judicieusement, en revanche, les notifications push peuvent être l’un de vos meilleurs outils pour développer et entretenir la communauté de votre jeu. Les notifications push reposent sur un protocole de messages de type fire and forget (envoyer et oublier) qui ne garantit pas la remise.
N’oubliez pas qu’il n’existe aucune garantie que vos joueurs recevront ou ouvriront votre message, ni qu’ils y réagiront. Compte tenu de cette réserve, il est conseillé d’utiliser les messages comme une fonctionnalité bonus, plutôt que comme un élément essentiel de votre boucle de jeu.
Sur les plateformes iOS, le système d’exploitation présente une seule fois une boîte de dialogue permettant à l’utilisateur de déterminer l’état des notifications push. Une fois que l’utilisateur a fait son choix initial, ce paramètre est conservé jusqu’à ce que :
  • L’application soit mise à jour ou réinstallée.
  • L’utilisateur modifie les paramètres depuis le menu des paramètres de son téléphone.
Pour les applications Android, les notifications sont activées par défaut et peuvent être activées ou désactivées à volonté depuis le client.
Il est conseillé de réinitialiser vos écouteurs de notifications à chaque session.

Ressources

Les ressources suivantes fournissent des informations supplémentaires sur les sujets abordés dans ce démarrage rapide :
Dernière modification le 8 octobre 2026