​

Notifications push pour iOS

​

Prérequis

​

Configuration du canal de notification Apple

1. Assurez-vous de disposer d’un certificat iOS actif de développement (APNS_SANDBOX) ou de production (APNS). Si ce n’est pas le cas, créez-en un depuis l’Apple Developer Portal, sous Certificates, Identities and Profiles.

2. Exportez le certificat de votre choix (développement ou production) :
   • Commencez par télécharger une copie de votre certificat depuis l’Apple Developer Portal, sous Certificates, Identities and Profiles. Un fichier .cer est alors créé.
   • Ouvrez et installez le certificat dans votre Keychain Access.
   • Affichez votre certificat installé dans la sous-catégorie Certificates.
   • Exportez votre Keychain Access Certificate au format .p12.
   • Convertissez le fichier .p12 en fichier .pem à l’aide de la commande de console suivante :
     • openssl pkcs12 -in apns-dev-cert.p12 -out apns-dev-cert.pem -nodes -clcerts
   • Une fois le fichier .pem obtenu, vous pouvez le charger directement via PlayFab Game Manager, sous Title’s settings > Push Notifications.
   • Vous pouvez également utiliser le générateur ci-dessous pour élaborer une requête JSON pour SetupPushNotification.

​

Générateur de requête JSON pour SetupPushNotification

• Platform : utilisez l’une des valeurs suivantes : APNS (iOS), APNS_SANDBOX (iOS), GCM (Android)
• Application Name : entrez le nom de l’application qui envoie le message.

• PEM Certificate / API Key : pour iOS (APNS ou APNS_SANDBOX), utilisez l’intégralité du contenu de votre fichier PEM.

{
    “code” : 200,
    “status” : “OK”,
    “data” :
        {
             “ARN” : “arn:*******/GCM/your_game_name”
        }
}

​

Inscription de votre client iOS aux notifications push

• Le code suivant de l’exemple est exécuté dans client Start().

// must be called before trying to obtain the push token
// an asynchronous call with no callback into native iOS code that takes a moment or two before
// the token is available. (so spin and wait, or call this one early on)
// this will always return null if your app is not signed
UnityEngine.iOS.NotificationServices.RegisterForNotifications(UnityEngine.iOS.NotificationType.Alert | UnityEngine.iOS.NotificationType.Badge | UnityEngine.iOS.NotificationType.Sound, true);

• À ce stade, si l’utilisateur a accepté les notifications, nous pouvons appeler l’API PlayFab RegisterForIOSPushNotification.

byte[] token = UnityEngine.iOS.NotificationServices.deviceToken;
if(token != null)
{
    RegisterForIOSPushNotificationRequest request = new RegisterForIOSPushNotificationRequest();
    request.DeviceToken = System.BitConverter.ToString(token).Replace("-", "").ToLower();
    PlayFabClientAPI.RegisterForIOSPushNotification(request, (RegisterForIOSPushNotificationResult result) =>
    {
        Debug.Log("Push Registration Successful");
    }, OnPlayFabError);
}
else
{
    Debug.Log("Push Token was null!");
}

• Si aucune erreur ne s’est produite, félicitations ! Votre client iOS est correctement lié au canal de notification Apple de votre titre.

​

Résolution des problèmes sur iOS

• Vérifiez que vous disposez de fichiers .pem valides.
• Assurez-vous que le certificat utilisé dans SetupPushNotification est le même que celui utilisé par XCode pour signer votre application.
• Vérifiez que l’API Push Notification est activée pour votre build dans XCode.
• Vérifiez que votre certificat de signature correspond à la plateforme PlayFab. Lors de l’exécution de SetupPushNotification, utilisez OverwriteOldARN = true pour associer de nouveau le canal à une nouvelle plateforme. Un seul environnement iOS (APNS ou APNS_SANDBOX) peut être actif sur un titre à un moment donné.

​

Assistance supplémentaire