本文為您介紹號碼認證iOS客戶端常見問題。
問題概覽
服務咨詢類
使用咨詢類
異常/錯誤咨詢類
號碼認證服務密鑰在哪查看?
登錄號碼認證控制臺,在方案管理頁面,創建認證方案后會自動生成密鑰。
提示isv.INVALID_APP,什么意思?
請確認創建方案號的阿里云賬號和服務端調用的阿里云賬號是否一致。
服務端App Code怎么獲取?
登錄號碼認證控制臺,在方案管理頁面,創建認證方案后會生成方案號。
H5獲取到的Access_Token給一鍵登錄取號用可以嗎?
不可以用,客戶端getlogintoken接口獲取的Token,作為getmobile接口的入參,Token是不通用的。
unity項目支持嗎?
目前只有uniapp阿里云有研發插件供用戶使用,如Flutter、Swift、RN等暫未提供插件,需要用戶側自行研發插件接入。
一個App可以對應多個認證方案嗎?
可以的,兩個方案號的Bundleid可以相同。
加速接口和獲取接口什么關系?
可以不調用預取號接口(加速接口)。 喚起授權頁的前提條件是預取號必須要成功,如果沒有提前調用預取號接口,直接調用getlogintoken接口時,SDK會自動調用預取號接口。所以喚起授權頁會有一個明顯的等待過程。如果提前調用了預取號接口,就可以快速喚起授權頁。
號碼認證的方案名稱和App名稱能修改嗎?
號碼認證方案號創建完成后,不支持修改。 如果您有信息變更,或新增加App,請創建新的方案號。
更多詳情,請參見號碼認證方案管理。
虛擬號可以使用嗎?
目前是不支持使用虛擬號。
登錄的按鈕背景色怎么配置?
授權頁登錄按鈕不支持修改背景色,只支持背景圖片。
在授權頁上如何自定義UI?
可以添加自定義控件,目前授權頁除了“一鍵登錄區域、協議區域、掩碼區域”之外,其他地方均可添加自定義控件,添加自定義UI請在customViewBlock
回調中進行。定義視圖的創建初始化和添加到父視圖,都需要在主線程。
號碼認證服務二次授權彈窗能自定義布局嗎?
二次授權彈框僅支持授權頁全屏模式。若SDK提供了對應UI修改接口,則表示相應UI支持修改。若未提供接口,即表示UI不支持修改。
可以通過自定義授權按鈕獲取Token嗎?
不可以,必須通過內置的登錄按鈕進行。授權頁的預取掩碼、登錄按鈕、運營商協議部分,不支持自定義控件的,其他區域支持自定義控件。
怎么判斷是顯示哪個運營商的隱私協議鏈接?
運營商協議是授權頁自動顯示的。您不需要處理,具體是哪個運營商就會自動顯示對應運營商協議。
iOS SDK中的ATAuthSDK.bundle圖片資源未能加載到頁面上?
使用默認圖片必須把SDK帶的bundle導進工程。
NSString *path = [[NSBundle mainBundle] pathForResource:@"ATAuthSDK" ofType:@"bundle"];
NSBundle *bundle = [[NSBundle alloc] initWithPath:path];
授權頁的隱私復選框位置怎么調整? 復選框設置寬高厚和隱私縱向不居中?
協議僅支持橫向居中,不支持縱向居中。 文案是頂部對齊,設置checkbox把圓圈切到頂部。
在點擊一鍵登錄之前獲取到手機號,有沒有辦法實現?
不可以,點擊一鍵登錄這個步驟不可以跳過。
授權頁面可以二次開發嗎?
可以,設置自定義控件實現二次開發。
為什么程序第一次啟動的時候失敗率較高?
第一次啟動時可能存在網絡授權相關問題,如果啟動直接調用喚起授權頁接口,可能存在超時現象。若需要快速拉起授權頁,建議先調用加速接口,再快速喚起授權頁。
獲取Token超時,為什么錯誤碼600015?
請您檢查手機的網絡環境是否正常,600015表示網絡異常超時導致,查看4 G移動數據(關閉Wi-Fi)測試是否正常,或開啟飛行模式進行網絡重啟。
號碼認證服務登錄失敗,AccessCode參數不合法?
重復使用Token,建議檢查業務邏輯是否重復使用或者Token過期后使用的情況,Token過期時間為10分鐘。
iOS客戶端請求號碼認證服務,報錯返回 600017?
600017一般是包名/簽名或密鑰設置錯誤導致,號碼認證控制臺方案管理頁面的密鑰需要同步到代碼
一鍵登錄取號接口提示code:isv.ACCESS_CODE_ILLEGAL?
Token解析失敗,建議將前端獲取的Token,完整的返給后端校驗。
登錄密鑰失敗,怎么辦?
建議檢查BundleId和密鑰是否對應正確。
號碼認證iOS客戶端SDK升級最新版本后,部分接口依舊報錯 600004?
問題原因:從iOS16.4開始,iOS系統開始廢棄CTCarrier功能,無法直接獲取當前SIM卡的運營商信息,并不再提供替代方案。號碼認證最新版本SDK通過IPv6來確定當前運營商信息, IPv4時則無法判斷。由于存在網關隨機分配IP地址、IPv6向IPv4轉換等兼容性場景的可能性, 所以如果網關剛好分配了IPv4地址,部分接口就會調用失敗返回錯誤碼600004。
根據運營商目前線上數據來看,IPv6地址占比在80%左右,上述問題在將SDK升級至最新版本后仍會低概率偶現。
解決辦法:600004問題已在號碼認證SDK版本2.12.15開始優化解決,請先確保您當前SDK版本已升級,如更新之后還存在偶發性報錯600004,請根據場景選擇推薦的辦法:
接口調試測試等場景:您可以切換飛行模式或重啟手機重置網絡后再進行調試。
用戶場景、業務場景:為了提升用戶體驗,建議在報錯后切換至其他驗證方式。