简介
本文档提供关于人脸检索的相关 API 概览以及 SDK 示例代码。
API | 操作描述 |
从数据集中搜索与指定图片最相似的前N张图片并返回人脸坐标可对数据集内文件进行一个或多个人员的人脸识别。 |
SDK API 参考
人脸搜索
功能说明
从数据集中搜索与指定图片最相似的前N张图片并返回人脸坐标可对数据集内文件进行一个或多个人员的人脸识别。
注意:
COS Android SDK 版本需要大于等于 v5.9.30。
示例代码
// APPIDString 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() {@Overridepublic void onSuccess(CosXmlRequest request, CosXmlResult cosResult) {// result 人脸搜索的结果// 详细字段请查看api文档或者SDK源码DatasetFaceSearchResult result = (DatasetFaceSearchResult) cosResult;}@Overridepublic void onFail(CosXmlRequest request, CosXmlClientException clientException, CosXmlServiceException serviceException) {if (clientException != null) {clientException.printStackTrace();} else {serviceException.printStackTrace();}}});
说明: