Share via

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

Azure 通知中心和 Google Firebase Cloud Messaging 迁移

  • 项目

Azure 通知中心与 Firebase Cloud Messaging (FCM) v1 的集成的核心功能可用。 谨此提醒：Google 将于 2024 年 6 月 20 日停止支持 FCM 旧版 HTTP，因此必须在该日期之前将应用程序和通知有效负载迁移到新格式。

重要

自 2024 年 6 月起，FCM 旧版 API 将不再受到支持，并且将会停用。 要避免推送通知服务发生任何中断，必须尽快迁移到 FCM v1 协议。

FCM v1 的概念

  • 将支持一种称为“FCM v1”的新平台类型。
  • 新的 API、凭据、注册和安装将用于 FCM v1。

迁移步骤

Firebase Cloud Messaging (FCM) 旧版 API 将于 2024 年 7 月弃用。 现在可以开始从旧版 HTTP 协议迁移到 FCM v1。 必须在 2024 年 6 月之前完成迁移。

常见问题解答

本部分提供有关从 FCM 旧版迁移到 FCM v1 的常见问题的解答。

如何使用 SDK 或 REST API 创建 FCM v1 模板注册？

有关如何创建 FCM v1 模板注册的说明，请参阅使用 SDK 进行 Azure 通知中心和 Google Firebase Cloud Messaging (FCM) 迁移。

是否需要同时存储 FCM 旧版和 FCM v1 的凭据？

是的，FCM 旧版和 FCM v1 被视为 Azure 通知中心中的两个独立的平台，因此必须分别存储 FCM 旧版和 FCM v1 的凭据。 有关详细信息，请参阅有关设置凭据的说明。

如何验证发送操作是通过 FCM v1 管道，而不是 FCM 旧版管道？

调试发送响应包含一个 results 属性，该属性是调试发送的注册结果数组。 每个注册结果都会指定应用程序平台。 此外，我们还会为标准层通知中心提供按消息遥测。 此遥测具有 GcmOutcomeCounts 和 FcmV1OutcomeCounts，可帮助验证是哪些平台用于发送操作。

是否需要为 FCM v1 创建新注册？

是的，但你可以使用导入/导出功能。 更新客户端 SDK 后，它会为 FCM v1 注册创建设备令牌。

Google Firebase 文档中表示，不需要任何客户端更改。 是否需要在通知中心进行任何更改，以确保我的通知将通过 FCM v1 发送？

对于直接发送操作，无需在客户端设备上进行特定于通知中心的更改。 如果使用 Azure 通知中心来存储安装或注册，则必须让通知中心知道你想要侦听迁移后的平台 (FCM v1)。 无论是使用通知中心还是直接使用 Firebase，都需要更改有效负载。 请参阅有关如何迁移到 FCM v1 的文档。

发送 FCM v1 消息时，我的 PNS 反馈显示“未知错误”。 我该怎么办才能修复此错误？

Azure 通知中心正在开发一种解决方案，以减少显示“未知错误”的次数。 同时，标准层客户可以使用通知反馈 API 来检查响应。

Xamarin 客户如何迁移到 FCM v1？

Xamarin 现已弃用。 Xamarin 客户应迁移到 MAUI，但 Azure 通知中心目前不支持 MAUI。 但是，可以将可用的 SDK 和 REST API 用于 MAUI 应用程序。 如果 Xamarin 客户需要 FCM v1 发送，建议他们离开通知中心来执行该操作。

后续步骤