快速入門：在通知中樞中設定推播通知

Azure 通知中樞提供易於使用且相應放大的推播引擎。使用通知中樞將通知傳送至任何平臺（iOS、Android、Windows、百度）和任何後端（雲端或內部部署）。 如需詳細資訊，請參閱 什麼是 Azure 通知中樞？。

在本快速入門中，您將使用通知中樞中的平臺通知系統 （PNS） 設定，在多個平台上設定推播通知。 快速入門說明 Azure 入口網站 中要採取的步驟。 Google Firebase 雲端通訊 包含使用 Azure CLI 的指示。

注意

如需 Firebase 雲端傳訊取代和移轉步驟的相關信息，請參閱 Google Firebase 雲端傳訊移轉。

如果您尚未建立通知中樞，立即建立一個。 如需詳細資訊，請參閱在 Azure 入口網站 中建立 Azure 通知中樞或使用 Azure CLI 建立 Azure 通知中樞。

Apple 推播通知服務

若要設定 Apple Push Notification Service （APNS）：

1. 在 [Azure 入口網站] 的 [通知中樞] 頁面上，從左側功能表中選取 [Apple][APNS]。

2. 針對 [驗證模式]，選取 [憑證] 或 [權杖]。

   a. 如果您選取 [憑證]：

   • 選取檔案圖示，然後選取您要上傳的 [.p12] 檔案。

   • 輸入密碼。

   • 選取 [沙箱] 模式。 或者，若要傳送推播通知給從市集購買應用程式的使用者，請選取 [生產] 模式。

     

     b. 如果您選取 [權杖]：

   • 輸入 [金鑰識別碼]、[搭售方案識別碼]、[小組識別碼] 和 [權杖] 的值。

   • 選取 [沙箱] 模式。 或者，若要傳送推播通知給從市集購買應用程式的使用者，請選取 [生產] 模式。

     

如需詳細資訊，請參閱 使用 Azure 通知中樞將推播通知傳送至 iOS 應用程式。

Google Firebase 雲端通訊 V1 （FCMv1）

若要設定Google FCMv1的推播通知：

1. 在 [Azure 入口網站] 的 [通知中樞] 頁面上，從左側功能表中選取 Google （FCMv1）。
2. 從從 Firebase 控制台取得的服務帳戶 JSON 檔案更新私鑰、專案識別碼和用戶端電子郵件值。
3. 選取儲存。

當您完成這些步驟時，警示表示通知中樞已成功更新。 [儲存] 按鈕已停用。

Google Firebase 雲端通訊 （FCM）

注意

Firebase 雲端傳訊 （FCM） 已被取代，不再支援。

入口網站

若要設定Google FCM的推播通知：

1. 在 [Azure 入口網站] 的 [通知中樞] 頁面上，從左側功能表中選取 Google （GCM/FCM）。

2. 貼上 您稍早儲存之 Google FCM 專案的 API 金鑰 。

3. 選取儲存。

   

當您完成這些步驟時，警示表示通知中樞已成功更新。 [儲存] 按鈕已停用。

Azure CLI

您將需要 Google Firebase雲端通訊 （FCM） 專案的 API 金鑰 。

備妥環境以使用 Azure CLI

• 在 Azure Cloud Shell 中使用 Bash 環境。 如需詳細資訊，請參閱 Azure Cloud Shell 中的 Bash 快速入門。

  

• 若要在本地執行 CLI 參考命令，請安裝 Azure CLI。 若您在 Windows 或 macOS 上執行，請考慮在 Docker 容器中執行 Azure CLI。 如需詳細資訊，請參閱〈如何在 Docker 容器中執行 Azure CLI〉。

  • 如果您使用的是本機安裝，請使用 az login 命令，透過 Azure CLI 來登入。 請遵循您終端機上顯示的步驟，完成驗證程序。 如需其他登入選項，請參閱使用 Azure CLI 登入。

  • 出現提示時，請在第一次使用時安裝 Azure CLI 延伸模組。 如需擴充功能詳細資訊，請參閱使用 Azure CLI 擴充功能。

  • 執行 az version 以尋找已安裝的版本和相依程式庫。 若要升級至最新版本，請執行 az upgrade。

• 本文需要 Azure CLI 2.0.67 版或更新版本。 如果您是使用 Azure Cloud Shell，就已安裝最新版本。

設定Google FCM的推播通知

1. 使用 az notification-hub credential gcm update 命令，將 Google API 金鑰新增至通知中樞。

   az notification-hub credential gcm update --resource-group spnhubrg --namespace-name spnhubns    --notification-hub-name spfcmtutorial1nhub --google-api-key myKey
   

2. Android 應用程式需要 連接字串 才能與通知中樞連線。 使用 az notification-hub authorization-rule list 命令來列出可用的存取原則。 使用 az notification-hub authorization-rule list-keys 命令來取得存取原則 連接字串。 在 參數中--query指定 primaryConnectionString 或 secondaryConnectionString，以直接取得主要 連接字串。

   #list access policies for a notification hub
   az notification-hub authorization-rule list --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --output table
   
   #list keys and connection strings for a notification hub access policy
   az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --output json
   
   #get the primaryConnectionString for an access policy
   az notification-hub authorization-rule list-keys --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --name myAccessPolicyName --query primaryConnectionString
   

3. 使用 az notification-hub test-send 命令來測試將訊息傳送至 Android 應用程式。

   #test with message body
   az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --message "my message body"
   
   #test with JSON string
   az notification-hub test-send --resource-group spnhubrg --namespace-name spnhubns --notification-hub-name spfcmtutorial1nhub --notification-format gcm --payload "{\"data\":{\"message\":\"my JSON string\"}}"
   

使用 az notification-hub credential 命令取得其他平臺的 Azure CLI 參考。

如需將通知傳送至 Android 應用程式的詳細資訊，請參閱 使用 Firebase 將推播通知傳送至 Android 裝置。

Windows 推播通知服務

若要設定 Windows 推播通知服務 （WNS）：

1. 在 [Azure 入口網站] 的 [通知中樞] 頁面上，從左側功能表中選取 [Windows][WNS]。

2. 輸入 [套件 SID] 和 [安全性金鑰] 的值。

3. 選取儲存。

   

如需詳細資訊，請參閱 使用 Azure 通知中樞將通知傳送至 UWP 應用程式。

百度 (Android China)

若要設定百度推播通知：

1. 在 [Azure 入口網站] 的 [通知中樞] 頁面上，從左側功能表中選取百度 （Android China）。

2. 在 百度雲端推送專案中輸入您從百度主控台取得的 API 金鑰 。

3. 在百度雲推送專案中，輸入從百度主控台取得的祕密金鑰。

4. 選取儲存。

   

當您完成這些步驟時，警示表示通知中樞已成功更新。 [儲存] 按鈕已停用。

如需詳細資訊，請參閱 使用百度開始使用通知中樞。

下一步

在本快速入門中，您已瞭解如何在 Azure 入口網站 中設定通知中樞的平臺通知系統設定。

若要深入瞭解如何將通知推播至各種平臺，請參閱下列教學課程：

• 使用 Azure 通知中樞將推播通知傳送至 iOS 應用程式
• 使用通知中樞和Google FCM將通知傳送至Android裝置
• 將通知傳送至 Windows 裝置上執行的 UWP 應用程式
• 使用通知中樞和百度雲端推送傳送通知