Configuration des notifications push – Firebase

Ce tutoriel vous guidera à travers les étapes de configuration de Firebase Cloud Messaging (FCM) avec brainCloud.

Prérequis

Doit avoir créé un projet sur la console Firebase

Étape 1 : Configurer la clé privée JSON de l'API Firebase Cloud Messaging (V1) sur brainCloud

Accédez à la console Firebase dans votre navigateur et sélectionnez le projet souhaité. Cliquez sur l'icône "Paramètres" -> "Paramètres du projet" dans la barre de navigation en haut à gauche.

Sélectionnez l’onglet "Cloud Messaging" et assurez-vous que "Firebase Cloud Messaging API" est activé pour votre projet Firebase dans Google Cloud Platform.

Sinon, vous pouvez toujours accéder à votre projet GCP et l’activer à partir de la bibliothèque API.

Passez à l'onglet "Comptes de service" sur la même page de paramètres du projet et cliquez sur le bouton "Générer une nouvelle clé privée" à l'écran pour générer une clé privée.

Une fois la nouvelle clé privée générée, vous pouvez la voir affichée sur le compte de service lié dans GCP.

Ouvrez ce fichier JSON généré avec un éditeur et copiez l’intégralité du contenu JSON.

Accédez à la page Conception > Notification > Paramètres de la console de développement brainCloud, sélectionnez Google Play et cliquez sur Modifier les paramètres.

Cliquez sur le bouton Modifier dans la fenêtre contextuelle, puis collez le contenu JSON dans la zone de saisie "Compte de serveur FCM JSON", puis enregistrez-le.

Étape 2 : Enregistrez un jeton de notification sur votre appareil via votre application

Utilisez le fichier Keystore de votre application Android pour créer une empreinte digitale SHA1 et l'ajouter à votre projet Firebase.

Téléchargez le fichier google-services.json et ajoutez-le au répertoire root de votre application (pour l'application Unity, il se trouvera sous le répertoire Assets). Ce fichier contient la plupart des identifiants nécessaires pour connecter votre application à Firebase.

Suivez les SDK Instructions pour finaliser les paramètres de votre application. (Si vous utilisez le package Unity Firebase Messaging, après l'importation, votre répertoire Assets devrait ressembler à la structure ci-dessous.)

Dans votre application, après avoir authentifié un utilisateur avec brainCloud, vous devrez enregistrer le token Firebase Registration auprès de brainCloud. Plus précisément, vous devrez appeler la méthode RegisterPushNotificationDeviceToken() pour transmettre le jeton.
Si vous utilisez Unity SDK, votre code doit être similaire à ce qui suit.

    void InitializeFirebase()
    {
        Firebase.Messaging.FirebaseMessaging.MessageReceived += OnMessageReceived;
        Firebase.Messaging.FirebaseMessaging.TokenReceived += OnTokenReceived;
        isFirebaseInitialized = true;
    } 
...
    public virtual void OnTokenReceived(object sender, Firebase.Messaging.TokenReceivedEventArgs token)
    {
        DebugLog("Received Registration Token: " + token.Token);
        firebaseToken = token.Token;
        AddStatusText("Received Registration Token: " + token.Token);
    }
...
    public void OnRegisterToken()
    {
        _bc.PushNotificationService.RegisterPushNotificationDeviceToken(Platform.GooglePlayAndroid, firebaseToken, authSuccess_BCcall, authError_BCcall);
    }
...

Si vous utilisez Java Android Studio

  FirebaseInstanceId.getInstance().getInstanceId()
  .addOnCompleteListener(new OnCompleteListener<InstanceIdResult>() {
      @Override
      public void onComplete(@NonNull Task<InstanceIdResult> task) {
          if (!task.isSuccessful()) {
              Log.w(TAG, "getInstanceId failed", task.getException());
              return;
          }
          // Obtenir un nouveau jeton d'ID d'instance
          String token = task.getResult().getToken();
          _bc.GetWrapper().getPushNotificationService().registerPushNotificationToken(Platform.GooglePlayAndroid, token, theCallback);
      }
  }); FirebaseInstanceId.getInstance().getInstanceId()

Étape 3 : Test

Exécutez votre application, authentifiez un utilisateur final sur brainCloud et appelez la méthode RegisterPushNotificationDeviceToken() pour enregistrer le jeton de l'appareil.

Une fois que votre appareil de test a enregistré le jeton de notification sur brainCloud à partir de votre application, vous pouvez le vérifier à partir de la page Usager > Résumé > Résumé de l'usager .

Cliquez sur le bouton Send Notification de la page ci-dessus pour ouvrir une fenêtre Send Notification. Saisissez du texte, puis cliquez sur Send. Votre appareil de test devrait recevoir cette notification de brainCloud. Vous pouvez également utiliser les méthodes de notification push de brainCloud pour tester les notifications push.

Notez que l'exemple ci-dessus correspond aux paramètres pour Android. Cependant, même si les étapes de configuration sont presque les mêmes, pour la configuration d'iOS avec FCM, veuillez consulter la documentation Firebase.