VerifyFaceResponse.php 6.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105
  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. * VerifyFace返回参数结构体
  21. *
  22. * @method float getScore() 获取给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
  23. 不同算法版本返回的相似度分数不同。
  24. 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
  25. 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
  26. * @method void setScore(float $Score) 设置给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
  27. 不同算法版本返回的相似度分数不同。
  28. 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
  29. 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
  30. * @method boolean getIsMatch() 获取是否为同一人判断,固定阈值分数为60分,若想更灵活地调整阈值可取Score参数返回进行判断
  31. * @method void setIsMatch(boolean $IsMatch) 设置是否为同一人判断,固定阈值分数为60分,若想更灵活地调整阈值可取Score参数返回进行判断
  32. * @method string getFaceModelVersion() 获取人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
  33. * @method void setFaceModelVersion(string $FaceModelVersion) 设置人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
  34. * @method string getRequestId() 获取唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
  35. * @method void setRequestId(string $RequestId) 设置唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
  36. */
  37. class VerifyFaceResponse extends AbstractModel
  38. {
  39. /**
  40. * @var float 给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
  41. 不同算法版本返回的相似度分数不同。
  42. 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
  43. 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
  44. */
  45. public $Score;
  46. /**
  47. * @var boolean 是否为同一人判断,固定阈值分数为60分,若想更灵活地调整阈值可取Score参数返回进行判断
  48. */
  49. public $IsMatch;
  50. /**
  51. * @var string 人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
  52. */
  53. public $FaceModelVersion;
  54. /**
  55. * @var string 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
  56. */
  57. public $RequestId;
  58. /**
  59. * @param float $Score 给定的人脸图片与 PersonId 对应人脸的相似度。若 PersonId 下有多张人脸(Face),返回相似度最大的分数。
  60. 不同算法版本返回的相似度分数不同。
  61. 若需要验证两张图片中人脸是否为同一人,3.0版本误识率千分之一对应分数为40分,误识率万分之一对应分数为50分,误识率十万分之一对应分数为60分。 一般超过50分则可认定为同一人。
  62. 2.0版本误识率千分之一对应分数为70分,误识率万分之一对应分数为80分,误识率十万分之一对应分数为90分。 一般超过80分则可认定为同一人。
  63. * @param boolean $IsMatch 是否为同一人判断,固定阈值分数为60分,若想更灵活地调整阈值可取Score参数返回进行判断
  64. * @param string $FaceModelVersion 人脸识别所用的算法模型版本,是该 Person 所在的人员库的算法模型版本。在创建人员库时设置,详情可参考[算法模型版本](https://cloud.tencent.com/document/product/867/40042)
  65. * @param string $RequestId 唯一请求 ID,每次请求都会返回。定位问题时需要提供该次请求的 RequestId。
  66. */
  67. function __construct()
  68. {
  69. }
  70. /**
  71. * For internal only. DO NOT USE IT.
  72. */
  73. public function deserialize($param)
  74. {
  75. if ($param === null) {
  76. return;
  77. }
  78. if (array_key_exists("Score",$param) and $param["Score"] !== null) {
  79. $this->Score = $param["Score"];
  80. }
  81. if (array_key_exists("IsMatch",$param) and $param["IsMatch"] !== null) {
  82. $this->IsMatch = $param["IsMatch"];
  83. }
  84. if (array_key_exists("FaceModelVersion",$param) and $param["FaceModelVersion"] !== null) {
  85. $this->FaceModelVersion = $param["FaceModelVersion"];
  86. }
  87. if (array_key_exists("RequestId",$param) and $param["RequestId"] !== null) {
  88. $this->RequestId = $param["RequestId"];
  89. }
  90. }
  91. }