文档首页/ 人脸识别服务 FRS/ 快速入门/ 调用SDK实现人脸检测
更新时间:2024-09-30 GMT+08:00

调用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
       }
     }
   ] 
}