​

Notificaciones push para Android

​

Requisitos previos

• Inicio rápido de notificaciones push
• Inicio rápido de Unity3D
• Opcional Unity Editor Extensions
• Opcional Inicio rápido de Postman

​

Configuración del canal de notificaciones de Android

​

Configuración de Firebase

• Proyecto:
  • Importe su proyecto en la consola de Firebase si aún no está allí.
• Aplicación:
  • Los proyectos de Firebase contienen aplicaciones.
  • Asegúrese de que su aplicación existe en ambas ubicaciones, con el mismo nombre e identificador (por ejemplo, Unicorn Battle y com.playfab.unicornbattle2).

​

PlayFab requiere un archivo de clave privada del servidor

• Puede obtener este archivo de clave privada en la consola de Firebase
• Consola de Firebase:
  • Seleccione su proyecto o aplicación y busque la opción Settings (hay muchas maneras de hacerlo, todas ellas le llevan al mismo lugar).
  • En la pestaña Service accounts, seleccione el botón Generate new private key para descargar el archivo JSON.

​

Uso del archivo de clave privada

• Proporcione su archivo de clave privada de una de estas dos maneras:
  1. Cargue el archivo de clave privada directamente en la interfaz de usuario de Game Manager: Settings (para su título) > Push Notifications > Android.
  2. O llame a SetupPushNotification mediante Postman o un proyecto de Unity con los métodos de la API de servidor habilitados.
  • Name: your_game_name
  • Platform: GCM
  • Credential: (contenido del archivo de clave privada como cadena): { ... }
  • Overwrite OldARN: true
  • Debería recibir una respuesta HTTP 200 OK con datos similares a los siguientes.
    // Postman JSON result output
    {
        "code": 200,
        "status": "OK",
        "data": { "ARN" : "arn:*******/GCM/your_game_name" }
    }
    
• Una vez configurado correctamente (con cualquiera de los dos métodos), debería ver esto en la interfaz de usuario de Game Manager, en Settings (para su título) > Push Notifications > Android.

​

Introducción: notificaciones push para Android + Unity

• Cree un nuevo proyecto de Unity.
• OPCIONAL Importe el paquete PlayFab Unity Editor Extensions.
• Importe el paquete del SDK de PlayFab para Unity.
• Siga la guía FCM Unity para instalar la mensajería de FCM y configurar un proyecto para notificaciones push.
  • Una vez finalizado, puede continuar con esta guía para recibir mensajes de PlayFab.
  • En el ejemplo siguiente le proporcionamos un script monoBehaviour completo listo para FCM, que combina FCM y PlayFab.
• En la guía de FCM, creó un script monobehavior que configuraba el complemento de Firebase.
  • Puede seguir usando ese script monobehavior o reemplazarlo por el del ejemplo siguiente.

​

Configuración de su primera notificación 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";
        }
    }
}

​

Solución de problemas en Android

• Compruebe que puede enviar notificaciones push de prueba desde la consola de Firebase.
  • Si no puede, su complemento de Firebase no está configurado correctamente y debe revisar la documentación de Firebase para averiguar por qué, o ponerse en contacto con el soporte técnico de Firebase.
• Asegúrese de que el pushToken de su cliente de FCM está establecido correctamente.
  • Debería llamarse a la función OnTokenReceived del ejemplo y esta debería tener un token válido.
  • Si no se llama, su complemento de Firebase no está configurado correctamente y debe revisar la documentación de Firebase para averiguar por qué, o ponerse en contacto con el soporte técnico de Firebase.
• Asegúrese de que su titleId está establecido en un título de su propiedad y de que se ha registrado con la clave de API de servidor de su proyecto de Firebase.

​

Características avanzadas

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

​

Soporte adicional

• Amazon SNS Message & JSON Formats