Add Face

UiPath.AmazonRekognition.Activities.AddFace

概述

“添加面容”活动使用 Amazon Rekognition IndexFaces API 首先检测输入图像（ ImagePath或ImageURL ）中的面容，然后将其添加到指定的集合（ CollectionName ）中。 对于检测到的每张面容，该活动会返回已添加到集合中的面容数组 ( Faces )。

摘要

依赖项

依赖项	详细信息
包	UiPath.Amazon.Rekognition.Activities
活动	Amazon Scope 创建集合（除非集合已存在）

属性

属性	详细信息
输入（变量）	String 适用于属性：“图像路径”、“图像 URL ”和“集合名称”
输出 (变量)	Faces[] 适用于属性：面容
使用的 API	Amazon Rekognition - 索引面容
示例	快速入门

属性

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

常见

显示名称

活动的显示名称。

属性	详细信息
类型	String
必填	是
默认值	Add Faces
允许的值	输入 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 级进行记录。

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

选项

ImageID

要分配给输入图像中面容的唯一标识符。

属性	详细信息
类型	String
必填	否
默认值	空白
允许的值	输入 String 或 String 变量。
注意	示例：如果图像只有一张面容，则图像ID可以是人名（例如，“彼得”）。 如果图像具有多张面容，则图像ID将应用于图像中的所有面容。 在这种情况下，您的值应反映您希望如何识别面容组（例如，“ Pet.Paul.Mary ”）。 如果您计划使用 识别面容 活动，则使用 图像 ID 属性非常有用。“识别面容”活动会（通过“面容”输出属性返回）与在输入图像中找到的面容相匹配的面容数组。 如果您先前已为图像分配了图像ID ，则该值将在数组中返回。

输出

面容

添加到集合名称中指定的集合的面容数组。

属性	详细信息
类型	Face[] UiPath.Amazon.Rekognition.Models.Face[]
必填	否（如果您计划在后续活动中使用输出数据，则建议使用此选项）
默认值	空白
允许的值	输入Face[]变量。
注意	使用“面容”数据类型为图像中每张已识别的面容分配一组唯一的面容属性，其中包括面容 ID 和边框。 如果您计划使用“ 遍历循环”活动来处理数组输出，请选择 UiPath.Amazon.Rekognition.Models.Face 作为 TypeArgument 。