​

Notifications push pour Android

​

Prérequis

• Démarrage rapide des notifications push
• Démarrage rapide Unity3D
• Facultatif Unity Editor Extensions
• Facultatif Démarrage rapide Postman

​

Configuration du canal de notification Android

​

Configuration de Firebase

• Projet :
  • Importez votre projet dans la console Firebase s’il n’y figure pas déjà.
• Application :
  • Les projets Firebase contiennent des applications.
  • Assurez-vous que votre application existe aux deux emplacements, avec le même nom et le même identifiant (par exemple, Unicorn Battle et com.playfab.unicornbattle2).

​

PlayFab requiert un fichier de clé privée de serveur

• Vous pouvez obtenir ce fichier de clé privée depuis la console Firebase
• Console Firebase :
  • Sélectionnez votre Project ou votre App, puis trouvez l’option Settings (il existe de nombreuses façons d’y parvenir, qui mènent toutes au même endroit).
  • Dans l’onglet Service accounts, sélectionnez le bouton Generate new private key pour télécharger le fichier JSON.

​

Utilisation du fichier de clé privée

• Fournissez votre fichier de clé privée de l’une des deux manières suivantes :
  1. Chargez le fichier de clé privée directement dans l’interface utilisateur de Game Manager : Settings (de votre Title) > Push Notifications > Android.
  2. Ou appelez SetupPushNotification à l’aide de Postman ou d’un projet Unity dont les méthodes de l’API Server sont activées.
  • Name : your_game_name
  • Platform : GCM
  • Credential : (contenu du fichier de clé privée sous forme de chaîne) : { ... }
  • Overwrite OldARN : true
  • Vous devriez recevoir une réponse HTTP 200 OK avec des données similaires à celles-ci.
    // Postman JSON result output
    {
        "code": 200,
        "status": "OK",
        "data": { "ARN" : "arn:*******/GCM/your_game_name" }
    }
    
• Une fois la configuration correctement effectuée (avec l’une ou l’autre méthode), vous devriez voir ceci dans l’interface utilisateur de Game Manager, sous Settings (de votre titre) > Push Notifications > Android.

​

Prise en main : notifications push pour Android + Unity

• Créez un projet Unity.
• FACULTATIF Importez le package PlayFab Unity Editor Extensions.
• Importez le package Unity PlayFab SDK.
• Suivez le guide FCM Unity pour installer la messagerie FCM et configurer un projet pour les notifications push.
  • Une fois cette opération terminée, vous pouvez poursuivre avec ce guide pour recevoir des messages de PlayFab.
  • Nous vous fournissons dans l’exemple suivant un script monoBehaviour complet prêt pour FCM, qui combine FCM et PlayFab.
• Dans le guide FCM, vous avez créé un script monobehavior qui configure le plug-in Firebase.
  • Vous pouvez continuer à utiliser ce script monobehavior, ou le remplacer par celui de l’exemple suivant.

​

Configuration de votre première notification push

using PlayFab;
using PlayFab.ClientModels;
using PlayFab.Json;
using UnityEngine;

public class MsgCatcher : MonoBehaviour
{
    public string pushToken;
    public string playFabId;
    public string lastMsg;

    // OnGUI should be deleted/replaced with your own gui - This is only provided for debugging
    public void OnGUI()
    {
        GUI.Label(new Rect(0, 0, Screen.width, 200), pushToken);
        GUI.Label(new Rect(0, 200, Screen.width, Screen.height - 200), lastMsg);
    }

    private void OnPfFail(PlayFabError error)
    {
        Debug.Log("PlayFab: api error: " + error.GenerateErrorReport());
    }

    public void Start()
    {
        // PlayFabSettings.TitleId = "TITLE_ID";
        Firebase.Messaging.FirebaseMessaging.TokenReceived += OnTokenReceived;
        Firebase.Messaging.FirebaseMessaging.MessageReceived += OnMessageReceived;
        LoginToPlayFab();
    }

    private void LoginToPlayFab()
    {
#if UNITY_ANDROID
        var request = new LoginWithAndroidDeviceIDRequest { AndroidDeviceId = SystemInfo.deviceUniqueIdentifier, CreateAccount = true, };
        PlayFabClientAPI.LoginWithAndroidDeviceID(request, OnPfLogin, OnPfFail);
#endif
    }

    private void OnPfLogin(LoginResult result)
    {
        Debug.Log("PlayFab: login successful");
        playFabId = result.PlayFabId;
        RegisterForPush();
    }

    private void RegisterForPush()
    {
        if (string.IsNullOrEmpty(pushToken) || string.IsNullOrEmpty(playFabId))
            return;

#if UNITY_ANDROID
        var request = new AndroidDevicePushNotificationRegistrationRequest {
            DeviceToken = pushToken,
            SendPushNotificationConfirmation = true,
            ConfirmationMessage = "Push notifications registered successfully"
        };
        PlayFabClientAPI.AndroidDevicePushNotificationRegistration(request, OnPfAndroidReg, OnPfFail);
#endif
    }

    private void OnPfAndroidReg(AndroidDevicePushNotificationRegistrationResult result)
    {
        Debug.Log("PlayFab: Push Registration Successful");
    }

    private void OnTokenReceived(object sender, Firebase.Messaging.TokenReceivedEventArgs token)
    {
        Debug.Log("PlayFab: Received Registration Token: " + token.Token);
        pushToken = token.Token;
        RegisterForPush();
    }

    private void OnMessageReceived(object sender, Firebase.Messaging.MessageReceivedEventArgs e)
    {
        Debug.Log("PlayFab: Received a new message from: " + e.Message.From);
        lastMsg = "";
        if (e.Message.Data != null)
        {
            lastMsg += "DATA: " + JsonWrapper.SerializeObject(e.Message.Data) + "\n";
            Debug.Log("PlayFab: Received a message with data:");
            foreach (var pair in e.Message.Data)
                Debug.Log("PlayFab data element: " + pair.Key + "," + pair.Value);
        }
        if (e.Message.Notification != null)
        {
            Debug.Log("PlayFab: Received a notification:");
            lastMsg += "TITLE: " + e.Message.Notification.Title + "\n";
            lastMsg += "BODY: " + e.Message.Notification.Body + "\n";
        }
    }
}

​

Résolution des problèmes sur Android

• Vérifiez que vous pouvez envoyer une notification push de test depuis la console Firebase.
  • Si ce n’est pas le cas, votre plug-in Firebase n’est pas correctement configuré ; consultez la documentation Firebase pour en trouver la raison, ou contactez le support Firebase.
• Assurez-vous que le pushToken de votre client FCM est correctement défini.
  • La fonction OnTokenReceived de l’exemple doit être appelée et disposer d’un jeton valide.
  • Si elle n’est pas appelée, votre plug-in Firebase n’est pas correctement configuré ; consultez la documentation Firebase pour en trouver la raison, ou contactez le support Firebase.
• Assurez-vous que votre titleId correspond à un titre dont vous êtes propriétaire et qu’il a été inscrit avec la clé d’API serveur de votre projet Firebase.

​

Fonctionnalités avancées

 Debug.Log("PlayFab: Received a message with data:");

​

Assistance supplémentaire

• Amazon SNS Message & JSON Formats