人脸检索

最近更新时间:2024-07-04 10:21:52

我的收藏

简介

本文档提供关于人脸检索的相关 API 概览以及 SDK 示例代码。
API
操作描述
从数据集中搜索与指定图片最相似的前N张图片并返回人脸坐标可对数据集内文件进行一个或多个人员的人脸识别。

SDK API 参考

SDK 所有接口的具体参数与方法说明,请参考 SDK API

人脸搜索

功能说明

从数据集中搜索与指定图片最相似的前N张图片并返回人脸坐标可对数据集内文件进行一个或多个人员的人脸识别。
注意:
COS Android SDK 版本需要大于等于 v5.9.30。

示例代码

// APPID
String appid = "1253000000";
DatasetFaceSearchRequest request = new DatasetFaceSearchRequest(appid);
DatasetFaceSearch datasetFaceSearch = new DatasetFaceSearch();// 人脸搜索请求体
request.setDatasetFaceSearch(datasetFaceSearch);// 设置请求
// 设置数据集名称,同一个账户下唯一。;是否必传:是
datasetFaceSearch.datasetName = "test";
// 设置资源标识字段,表示需要建立索引的文件地址。;是否必传:是
datasetFaceSearch.uRI = "cos://examplebucket-1250000000/test.jpg";
// 设置输入图片中检索的人脸数量,默认值为1(传0或不传采用默认值),最大值为10。;是否必传:否
datasetFaceSearch.maxFaceNum = 1;
// 设置检索的每张人脸返回相关人脸数量,默认值为10,最大值为100。;是否必传:否
datasetFaceSearch.limit = 10;
// 设置出参 Score 中,只有超过 MatchThreshold 值的结果才会返回。范围:1-100,默认值为0,推荐值为80。;是否必传:否
datasetFaceSearch.matchThreshold = 10;

ciService.datasetFaceSearchAsync(request, new CosXmlResultListener() {
@Override
public void onSuccess(CosXmlRequest request, CosXmlResult cosResult) {
// result 人脸搜索的结果
// 详细字段请查看api文档或者SDK源码
DatasetFaceSearchResult result = (DatasetFaceSearchResult) cosResult;

}
@Override
public void onFail(CosXmlRequest request, CosXmlClientException clientException, CosXmlServiceException serviceException) {
if (clientException != null) {
clientException.printStackTrace();
} else {
serviceException.printStackTrace();
}
}
});

说明:
更多完整示例,请前往 GitHub 查看。