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
必填	是
默认值	Compare Faces
允许的值	输入 String 或 String 变量。
注意	不适用

输入

SourceImagePath

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

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

SourceImageURL

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

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

TargetImagePath

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

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

TargetImageURL

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

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

其他

私有

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

属性	描述
类型	复选框
必填	否
默认值	未选中
允许的值	已选择或未选择
注意	不适用

选项

可信度

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

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

输出

MatchingFaces

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

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