Mobile Platform as a Service：通道配置

配置 Android 推送通道

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

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

• 配置華為推送渠道

• 配置榮耀推送渠道

• 配置小米推送通道

• 配置 OPPO 推送通道

• 配置 vivo 推送通道

• 配置 FCM 推送通道

• 配置新版 FCM 通道

前置條件

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

操作方法

配置華為推送渠道

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

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

   

   參數	是否必填	說明
   狀態	是	渠道的接入狀態開關。開啟開關，MPS 將根據配置接入華為推送渠道；關閉開關，即取消接入。
   包名	是	輸入華為應用程式套件名。
   華為應用 ID	是	輸入華為應用的 App ID。
   華為應用密鑰	是	輸入華為應用的密鑰（App Secret）。
   廠商回執	是	控制 MPS 是否支援廠商回執。

   說明

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

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

配置榮耀推送渠道

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

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

   

   參數	是否必填	說明
   狀態	是	渠道的接入狀態開關。開啟開關，MPS 將根據配置接入榮耀推送渠道；關閉開關，即取消接入。
   包名	是	支援自訂榮耀應用程式套件名。
   榮耀 AppID	是	唯一應用標識符，在開發人員平台開通對應應用的榮耀推送服務時產生。
   榮耀應用 ID	是	應用的客戶 ID，用於擷取發送訊息令牌的 ID，在開發人員平台開通對應應用 PUSH 服務時產生。
   榮耀應用密鑰	是	輸入榮耀應用的密鑰（App Secret）。
   廠商回執	是	控制 MPS 是否支援廠商回執。

   說明

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

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

配置小米推送通道

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

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

   

   參數	是否必填	說明
   狀態	是	通道的接入狀態開關。開啟開關，MPS 將根據配置接入小米推送通道；關閉開關，即取消接入。
   包名	是	輸入小米應用的主包名。
   密碼	是	輸入小米應用的密鑰（AppSecret）。
   廠商回執	是	控制 MPS 是否支援廠商回執.
   回執地址	否	當開啟廠商回執時必填，需是 HTTPS 協議。

   說明

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

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

配置 OPPO 推送通道

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

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

   

   參數	是否必填	說明
   狀態	是	通道的接入狀態開關。開啟開關，MPS 將根據配置接入 OPPO 推送通道；關閉開關，即取消接入。
   AppKey	是	AppKey 是用戶端的身份標識，在用戶端 SDK 初始化時使用。
   MasterSecret	是	MasterSecret 是開發人員在使用服務端 API 介面時，用於校正身份的標識。
   廠商回執	是	控制 MPS 是否支援廠商回執。
   回執地址	否	當開啟廠商回執時必填，需是 HTTPS 協議。

   說明

   在 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。
   廠商回執	是	控制 MPS 是否支援廠商回執。
   回執地址	否	當開啟廠商回執時必填，需是 HTTPS 協議。

   說明

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

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

配置 FCM 推送通道

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

前提條件

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

操作步驟

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

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

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

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

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

配置新版 FCM 通道

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

   

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

   說明

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

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

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

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

2. 推送鏈路切換方式。

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

   

   推送訊息時，需要添加擴充欄位：

   • 舊版：useNewFcmApi，0；

   • 新版：useNewFcmApi，1；

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

配置 iOS 推送通道

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

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

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

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

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

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

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

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

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

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

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

   

   重要

   • 如需瞭解 p8AuthKey 私密金鑰檔案的製作步驟，參考 製作 iOS P8 即時活動認證。

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

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

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

配置回執地址

目前支援回執的廠商分別有：華為、榮耀、鴻蒙、小米、OPPO、vivo。