Identify Face

UiPath.AmazonRekognition.Activities.AddFace

“识别面容”活动使用 Amazon Rekognition“按图像搜索面容” API 来首先检测输入图像（ ImagePath或ImageURL ）中最大的面容，然后在指定的集合 ( Collection ) 中搜索匹配的面容。 该活动将输入面容的特征与集合中的面容进行比较，并输出与输入图像匹配的面容数组 ( Faces )。

摘要

依赖项

依赖项	详细信息
包	UiPath.Amazon.Rekognition.Activities
活动	Amazon Scope 创建集合（除非集合已存在） 添加面容（除非集合已包含您要识别的面容）

属性

属性	详细信息
输入数据类型（变量）	String 适用于属性：“图像路径”、“图像 URL ”和“集合名称”
输出数据类型（变量）	Faces[] 适用于属性：面容 有关更多信息，请参阅 Amazon Rekognition API 文档中的面容数据类型。
使用的 API	Amazon Rekognition - 按图像搜索面容
示例	快速入门

属性

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

常见

显示名称

活动的显示名称。

属性	详细信息
类型	String
必填	是
默认值	Identify Face
允许的值	输入 String 或 String 变量。
注意	不适用

输入

CollectionName

要用于识别检测到的面容的现有集合的名称或 ID。

属性	详细信息
类型	String
必填	是
默认值	空白
允许的值	输入 String 或 String 变量。
注意	如果您要使用现有集合，请输入其确切的集合名称。 没有用于检索集合名称列表的活动，但您可以使用 AWS CLI 或 AWS 开发工具包 API 直接调用 ListCollections API。

图像路径

要分析的本地映像的路径。

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

图像 URL

要分析的图像的 URL。

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

其他

私有

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

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

选项

可信度

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

属性	详细信息
类型	Double
必填	否
默认值	0.70 （未显示在属性中）
允许的值	输入 0 到 1 之间的数字以表示相似度百分比（例如，如果要将相似度设为 80％，请输入0.8 ）。
注意	如果设置了此属性，则“面容”属性仅返回符合或超过指定值的面容 示例：如果您输入值.8 ，且活动返回的置信度为 0.8 或更高，则“ ImagePath ”或“ImageURL”图像中的面容被视为已识别为集合中的面容。 如果活动返回的置信度低于 0.8，则系统不会认为面容已识别，并且“面容”属性将返回 null 值。

最大结果数量

希望活动在响应中返回的最大面容数。

属性	详细信息
类型	Int32
必填	否
默认值	空白
允许的值	输入 Int32 或 Int32 变量。
注意	不适用

输出

面容

与输入图像中指定的面容匹配的面容数组。

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