全部產品
Search
文件中心

Mobile Platform as a Service:通道配置

更新時間:Nov 08, 2024

本文介紹如何進行 iOS 和 Android 推送通道配置。

配置 iOS 推送通道

接入蘋果手機時,依賴 APNs 服務作為訊息推送網關,需要在控制台側上傳 iOS 推送認證,用於串連 APNs 服務。

完成以下步驟配置 iOS 推送認證:

  1. 登入 mPaaS 控制台,選擇目標應用後,從左側導覽列進入 訊息推送 > 設定 頁面。

  2. 在右側的設定頁面上,選擇 通道配置 標籤,在 iOS 通道 配置地區,配置 iOS 推送認證。

    • 選擇認證檔案:選擇並上傳預先準備好的 iOS 推送認證。後端會通過解析上傳的認證獲得認證環境和 BundleId。如需瞭解 iOS 推送認證的製作步驟,參考 製作 iOS 推送認證

    • 認證密碼:填寫認證密碼,即匯出 .p12 認證時所設定的密碼。

  3. 單擊 上傳,儲存配置,若認證格式正確,可以看到認證的詳細內容,如下圖所示。若需要驗證認證是否和環境對應,是否合法,可通過在控制台推送訊息進行測試。p342649

說明

iOS 推送認證具有有效期間,請在推送認證失效前及時更新認證,以免訊息推送無法正常工作。系統會在認證失效前 15 天開始提醒更換。如需更換認證,單擊認證資訊下方的 重新上傳 上傳新的認證即可。

配置 iOS 即時活動訊息推送認證

重要

在配置 iOS 即時活動訊息推送認證之前,首先要確定 iOS 原推送認證,即 .p12 認證,已經配置完畢,否則將無法配置即時活動訊息認證。

完成以下步驟配置 iOS 即時活動訊息推送認證:

  1. 登入 mPaaS 控制台,選擇目標應用後,從左側導覽列進入 訊息推送 > 設定 頁面。

  2. iOS 通道 的設定頁面上,勾選 Token Authentication 配置,配置好 bundleId、keyId、teamId 後,上傳 p8AuthKey 私密金鑰檔案,即 .p8 檔案,而後點擊 儲存

    image.png

    重要
    • 上述參數擷取可參考 製作 iOS P8 即時活動認證

    • 即時活動訊息推送的環境和原 iOS 認證之間綁定,因此使用效果如下:

      • 若原 iOS 認證為測試環境 sandbox 認證,則推送測試環境即時活動訊息。

      • 若原 iOS 認證為生產環境認證,則推送生產環境即時活動訊息。

配置 Android 推送通道

為提升推送的到達率,mPaaS 整合了華為、小米、OPPO 和 vivo 等廠商推送通道。採用小米通知欄訊息、華為通知欄訊息、OPPO 通知欄訊息和 vivo 通知欄訊息實現訊息推送。在應用未運行時,依然可以發送通知,使用者點擊通知欄即可啟用進程。

說明

接入廠商自有的推送通道後,能夠協助應用獲得穩定的推送效能,因此建議您將廠商推送通道接入應用。

本文將引導您完成在接入小米、華為、OPPO 和 vivo 推送渠道時需要進行的控制台側配置。

前置條件

您需要先完成用戶端側的接入配置,操作參見 接入廠商推送通道

操作方法

配置華為推送渠道

  1. 從左側導覽列進入 訊息推送 > 設定 > 通道配置 標籤頁。

  2. 單擊 華為推送通道 配置地區右上方的 配置,頁面上展示配置入口,如下圖所示。 配置華為推送渠道

    參數

    是否必填

    說明

    狀態

    渠道的接入狀態開關。開啟開關,MPS 將根據配置接入華為推送渠道;關閉開關,即取消接入。

    包名

    輸入華為應用程式套件名。

    華為應用 ID

    輸入華為應用的 App ID。

    華為應用密鑰

    輸入華為應用的密鑰(App Secret)。

    說明

    可登入 華為開發人員聯盟 官網,進入 管理中心 > 我的產品 > 行動裝置 App詳情 頁面中擷取應用程式套件名、應用 App ID 和密鑰。

  3. 點擊 確定 按鈕,儲存配置。

配置榮耀推送渠道

  1. 從左側導覽列進入 訊息推送 > 設定 > 通道配置 標籤頁。

  2. 單擊 榮耀推送通道 配置地區右上方的 配置,頁面上展示配置入口。

    參數

    是否必填

    說明

    狀態

    渠道的接入狀態開關。開啟開關,MPS 將根據配置接入榮耀推送渠道;關閉開關,即取消接入。

    包名

    支援自訂榮耀應用程式套件名。

    榮耀 AppID

    唯一應用標識符,在開發人員平台開通對應應用的榮耀推送服務時產生。

    榮耀應用 ID

    應用的客戶 ID,用於擷取發送訊息令牌的 ID,在開發人員平台開通對應應用 PUSH 服務時產生。

    榮耀應用密鑰

    輸入榮耀應用的密鑰(App Secret)。

    說明

    可登入 榮耀開發人員聯盟 官網,進入 管理中心 > 我的產品 > 行動裝置 App詳情 頁面中擷取應用程式套件名、應用 App ID 和密鑰。

  3. 點擊 確定 按鈕,儲存配置。

配置小米推送通道

  1. 從左側導覽列進入 訊息推送 > 設定 > 通道配置 標籤頁。

  2. 單擊 小米推送通道 配置地區右上方的 配置,頁面上展示配置入口,如下圖所示。

    參數

    是否必填

    說明

    狀態

    通道的接入狀態開關。開啟開關,MPS 將根據配置接入小米推送通道;關閉開關,即取消接入。

    包名

    輸入小米應用的主包名。

    密碼

    輸入小米應用的密鑰(AppSecret)。

    說明

    可登入 小米開放平台,進入 應用管理 > 應用資訊 頁面擷取包名和密鑰。

  3. 點擊 確定 按鈕,儲存配置。

配置 OPPO 推送通道

  1. 從左側導覽列進入 訊息推送 > 設定 > 通道配置 標籤頁。

  2. 單擊 OPPO 推送通道 配置地區右上方的 配置,頁面上展示配置入口,如下圖所示。

    參數

    是否必填

    說明

    狀態

    通道的接入狀態開關。開啟開關,MPS 將根據配置接入 OPPO 推送通道;關閉開關,即取消接入。

    AppKey

    AppKey 是用戶端的身份標識,在用戶端 SDK 初始化時使用。

    MasterSecret

    MasterSecret 是開發人員在使用服務端 API 介面時,用於校正身份的標識。

    說明

    OPPO 開放平台 上,開通 OPPO PUSH 許可權後,即可在 OPPO 推送平台 > 組態管理 > 應用配置 頁面上查看應用的 AppKey 和 MasterSecret 資訊。

  3. 點擊 確定 按鈕,儲存配置。

配置 vivo 推送通道

  1. 從左側導覽列進入 訊息推送 > 設定 > 通道配置 標籤頁。

  2. 單擊 VIVO 推送通道 配置地區右上方的 配置,頁面上展示配置入口,如下圖所示。

    參數

    是否必填

    說明

    狀態

    通道的接入狀態開關。開啟開關,MPS 將根據配置接入 vivo 推送通道;關閉開關,即取消接入。

    APP ID

    AppId 是用戶端的身份標識,在用戶端 SDK 初始化時使用。

    AppKey

    AppKey 是用戶端的身份標識,在用戶端 SDK 初始化時使用。

    MasterSecret

    MasterSecret 是開發人員在使用服務端 API 介面時,用於校正身份的標識。該參數對應您從 vivo 開發人員平台申請擷取的 AppSecret。

    說明

    vivo 開放平台 上為應用申請 Push 服務通過後,即可擷取應用的 AppId,AppKey 和 MasterSecret(AppSecret)。

  3. 點擊 確定 按鈕,儲存配置。

配置 FCM 推送通道

接入海外安卓裝置時,依賴Google的 FCM 服務作為訊息推送網關,需要在控制台側配置 FCM 推送通道。

前提條件

進行 FCM 推送通道配置前,您需要先在 Firebase 控制台上擷取 FCM 伺服器密鑰,擷取方法如下圖所示。

擷取 FCM 伺服器密鑰02

操作步驟
  1. 從左側導覽列進入 訊息推送 > 設定 > 通道配置 標籤頁。

  2. 單擊 FCM 推送通道 配置地區右上方的 配置,配置通道資訊,如下圖所示。FCM 推送渠道配置

  3. 單擊 狀態 開關,開啟開關後,MPS 將接入 FCM 服務;關閉開關後,MPS 不接入 FCM 服務。

  4. 填寫 FCM 伺服器密鑰,確保填寫的是伺服器(server)的密鑰,Android 密鑰、iOS 密鑰和瀏覽器密鑰會被 FCM 拒絕。

  5. 單擊 確定,儲存配置。

配置新版 FCM 通道

重要

自 2024 年 6 月 20 日起,FCM 舊版 API 不再受到支援,並且會停用。為避免推播通知服務發生任何中斷,請您儘快遷移到新版 FCM API。

  1. 通過控制台上傳 FCM 鑒權檔案。

    image

    Firebase 專案支援 Google 服務帳號,您可以使用這些帳號從應用伺服器或受信任環境調用 Firebase 伺服器 API。如果您在本地編寫代碼,或在本地部署您的應用,則可以通過此服務帳號擷取的憑據來對伺服器請求進行授權。

    說明

    如需對服務帳號進行身分識別驗證並授予其訪問 Firebase 服務的許可權,您必鬚生成 JSON 格式的私密金鑰檔案,操作步驟如下:

    1. 在 Firebase 控制台中,選擇 設定 > 服務帳號

    2. 單擊 產生新的私密金鑰,而後通過單擊 產生密鑰 按鈕進行確認。

    3. 妥善儲存包含密鑰的 JSON 檔案。

  2. 推送鏈路切換方式。

    通過新版 FCM 邏輯提供的鏈路切換方式是增加擴充參數(extended_params)配置,增加一個索引值對 useNewFcmApi=1 表示通過新鏈路進行訊息推送。

    image.png

    推送訊息時,需要添加擴充欄位:

    • 舊版:useNewFcmApi,0;

    • 新版:useNewFcmApi,1;

    不添加擴充參數時預設為舊版。