VerifyPersonRequest.php 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165
  1. <?php
  2. /*
  3. * Copyright (c) 2017-2018 THL A29 Limited, a Tencent company. All Rights Reserved.
  4. *
  5. * Licensed under the Apache License, Version 2.0 (the "License");
  6. * you may not use this file except in compliance with the License.
  7. * You may obtain a copy of the License at
  8. *
  9. * http://www.apache.org/licenses/LICENSE-2.0
  10. *
  11. * Unless required by applicable law or agreed to in writing, software
  12. * distributed under the License is distributed on an "AS IS" BASIS,
  13. * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14. * See the License for the specific language governing permissions and
  15. * limitations under the License.
  16. */
  17. namespace TencentCloud\Iai\V20200303\Models;
  18. use TencentCloud\Common\AbstractModel;
  19. /**
  20. * VerifyPerson请求参数结构体
  21. *
  22. * @method string getPersonId() 获取待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。
  23. * @method void setPersonId(string $PersonId) 设置待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。
  24. * @method string getImage() 获取图片 base64 数据。
  25. jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
  26. 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
  27. 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
  28. * @method void setImage(string $Image) 设置图片 base64 数据。
  29. jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
  30. 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
  31. 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
  32. * @method string getUrl() 获取图片的 Url
  33. jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。。
  34. 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
  35. 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
  36. 非腾讯云存储的Url速度和稳定性可能受一定影响。
  37. 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
  38. 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
  39. * @method void setUrl(string $Url) 设置图片的 Url
  40. jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。。
  41. 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
  42. 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
  43. 非腾讯云存储的Url速度和稳定性可能受一定影响。
  44. 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
  45. 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
  46. * @method integer getQualityControl() 获取图片质量控制。
  47. 0: 不进行控制;
  48. 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
  49. 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
  50. 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
  51. 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
  52. 默认 0。
  53. 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
  54. * @method void setQualityControl(integer $QualityControl) 设置图片质量控制。
  55. 0: 不进行控制;
  56. 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
  57. 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
  58. 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
  59. 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
  60. 默认 0。
  61. 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
  62. * @method integer getNeedRotateDetection() 获取是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
  63. * @method void setNeedRotateDetection(integer $NeedRotateDetection) 设置是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
  64. */
  65. class VerifyPersonRequest extends AbstractModel
  66. {
  67. /**
  68. * @var string 待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。
  69. */
  70. public $PersonId;
  71. /**
  72. * @var string 图片 base64 数据。
  73. jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
  74. 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
  75. 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
  76. */
  77. public $Image;
  78. /**
  79. * @var string 图片的 Url
  80. jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。。
  81. 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
  82. 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
  83. 非腾讯云存储的Url速度和稳定性可能受一定影响。
  84. 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
  85. 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
  86. */
  87. public $Url;
  88. /**
  89. * @var integer 图片质量控制。
  90. 0: 不进行控制;
  91. 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
  92. 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
  93. 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
  94. 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
  95. 默认 0。
  96. 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
  97. */
  98. public $QualityControl;
  99. /**
  100. * @var integer 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
  101. */
  102. public $NeedRotateDetection;
  103. /**
  104. * @param string $PersonId 待验证的人员ID。人员ID具体信息请参考人员库管理相关接口。
  105. * @param string $Image 图片 base64 数据。
  106. jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。
  107. 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
  108. 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
  109. * @param string $Url 图片的 Url
  110. jpg格式长边像素不可超过4000,其他格式图片长边像素不可超2000。。
  111. 图片的 Url、Image必须提供一个,如果都提供,只使用 Url。
  112. 图片存储于腾讯云的Url可保障更高下载速度和稳定性,建议图片存储于腾讯云。
  113. 非腾讯云存储的Url速度和稳定性可能受一定影响。
  114. 若图片中包含多张人脸,只选取其中人脸面积最大的人脸。
  115. 支持PNG、JPG、JPEG、BMP,不支持 GIF 图片。
  116. * @param integer $QualityControl 图片质量控制。
  117. 0: 不进行控制;
  118. 1:较低的质量要求,图像存在非常模糊,眼睛鼻子嘴巴遮挡至少其中一种或多种的情况;
  119. 2: 一般的质量要求,图像存在偏亮,偏暗,模糊或一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,至少其中三种的情况;
  120. 3: 较高的质量要求,图像存在偏亮,偏暗,一般模糊,眉毛遮挡,脸颊遮挡,下巴遮挡,其中一到两种的情况;
  121. 4: 很高的质量要求,各个维度均为最好或最多在某一维度上存在轻微问题;
  122. 默认 0。
  123. 若图片质量不满足要求,则返回结果中会提示图片质量检测不符要求。
  124. * @param integer $NeedRotateDetection 是否开启图片旋转识别支持。0为不开启,1为开启。默认为0。本参数的作用为,当图片中的人脸被旋转且图片没有exif信息时,如果不开启图片旋转识别支持则无法正确检测、识别图片中的人脸。若您确认图片包含exif信息或者您确认输入图中人脸不会出现被旋转情况,请不要开启本参数。开启后,整体耗时将可能增加数百毫秒。
  125. */
  126. function __construct()
  127. {
  128. }
  129. /**
  130. * For internal only. DO NOT USE IT.
  131. */
  132. public function deserialize($param)
  133. {
  134. if ($param === null) {
  135. return;
  136. }
  137. if (array_key_exists("PersonId",$param) and $param["PersonId"] !== null) {
  138. $this->PersonId = $param["PersonId"];
  139. }
  140. if (array_key_exists("Image",$param) and $param["Image"] !== null) {
  141. $this->Image = $param["Image"];
  142. }
  143. if (array_key_exists("Url",$param) and $param["Url"] !== null) {
  144. $this->Url = $param["Url"];
  145. }
  146. if (array_key_exists("QualityControl",$param) and $param["QualityControl"] !== null) {
  147. $this->QualityControl = $param["QualityControl"];
  148. }
  149. if (array_key_exists("NeedRotateDetection",$param) and $param["NeedRotateDetection"] !== null) {
  150. $this->NeedRotateDetection = $param["NeedRotateDetection"];
  151. }
  152. }
  153. }