你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

快速入门：在通知中心设置推送通知

Azure 通知中心提供了一种易于使用且可扩展的推送引擎。使用通知中心可将通知发送到任意平台（iOS、Android、Windows 和百度），也可从任意后端（云或本地）进行发送。 有关详细信息，请参阅什么是 Azure 通知中心？。

在该快速入门中，你将在通知中心使用平台通知系统 (PNS) 设置在多个平台上设置推送通知。 该快速入门介绍了要在 Azure 门户中执行的步骤。 Google Firebase Cloud Messaging 包含 Azure CLI 使用说明。

注意

有关 Firebase Cloud Messaging 弃用和迁移步骤的信息，请参阅 Google Firebase Cloud Messaging 迁移。

如果尚未创建通知中心，请立即创建。 有关详细信息，请参阅在 Azure 门户中创建 Azure 通知中心或使用 Azure CLI 创建 Azure 通知中心。

Apple Push Notification 服务

要设置 Apple Push Notification 服务 (APNS)：

1. 在 Azure 门户的“通知中心”页上，从左侧菜单中选择“Apple (APNS)”。

2. 对于“身份验证模式”，请选择“证书”或“令牌” 。

   a. 如果选择“证书”：

   • 选择文件图标，再选择要上传的 .p12 文件。

   • 输入密码。

   • 选择沙盒模式。 要将推送通知发送给从应用商店购买应用的用户，则选择生产模式。

     

     b. 如果选择“令牌”：

   • 输入密钥 ID、绑定 ID、团队 ID 和令牌的值。

   • 选择沙盒模式。 要将推送通知发送给从应用商店购买应用的用户，则选择生产模式。

     

有关详细信息，请参阅使用 Azure 通知中心向 iOS 应用发送推送通知。

Google Firebase Cloud Messaging V1 (FCMv1)

为 Google FCMv1 设置推送通知：

1. 在 Azure 门户的“通知中心”页上，从左侧菜单中选择“Google (FCMv1)”。
2. 从 Firebase 控制台获取的服务帐户 JSON 文件中更新“私钥”、“项目 ID”和“客户端电子邮件”的值。
3. 选择“保存”。

完成这些步骤后，会显示一条警报，指出已成功上传通知中心。 “保存”按钮已禁用。

Google Firebase Cloud Messaging (FCM)

注意

Firebase Cloud Messaging (FCM) 已被弃用，不再受支持。

门户

若要为 Google FCM 设置推送通知，请执行以下操作：

1. 在 Azure 门户的“通知中心”页上，从左侧菜单中选择“Google (GCM/FCM)”。

2. 为之前保存的 Google FCM 项目粘贴“API 密钥”。

3. 选择“保存”。

   

完成这些步骤后，会显示一条警报，指出已成功上传通知中心。 “保存”按钮已禁用。

Azure CLI

你将需要用于 Google Firebase Cloud Messaging (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 发送通知。

Baidu (Android China)

要为百度设置推送通知：

1. 在 Azure 门户的“通知中心”页上，从左侧菜单中选择“Baidu (Android China)”。

2. 在百度云推送项目中，输入从百度控制台获得的 API 密钥。

3. 在百度云推送项目中，输入从百度控制台获得的机密密钥。

4. 选择“保存”。

   

完成这些步骤后，会显示一条警报，指出已成功上传通知中心。 “保存”按钮已禁用。

有关详细信息，请参阅借助百度的通知中心入门。

后续步骤

在该快速入门中，你学习了如何在 Azure 门户中为通知中心配置平台通知系统设置。

要详细了解如何将通知推送到各类平台，请参阅以下教程：

• 使用 Azure 通知中心向 iOS 应用发送推送通知
• 使用通知中心和 Google FCM 向 Android 设备发送通知
• 将通知发送到在 Windows 设备上运行的 UWP 应用
• 使用通知中心和百度云推送服务来发送通知