Compare Faces

UiPath.AmazonRekognition.Activities.CompareFaces

“比较面容”活动使用“比较面容” API 将源输入图像（ SourceImagePath或SourceImageURL ）中最显着的面容与目标输入图像（ TargetImagePath或TargetImageURL ）中检测到的前 100 张最大面容进行比较。

作为响应，该活动会返回一个面容匹配项数组，该数组按相似度分数以降序排列。对于每次面容匹配，响应都会提供面容的边框和置信度值（指示面容匹配程度的分数）。

摘要

依赖项	详细信息
包	UiPath.Amazon.Rekognition.Activities
活动	Amazon Scope

属性	详细信息
输入（变量）	`String` 适用于属性： SourceImagePath 、 SourceImageURL 、 TargetImagePath和 TargetImageURL
输出 (变量)	`FaceMatch[]` 适用于属性: 匹配面容
使用的 API	Amazon Rekognition - 比较面容
示例	快速入门

将此活动添加到 UiPath Studio 中的项目时，会指定以下属性的值。

活动的显示名称。

包含要与目标输入图像进行比较的面容的本地图像的路径。

属性	详细信息
类型	`String`
必填	是（如果 SourceImageURL 为空）
默认值	空白
允许的值	输入 `String` 或 `String` 变量。
注意	“源图像路径”或“源图像 URL ”属性为必填项。如果您同时为 SourceImagePath 和 SourceImageURL输入值，则使用 SourceImagePath 值。

包含要与目标输入图像进行比较的面容的远程图像的路径。

属性	详细信息
类型	`String`
必填	是（如果“源图像路径”为空）
默认值	空白
允许的值	输入 `String` 或 `String` 变量。
注意	“源图像路径”或“源图像 URL ”属性为必填项。如果您同时为 SourceImagePath 和 SourceImageURL输入值，则使用 SourceImagePath 值。

包含要与源输入图像进行比较的面容的本地图像的路径。

属性	详细信息
类型	`String`
必填	是（如果目标图像 URL 为空）
默认值	空白
允许的值	输入 `String` 或 `String` 变量。
注意	“目标图像路径”或“目标图像 URL” 属性为必填项。如果同时为 TargetImagePath 和 TargetImageURL输入值，则使用 TargetImagePath 的值。

包含您想要与源输入图像进行比较的面容的远程图像的路径。

属性	描述
类型	`String`
必填	是（如果目标图像路径为空）
默认值	空白
允许的值	输入 `String` 或 `String` 变量。
注意	“目标图像路径”或“目标图像 URL” 属性为必填项。如果同时为 TargetImagePath 和 TargetImageURL输入值，则使用 TargetImagePath 的值。

如果已选择，变量和参数的值将不会在 Verbose 级进行记录。

将面容视为匹配项的最低置信度值 (即相似性百分比)。

属性	描述
类型	`Double`
必填	否
默认值	空白
允许的值	输入 0 到 1 之间的数字以表示相似度百分比（例如，如果要将相似度设为 80％，请输入0.8 ）。
注意	如果设置了此属性，则“面容匹配”属性仅返回符合或超过指定值的面容示例：如果输入值 .8 ，并且活动返回的置信度为 0.8 或更高，则目标图像路径或目标图像 URL 图像中的面容被视为与源图像路径或源图像 URL 中的面容相匹配。如果活动返回的置信度低于 0.8，则这些面容不会被视为匹配项，并且“面容匹配”属性将返回 null 值。

目标图像中与源图像中的面容相匹配的面容数组。

属性	详细信息
类型	`FaceMatch[]` UiPath.Amazon.Rekognition.Models.FaceMatch[]
必填	否（如果您计划在后续活动中使用输出数据，则建议使用此选项）
默认值	空白
允许的值	输入您的值作为`FaceMatch[]`变量。
注意	如果设置了“置信度”值，则数组仅包含达到或超过指定相似度的面容。如果计划使用“ 遍历循环” 活动来处理数组输出，请选择“UiPath.Amazon.Rekognition.Models.FaceMatch ” 作为“ 类型参数 ”。