文档首页> 人脸识别服务 FRS> 快速入门> 调用SDK实现人脸检测
更新时间：2024-04-19 GMT+08:00
查看PDF

调用SDK实现人脸检测

人脸识别服务软件开发工具包（FRS SDK）是对人脸识别服务提供的REST API进行的封装，以简化用户的开发工作。

本章节提供了通过Java SDK调用人脸检测API服务的样例，用户直接调用接口函数即可使用SDK功能。

使用FRS SDK的详细步骤如下所示：

步骤1：开通服务

步骤2：配置环境

步骤3：修改配置信息

步骤4：调用服务

准备工作

注册华为账号并开通华为云，账号不能处于欠费或冻结状态。

步骤1：开通服务

  1. 登录人脸识别服务控制台。
  2. 单击左侧“委托授权”，完成OBS授权。
  3. 选择需要使用的API，进行开通。

    本示例中需开通人脸检测API。

步骤2：配置环境

  1. 下载FRS Java SDK。

    选择huaweicloud-sdk-java-frs目录，单击“Code > Download ZIP”，下载frs-sdk-demo。

  2. 准备Java开发环境。
  3. 导入FRS Java SDK工程。
    1. 将下载的frs-sdk-demo文件复制到Eclipse工程文件夹中。
    2. 在Eclipse中打开工程，右键单击该项工程，选择“Properties”。
    3. 在弹出的对话框中，单击“Java Build Path”，然后在“Libraries”页签下单击“Add JARs”，添加下载的JAR文件。

步骤3：修改配置信息

Java SDK Demo中认证鉴权方式为AK/SK。

  1. 获取AK/SK。

    AK/SK即访问秘钥，请登录我的凭证界面，选择“访问密钥 > 新增访问密钥”获取。

  2. AK/SK认证鉴权。

    根据获取的AK/SK，修改Demo工程“frs-sdk-demo”文件中Main函数的“AK”和“SK”的值。

    图1 配置AK/SK
  3. 修改“frs-sdk-demo”配置文件。
    图2 frs-sdk-demo文件
    表1 Main函数中参数说明

    参数名称

    参数说明

    参数值

    ak

    访问密钥ID（Access Key ID）

    登录我的凭证界面，选择“访问密钥 > 新增访问密钥”获取。

    sk

    秘密访问密钥（Secret Access Key）

    登录我的凭证界面，选择“访问密钥 > 新增访问密钥”获取。

    endpoint

    终端节点

    终端节点请依据实际开通服务的区域进行选择。

    region

    服务所在区域

    服务所在区域请依据实际开通服务的区域进行选择。

    projectId

    项目ID

    项目ID，获取方法请参见获取项目ID。
    • 因为java sdk demo中包含了人脸识别所有接口样例，如果只验证人脸检测（face detect）接口，就需要将Main.java文件中其他接口进行注释或删除。
    • 将detectFaceByObsUrl中的图片路径修改为您账户下OBS桶中的图片即可。

步骤4：调用服务

执行Main.java文件，控制台输出状态码“200”即表示程序执行成功。

人脸检测结果为JSON格式，如下所示。

{
   "faces": [
     {
       "bounding_box": {
         "width": 174,
         "top_left_y": 37,
         "top_left_x": 22,
         "height": 174
       }
     }
   ] 
}