<?php
/*
* Copyright (c) 2017-2018 THL A29 Limited, a Tencent company. All Rights Reserved.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
namespace TencentCloud\Iai\V20180301\Models;
use TencentCloud\Common\AbstractModel;
/**
* CreatePerson请求参数结构体
*
* @method string getGroupId() 获取待加入的人员库ID。
* @method void setGroupId(string $GroupId) 设置待加入的人员库ID。
* @method string getPersonName() 获取人员名称。[1，60]个字符，可修改，可重复。
* @method void setPersonName(string $PersonName) 设置人员名称。[1，60]个字符，可修改，可重复。
* @method string getPersonId() 获取人员ID，单个腾讯云账号下不可修改，不可重复。支持英文、数字、-%@#&_，长度限制64B。
* @method void setPersonId(string $PersonId) 设置人员ID，单个腾讯云账号下不可修改，不可重复。支持英文、数字、-%@#&_，长度限制64B。
* @method integer getGender() 获取0代表未填写，1代表男性，2代表女性。
* @method void setGender(integer $Gender) 设置0代表未填写，1代表男性，2代表女性。
* @method array getPersonExDescriptionInfos() 获取人员描述字段内容，key-value。[0，60]个字符，可修改，可重复。
* @method void setPersonExDescriptionInfos(array $PersonExDescriptionInfos) 设置人员描述字段内容，key-value。[0，60]个字符，可修改，可重复。
* @method string getImage() 获取图片 base64 数据，base64 编码后大小不可超过5M。
支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
* @method void setImage(string $Image) 设置图片 base64 数据，base64 编码后大小不可超过5M。
支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
* @method string getUrl() 获取图片的 Url 。对应图片 base64 编码后大小不可超过5M。
Url、Image必须提供一个，如果都提供，只使用 Url。
图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
非腾讯云存储的Url速度和稳定性可能受一定影响。
支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
* @method void setUrl(string $Url) 设置图片的 Url 。对应图片 base64 编码后大小不可超过5M。
Url、Image必须提供一个，如果都提供，只使用 Url。
图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
非腾讯云存储的Url速度和稳定性可能受一定影响。
支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
* @method integer getUniquePersonControl() 获取此参数用于控制判断 Image 或 Url 中图片包含的人脸，是否在人员库中已有疑似的同一人。
如果判断为已有相同人在人员库中，则不会创建新的人员，返回疑似同一人的人员信息。
如果判断没有，则完成创建人员。
0: 不进行判断，无论是否有疑似同一人在库中均完成入库；
1:较低的同一人判断要求（百一误识别率）；
2: 一般的同一人判断要求（千一误识别率）；
3: 较高的同一人判断要求（万一误识别率）；
4: 很高的同一人判断要求（十万一误识别率）。
默认 0。
注： 要求越高，则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值，您可以根据实际情况调整。
* @method void setUniquePersonControl(integer $UniquePersonControl) 设置此参数用于控制判断 Image 或 Url 中图片包含的人脸，是否在人员库中已有疑似的同一人。
如果判断为已有相同人在人员库中，则不会创建新的人员，返回疑似同一人的人员信息。
如果判断没有，则完成创建人员。
0: 不进行判断，无论是否有疑似同一人在库中均完成入库；
1:较低的同一人判断要求（百一误识别率）；
2: 一般的同一人判断要求（千一误识别率）；
3: 较高的同一人判断要求（万一误识别率）；
4: 很高的同一人判断要求（十万一误识别率）。
默认 0。
注： 要求越高，则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值，您可以根据实际情况调整。
* @method integer getQualityControl() 获取图片质量控制。
0: 不进行控制；
1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；
2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；
3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；
4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；
默认 0。
若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
* @method void setQualityControl(integer $QualityControl) 设置图片质量控制。
0: 不进行控制；
1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；
2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；
3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；
4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；
默认 0。
若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
* @method integer getNeedRotateDetection() 获取是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
* @method void setNeedRotateDetection(integer $NeedRotateDetection) 设置是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
*/
class CreatePersonRequest extends AbstractModel
{
/**
* @var string 待加入的人员库ID。
*/
public $GroupId;
/**
* @var string 人员名称。[1，60]个字符，可修改，可重复。
*/
public $PersonName;
/**
* @var string 人员ID，单个腾讯云账号下不可修改，不可重复。支持英文、数字、-%@#&_，长度限制64B。
*/
public $PersonId;
/**
* @var integer 0代表未填写，1代表男性，2代表女性。
*/
public $Gender;
/**
* @var array 人员描述字段内容，key-value。[0，60]个字符，可修改，可重复。
*/
public $PersonExDescriptionInfos;
/**
* @var string 图片 base64 数据，base64 编码后大小不可超过5M。
支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
*/
public $Image;
/**
* @var string 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
Url、Image必须提供一个，如果都提供，只使用 Url。
图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
非腾讯云存储的Url速度和稳定性可能受一定影响。
支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
*/
public $Url;
/**
* @var integer 此参数用于控制判断 Image 或 Url 中图片包含的人脸，是否在人员库中已有疑似的同一人。
如果判断为已有相同人在人员库中，则不会创建新的人员，返回疑似同一人的人员信息。
如果判断没有，则完成创建人员。
0: 不进行判断，无论是否有疑似同一人在库中均完成入库；
1:较低的同一人判断要求（百一误识别率）；
2: 一般的同一人判断要求（千一误识别率）；
3: 较高的同一人判断要求（万一误识别率）；
4: 很高的同一人判断要求（十万一误识别率）。
默认 0。
注： 要求越高，则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值，您可以根据实际情况调整。
*/
public $UniquePersonControl;
/**
* @var integer 图片质量控制。
0: 不进行控制；
1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；
2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；
3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；
4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；
默认 0。
若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
*/
public $QualityControl;
/**
* @var integer 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
*/
public $NeedRotateDetection;
/**
* @param string $GroupId 待加入的人员库ID。
* @param string $PersonName 人员名称。[1，60]个字符，可修改，可重复。
* @param string $PersonId 人员ID，单个腾讯云账号下不可修改，不可重复。支持英文、数字、-%@#&_，长度限制64B。
* @param integer $Gender 0代表未填写，1代表男性，2代表女性。
* @param array $PersonExDescriptionInfos 人员描述字段内容，key-value。[0，60]个字符，可修改，可重复。
* @param string $Image 图片 base64 数据，base64 编码后大小不可超过5M。
支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
* @param string $Url 图片的 Url 。对应图片 base64 编码后大小不可超过5M。
Url、Image必须提供一个，如果都提供，只使用 Url。
图片存储于腾讯云的Url可保障更高下载速度和稳定性，建议图片存储于腾讯云。
非腾讯云存储的Url速度和稳定性可能受一定影响。
支持PNG、JPG、JPEG、BMP，不支持 GIF 图片。
* @param integer $UniquePersonControl 此参数用于控制判断 Image 或 Url 中图片包含的人脸，是否在人员库中已有疑似的同一人。
如果判断为已有相同人在人员库中，则不会创建新的人员，返回疑似同一人的人员信息。
如果判断没有，则完成创建人员。
0: 不进行判断，无论是否有疑似同一人在库中均完成入库；
1:较低的同一人判断要求（百一误识别率）；
2: 一般的同一人判断要求（千一误识别率）；
3: 较高的同一人判断要求（万一误识别率）；
4: 很高的同一人判断要求（十万一误识别率）。
默认 0。
注： 要求越高，则疑似同一人的概率越小。不同要求对应的误识别率仅为参考值，您可以根据实际情况调整。
* @param integer $QualityControl 图片质量控制。
0: 不进行控制；
1:较低的质量要求，图像存在非常模糊，眼睛鼻子嘴巴遮挡至少其中一种或多种的情况；
2: 一般的质量要求，图像存在偏亮，偏暗，模糊或一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，至少其中三种的情况；
3: 较高的质量要求，图像存在偏亮，偏暗，一般模糊，眉毛遮挡，脸颊遮挡，下巴遮挡，其中一到两种的情况；
4: 很高的质量要求，各个维度均为最好或最多在某一维度上存在轻微问题；
默认 0。
若图片质量不满足要求，则返回结果中会提示图片质量检测不符要求。
* @param integer $NeedRotateDetection 是否开启图片旋转识别支持。0为不开启，1为开启。默认为0。本参数的作用为，当图片中的人脸被旋转且图片没有exif信息时，如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况，请不要开启本参数。开启后，整体耗时将可能增加数百毫秒。
*/
function __construct()
{
}
/**
* For internal only. DO NOT USE IT.
*/
public function deserialize($param)
{
if ($param === null) {
return;
}
if (array_key_exists("GroupId",$param) and $param["GroupId"] !== null) {
$this->GroupId = $param["GroupId"];
}
if (array_key_exists("PersonName",$param) and $param["PersonName"] !== null) {
$this->PersonName = $param["PersonName"];
}
if (array_key_exists("PersonId",$param) and $param["PersonId"] !== null) {
$this->PersonId = $param["PersonId"];
}
if (array_key_exists("Gender",$param) and $param["Gender"] !== null) {
$this->Gender = $param["Gender"];
}
if (array_key_exists("PersonExDescriptionInfos",$param) and $param["PersonExDescriptionInfos"] !== null) {
$this->PersonExDescriptionInfos = [];
foreach ($param["PersonExDescriptionInfos"] as $key => $value){
$obj = new PersonExDescriptionInfo();
$obj->deserialize($value);
array_push($this->PersonExDescriptionInfos, $obj);
}
}
if (array_key_exists("Image",$param) and $param["Image"] !== null) {
$this->Image = $param["Image"];
}
if (array_key_exists("Url",$param) and $param["Url"] !== null) {
$this->Url = $param["Url"];
}
if (array_key_exists("UniquePersonControl",$param) and $param["UniquePersonControl"] !== null) {
$this->UniquePersonControl = $param["UniquePersonControl"];
}
if (array_key_exists("QualityControl",$param) and $param["QualityControl"] !== null) {
$this->QualityControl = $param["QualityControl"];
}
if (array_key_exists("NeedRotateDetection",$param) and $param["NeedRotateDetection"] !== null) {
$this->NeedRotateDetection = $param["NeedRotateDetection"];
}
}
}