登錄 App ID

App ID（組合 ID）是用於識別特定應用程式的唯一 ID。 每個應用程式都需要 App ID。 諸如推播通知服務之類的服務被配置到App ID。

• 移至 Apple 開發者入口網站，然後選取 憑證、ID 及設定檔。

  

• 移至 Identifiers > Add identifier button。

  

• 按一下「新增 Identifier」按鈕。

  

• 選取 App ID 選項。

  

• 選擇類型並點擊 Continue。

  

• 為 App ID Prefix 提供字串。 在 Description 欄位中提供應用程式名稱。 例如，Event Notifications iOS 應用程式。

• 對於 Bundle ID，選擇 明確 並提供「組合 ID」值。 建議提供反向網域名稱樣式字串。 例如，com.ibm.cloud.en.app。

  

• 從「功能」中選取 Push Notifications 勾選框，然後按一下 Continue。

  

• 瀏覽您的設定並點擊 Register > Done。

現在，您的 App ID 已登錄。

建立開發和配送 APNs SSL 憑證

在取得 APNs 憑證之前，必須先產生一個憑證簽署要求 (CSR)，然後將其提交給 Apple（憑證管理中心 (CA)）。 CSR 所含的資訊可識別您的公司，以及用來簽署 Apple Push Notifications 的公開和私密金鑰。 然後，在 iOS 開發人員入口網站上產生 SSL 憑證。 該憑證與其公開金鑰和私密金鑰一起儲存在「金鑰鏈存取」中。

您可以在兩種模式下使用 APNs：

• 沙盤推演模式，用於開發和測試。
• 正式作業模式，用於透過 App Store（或其他企業配送機制）配送應用程式。

必須分別針對開發環境和配送環境取得不同的憑證。 憑證與接收遠端通知的應用程式的 App ID 相關聯。 對於正式作業，您最多可以建立兩個憑證。IBM Cloud 使用憑證來建立與 APN 的 SSL 連線。

CocoaPods

use_frameworks!

target 'MyApp' do
   pod 'ENPushDestination', '~> 0.0.1'
end

Carthage

若要使用 Carthage 來安裝 ENPushDestination，請將下列內容新增至 Cartfile。

github "IBM/event-notifications-destination-ios-sdk" ~> 0.0.1

然後，執行下列指令，以建置相依關係及架構:

carthage update --platform iOS

Swift 套件管理程式

將下列內容新增至 Package.swift 檔案，以將 ENPushDestination 識別為相依關係。 當您使用 Swift 建置來建置專案時，套件管理程式會複製 ENPushDestination。

dependencies: [
   .package(url: "https://github.com/IBM/event-notifications-destination-ios-sdk", from: "0.0.1")
]

從通知取消登錄

使用下列程式碼 Snippet，從 Event Notifications取消登錄。

enPush.unregisterDevice { response, statusCode, error in
   /**.....*/
}

若要從 UserId 型登錄取消登錄，您必須呼叫登錄方法。 請參閱 登錄通知 中的 Register without userId option。

訂閱標籤

subscribe API 會訂閱給定標籤的裝置。 設備訂閱特定標籤後，設備可以接收針對該標籤發送的通知。

將下列程式碼 Snippet 新增至 iOS 行動式應用程式，以訂閱標籤清單。

// Subscribe to the given tag
enPush.subscribeToTags(tagName: "<tag_name>") { response, statusCode, error in
   /**.....*/
});

擷取已訂閱的標籤

retrieveSubscriptionsWithCompletionHandler API 會傳回裝置訂閱的標籤清單。 在行動式應用程式中使用下列程式碼 Snippet 來取得訂閱清單。

// Get a list of tags that to which the device is subscribed.
enPush.retrieveSubscriptionsWithCompletionHandler { response, statusCode, error in
   /**.....*/
}

取消訂閱標籤

unsubscribeFromTags API 會從清單標籤中移除裝置訂閱。 使用下列程式碼 Snippet，可讓您的裝置取消訂閱標籤。

// unsubscibe from the given tag ,that to which the device is subscribed.
enPush.unsubscribeFromTags(tagName: "<tag_name>") { response, statusCode, error in
   /**.....*/
}

在 iOS 裝置上接收推送通知

若要在iOS裝置上接收推播通知，請將以下Swift方法新增至應用程式的 appDelegate.swift：

func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {

   //UserInfo dictionary will contain data sent from the server
}

互動式通知

1. 若要啟用互動式推送通知，必須在通知物件中傳入通知動作參數。 下列是啟用互動式通知的範例程式碼:

let actionOne = ENPushNotificationAction(identifierName: "FIRST", buttonTitle: "Accept", isAuthenticationRequired: false, defineActivationMode: .foreground)

let actionTwo = ENPushNotificationAction(identifierName: "SECOND", buttonTitle: "Reject", isAuthenticationRequired: false, defineActivationMode: .destructive)

let category = ENPushNotificationActionCategory(identifierName: "category", buttonActions: [actionOne, actionTwo])

let notificationOptions = ENPushClientOptions()
notificationOptions.setInteractiveNotificationCategories(categoryName: [category])
enPush.initialize(instanceGUID, destinationID, apiKey, notificationOptions)

1. 在 AppDelegate.swift 上實作回呼方法:

   func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
      switch response.actionIdentifier {
         case "Accept":
         print("Clicked Accept")
         case "Reject":
         print("Clicked Reject")
         default:
      }
      completionHandler()
   }
   

當使用者按一下操作按鈕時，將呼叫此回調方法。 此方法的實作必須執行與指定識別碼關聯的任務並執行completionHandler參數中的區塊。

新增自訂 DeviceId 以進行登錄

若要傳送 DeviceId，請使用 ENPushClientOptions 類別的 setDeviceId 方法。

let options = ENPushClientOptions();
options.setDeviceId(deviceId: "YOUR_DEVICE_ID");

請記得為每一個裝置保留自訂 DeviceId unique。

啟用複合式多媒體通知

iOS 10 或更新版本支援複合式多媒體通知。 若要接收富媒體通知，請實作UNNotificationServiceExtension。 延伸將截取並處理複合式多媒體通知。

在服務擴充的didReceive( ) 方法中，新增下列程式碼以擷取豐富的推播通知內容。

override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
   self.contentHandler = contentHandler
   bestAttemptContent = (request.content.mutableCopy() as? UNMutableNotificationContent)
   ENPushRichPushNotificationOptions.didReceive(request, withContentHandler: contentHandler)
}