您的位置首页生活百科

CIA身份验证SDK如何使用(Android版)

CIA身份验证SDK如何使用(Android版)

的有关信息介绍如下:

CIA身份验证SDK如何使用(Android版)

下面介绍一下CIA易验证(CIA身份验证)SDK集成方法

SDK功能说明,架构设计

主要功能

本SDK主要提供以下功能接口

1、 初始化服务:初始化SDK,以便后续的验证操作。

2、 请求验证:发起一个验证手机号的请求。这里会有两种情况:

i) 本机手机号:用户输入的手机号码是本机号码,这种情况无需用户操作,SDK会自动完成验证;

ii) 非本机手机号:用户输入的手机号码不是本机号码,这时候会进入“输入验证码模式”,该手机号码所在的手机收到一个呼入电话,需要用户输入该呼入电话的后4位号码作为验证码。

3、 获取验证码:针对“请求验证”中的第2种情况——即需要手动输入验证码的情况。为了更好的提示用户,可以调用SDK的获取验证码(呼入的电话号码)来提示用户哪个号码将会呼入。

4、 校验验证码:校验用户输入的验证码是否正确。

步骤一:运行环境

CIA易验证SDK可运行在Android2.1(API Level 7)及以上版本。

步骤二:账户申请及权限开通

1、获取方式

打开CIA易验证官网注册账户,并登录到开发者后台。

2、获取 appId 和 authKey

进入开发者后台。

步骤三:使用SDK开发应用

添加SDK到APP工程

1、 创建一个Android Project

2、 在该工程下创建一个libs文件夹

3、 将cia-sdk-VERSION.jar拷贝到刚刚创建的libs文件夹中。

4、 将上述jar包添加到工程的Java Build Path。

5、 将so目录下的相关so文件添加到工程中。

a) 提示:so提供了armeabi、armeabi-v7a、mips、x86版本,请根据需要添加,如果使用了其他so库,请保证所有文件夹下都有相同的so文件。

在自定义Application中进行初始化调用。

6、在自定义Application中进行初始化调用。

7、AndroidManifest.xml中声明必须的权限,复制如下代码

8、 AndroidManifest.xml中注册必须的Service

9、混淆配置需要添加(没有使用混淆忽略此步)

步骤四:调用API

1、开始请求验证

a) CIAService. startVerification(String phoneNumber, VerificationListener listener);

2、等待Listener回调,参考监听器。

3、如果进入验证码模式,需要校验用户输入的验证码。

a) CIAService. verifySecurityCode(String code, VerificationListener listener);

4、如果用户中途关闭了页面,需要取消当前验证

a) CIAService.cancelVerification();

1、初始化SDK

a) init(Context context, String appId, String authKey);

i. context:上下文环境

ii. appId:开发者后台注册的appId

iii. authKey:开发者后台生成的authKey

2、开始验证

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();

用户中途关闭了页面,需要取消当前的验证请求,调用该方法的时候不需要判断是否有请求存在,该方法内部只在有验证请求的情况下取消验证。

监听器

VerificationListener接口提供了以下回调方法

功能

API函数原型

验证状态返回

afterVerification ();

1、afterVerification(String phoneNumber, int status, String msg);

a) phoneNumber:验证的手机号码

b) status:状态码(参考验证状态码)

c) msg:文字描述

验证状态码

CIAService类中定义了一些静态常量表示验证状态码

功能

数值

常量

验证成功

100

VERIFICATION_SUCCESS

验证码模式(需要用户输入验证码)

101

SECURITY_CODE_MODE

验证码错误

102

SECURITY_CODE_WRONG

验证码过期

103

SECURITY_CODE_EXPIRED

验证码错误次数超限

104

SECURITY_CODE_EXPIRED_INPUT_OVERRUN

请求失败

110

REQUEST_FAIL

其他异常情况

111

REQUEST_EXCEPTION

服务器返回的错误

<100