文档

人脸属性检测

更新时间:

本文介绍了如何使用Java SDK人脸属性检测接口,对指定的人脸图片进行属性检测。人脸属性检测仅支持以图片作为检测媒介。

功能描述

人脸属性检测能够识别图片中的人脸属性信息,包括人脸模糊度、人脸角度、人脸位置、微笑程度、是否戴眼镜、是否戴口罩、是否戴帽子、是否有胡子、是否有刘海、头发类型等。关于参数的详细说明,请参见人脸属性检测API文档

您需要使用内容安全的API接入地址,调用本SDK接口。关于API接入地址的信息,请参见接入地址(Endpoint)

前提条件

  • 安装Java依赖。关于安装Java依赖的具体操作,请参见安装Java依赖

    说明

    请一定按照安装Java依赖页面中的版本安装,否则会导致调用失败。

  • 如果使用本地文件或者二进制文件检测,请下载并在项目工程中引入Extension.Uploader工具类

传入URL示例代码

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.green.model.v20180509.DetectFaceRequest;
import com.aliyuncs.http.FormatType;
import com.aliyuncs.http.HttpResponse;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.http.ProtocolType;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;

/**
 * 人脸属性检测代码示例。
 */
public class DetectFaceSample {

    public static void main(String[] args) throws Exception {
        /**
         * 阿里云账号AccessKey拥有所有API的访问权限,建议您使用RAM用户进行API访问或日常运维。 
         * 常见获取环境变量方式:
         * 方式一:
         *     获取RAM用户AccessKey ID:System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
         *     获取RAM用户AccessKey Secret:System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
         * 方式二:
         *     获取RAM用户AccessKey ID:System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
         *     获取RAM用户AccessKey Secret:System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
         */
        DefaultProfile profile = DefaultProfile.getProfile(
                "cn-shanghai",
                "建议从环境变量中获取RAM用户AccessKey ID",
                "建议从环境变量中获取RAM用户AccessKey Secret");
        DefaultProfile.addEndpoint("cn-shanghai", "Green", "green.cn-shanghai.aliyuncs.com");
        // 注意:此处实例化的client尽可能重复使用,提升检测性能。避免重复建立连接。
        IAcsClient client = new DefaultAcsClient(profile);

        DetectFaceRequest detectFaceRequest = new DetectFaceRequest();
        detectFaceRequest.setAcceptFormat(FormatType.JSON); // 指定API返回格式。
        detectFaceRequest.setMethod(MethodType.POST); // 指定请求方法。
        detectFaceRequest.setEncoding("utf-8");
        detectFaceRequest.setHttpContentType(FormatType.JSON);

        JSONObject data = new JSONObject();
        // 设置待检测的人脸图片。
        data.put("url", "http://www.aliyundoc.com/xx");
        detectFaceRequest.setHttpContent(data.toJSONString().getBytes("UTF-8"), "UTF-8", FormatType.JSON);

        /**
         * 请设置超时时间, 服务端全链路处理超时时间为10秒,请做相应设置。
         * 如果您设置的ReadTimeout小于服务端处理的时间,程序中会获得一个ReadTimeout异常。
         */
        detectFaceRequest.setConnectTimeout(3000);
        detectFaceRequest.setReadTimeout(10000);

        HttpResponse httpResponse;
        try {
            httpResponse = client.doAction(detectFaceRequest);
        } catch (Exception e) {
            e.printStackTrace();
            // 异常处理。
            return;
        }

        // 判断HTTP请求是否成功。
        if (httpResponse.isSuccess()) {
            JSONObject scrResponse = JSON.parseObject(new String(httpResponse.getHttpContent(), "UTF-8"));
            if (200 == scrResponse.getInteger("code")) {
                JSONObject result = scrResponse.getJSONObject("data");
                if (200 == result.getInteger("code")) {
                    /**
                     *   结果数据。
                     */
                    JSONArray faces = result.getJSONArray("faces");
                    // 检测到的人脸个数。
                    System.out.println("faceCount:" + faces.size());
                    // 每个人脸的结果详情。
                    for (int i = 0; i < faces.size(); i++) {
                        System.out.println("face" + i + ": " + faces.getJSONObject(i).toJSONString());
                    }
                } else {
                    System.out.println("result fail: " + result.toJSONString());
                }
            } else {
                /**
                 * 请求整体处理失败,原因视具体的情况详细分析。
                 */
                System.out.println("request fail:" + scrResponse.toJSONString());
            }
        } else {
            /**
             * HTTP请求失败,错误详情。
             */
            System.out.println("response fail!" +
                    "\ncode:" + httpResponse.getStatus() +
                    "\nmsg:" + new String(httpResponse.getHttpContent(), "UTF-8"));
        }

    }
}

传入本地文件示例代码

说明

如果您需要检测本地文件或者二进制文件,请下载并在项目工程中引入Extension.Uploader工具类

import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONArray;
import com.alibaba.fastjson.JSONObject;
import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.green.extension.uploader.ClientUploader;
import com.aliyuncs.green.model.v20180509.DetectFaceRequest;
import com.aliyuncs.http.FormatType;
import com.aliyuncs.http.HttpResponse;
import com.aliyuncs.http.MethodType;
import com.aliyuncs.profile.DefaultProfile;
import com.aliyuncs.profile.IClientProfile;

/**
 * 人脸属性检测:本地图片文件检测样例。
 */
public class DetectFaceFileSample {

    public static void main(String[] args) throws Exception {
        /**
         * 阿里云账号AccessKey拥有所有API的访问权限,建议您使用RAM用户进行API访问或日常运维。 
         * 常见获取环境变量方式:
         * 方式一:
         *     获取RAM用户AccessKey ID:System.getenv("ALIBABA_CLOUD_ACCESS_KEY_ID");
         *     获取RAM用户AccessKey Secret:System.getenv("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
         * 方式二:
         *     获取RAM用户AccessKey ID:System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_ID");
         *     获取RAM用户AccessKey Secret:System.getProperty("ALIBABA_CLOUD_ACCESS_KEY_SECRET");
         */
        DefaultProfile profile = DefaultProfile.getProfile(
                "cn-shanghai",
                "建议从环境变量中获取RAM用户AccessKey ID",
                "建议从环境变量中获取RAM用户AccessKey Secret");
        DefaultProfile.addEndpoint("cn-shanghai", "Green", "green.cn-shanghai.aliyuncs.com");
        // 注意:此处实例化的client尽可能重复使用,提升检测性能。避免重复建立连接。
        IAcsClient client = new DefaultAcsClient(profile);

        DetectFaceRequest detectFaceRequest = new DetectFaceRequest();
        detectFaceRequest.setAcceptFormat(FormatType.JSON); // 指定API返回格式。
        detectFaceRequest.setMethod(MethodType.POST); // 指定请求方法。
        detectFaceRequest.setEncoding("utf-8");
        detectFaceRequest.setHttpContentType(FormatType.JSON);

        ClientUploader clientUploader = ClientUploader.getImageClientUploader(profile, false);

        String url1 = null;
        try{
            //上传待检测人脸图片。
            url1 = clientUploader.uploadFile("d:/image1.jpg");
        }catch (Exception e){
            e.printStackTrace();
        }

        JSONObject data = new JSONObject();
        // 设置待检测的人脸图片。
        data.put("url", url1);
        detectFaceRequest.setHttpContent(data.toJSONString().getBytes("UTF-8"), "UTF-8", FormatType.JSON);

        /**
         * 请设置超时时间, 服务端全链路处理超时时间为10秒,请做相应设置。
         * 如果您设置的ReadTimeout小于服务端处理的时间,程序中会获得一个ReadTimeout异常。
         */
        detectFaceRequest.setConnectTimeout(3000);
        detectFaceRequest.setReadTimeout(10000);

        HttpResponse httpResponse;
        try {
            httpResponse = client.doAction(detectFaceRequest);
        } catch (Exception e) {
            e.printStackTrace();
            // 异常处理。
            return;
        }

        // 判断HTTP请求是否成功。
        if (httpResponse.isSuccess()) {
            JSONObject scrResponse = JSON.parseObject(new String(httpResponse.getHttpContent(), "UTF-8"));
            if (200 == scrResponse.getInteger("code")) {
                JSONObject result = scrResponse.getJSONObject("data");
                if (200 == result.getInteger("code")) {
                    /**
                     *   结果数据。
                     */
                    JSONArray faces = result.getJSONArray("faces");
                    // 检测到的人脸个数。
                    System.out.println("faceCount:" + faces.size());
                    // 每个人脸的结果详情。
                    for (int i = 0; i < faces.size(); i++) {
                        System.out.println("face" + i + ": " + faces.getJSONObject(i).toJSONString());
                    }
                } else {
                    System.out.println("result fail: " + result.toJSONString());
                }
            } else {
                /**
                 * 请求整体处理失败,原因视具体的情况详细分析。
                 */
                System.out.println("request fail:" + scrResponse.toJSONString());
            }
        } else {
            /**
             * HTTP 请求失败,错误详情。
             */
            System.out.println("response fail!" +
                    "\ncode:" + httpResponse.getStatus() +
                    "\nmsg:" + new String(httpResponse.getHttpContent(), "UTF-8"));
        }

    }
}