com.tencentcloudapi.iai.v20180301.models

类 SearchPersonsRequest

java.lang.Object

com.tencentcloudapi.common.AbstractModel

com.tencentcloudapi.iai.v20180301.models.SearchPersonsRequest

public class SearchPersonsRequest
extends AbstractModel

构造器概要

构造器

构造器和说明
SearchPersonsRequest()

方法概要

限定符和类型	方法和说明
Float	getFaceMatchThreshold() 获取出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。
String[]	getGroupIds() 获取希望搜索的人员库列表，上限100个。
String	getImage() 获取图片 base64 数据，base64 编码后大小不可超过5M。
Long	getMaxFaceNum() 获取最多识别的人脸数目。
Long	getMaxPersonNum() 获取单张被识别的人脸返回的最相似人员数量。
Long	getMinFaceSize() 获取人脸长和宽的最小尺寸，单位为像素。
Long	getNeedPersonInfo() 获取是否返回人员具体信息。
Long	getQualityControl() 获取图片质量控制。
String	getUrl() 获取图片的 Url 。
void	setFaceMatchThreshold(Float FaceMatchThreshold) 设置出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。
void	setGroupIds(String[] GroupIds) 设置希望搜索的人员库列表，上限100个。
void	setImage(String Image) 设置图片 base64 数据，base64 编码后大小不可超过5M。
void	setMaxFaceNum(Long MaxFaceNum) 设置最多识别的人脸数目。
void	setMaxPersonNum(Long MaxPersonNum) 设置单张被识别的人脸返回的最相似人员数量。
void	setMinFaceSize(Long MinFaceSize) 设置人脸长和宽的最小尺寸，单位为像素。
void	setNeedPersonInfo(Long NeedPersonInfo) 设置是否返回人员具体信息。
void	setQualityControl(Long QualityControl) 设置图片质量控制。
void	setUrl(String Url) 设置图片的 Url 。
void	toMap(HashMap<String,String> map, String prefix) 内部实现，用户禁止调用

从类继承的方法 com.tencentcloudapi.common.AbstractModel

any, fromJsonString, getBinaryParams, getMultipartRequestParams, set, setParamArrayObj, setParamArraySimple, setParamObj, setParamSimple, toJsonString

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造器详细资料

SearchPersonsRequest

public SearchPersonsRequest()

方法详细资料

getGroupIds

public String[] getGroupIds()

获取希望搜索的人员库列表，上限100个。

返回:

GroupIds 希望搜索的人员库列表，上限100个。

setGroupIds

public void setGroupIds(String[] GroupIds)

设置希望搜索的人员库列表，上限100个。

参数:

GroupIds - 希望搜索的人员库列表，上限100个。

getImage

public String getImage()

获取图片 base64 数据，base64 编码后大小不可超过5M。 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

返回:

Image 图片 base64 数据，base64 编码后大小不可超过5M。 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

setImage

public void setImage(String Image)

设置图片 base64 数据，base64 编码后大小不可超过5M。 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

参数:

Image - 图片 base64 数据，base64 编码后大小不可超过5M。 若图片中包含多张人脸，只选取其中人脸面积最大的人脸。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

getUrl

public String getUrl()

获取图片的 Url 。对应图片 base64 编码后大小不可超过5M。 Url、Image必须提供一个，如果都提供，只使用 Url。 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 非腾讯云存储的Url速度和稳定性可能受一定影响。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

返回:

Url 图片的 Url 。对应图片 base64 编码后大小不可超过5M。 Url、Image必须提供一个，如果都提供，只使用 Url。 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 非腾讯云存储的Url速度和稳定性可能受一定影响。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

setUrl

public void setUrl(String Url)

设置图片的 Url 。对应图片 base64 编码后大小不可超过5M。 Url、Image必须提供一个，如果都提供，只使用 Url。 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 非腾讯云存储的Url速度和稳定性可能受一定影响。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

参数:

Url - 图片的 Url 。对应图片 base64 编码后大小不可超过5M。 Url、Image必须提供一个，如果都提供，只使用 Url。 图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。 非腾讯云存储的Url速度和稳定性可能受一定影响。 支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。

getMaxFaceNum

public Long getMaxFaceNum()

获取最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。

返回:

MaxFaceNum 最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。

setMaxFaceNum

public void setMaxFaceNum(Long MaxFaceNum)

设置最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。

参数:

MaxFaceNum - 最多识别的人脸数目。默认值为1（仅检测图片中面积最大的那张人脸），最大值为10。 MaxFaceNum用于，当输入的待识别图片包含多张人脸时，设定要搜索的人脸的数量。 例：输入的Image或Url中的图片包含多张人脸，设MaxFaceNum=5，则会识别图片中面积最大的5张人脸。

getMinFaceSize

public Long getMinFaceSize()

获取人脸长和宽的最小尺寸，单位为像素。默认为80。低于40将影响搜索精度。建议设置为80。

返回:

MinFaceSize 人脸长和宽的最小尺寸，单位为像素。默认为80。低于40将影响搜索精度。建议设置为80。

setMinFaceSize

public void setMinFaceSize(Long MinFaceSize)

设置人脸长和宽的最小尺寸，单位为像素。默认为80。低于40将影响搜索精度。建议设置为80。

参数:

MinFaceSize - 人脸长和宽的最小尺寸，单位为像素。默认为80。低于40将影响搜索精度。建议设置为80。

getMaxPersonNum

public Long getMaxPersonNum()

获取单张被识别的人脸返回的最相似人员数量。默认值为5，最大值为100。 例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。 值越大，需要处理的时间越长。建议不要超过10。

返回:

MaxPersonNum 单张被识别的人脸返回的最相似人员数量。默认值为5，最大值为100。 例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。 值越大，需要处理的时间越长。建议不要超过10。

setMaxPersonNum

public void setMaxPersonNum(Long MaxPersonNum)

设置单张被识别的人脸返回的最相似人员数量。默认值为5，最大值为100。 例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。 值越大，需要处理的时间越长。建议不要超过10。

参数:

MaxPersonNum - 单张被识别的人脸返回的最相似人员数量。默认值为5，最大值为100。 例，设MaxFaceNum为1，MaxPersonNum为8，则返回Top8相似的人员信息。 值越大，需要处理的时间越长。建议不要超过10。

getQualityControl

public Long getQualityControl()

获取图片质量控制。 0: 不进行控制； 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； 默认 0。 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。

返回:

QualityControl 图片质量控制。 0: 不进行控制； 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； 默认 0。 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。

setQualityControl

public void setQualityControl(Long QualityControl)

设置图片质量控制。 0: 不进行控制； 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； 默认 0。 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。

参数:

QualityControl - 图片质量控制。 0: 不进行控制； 1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况； 2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况； 3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况； 4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题； 默认 0。 若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。

getFaceMatchThreshold

public Float getFaceMatchThreshold()

获取出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。

返回:

FaceMatchThreshold 出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。

setFaceMatchThreshold

public void setFaceMatchThreshold(Float FaceMatchThreshold)

设置出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。

参数:

FaceMatchThreshold - 出参Score中，只有大于等于FaceMatchThreshold值的结果才会返回。默认为0。取值范围[0.0,100.0) 。

getNeedPersonInfo

public Long getNeedPersonInfo()

获取是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0

返回:

NeedPersonInfo 是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0

setNeedPersonInfo

public void setNeedPersonInfo(Long NeedPersonInfo)

设置是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0

参数:

NeedPersonInfo - 是否返回人员具体信息。0 为关闭，1 为开启。默认为 0。其他非0非1值默认为0

toMap

public void toMap(HashMap<String,String> map,
                  String prefix)

内部实现，用户禁止调用

指定者:

toMap 在类中 AbstractModel