​

iOS 推播通知

​

必要條件

​

設定 Apple 通知通道

1. 確保您擁有有效的 iOS 開發 (APNS_SANDBOX) 或生產 (APNS) 憑證。如果沒有，請從 Apple Developer Portal 的 Certificates, Identities and Profiles 下建立一個。

2. 匯出您選擇的憑證 (開發或生產)：
   • 首先，從 Apple Developer Portal 的 Certificates, Identities and Profiles 下下載憑證的複本。這會建立一個 .cer 檔案。
   • 開啟憑證並將其安裝至您的 Keychain Access。
   • 在 Certificates 子類別下檢視您已安裝的憑證。
   • 將您的 Keychain Access Certificate 匯出為 .p12 格式。
   • 使用下列主控台命令將 .p12 檔案轉換為 .pem 檔案：
     • openssl pkcs12 -in apns-dev-cert.p12 -out apns-dev-cert.pem -nodes -clcerts
   • 取得 .pem 檔案後，您可以直接透過 PlayFab Game Manager 在遊戲設定 > Push Notifications 下上傳。
   • 或者，使用下方的產生器為 SetupPushNotification 製作 JSON 要求。

​

SetupPushNotification 的 JSON 要求產生器

• Platform - 使用下列其中一個值：APNS (iOS)、APNS_SANDBOX (iOS)、GCM (Android)
• Application Name - 輸入傳送訊息之應用程式的名稱。

• PEM Certificate / API Key - 若為 iOS (APNS 或 APNS_SANDBOX)，請使用 PEM 檔案的完整內容。

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

​

註冊您的 iOS 用戶端以接收推播

• 範例中的下列程式碼會在 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);

• 此時，如果使用者已選擇接收通知，我們就可以呼叫 PlayFab API 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!");
}

• 如果沒有發生錯誤，恭喜！您的 iOS 用戶端已成功連結至遊戲的 Apple 通知通道。

​

iOS 疑難排解

• 確認您擁有有效的 .pem 檔案。
• 確保 XCode 使用與 SetupPushNotification 中相同的憑證來簽署您的應用程式。
• 確認已在 XCode 中為您的組建啟用推播通知 API。
• 確認您的簽署憑證與 PlayFab 平台相符。執行 SetupPushNotification 時，請使用 OverwriteOldARN = true 將通道重新繫結至新平台。在指定時間，一個遊戲上只能有一個 iOS 環境 (APNS 或 APNS_SANDBOX) 處於作用中狀態。

​

其他支援