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

配置 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 文件，而后點擊 保存。

   

   重要

   • 上述參數獲取可參考 制作 iOS P8 實時活動證書。

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

     • 若原 iOS 證書為測試環境 sandbox 證書，則推送測試環境實時活動消息。

     • 若原 iOS 證書為生產環境證書，則推送生產環境實時活動消息。

配置 Android 推送通道

為提升推送的到達率，mPaaS 集成了華為、小米、OPPO 和 vivo 等廠商推送通道。采用小米通知欄消息、華為通知欄消息、OPPO 通知欄消息和 vivo 通知欄消息實現消息推送。在應用未運行時，依然可以發送通知，用戶點擊通知欄即可激活進程。

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

• 配置華為推送渠道

• 配置榮耀推送渠道

• 配置小米推送通道

• 配置 OPPO 推送通道

• 配置 vivo 推送通道

• 配置 FCM 推送通道

• 配置新版 FCM 通道

前置條件

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

操作方法

配置華為推送渠道

1. 從左側導航欄進入 消息推送 > 設置 > 通道配置 標簽頁。

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

   參數	是否必填	說明
   狀態	是	渠道的接入狀態開關。打開開關，MPS 將根據配置接入華為推送渠道；關閉開關，即取消接入。
   包名	是	輸入華為應用包名。
   華為應用 ID	是	輸入華為應用的 App ID。
   華為應用密鑰	是	輸入華為應用的密鑰（App Secret）。

   說明

   可登錄 華為開發者聯盟 官網，進入 管理中心 > 我的產品 > 移動應用詳情 頁面中獲取應用包名、應用 App ID 和密鑰。

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

配置榮耀推送渠道

1. 從左側導航欄進入 消息推送 > 設置 > 通道配置 標簽頁。

2. 單擊 榮耀推送通道 配置區域右上角的 配置，頁面上展示配置入口。

   參數	是否必填	說明
   狀態	是	渠道的接入狀態開關。打開開關，MPS 將根據配置接入榮耀推送渠道；關閉開關，即取消接入。
   包名	是	支持自定義榮耀應用包名。
   榮耀 AppID	是	唯一應用標識符，在開發者平臺開通對應應用的榮耀推送服務時生成。
   榮耀應用 ID	是	應用的客戶 ID，用于獲取發送消息令牌的 ID，在開發者平臺開通對應應用 PUSH 服務時生成。
   榮耀應用密鑰	是	輸入榮耀應用的密鑰（App Secret）。

   說明

   可登錄 榮耀開發者聯盟 官網，進入 管理中心 > 我的產品 > 移動應用詳情 頁面中獲取應用包名、應用 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 推送通道

接入海外安卓設備時，依賴谷歌的 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；

   不添加擴展參數時默認為舊版。