本文為您介紹號碼認證Android客戶端常見問題。
在哪可以直接下載一鍵登錄的SDK和Demo?
登錄號碼認證控制臺,在概覽頁面右側API&SDK區域,單擊立即下載,進入API&SDK頁面,根據頁面提示下載并解壓SDK,解壓后直接運行即可。
SDK存在收集(讀取設備IP)的行為嗎?
號碼認證SDK會采集用戶客戶端的IP信息,采集信息的說明,請參見號碼認證服務隱私權政策。
如果存在隱私合規問題,請您在SDK初始化之前,先讓用戶勾選確認隱私協議后,再開始初始化SDK即可。
Android 13模擬器不支持x86了,只支持x86_x64?
號碼認證依賴數據流量實現功能,如果使用模擬器,就不需要調用阿里云號碼認證服務的SDK。以下代碼用于判斷虛擬機的條件implementation 'com.snail:antifake:1.4' EmulatorDetectUtil.isEmulator(context);
。
號碼認證支持的設備CPU架構有哪幾種?是否支持模擬器?
號碼認證當前僅支持armeabi-v7a、x86及arm64-v8a三種CPU架構,請檢查相應設備架構。由于號碼認證依賴數據流量實現功能,因此不支持模擬器。
號碼認證的方案名稱和App名稱能修改嗎?
號碼認證方案號創建完成后,不支持修改。 如果您有信息變更,或新增加App,請創建新的方案號。
更多詳情,請參見號碼認證方案管理。
如何獲取Android App的簽名?
您可以通過手機終端下載并安裝 Android APP簽名獲取工具,快速獲取創建認證方案時所需的Android App的包簽名信息,便于認證過程進行鑒權。
號碼認證服務取號的過程中對終端移動數據的狀態有要求嗎?
具體要求如下:
終端僅開啟移動數據時,取號功能可正常使用。
終端僅開啟Wi-Fi、關閉移動數據時,取號功能無法使用,已取號成功的除外。
終端同時開啟移動數據和Wi-Fi時,取號功能可正常使用,終端需支持移動數據切換方法。
在新用戶注冊場景中已經接入短信服務,接入號碼認證服務需要進行哪些改造?
客戶端
用戶UI優化。使用號碼認證服務時,由于新用戶僅需輸入手機號碼、無需輸入驗證碼,因此新用戶UI僅提供手機號碼輸入框。當初始化判斷網絡環境不支持號碼認證或號碼認證結果返回不一致時,您可以選擇將UI切換至原使用短信驗證碼的頁面。
在客戶端App中集成號碼認證SDK。
服務端
在服務端對接號碼認證API。
登錄密鑰失敗,怎么辦?
請檢查包名packagename和簽名signature是否與密鑰正確對應。
首次取號時,為什么App網絡通信正常,但號碼認證一直失敗?
請您從以下幾個方面檢查認證失敗的原因:
檢查網絡權限設置。
檢查SIM卡是否欠費。
檢查App是否只有Wi-Fi網絡權限,移動數據網絡權限缺失。
中國某些廠商的Android系統,Wi-Fi網絡權限是與移動網絡權限是分開管理的。
Android加固報錯,怎么辦?
采用白名單策略,用戶對密鑰進行MD5加密,用這個值作為文件名,存入App的assets
目錄。SDK檢測通過就不再進行ptrace檢測。
獲取Token超時,報600015?
請您檢查手機的網絡環境是否正常,600015表示網絡異常超時導致,查看4 G移動數據(關閉Wi-Fi)測試是否正常,或開啟飛行模式進行網絡重啟。
號碼認證一鍵登錄支持的運營商類型有哪些?
號碼認證服務支持三大運營商(中國移動、中國電信、中國聯通)實名認證的手機卡,暫不支持物聯卡和流量卡。
一鍵登錄功能報錯code = 600017,什么意思?
600017一般是包名/簽名或密鑰設置錯誤導致,號碼認證控制臺方案管理頁面的密鑰需要同步到代碼。
第一次加載失敗概率高,怎么辦?
可以不調用預取號接口(加速接口)。 喚起授權頁的前提條件是預取號必須要成功,如果沒有提前調用預取號接口,直接調用getlogintoken接口時,SDK會自動調用預取號接口。所以喚起授權頁會有一個明顯的等待過程。如果提前調用了預取號接口,就可以快速喚起授權頁。
少數設備Wi-Fi和4 G無法拉起一鍵登錄界面?
號碼認證依賴數據流量實現功能。支持數據流量或數據流量+Wi-Fi環境。 數據流量+Wi-Fi環境下,一鍵登錄會從Wi-Fi切到數據網絡通道完成登錄,有一定的耗時,耗時與機型有關。另外建議檢查是否獲取到網絡模塊的切換權限。
號碼認證服務登錄失敗,AccessCode參數不合法?
重復使用Token,建議檢查業務邏輯是否重復使用或者Token過期后使用的情況,認證token的使用有效期:
中國電信10分鐘,僅可使用一次。
中國聯通60分鐘,僅可使用一次。
中國移動2分鐘,僅可使用一次。
授權頁能否自定義UI?
可以添加自定義控件,目前授權頁除“一鍵登錄區域、協議區域、掩碼區域”之外,其他地方均可添加自定義控件。
登錄的按鈕背景色怎么配置?
授權頁登錄按鈕不支持修改背景色,只支持背景圖片,可自定義xml文件配置背景效果。
可以通過自定義授權按鈕獲取Token嗎?
授權頁上的預取掩碼、登錄按鈕和運營商協議,不支持自定義控件。其他區域支持自定義控件。
如何隱藏返回按鈕?
setNavReturnHidden(true)
隱藏返回按鈕。
號碼認證服務二次授權彈窗能自定義布局嗎?
二次授權彈框僅支持授權頁全屏模式。
若SDK提供了對應UI修改接口,則表示相應UI支持修改。若未提供接口,即表示UI不支持修改。
深色模式下,登錄頁面顯示異常,怎么辦?
號碼認證版本升到2.12.10版本。授權頁是否跟隨系統深色模式,true(默認值)表示跟隨,false表示不跟隨,mPhoneNumberAuthHelper.setAuthPageUseDayLight(true);
。
授權頁彈窗是懸浮附著在我們的activity之上嗎?
不是,授權頁彈窗模式是拉起一個新的Activity。
"切換到其他方式"組件如何隱藏?
setSwitchAccHidden(true)
隱藏授權頁自帶的切換其他登錄方式。
授權頁隱私復選框的位置怎么調整? 復選框設置寬高厚和隱私縱向不居中?
協議僅支持橫向居中,不支持縱向居中。文案是頂部對齊,設置checkbox把圓圈切到頂部。