Android客户端FAQ

在哪可以直接下载一键登录的SDK和Demo？

登录号码认证控制台，在概览页面右侧API&SDK区域，单击立即下载，进入API&SDK页面，根据页面提示下载并解压SDK，解压后直接运行即可。

SDK存在收集（读取设备IP）的行为吗？

号码认证SDK会采集用户客户端的IP信息，采集信息的说明，请参见号码认证服务隐私权政策。

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加固报错，怎么办？

采用白名单策略，用户对密钥进行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分钟。

授权页能否自定义UI？

可以添加自定义控件，目前授权页除“一键登录区域、协议区域、掩码区域”之外，其他地方均可添加自定义控件。

登录的按钮背景色怎么配置？

授权页登录按钮不支持修改背景色，只支持背景图片，可自定义xml文件配置背景效果。

可以通过自定义授权按钮获取Token吗？

授权页上的预取掩码、登录按钮和运营商协议，不支持自定义控件。其他区域支持自定义控件。

如何隐藏返回按钮？

setNavReturnHidden(true)隐藏返回按钮。

号码认证服务二次授权弹窗能自定义布局吗？

二次授权弹框仅支持授权页全屏模式。

若SDK提供了对应UI修改接口，则表示相应UI支持修改。若未提供接口，即表示UI不支持修改。

深色模式下，登录页面显示异常，怎么办？

号码认证版本升到2.12.10版本。授权页是否跟随系统深色模式，true（默认值）表示跟随，false表示不跟随，mPhoneNumberAuthHelper.setAuthPageUseDayLight(true);。

授权页弹窗是悬浮附着在我们的activity之上吗？

不是，授权页弹窗模式是拉起一个新的Activity。

"切换到其他方式"组件如何隐藏？

setSwitchAccHidden(true)隐藏授权页自带的切换其他登录方式。

授权页隐私复选框的位置怎么调整？ 复选框设置宽高厚和隐私纵向不居中？

协议仅支持横向居中，不支持纵向居中。文案是顶部对齐，设置checkbox把圆圈切到顶部。