將 Android SDK 推播通知遷移至 Firebase 雲端訊息 HTTP v1

Warning

Azure 通訊服務 正在推出突破性變更,部分服務也將被淘汰。 若要深入了解,請參閱 淘汰與重大變更指南。

本文適用於使用 Android SDK 搭配 Firebase Cloud Messaging(FCM)推播通知的通話與聊天應用程式。 FCM 先前稱為 Google Cloud Messaging(GCM/FCM)。

2023 年 6 月 20 日,Google 宣布 不再支持使用 FCM 舊有 API 發送訊息。 Google 將於 2024 年 6 月將舊有的 FCM 從服務中移除。 Google 建議 [從舊版 FCM API 移轉至 FCM HTTP v1]。

如果你有新的 Android 應用程式或從未使用 Google FCM,請參閱「 使用 FCM v1 註冊 Android SDK 推播通知 」文章。

如果您的 Android 應用程式使用推播通知功能,請完成以下步驟將推播通知遷移至 FCM HTTP v1。

1. 在 Firebase 主控台產生私鑰

  1. 在 Firebase 控制台開啟你的專案。

  2. 開啟 專案設定>服務帳號。

  3. 選擇任何程式語言。

  4. 點擊 「產生新私鑰 」以下載包含新私鑰的 JSON 檔案。

    如何在 Firebase 控制台中為 FMC v1 產生新私鑰的截圖。

  5. 找到並打開下載的 JSON 檔案。 你需要這個檔案的值才能進行下一步。

2. 提供 Google 私鑰憑證(FCM v1)

  1. 在 Azure 入口網站開啟你的 Azure 通訊服務通知中心。

  2. 開啟 Google 設定>(FCM v1)。

  3. 在文字框中輸入下載的 JSON 檔案中的數值,分別是 私鑰、 客戶電子郵件和 專案編號。

    如何在 Azure 入口網站設定中提供 FCM v1 的新私鑰憑證截圖。

  4. 點選 [儲存]。

3. 移除 Google 的舊有憑證(GCM/FCM)

  1. 在 Azure 入口網站開啟你的 Azure 通訊服務通知中心。

  2. 開啟 Google 設定>(GCM/FCM)。

  3. 清除 API Key 文字框。

    以下是如何從 Azure 入口網站設定中移除 GCM / FCM 舊有憑證的截圖。

  4. 點選 [儲存]。

4. 確認您的應用程式是否收到推播通知

  1. 請等待幾分鐘,讓您在通知中樞中做的變更生效。 在此期間,您的應用程式可能會遇到重複推播通知或錯過通知。

  2. 確保你的應用程式能順利收到推播通知,且不會出錯。

故障排除

如果你的應用程式無法收到推播通知,請確認你的新 FCM v1 憑證正確。 請依照本文件中的步驟重複,以便在 Firebase 主控台產生私鑰 ,或 提供 Google(FCM v1)私鑰憑證。

如果您的應用程式仍無法收到推播通知,請聯絡 Microsoft Azure Help+ 支援的 Azure 通訊服務。

在你的 Android 聊天應用程式中啟用推播通知開啟來電推播通知