自注冊DM(二)CMCC移動DM FAQ



適配平臺地址:https://test.fxltsbl.com/

Q1w2e3

問題0:總體概述。廠商如何使用SDK、DM的實現原理是什麼、找不到DmykAbsTelephonyManager類?



答:參考CmccDemo_Svn示例Demo,廠商要負責實現類似功能的系統級應用,賦予相應的權限,滿足相應的“不可見”、“無感知”、“常駐”等要求,在Application的onCreate(Bundle)函數中初始化SDK,由廠商自行創建DmykAbsTelephonyManager類並在其中實現文檔中要求的接口,通過getDefault函數返回該類實例,將jar包及.so文件添加到應用中。SDK會根據業務需求通過該實例調用接口,獲取對應的信息進行處理並完成對應的上報業務。配置業務中,所需數據參數由SDK從服務器獲取並進行處理,需要廠商注意的是,APN配置的修改是SDK通過操作數據庫實現的,廠商只需監聽數據庫的變化並在數據庫發生變化時發送相應的設置狀態變更廣播,VoLTE開關狀態需要變更時,需要跳轉到對應的設置頁面,在用戶設置完成後再發送對應的廣播由SDK接收並做進一步處理。實際上,數據的採集是由廠商完成並通過接口提供給SDK的,SDK僅僅是對數據的彙總處理,並完成與平臺的交互。另外,SDK中很多業務是由廣播觸發的,如果出現短時間內重複上報,請先自行判斷是否有廣播的密集重複發送。

 

問題1、SDK方提供了多個.so文件,可以刪除或混淆麼?

.so文件是根據CPU型號適配的,由系統決定具體使用哪個文件,所以不要做任何混淆或刪改。

 

問題2、心跳週期時長及設置?

爲了方便調試,心跳週期在調試版中做過比例縮短處理,商用版的一小時等於調試版的一分鐘。例如:調試版在配置頁面中配置心跳週期爲3小時,實際3分鐘就會上傳心跳。

 

問題3、心跳週期什麼時候生效?

心跳週期的變更會在下一次心跳後生效,例如,在10:00:00開始上報第一次心跳,默認爲1小時(調試版爲1分鐘)週期,在10:01:20修改心跳週期爲5小時(調試版中爲5分鐘),則10:02:00依然會上報第三次心跳,第四次心跳會在第10:07:00上報。

 

問題4、數據上報成功後在終端適配平臺查不大數據,過一會又查到了?

終端適配平臺頁面展示存在一定延遲,上報的數據並不會即時在平臺上展示,可能存在2~5分鐘延遲,屬於正常現象,且商用版和調試版延遲是相同的。

 

問題5、SDK的心跳怎麼保活,遇到異常情景是否會失效?

SDK的計時功能(心跳、上報失敗的重新發送等)可能因一些不可預測的情況導致計時器失效,但SDK有計時器檢測機制,在終端重啓、網絡變更、計時器觸發時會檢測其餘計時器狀態,如果檢測到計時器失效,會根據最近一次設置的時間

重新開啓計時器,導致時間存在一定偏移,運行一段時間後恢復穩定心跳。

 

問題6、SDK設置VoLTE通知欄提醒、VoLTE狀態變更、APN信息狀態變更等廣播的Action怎麼接收?

由SDK發送的廣播使用系統靜態BroadCastReceiver接收,具體廣播類型參考《終端管理接口規範》中定義的行爲,在Activity或Server中接收可能會接受不到。

 

問題7、部分廠家手機在恢復出廠後上報業務均不再觸發,發現數據不上報,使用瀏覽器訪問網頁提示證書無效等。

請確認恢復出廠後的時間,因網絡傳輸採用HTTPS協議,證書受時間影響,可能在恢復出廠的默認時間(如2016.01.01)證書失效,在設置正確時間後上報業務即可恢復正常。

 

問題8、SDK的Service在什麼條件下會stopSelf ?

出於適配和功能的考慮,Service開啓後是不會關閉的,如出現Service被殺死屬於異常情況,Service會在接收到指定廣播後重新開啓Service。終端廠商需保證終端管理客戶端能後臺靜默運行。

 

問題9、適配過程中發現沒有心跳、APN數據、應用數據不上報,日誌中參照不到對應的日誌。

請確保AndroidManifest.xml配置清單中的uses-permission、service、receiver、intent-filter、action等均正確配置且無遺漏。

 

問題10、重啓手機後沒有自注冊信息上報?

自注冊上報的判斷條件是SIM卡變更或卡槽位置變更,僅僅重啓手機是不會觸發自注冊上報的,可以考慮恢復出廠、更換SIM卡、將SIM卡更換卡槽等方式再次觸發自注冊。

 

問題11、終端廠商需實現那些功能、SDK實現那些功能?

終端廠商的職責是要實現的是接口規範的接口,以及終端規範裏屏蔽權限提示,用戶不可見要求,將jar包集成內置,資源集成,並賦予相應權限,保證SDK的正常運行及接口規範文檔中的列出的接口均能夠正常調用,DM業務上報、心跳、應用信息採集及上報邏輯由SDK實現。

 

問題12、終端管理客戶端命名有什麼特殊要求麼?

不得包含“中國移動”、“CMCC”等與中國移動相關的字樣,同樣不建議包含“DM”

 

問題13、環境配置有什麼要求?

參見《SDK集成文檔》

 

問題14、有些手機雙卡IMEI號相同,是否會觸發自注冊?

雙卡的手機的IMEI相同,導致同一張SIM卡在更換卡槽時不觸發自注冊。

問題15、單卡手機卡槽2的IMEI號、cellId、LAC等信息返回什麼?

默認返回空。

 

問題16、雙VoLTE終端獲取主卡狀態時返回什麼,getMasterPhoneId()在這個情況下返回什麼?

雙VoLTE終端返回值爲3,兩張卡可同時4G駐網

 

問題17、如何獲取廠商實現DmykAbsTelephonyManager類實例?

DmykAbsTelephonyManager類是由終端廠商實現類,獲取對象的方法爲getDefault(Context context)。

 

問題18、無法查詢不到VoLTE開關業務配置數據

根據imei號查看是否有相應的心跳數據volte數據上報,VoLTE業務狀態隨心跳上報到終端管理平臺。

 

問題19、根據查詢條件,未查詢到上報數據,怎麼處理?

上報數據會有2到3分鐘延遲入庫,請在之後時間在進行查詢。

 

問題20、如何查看終端自注冊、心跳、應用數據查看詳細信息?

點擊某行數據即可彈出詳細數據窗口。如圖所示:

 

問題21、系統參數配置沒有新增規則的操作按鈕?

需要有心跳數據上報後才能顯示按鈕。


 

問題22、採集配置沒有新增規則的操作按鈕?

需要有心跳數據上報後才能顯示按鈕。

 

 

問題23、系統參數配置如何操作?

可通過廠家+型號或IMEI號兩種範圍來進行配置;常用場景:點擊新增系統參數配置,輸入規則名稱,配置緯度選擇IMEI號,輸入要配置的終端IMEI號,新增需要測試的配置規則;

適配平臺地址:https://test.fxltsbl.com/

Q1w2e3

問題0:總體概述。廠商如何使用SDK、DM的實現原理是什麼、找不到DmykAbsTelephonyManager類?



答:參考CmccDemo_Svn示例Demo,廠商要負責實現類似功能的系統級應用,賦予相應的權限,滿足相應的“不可見”、“無感知”、“常駐”等要求,在Application的onCreate(Bundle)函數中初始化SDK,由廠商自行創建DmykAbsTelephonyManager類並在其中實現文檔中要求的接口,通過getDefault函數返回該類實例,將jar包及.so文件添加到應用中。SDK會根據業務需求通過該實例調用接口,獲取對應的信息進行處理並完成對應的上報業務。配置業務中,所需數據參數由SDK從服務器獲取並進行處理,需要廠商注意的是,APN配置的修改是SDK通過操作數據庫實現的,廠商只需監聽數據庫的變化並在數據庫發生變化時發送相應的設置狀態變更廣播,VoLTE開關狀態需要變更時,需要跳轉到對應的設置頁面,在用戶設置完成後再發送對應的廣播由SDK接收並做進一步處理。實際上,數據的採集是由廠商完成並通過接口提供給SDK的,SDK僅僅是對數據的彙總處理,並完成與平臺的交互。另外,SDK中很多業務是由廣播觸發的,如果出現短時間內重複上報,請先自行判斷是否有廣播的密集重複發送。

 

問題1、SDK方提供了多個.so文件,可以刪除或混淆麼?

.so文件是根據CPU型號適配的,由系統決定具體使用哪個文件,所以不要做任何混淆或刪改。

 

問題2、心跳週期時長及設置?

爲了方便調試,心跳週期在調試版中做過比例縮短處理,商用版的一小時等於調試版的一分鐘。例如:調試版在配置頁面中配置心跳週期爲3小時,實際3分鐘就會上傳心跳。

 

問題3、心跳週期什麼時候生效?

心跳週期的變更會在下一次心跳後生效,例如,在10:00:00開始上報第一次心跳,默認爲1小時(調試版爲1分鐘)週期,在10:01:20修改心跳週期爲5小時(調試版中爲5分鐘),則10:02:00依然會上報第三次心跳,第四次心跳會在第10:07:00上報。

 

問題4、數據上報成功後在終端適配平臺查不大數據,過一會又查到了?

終端適配平臺頁面展示存在一定延遲,上報的數據並不會即時在平臺上展示,可能存在2~5分鐘延遲,屬於正常現象,且商用版和調試版延遲是相同的。

 

問題5、SDK的心跳怎麼保活,遇到異常情景是否會失效?

SDK的計時功能(心跳、上報失敗的重新發送等)可能因一些不可預測的情況導致計時器失效,但SDK有計時器檢測機制,在終端重啓、網絡變更、計時器觸發時會檢測其餘計時器狀態,如果檢測到計時器失效,會根據最近一次設置的時間

重新開啓計時器,導致時間存在一定偏移,運行一段時間後恢復穩定心跳。

 

問題6、SDK設置VoLTE通知欄提醒、VoLTE狀態變更、APN信息狀態變更等廣播的Action怎麼接收?

由SDK發送的廣播使用系統靜態BroadCastReceiver接收,具體廣播類型參考《終端管理接口規範》中定義的行爲,在Activity或Server中接收可能會接受不到。

 

問題7、部分廠家手機在恢復出廠後上報業務均不再觸發,發現數據不上報,使用瀏覽器訪問網頁提示證書無效等。

請確認恢復出廠後的時間,因網絡傳輸採用HTTPS協議,證書受時間影響,可能在恢復出廠的默認時間(如2016.01.01)證書失效,在設置正確時間後上報業務即可恢復正常。

 

問題8、SDK的Service在什麼條件下會stopSelf ?

出於適配和功能的考慮,Service開啓後是不會關閉的,如出現Service被殺死屬於異常情況,Service會在接收到指定廣播後重新開啓Service。終端廠商需保證終端管理客戶端能後臺靜默運行。

 

問題9、適配過程中發現沒有心跳、APN數據、應用數據不上報,日誌中參照不到對應的日誌。

請確保AndroidManifest.xml配置清單中的uses-permission、service、receiver、intent-filter、action等均正確配置且無遺漏。

 

問題10、重啓手機後沒有自注冊信息上報?

自注冊上報的判斷條件是SIM卡變更或卡槽位置變更,僅僅重啓手機是不會觸發自注冊上報的,可以考慮恢復出廠、更換SIM卡、將SIM卡更換卡槽等方式再次觸發自注冊。

 

問題11、終端廠商需實現那些功能、SDK實現那些功能?

終端廠商的職責是要實現的是接口規範的接口,以及終端規範裏屏蔽權限提示,用戶不可見要求,將jar包集成內置,資源集成,並賦予相應權限,保證SDK的正常運行及接口規範文檔中的列出的接口均能夠正常調用,DM業務上報、心跳、應用信息採集及上報邏輯由SDK實現。

 

問題12、終端管理客戶端命名有什麼特殊要求麼?

不得包含“中國移動”、“CMCC”等與中國移動相關的字樣,同樣不建議包含“DM”

 

問題13、環境配置有什麼要求?

參見《SDK集成文檔》

 

問題14、有些手機雙卡IMEI號相同,是否會觸發自注冊?

雙卡的手機的IMEI相同,導致同一張SIM卡在更換卡槽時不觸發自注冊。

問題15、單卡手機卡槽2的IMEI號、cellId、LAC等信息返回什麼?

默認返回空。

 

問題16、雙VoLTE終端獲取主卡狀態時返回什麼,getMasterPhoneId()在這個情況下返回什麼?

雙VoLTE終端返回值爲3,兩張卡可同時4G駐網

 

問題17、如何獲取廠商實現DmykAbsTelephonyManager類實例?

DmykAbsTelephonyManager類是由終端廠商實現類,獲取對象的方法爲getDefault(Context context)。

 

問題18、無法查詢不到VoLTE開關業務配置數據

根據imei號查看是否有相應的心跳數據volte數據上報,VoLTE業務狀態隨心跳上報到終端管理平臺。

 

問題19、根據查詢條件,未查詢到上報數據,怎麼處理?

上報數據會有2到3分鐘延遲入庫,請在之後時間在進行查詢。

 

問題20、如何查看終端自注冊、心跳、應用數據查看詳細信息?

點擊某行數據即可彈出詳細數據窗口。如圖所示:

 

問題21、系統參數配置沒有新增規則的操作按鈕?

需要有心跳數據上報後才能顯示按鈕。


 

問題22、採集配置沒有新增規則的操作按鈕?

需要有心跳數據上報後才能顯示按鈕。

 

 

問題23、系統參數配置如何操作?

可通過廠家+型號或IMEI號兩種範圍來進行配置;常用場景:點擊新增系統參數配置,輸入規則名稱,配置緯度選擇IMEI號,輸入要配置的終端IMEI號,新增需要測試的配置規則;

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章