Android集成文档

1、SDK下载

请联系技术支持：文档中心右侧“技术咨询”

2、获取并配置个推应用参数

2.1、获取应用参数

说明：进入个推开发者中心（dev.getui.com），在应用管理中添加”实人认证“服务，获取对应的APPID。

2.2、配置应用参数

在app/build.gradle文件中的android.defaultConfig下添加manifestPlaceholders配置个推相关的应用参数，如下图所示：

manifestPlaceholders = [
    GETUI_APPID : "你的应用GETUI_APPID"
]

在工程的根目录下的build.gradle文件中的 allprojects{} 的 repositories{} 中，添加如下代码:

maven {
    url "http://mvn.gt.getui.com/nexus/content/repositories/releases/"
}

在app所在module的build.gradle文件中的 dependencies { } 中，添加如下代码:

dependencies {
    ...
    implementation 'com.getui:ctid:1.1.0.0'    
    ...
}

3、接口列表

API类名：com.getui.ctid.CTIDManager

3.1、初始化SDK

通过调用 init 接口进行SDK初始化。

接口说明

CTIDManager.getInstance().init(Context context, CTIDCallBack callback);

参数

代码示例

CTIDManager.getInstance().init(context, new CTIDCallBack() {
    @Override
    public void onSuccess(String gtcid) {
        Log.d(TAG, "gtcid:"+gtcid );
    }

    @Override
    public void onFailure(String error) {
        //返回失败的原因
        Log.d(TAG, "init onFailure:"+error );
    }
});

sdk初始化后回调onSuccess即代表 SDK 初始化成功，否则会在onFailure中回调失败的原因。

3.2、验证接口

通过调用 auth 接口唤起身份信息验证页面，进行验证的流程。

接口说明

CTIDManager.getInstance().auth(String name, String idNum, Context context, AuthCallBack callback);

参数

代码示例

CTIDManager.getInstance().auth(name, idNum, imageStr, context, new AuthCallBack() {
        @Override
    public void onSuccess(JSONObject jsonObject) {
        // 成功或失败，均会返回一个 JSONObejct
        Log.e("auth success", jsonObject.toString());
    }

    @Override
    public void onFailure(JSONObject jsonObject) {
        // 成功或失败，均会返回一个 JSONObejct
        Log.e("auth failure", jsonObject.toString());
    }
});

返回示例

说明：pid为互联网身份标识

{
"code":200,
"errorCode":"0XXX",
"msg":"身份信息正确",
"pid":"CfKc1kaX5QZ6oY8qiBuM91POQIUtH2zLNhUXHJPtzuJNMjAyMDA0MjYxNTM3MDEwRAIgTMGGk7pSZ7jSpRwcdGUwJyJQsCcWAiNOmI9U+qloBCQCIFviGPujRdqroIf8zdzrsZRN+uaY05XX4dcH9Dh0GtM2AAA="
}

调用身份验证接口，用户输入身份证上的姓名、身份证号码、照片对应的字符串(可选)，在完成身份验证流程后，无论成功或失败，开发者均可在onSuccess和onFailure 回调方法中获取一个 JSONObejct 实例，其格式如下所示：

错误码errorCode的具体含义：

详细说明：若errorCode不为1开头，则为中盾业务标识，一般为4位数字，例如51XX，第一位字符为5，代表身份信息无效，第二位字符为1，代表非同一人。具体规则如下：

第四字符:保留字段

3.3、获取SDK版本号

通过调用 getVersion 接口获取当前 SDK 的版本号。

接口说明

CTIDManager.getInstance().getVersion();