概述与资源

Android SDK提供给集成Android原生客户端开发的开发者使用。

环境需求

相关开发资料

安装

获取SDK

1. 在demo的libs包下，将获取的.aar文件拖拽到工程中的libs文件夹下。

2. 在拖入.aar到libs文件夹后, 还要检查.aar是否被添加到Library,要在项目的
   build.gradle下添加如下代码：

   repositories { flatDir { dirs 'libs' } }

   并且要手动将aar包添加依赖：

   compile(name: 'geetest_onepassv2_android_vx.y.z', ext: 'aar')

3. 添加权限

   <uses-permission android:name="android.permission.WRITE_SETTINGS" /> <uses-permission android:name="android.permission.READ_PHONE_STATE" /> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" /> <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /> <uses-permission android:name="android.permission.CHANGE_WIFI_STATE" /> <uses-permission android:name="android.permission.INTERNET" /> <uses-permission android:name="android.permission.CHANGE_NETWORK_STATE" />

配置接口

开发者集成客户端sdk前, 必须先在您的服务器上搭建相应的 服务端SDK ，配置 verifyUrl ，并配置从 极验后台 获取的customId。这里以服务端 verifyUrl 配置成功，客户端开发步骤为例，如下：

1. 配置初始化接口

   OnePassHelper.with().init(MainActivity.this);

2. 调用校验接口

   OnePassHelper.with().getToken(phone,custom, onePassListener); //第一个参数为输入的手机号码 //第二个参数为所需要配置的CUSTOM_ID //第三个参数为所需实现监听回调结果接口

集成代码参考下方的 代码示例

代码示例

初始化与校验

初始化

在项目的具体页面的onCreate方法里面进行初始化。

OnePassHelper.with().init(MainActivity.this);

调用校验

OnePassHelper.with().getToken(phone,custom, onePassListener);

接口实现

实现接口进行校验。

OnePassListener onePassListener =new OnePassListener() {
	@Override
	public void onTokenFail(JSONObject jsonObject) {
		//过程中出现的错误, 具体参考下方错误码
	}

	@Override
	public void onTokenSuccess(JSONObject jsonObject) {
		//sdk输出的参数,通过这些参数请求verifyUrl判断是否是本机号
	}

};

页面关闭

在页面关闭的时候执行此方法。

@Override
protected void onDestroy() {
 	super.onDestroy();
 	OnePassHelper.with().cancel();
}