1. 概述
1.1 版本說明
版本庫 | 信鴿推送配置插件版本 | 支持的功能 |
|---|---|---|
| 10.0 | 10.4.76 | 支持騰訊消息推送中心有償推送服務 |
| 10.4.975 |
| |
| 10.4.976 |
|
1.2 應用場景
OEM 的 FineMobile 數據分析 App 可根據用戶需求設置消息推送功能。
1.3 功能介紹
OEM 的 FineMobile 數據分析 App 可以使用自己的信鴿平台，且不通過推送中心進行消息轉發。
「消息推送」功能默認不勾選，用戶勾選後，需填寫一些配置信息，如下圖所示：
根據信鴿版本的不同，各類推送方式的功能區别也不相同，具體如下圖所示：
注：信鴿推送配置插件 V10.4.76 版本僅适配信鴿 TPNS 版本。
| 信鴿版本配置 | 推送通道 | 功能 |
|---|---|---|
TPNS版本 （收費版本） | 自建通道 | 需要購買 騰訊移動推送服務 打開App 後，可接收消息推送 不打開 App，無法接收消息推送 |
| 廠商通道 | 需要購買 騰訊移動推送服務 無需打開應用，即可收到推送消息 |
注：若用戶 配置了 iOS 證書，且證書中不包含「Push Notifications」功能，則消息推送功能灰化，無法打包。如下圖所示：
2. 獲取信鴿應用密鑰
2.1 新建産品
登錄 騰訊移動推送平台，點擊産品管理>新增産品，填寫産品信息，勾選平台版本，點擊确定。如下圖所示：
注1：如果 iOS 和 Android 都需要打包，則都需要進行注冊。
注2：服務器接入點也就是信鴿集群，在後續步驟3.2推送配置和4.3配置密鑰會用到，需要注意下。
注3：大陸用戶選擇廣州或上海集群，港澳台及海外用戶選擇中國香港或新加坡集群。
2.2 配置管理
填寫配置，此處的應用包名應與 帆軟 App 打包證書 中的package包名一緻，如下圖所示：
2.3 獲取參數
配置完成後，會得到三個和 App 相關的參數：ACCESS ID、ACCESS KEY、SECRET KEY。
3. 服務器推送配置
3.1 插件安裝
點擊下載插件：信鴿推送配置（TPNS）插件
設計器插件安裝方法參照 設計器插件管理
服務器安裝插件方法參照 服務器插件管理
注：需安裝 V10.4.76 及以上版本的插件
3.2 推送配置
插件安裝後，登錄數據決策平台，管理系統>移動平台目錄下新增推送配置。
推送配置分爲「國内設置」和「國際/中國港澳台設置」，國内設置的集群服務器可選廣州或上海，國際/中國港澳台設置的集群服務器可選中國香港或新加坡。
推送配置分爲「國内設置」和「國際/中國港澳台設置」後，現在可以一次向多個集群推送消息，例如同時向上海和新加坡集群推送消息。
選擇設置方式後，填寫2.3節獲取的ACCESS ID、SECRET KEY，以及2.1新建産品中選擇的服務接入點。
如下圖所示：
3.3 設置代理服務器
如報表服務器部署在内網，不能訪問外網，也不能被外網訪問，此時需要配置代理服務器，方可成功推送消息。具體操作請參見：代理服務器配置
4. App 打包配置
4.1 新建應用
注1：正常定制打包步驟請參見 App 打包 ，本文僅對消息推送設置進行說明。
打開 帆軟市場 ，點擊用戶中心>App 打包，新建應用或對已有 App 進行打包，如下圖所示：
4.2 選擇版本庫
僅當選擇「10.0 版本庫」時，支持設置「消息推送」功能。
4.3 配置密鑰
勾選「消息推送」功能，填寫2.3節獲取的ACCESS ID、ACCESS KEY，以及2.1新建産品中選擇的服務接入點。如下圖所示：
4.4 信鴿版本配置
信鴿版本配置勾選「TPNS 版本」。
推送通道可選擇：
自建通道：打開App 後，可接收消息推送。不打開 App，無法接收消息推送。可跳過第 5 章操作步驟。
廠商通道：開通廠商通道，能夠實現無需打開應用，即可收到推送消息。需執行第 5 章操作步驟。
5. 配置廠商通道
注：推送通道選擇選擇自建通道時，無需執行本章操作。
開通廠商通道，能夠實現無需打開應用，即可收到推送消息。
5.1 獲取廠商密鑰
5.1.1 國内廠商
用戶根據需要适配的廠商通道，到對應的廠商開放平台，開通開發者賬号，并獲取廠商推送的密鑰。如下表所示：
| 廠商 | 開發者平台 | 密鑰 | 操作步驟 |
|---|---|---|---|
| 小米 | 小米開放平台 | AppId AppKey AppSecret | 1）進入 小米開放平台 ，開通小米開發者賬号 2）獲取廠商密鑰：AppId、AppKey、AppSecret 更多詳情請參見：快速接入指南 |
| 華爲 | 華爲開發者平台 | AppID SecretKey | 1）進入 華爲開放平台 2）注冊和登錄開發者賬号，詳情請參見 賬号注冊認證（新用戶需進行實名認證） 3）在華爲推送平台中新建應用，詳情請參見 創建應用（應用包名需跟3.2.2 節填寫的包名保持一緻） 4）獲取廠商密鑰：AppID、SecretKey |
| 魅族 | 魅族開放平台 | AppId AppKey AppSecret | 1）進入 魅族推送官網，注冊并登錄開發者賬号 2）獲取廠商密鑰：AppId，AppKey，AppSecret 更多詳情請參見：魅族開發文檔 |
| oppo | OPPO開放平台 | AppKey AppSecret MasterSecret | 1）使用 OPPO 企業開發者賬号，登錄 OPPO 開發平台 2）在「管理中心 > 應用服務平台 > 移動應用列表 > 選擇應用 > 開發服務 > 推送服務」中完成 OPPO PUSH 權限申請 3）Opush 申請開通成功後，在「OPPO 推送平台 > 配置管理 > 應用配置」頁面，獲取廠商密鑰：AppKey、AppSecret 和 MasterSecret 更多詳情請參見：快速接入指引 |
| vivo | vivo開放平台 | AppId AppKey AppSecret | 開發者需向 vivo 申請開通推送權限，獲取廠商密鑰：AppID 、AppKey、AppSecret 更多詳情請參見：快速接入指引 |
5.1.2 海外廠商
Android 信鴿集群服務器選擇「中國香港」或「新加坡」後，可以使用中國香港或新加坡集群的 FCM 通道向 Google 手機推送消息。
該功能按鈕默認關閉，開啓後需要上傳 google-services.json 文件，獲取該文件的方法參見文檔：獲取FCM的google-services.json
想要更換 google-services.json 文件可以重新傳覆蓋掉，上傳文件後會持久保留，關閉按鈕再開啓配置文件仍然存在。
FCM 通道的設置位置如下圖所示：
注：小米和華爲也是支持海外通道的，設置方法同 5.1.1 的介紹。
5.2 配置信鴿廠商接入
登錄 騰訊移動推送平台，點擊産品管理>對應的應用>配置管理，打開需要的廠商推送通道，填寫5.1 節獲取的密鑰。如下圖所示：
5.3 配置 OEM 廠商通道
打開 帆軟市場 App 打包界面，在消息推送>廠商通道處填寫5.1 節獲取的密鑰。如下圖所示：
注：如不填寫相關密鑰，即使打開了推送通道，仍将使用信鴿自建通道。
注：當「ANDROID信鴿集群服務器」設置爲「香港」或「新加坡」時，推送通道的廠商通道只能選擇小米或華爲，如下圖所示：
6. 效果展示
生成 App 安裝包并下載安裝，用戶可以收到系統通知，App 主頁底部菜單顯示消息，如下圖所示：
注：僅設置服務器消息推送，不設置OEM 消息推送打包，客戶端将收不到系統通知，底部無消息列。
僅設置OEM 消息推送打包，不設置服務器消息推送，客戶端将收不到系統通知，底部有消息列。
7. 屏蔽信鴿前端配置頁面
插件 10.4.975 版本新增一個參數frontPageHidden，可以通過修改這個參數決定是否顯示信鴿前端配置頁面：
在數據庫中修改表fine_conf_entity即可，默認爲 false 。
設置frontPageHidden=true時推送配置頁面隐藏。
設置frontPageHidden=false時推送配置頁面顯示。
注：該參數只有超級管理員才能使用，次級管理員或普通用戶無權修改。
