概述与资源

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

环境需求

条目 资源
开发目标 4.0以上
开发环境 Android Studio 2.1.3
系统依赖 v7包
sdk三方依赖

相关开发资料

条目 资源
产品结构流程 交互流程, 通讯流程
SDK 下载 opv2-android-sdk
接口文档 opv2-android-api-docs
错误码 Error Code 列表

安装

获取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();
}