教你如何快速集成CIA易验证SDK（Android版）

1、SDK功能说明1）架构设计

3、开发前准备1）运行环境可运行于Android 2.1（API Level 7）及以上版本。2）账户申请及权限开通1、获取方式开打CIA易验证官网注册账户，并登录到开发者后台。

6、 AndroidManifest.xml中声明必须的权限，复制如下代码（图一）8、 AndroidManifest.xml中可选的权限，SDK会自动挂断来电，用户无感知。（图二）9、 AndroidManifest.xml中注册必须的Service（图三）10、 混淆配置需要添加（没有使用混淆忽略此步）（图四）

7、调用API1、开始请求验证a) CIAService. startVer坡纠课柩ification(String phone绿覆冗猩Number, VerificationListener listener);2、等待Listener回调，参考监听器。3、如果进入验证码模式，需要校验用户输入的验证码。a) CIAService. verifySecurityCode(String code, VerificationListener listener);4、如果用户中途关闭了页面，需要取消当前验证a) CIAService.cancelVerification();API说明类

9、套趱咝鲞初始化SDKa) init(Context context, String appId, String authKey);i. context：上下文环境ii. appId：开发者后台注册的appIdiii. authKey：开发者后台生成的authKey2、开始验证a)startVerification(String phoneNumber, VerificationListener listener)i. phoneNumber：需要验证的手机号码ii. listener：验证状态监听器，查看状态码3、获取验证码a) getSecurityCode ();i. 返回值为呼入的电话号码（其中后四位为****形式），返回值的一个可能示例为：05311122****，该返回值用于向用户显示“提示语”。该方法在验证码模式下调用。显示给用户的提示语，需要开发者自行编写，可参见下图中的一个实例描述：（图一）4、校验验证码a) verifySecurityCode (String code, VerificationListener listener);i. code：用户输入的验证码ii. listener：验证码校验结果监听器，查看状态码5、取消验证a) cancelVerification();i. 用户中途关闭了页面，需要取消当前的验证请求，调用该方法的时候不需要判断是否有请求存在，该方法内部只在有验证请求的情况下取消验证。6、验证成功后，获取真实的四位验证码a) getRealSecurityCode ();i. 返回真实的四位验证码。注：该方法只在验证成功之后有返回值。

11、验证状态码（图一）CIAService类中定义了一些静态常量表示验证状态码startVerification开始验证方法回调（图二）注：验证失败（101）：比如手机号码格式错误，手机信号不好等。 请求错误（131）：比如没有网络连接等，一般需要开发者提前判断。verifySecurityCode校验验证码方法回调注： 请求异常（111）：比如没有网络连接等，一般需要开发者提前判断。

12、后台查询接口（图一）返回结果（图二）{"transId":"业务流水号","status":"验证状态"}