服务端接入

• 配合SDK调用发起认证请求（InitFaceVerify）和查询认证结果（DescribeFaceVerify）接口。
• 无需与SDK配合，通过纯服务端调用人脸静默活体检测（LivenessFaceVerify）接口。
  说明 如果您的业务场景无法通过SDK方式集成活体检测，推荐您选择人脸静默活体检测。人脸静默活体检测指对用户自拍图片或线下设备采集的用户人脸图片进行活体检测，适用于SDK无法覆盖的场景。

• 通过Maven引入服务依赖。代码如下：

  <dependency>
      <groupId>com.aliyun</groupId>
      <artifactId>aliyun-java-sdk-core</artifactId>
      <version>4.4.3</version>
  </dependency>
  <dependency>
      <groupId>com.aliyun</groupId>
      <artifactId>aliyun-java-sdk-cloudauth</artifactId>
      <version>2.0.20</version>
  </dependency>

• 使用示例：

  DefaultProfile profile = DefaultProfile.getProfile(
              "cn-hangzhou",    // 固定为cn-hangzhou。
              "AccessKeyID",      // 您的AccessKey ID。
              "AccessKeySecret");  // 您的AccessKey Secret。
  IAcsClient client = new DefaultAcsClient(profile);
  
  InitFaceVerifyRequest request = new InitFaceVerifyRequest();
  request.setMetaInfo("MetaInfo环境参数");
  request.setCertName("姓名张三");
  request.setCertNo("18位身份证号");
  // 固定值。
  request.setCertType("IDENTITY_CARD");
  request.setSceneId(10xxxxxxL);
  request.setOuterOrderNo("商户请求的唯一标识");
  // 固定值。
  request.setProductCode("LR_FR");
  request.setModel("LIVENESS");
  
  InitFaceVerifyResponse response = client.getAcsResponse(request);
  System.out.println(response.getCode());
  System.out.println(response.getMessage());
  System.out.println(response.getRequestId());
  System.out.println(response.getResultObject().getCertifyId());

{
     // 是否为攻击：攻击为T，非攻击为F。
    "faceAttack": "F",    
     // 是否有脸部遮挡：有脸部遮挡为T，否则为F。
    "faceOcclusion": "F",
    // 认证的照片信息。
    "facialPictureFront": {
         // 人脸攻击分。
        "faceAttackScore": 0.00008597839769208804，
        // 活体人脸质量分数。
        "qualityScore": 88.3615493774414,
        // 照片https地址，有效期15分钟，从查询时开始计时。
        "pictureUrl": "https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg",
        // 照片存放客户上海区域的OSS里，此为照片的bucket名。
        "ossBucketName": "cn-shanghai-aliyun-cloudauth-1260051251634779",
        // 照片存放客户上海区域的OSS里，此为照片的文件名。
        "ossObjectName": "verify/1260051251634779/6ba7bcfccf33f56cdb44ed086f36ce3e0.jpeg"   
   }
}

• 通过Maven引入服务依赖。代码如下：

  <dependency>
      <groupId>com.aliyun</groupId>
      <artifactId>aliyun-java-sdk-core</artifactId>
      <version>4.4.3</version>
  </dependency>
  <dependency>
      <groupId>com.aliyun</groupId>
      <artifactId>aliyun-java-sdk-cloudauth</artifactId>
      <version>2.0.20</version>
  </dependency>

• 使用示例：

  DefaultProfile profile = DefaultProfile.getProfile(
              "cn-hangzhou",    // 固定为cn-hangzhou。
              "AccessKeyID",      // 您的AccessKey ID。
              "AccessKeySecret");  // 您的AccessKey Secret。
  IAcsClient client = new DefaultAcsClient(profile);
  DescribeFaceVerifyRequest request = new DescribeFaceVerifyRequest();
  request.setCertifyId("服务端初始化返回的CertifyId");
  request.setSceneId(100000xxxxL);
  
  DescribeFaceVerifyResponse response = client.getAcsResponse(request);
  System.out.println(response.getCode());
  System.out.println(response.getMessage());
  System.out.println(response.getRequestId());
  System.out.println(response.getResultObject().getPassed());
  System.out.println(response.getResultObject().getSubCode());
  System.out.println(response.getResultObject().getMaterialInfo());
  System.out.println(response.getResultObject().getIdentityInfo());
  System.out.println(response.getResultObject().getDeviceToken());

{
    // 是否为攻击。T表示是，F表示否。
    "faceAttack": "F",
    // 是否有脸部遮挡。T表示是，F表示否。
    "faceOcclusion": "F",
    "facialPictureFront": {
         // 人脸攻击分。
         "faceAttackScore": 0.00008597839769208804，
         // 活体人脸质量分数。
        "qualityScore": 88.3615493774414
    }
}

• 通过Maven进入服务依赖。代码如下：

  <dependency>
      <groupId>com.aliyun</groupId>
      <artifactId>aliyun-java-sdk-core</artifactId>
      <version>4.4.3</version>
  </dependency>
  <dependency>
      <groupId>com.aliyun</groupId>
      <artifactId>aliyun-java-sdk-cloudauth</artifactId>
      <version>2.0.20</version>
  </dependency>

• 使用示例：

  DefaultProfile profile = DefaultProfile.getProfile(
      "cn-hangzhou",    // 固定为cn-hangzhou。
      "AccessKeyID",      // 您的AccessKey ID。
      "AccessKeySecret");  // 您的AccessKey Secret。
  IAcsClient client = new DefaultAcsClient(profile);
  LivenessFaceVerifyRequest request = new LivenessFaceVerifyRequest();
  // 固定值。
  request.setProductCode("LR_FR_MIN");
  // 固定值。
  request.setModel("FRONT_CAMERA_LIVENESS");
  
  request.setOuterOrderNo("商户请求的唯一标识");
  request.setSceneId(10xxxxxxL);
  
  // 请在以下方式中选择一种，传入人脸图片。
  // 方式一：人脸图片Base64。
  request.setFaceContrastPicture("人脸图片Base64编码");
  // 方式二：人脸图片OSS bucket名和文件名。
  //request.setOssBucketName("cn-shanghai-aliyun-cloudauth-xxxxx");
  //request.setOssObjectName("verify/xxxxx/xxxxxx.jpeg");
  // 方式三：人脸图片的OSS URL地址。该地址必须公网可访问。
  //request.setFaceContrastPictureUrl("https://cn-shanghai-aliyun-cloudauth-xxxxxx.oss-cn-shanghai.aliyuncs.com/verify/xxxxx/xxxxx.jpeg")
  
  LivenessFaceVerifyResponse response = client.getAcsResponse(request);
  System.out.println(response.getCode());
  System.out.println(response.getMessage());
  System.out.println(response.getRequestId());
  System.out.println(response.getResultObject().getPassed());
  System.out.println(response.getResultObject().getSubCode());
  System.out.println(response.getResultObject().getMaterialInfo());