sts_flutter 0.0.17

AHCA STS Flutter plugin. 基于AHCA手机盾原生SDK封装的Flutter插件.

sts_flutter

AHCA STS Flutter plugin. AHCA Flutter平台手机盾SDK插件

说明

此插件是在手机盾原生SDK上封装的Flutter平台插件，其功能和接口与原生SDK一致。 目前只支持Android平台的原生功能，iOS部分的待定。

初始化

初始化手机盾配置，建议在自定义Application类的onCreate生命方法内操作：

StsFlutter.init("服务地址", "AppKey", "SecretKey");
StsFlutter.initFace("活体检测授权码", "活体检测授权文件名");

注意，同时需要在确定用户信息和唯一标识后调用以下接口：

StsFlutter.initUseId("用户唯一标识");

可选的流程

请根据实际需求进行配置，例如项目无需使用手机盾活体检测功能，则无需配置initFace。 在使用证书前（例如签名、签章等），需要先判断证书是否已申请，如果证书不存在，需要调用申请证书接口，申请成功后方可使用。建议在调用证书签名/证书签章/证书登录等接口之前，先调用申请证书接口，当该接口返回码为1或10503时，再调用需要操作的证书功能的接口。 同时手机盾还提供了判断本地证书数据是否存在的接口，即isLocalCertExist接口，这是为了方便对流程响应速度有需求的业务场景，例如，APP证书登录场景，由于checkCert、certLogin或其他接口需要联网，存在一定的耗时，可仅使用isLocalCertExist接口仅判断本地证书是否存在，证书存在则调用证书登录接口，证书不存在则显示密码输入框或验证码相关控件，进行后续申请证书的操作。

StsCodeTable

StsCodeTable类包含了SDK接口返回的部分错误码和对应解释，例如常用的 1(成功) 10502(参数不全或为空) 10502(证书不存在或已损坏) 10503(证书已存在)等

StsFlutter

StsFlutter类包含接口外，还包括部分接口使用的固定标识 如申请个人证书接口的StsUserInfo实体类的证件类型属性(cardType)即可使用以下标识

  static const String CARD_TYPE_ID_CARD = "00"; // 身份证
  static const String CARD_TYPE_TEMPORARY_ID_CARD = "01"; // 临时身份证
  static const String CARD_TYPE_HOUSEHOLD_REGISTER = "02"; // 户口本
  static const String CARD_TYPE_PASSPORT = "03"; // 护照
  static const String CARD_TYPE_MILITARY_ID_CARD = "04"; // 军人身份证
  static const String CARD_TYPE_ARMED_POLICE_ID_CARD = "05"; // 武警身份证

如certSign、certLogin等接口的dataType、dataFormat参数可使用如下标识

  static const String DATA_TYPE_ORIGINAL_TO_HEXADECIMAL = "0"; // 原文数据转成16进制
  static const String DATA_TYPE_BYTE_BY_HEXADECIMAL = "1"; // byte类型数据（16进制编码）
  static const String DATA_TYPE_CHINESE_TO_HEXADECIMAL = "2"; // 中文转成16进制
  static const String DATA_TYPE_ORIGINAL = "3"; // 原文数据
  static const String DATA_TYPE_BYTE_BY_BASE64 = "4"; // byte类型数据（Base64编码加密后的值）

  static const String DATA_FORMAT_P1 = "p1"; // P1
  static const String DATA_FORMAT_P7 = "p7"; // P7
  static const String DATA_FORMAT_P7_ENVELOPE = "p7envelope"; // P7数字信封
  static const String DATA_FORMAT_DEFAULT = "default"; // 裸签名