Android SDK 文档 Android SDK 文档前期准备导入 SDK 配置 android manifest.xml API 详细说明概念解释初始化人脸检测与分析人脸对比人脸验证人脸识别个体 (Person) 管理个体 Person 创建个体 Person 删除增加人脸人脸删除设置个体 (

Size: px

Start display at page:

Download "Android SDK 文档 Android SDK 文档前期准备导入 SDK 配置 android manifest.xml API 详细说明概念解释初始化人脸检测与分析人脸对比人脸验证人脸识别个体 (Person) 管理个体 Person 创建个体 Person 删除增加人脸人脸删除设置个体 ("

固赖越
5 years ago
Views:

1 Android SDK 文档 Android SDK 文档前期准备导入 SDK 配置 android manifest.xml API 详细说明概念解释初始化人脸检测与分析人脸对比人脸验证人脸识别个体 (Person) 管理个体 Person 创建个体 Person 删除增加人脸人脸删除设置个体 (Person) 信息获取个体 (Person) 信息信息查询获取组列表获取个体 (Person) 列表获取人脸列表获取人脸信息前期准备下载腾讯云优图人脸识别 Android SDK SDK 支持 Android 2.2 及以上版本的手机系统 ; 手机必须要有网络 (GPRS 3G 或 Wifi 网络等 ); 在腾讯云密钥管理页面, 为你的项目申请安全密钥导入 SDK

2 将下载的 SDK libs 下的 youtu_sdk_android.jar 拷贝到项目的 libs 下, 并导入该包到项目中 : 配置 android manifest.xml SDK 需要网络访问和读取 SD 卡存储空间的权限, 配置如下 : <uses-permission android:name="android.permission.internet"/> <uses-permission android:name="android.permission.read_external_storage"/> API 详细说明概念解释 id user_id secret_id secret_key group_id person_id face_id 接入人脸识别服务时, 生成的唯一 id, 用于唯一标识接入业务接入业务自行定义的用户 id, 用于唯一标识一个用户标识 api 鉴权调用者的密钥身份用于加密签名字符串和服务器端验证签名字符串的密钥,secret_key 必须严格保管避免泄露个体 (person) 以组 (group) 的形式存储, 一个组可以包含多个个体, 一个个体也可以存在于多个组 group_id 即用来标识 group 人脸以个体 (person) 的形式存储, 一个个体下可以存储多张人脸 person_id 即用来标识 person 标识每张人脸的 id 注意 : (1) 一个 app_id 下建立的 group_id 数量限制为 5000 个 (2) 一个 group_id 下建立的 person_id 数量限制为 1000 个 (3) 一个 person_id 下建立的人脸数量限制为 20 个 (4) 每个请求的包体大小限制为 2MB (5)SDK 的发起请求方式为 post

3 初始化申请安全密钥, 并请求你的业务服务器生成签名, 详见鉴权签名文档导入优图人脸识别的 SDK 相关 jar 包后, 通过以下方法对优图 sdk 进行初始化 : QcloudFrSDK sdk = new QcloudFrSDK (APP_ID, AUTHORIZATION); 人脸检测与分析检测给定图片中的所有人脸 (Face) 的位置和相应的面部属性位置包括人脸在图片的坐标宽高信息 (x, y, w, h), 面部属性包括性别 (gender), 年龄 (age), 表情 (expression), 眼镜 (glass) 和姿态 (pitch,roll,yaw). 单次请求的图片大小限制在 2M 以下 * image_path 人脸图片的路径 ( 图片大小限制为 2M 以下 ) public JSONObject DetectFace(String image_path) throws IOException, JSONException;

4 "session_id":"xxxx", "image_id":"xxxx", "image_height":584, "image_width":527, "face":[ "face_id":" ", "x":145, "y":147, "height":305.0, "width":305.0, "pitch":3, "roll":0, "yaw":0, "age":34, "gender":99, "glass":true, "expression":27 ], "errormsg":"ok" 人脸对比给定两张人脸照片, 计算两个人脸 Face 的相似性以及五官相似度 image_path_a 第一张人脸图片路径 image_path_b 第二张人脸图片路径 ( 两张图片加起来总大小限制在 2M 以下 ) public JSONObject FaceCompare(String image_path_a, String image_path_b) throws IOException, JSONException;

5 "session_id":"sessionid", "eye_sim": , "mouth_sim": , "nose_sim": , "eyebrow_sim": , "similarity": , "errormsg":"ok" 人脸验证给定一张人脸照片和一个已有的 Person 个体 ID, 判断照片是否和给定的 Person 相同并给出该次判断的可置信度 image_path 需要验证的人脸图片路径 person_id 验证的目标 person public JSONObject FaceVerify(String image_path, String person_id) throws IOException, JSONException; "confidence": , "ismatch":false, "session_id":"xxxx", "errormsg":"ok" 人脸识别给定一张待识别的人脸图片和一个已有的 Group, 在该 Group 中的所有 Person 个体中, 识别出最相似的 Top5 Person 作为其身份返回, 返回的 Top5 中按照相似度从大到小排列

6 image_path 需要识别的人脸图片路径 group_id 人脸 face 组 public JSONObject FaceIdentify(String image_path, String group_id) throws IOException, JSONException; "session_id":"xxx", "candidates":[ "person_id":"person id", "face_id":" ", "confidence": , "tag":"xxx",...], 个体 (Person) 管理个体 Person 创建用给定的人脸照片和 person id 来创建一个 Person, 并将该 Person 加入到 group_ids 指定的组当中, 一个 person 可以被加到多个 Group 组中

7 image_path 需要新建的人脸图片路径 person_id 指定创建的人脸 group_ids 加入的 group 列表 personname 名字 ( 可选, 如果名字为中文要求编码为 UTF-8) persontag 备注 ( 可选 ) public JSONObject NewPerson(String image_path, String person_id, List<String> group_ids, String personname, String persontag) throws IOException, JSONException; "person_id":"hello", "suc_group":2, "suc_face":1, "session_id":"", "face_id":" ", "group_ids":["group1","group2"], 个体 Person 删除根据指定的 person id 删除已有的 Person person_id 要删除的 person ID public JSONObject DelPerson(String person_id) throws IOException, JSONException;

8 "deleted":1, "session_id":"", "person_id":"hello", 增加人脸给指定 Person 中增加人脸图片 Face 注意, 一个人脸 Face 只能被加入到一个 Person 中, 一个 Person 最多允许包含 100 个人脸 Face person_id 待增加人脸 Face 的 person id image_path_arr 人脸图片路径列表 ( 图片总大小限制在 2M 以下 ) public JSONObject AddFace(String person_id, List<String> image_path_arr)throws IOException, JSONException; "added":1, "face_ids":[" "], "session_id":"", 人脸删除删除给定 person id 下的 face 列表, 包括删除其特征属性和 face_id 信息

9 person_id 待删除人脸的 person ID face_id_arr 删除人脸 id 的列表 public JSONObject DelFace(String person_id, List<String> face_id_arr)throws IOException, JSONException; "deleted":1, "session_id":"", "face_ids":[" "], 设置个体 (Person) 信息设置 Person 的 name person_name 新的 name person_id 要设置的 person id public JSONObject SetInfo(String person_name, String person_id) throws IOException, JSONException;

10 "person_id":"person1", "session_id":"", 获取个体 (Person) 信息获取一个 Person 的信息, 包括其 name, id, tag, 相关的 face, 以及 groups 等信息 person_id 待查询个体的 ID public JSONObject GetInfo(String person_id) throws IOException, JSONException "person_id":"person1", "person_name":"newname", "tag":"", "face_ids":[" "], "group_ids":["group3"], "session_id":"", 信息查询获取组列表获取已有的全部 group 列表信息

11 public JSONObject GetGroupIds() throws IOException, JSONException; "group_ids":["group1","group2"], 获取个体 (Person) 列表获取指定的 Group 中所有 person 信息列表 group_id 待查询的组 id public JSONObject GetPersonIds(String group_id) throws IOException, JSONException; "person_ids":[], 获取人脸列表

12 获取给定的 person id 中所有 face id 列表信息 person_id 待查询的个体 id public JSONObject GetFaceIds(String person_id) throws IOException, JSONException "face_ids":[" "," "], 获取人脸信息获取给定的 face id 的相关特征信息 face_id 带查询的人脸 ID public JSONObject GetFaceInfo(String face_id) throws IOException, JSONException;

13 "face_info": "face_id":" ", "x":106, "y":83, "height":79, "width":79, "pitch":7, "roll":13, "yaw":-9, "age":27, "gender":99, "glass":true, "expression":0,

TencentYoutuyun-person-face-service php sdk for 腾讯云智能优图服务 & 腾讯优图开放平台安装 ( 直接下载源码集成 ) 从 github 下载源码装入到您的程序中, 并加载 include.php 名词 AppId 平台添加应用后分配的 AppId

TencentYoutuyun-person-face-service php sdk for 腾讯云智能优图服务 & 腾讯优图开放平台安装 ( 直接下载源码集成 ) 从 github 下载源码装入到您的程序中, 并加载 include.php 名词 AppId 平台添加应用后分配的 AppId SecretId 平台添加应用后分配的 SecretId SecretKey 平台添加应用后分配的 SecretKey