本文介紹如何進行 iOS 和 Android 推送通道配置。
配置 iOS 推送通道
接入蘋果手機時,依賴 APNs 服務作為訊息推送網關,需要在控制台側上傳 iOS 推送認證,用於串連 APNs 服務。
完成以下步驟配置 iOS 推送認證:
登入 mPaaS 控制台,選擇目標應用後,從左側導覽列進入 訊息推送 > 設定 頁面。
在右側的設定頁面上,選擇 通道配置 標籤,在 iOS 通道 配置地區,配置 iOS 推送認證。
選擇認證檔案:選擇並上傳預先準備好的 iOS 推送認證。後端會通過解析上傳的認證獲得認證環境和 BundleId。如需瞭解 iOS 推送認證的製作步驟,參考 製作 iOS 推送認證。
認證密碼:填寫認證密碼,即匯出 .p12 認證時所設定的密碼。
單擊 上傳,儲存配置,若認證格式正確,可以看到認證的詳細內容,如下圖所示。若需要驗證認證是否和環境對應,是否合法,可通過在控制台推送訊息進行測試。
iOS 推送認證具有有效期間,請在推送認證失效前及時更新認證,以免訊息推送無法正常工作。系統會在認證失效前 15 天開始提醒更換。如需更換認證,單擊認證資訊下方的 重新上傳 上傳新的認證即可。
配置 iOS 即時活動訊息推送認證
在配置 iOS 即時活動訊息推送認證之前,首先要確定 iOS 原推送認證,即 .p12
認證,已經配置完畢,否則將無法配置即時活動訊息認證。
完成以下步驟配置 iOS 即時活動訊息推送認證:
登入 mPaaS 控制台,選擇目標應用後,從左側導覽列進入 訊息推送 > 設定 頁面。
在 iOS 通道 的設定頁面上,勾選 Token Authentication 配置,配置好 bundleId、keyId、teamId 後,上傳 p8AuthKey 私密金鑰檔案,即
.p8
檔案,而後點擊 儲存。重要上述參數擷取可參考 製作 iOS P8 即時活動認證。
即時活動訊息推送的環境和原 iOS 認證之間綁定,因此使用效果如下:
若原 iOS 認證為測試環境 sandbox 認證,則推送測試環境即時活動訊息。
若原 iOS 認證為生產環境認證,則推送生產環境即時活動訊息。
配置 Android 推送通道
為提升推送的到達率,mPaaS 整合了華為、小米、OPPO 和 vivo 等廠商推送通道。採用小米通知欄訊息、華為通知欄訊息、OPPO 通知欄訊息和 vivo 通知欄訊息實現訊息推送。在應用未運行時,依然可以發送通知,使用者點擊通知欄即可啟用進程。
接入廠商自有的推送通道後,能夠協助應用獲得穩定的推送效能,因此建議您將廠商推送通道接入應用。
本文將引導您完成在接入小米、華為、OPPO 和 vivo 推送渠道時需要進行的控制台側配置。
前置條件
您需要先完成用戶端側的接入配置,操作參見 接入廠商推送通道。
操作方法
配置華為推送渠道
從左側導覽列進入 訊息推送 > 設定 > 通道配置 標籤頁。
單擊 華為推送通道 配置地區右上方的 配置,頁面上展示配置入口,如下圖所示。
參數
是否必填
說明
狀態
是
渠道的接入狀態開關。開啟開關,MPS 將根據配置接入華為推送渠道;關閉開關,即取消接入。
包名
是
輸入華為應用程式套件名。
華為應用 ID
是
輸入華為應用的 App ID。
華為應用密鑰
是
輸入華為應用的密鑰(App Secret)。
說明可登入 華為開發人員聯盟 官網,進入 管理中心 > 我的產品 > 行動裝置 App詳情 頁面中擷取應用程式套件名、應用 App ID 和密鑰。
點擊 確定 按鈕,儲存配置。
配置榮耀推送渠道
從左側導覽列進入 訊息推送 > 設定 > 通道配置 標籤頁。
單擊 榮耀推送通道 配置地區右上方的 配置,頁面上展示配置入口。
參數
是否必填
說明
狀態
是
渠道的接入狀態開關。開啟開關,MPS 將根據配置接入榮耀推送渠道;關閉開關,即取消接入。
包名
是
支援自訂榮耀應用程式套件名。
榮耀 AppID
是
唯一應用標識符,在開發人員平台開通對應應用的榮耀推送服務時產生。
榮耀應用 ID
是
應用的客戶 ID,用於擷取發送訊息令牌的 ID,在開發人員平台開通對應應用 PUSH 服務時產生。
榮耀應用密鑰
是
輸入榮耀應用的密鑰(App Secret)。
說明可登入 榮耀開發人員聯盟 官網,進入 管理中心 > 我的產品 > 行動裝置 App詳情 頁面中擷取應用程式套件名、應用 App ID 和密鑰。
點擊 確定 按鈕,儲存配置。
配置小米推送通道
從左側導覽列進入 訊息推送 > 設定 > 通道配置 標籤頁。
單擊 小米推送通道 配置地區右上方的 配置,頁面上展示配置入口,如下圖所示。
參數
是否必填
說明
狀態
是
通道的接入狀態開關。開啟開關,MPS 將根據配置接入小米推送通道;關閉開關,即取消接入。
包名
是
輸入小米應用的主包名。
密碼
是
輸入小米應用的密鑰(AppSecret)。
說明可登入 小米開放平台,進入 應用管理 > 應用資訊 頁面擷取包名和密鑰。
點擊 確定 按鈕,儲存配置。
配置 OPPO 推送通道
從左側導覽列進入 訊息推送 > 設定 > 通道配置 標籤頁。
單擊 OPPO 推送通道 配置地區右上方的 配置,頁面上展示配置入口,如下圖所示。
參數
是否必填
說明
狀態
是
通道的接入狀態開關。開啟開關,MPS 將根據配置接入 OPPO 推送通道;關閉開關,即取消接入。
AppKey
是
AppKey 是用戶端的身份標識,在用戶端 SDK 初始化時使用。
MasterSecret
是
MasterSecret 是開發人員在使用服務端 API 介面時,用於校正身份的標識。
點擊 確定 按鈕,儲存配置。
配置 vivo 推送通道
從左側導覽列進入 訊息推送 > 設定 > 通道配置 標籤頁。
單擊 VIVO 推送通道 配置地區右上方的 配置,頁面上展示配置入口,如下圖所示。
參數
是否必填
說明
狀態
是
通道的接入狀態開關。開啟開關,MPS 將根據配置接入 vivo 推送通道;關閉開關,即取消接入。
APP ID
是
AppId 是用戶端的身份標識,在用戶端 SDK 初始化時使用。
AppKey
是
AppKey 是用戶端的身份標識,在用戶端 SDK 初始化時使用。
MasterSecret
是
MasterSecret 是開發人員在使用服務端 API 介面時,用於校正身份的標識。該參數對應您從 vivo 開發人員平台申請擷取的 AppSecret。
說明在 vivo 開放平台 上為應用申請 Push 服務通過後,即可擷取應用的 AppId,AppKey 和 MasterSecret(AppSecret)。
點擊 確定 按鈕,儲存配置。
配置 FCM 推送通道
接入海外安卓裝置時,依賴Google的 FCM 服務作為訊息推送網關,需要在控制台側配置 FCM 推送通道。
前提條件
進行 FCM 推送通道配置前,您需要先在 Firebase 控制台上擷取 FCM 伺服器密鑰,擷取方法如下圖所示。
操作步驟
從左側導覽列進入 訊息推送 > 設定 > 通道配置 標籤頁。
單擊 FCM 推送通道 配置地區右上方的 配置,配置通道資訊,如下圖所示。
單擊 狀態 開關,開啟開關後,MPS 將接入 FCM 服務;關閉開關後,MPS 不接入 FCM 服務。
填寫 FCM 伺服器密鑰,確保填寫的是伺服器(server)的密鑰,Android 密鑰、iOS 密鑰和瀏覽器密鑰會被 FCM 拒絕。
單擊 確定,儲存配置。
配置新版 FCM 通道
自 2024 年 6 月 20 日起,FCM 舊版 API 不再受到支援,並且會停用。為避免推播通知服務發生任何中斷,請您儘快遷移到新版 FCM API。
通過控制台上傳 FCM 鑒權檔案。
Firebase 專案支援 Google 服務帳號,您可以使用這些帳號從應用伺服器或受信任環境調用 Firebase 伺服器 API。如果您在本地編寫代碼,或在本地部署您的應用,則可以通過此服務帳號擷取的憑據來對伺服器請求進行授權。
說明如需對服務帳號進行身分識別驗證並授予其訪問 Firebase 服務的許可權,您必鬚生成 JSON 格式的私密金鑰檔案,操作步驟如下:
在 Firebase 控制台中,選擇 設定 > 服務帳號。
單擊 產生新的私密金鑰,而後通過單擊 產生密鑰 按鈕進行確認。
妥善儲存包含密鑰的 JSON 檔案。
推送鏈路切換方式。
通過新版 FCM 邏輯提供的鏈路切換方式是增加擴充參數(extended_params)配置,增加一個索引值對
useNewFcmApi=1
表示通過新鏈路進行訊息推送。推送訊息時,需要添加擴充欄位:
舊版:
useNewFcmApi
,0;新版:
useNewFcmApi
,1;
不添加擴充參數時預設為舊版。