Identify Face

UiPath.AmazonRekognition.Activities.AddFace

[ 顔を識別 ] アクティビティは、Amazon Rekognition SearchFacesByImage API を使用して、最初に入力画像内の最も大きい顔 ([画像パス ] または [ 画像 URL]) を検出し、一致する顔を指定してコレクション ([コレクション]) を検索します。 このアクティビティは、入力面の特徴とコレクション内の顔を比較し、入力画像に一致する顔の配列 ([顔]) を出力します。

概要

依存関係

依存関係	詳細
パッケージ	UiPath.Amazon.Rekognition.Activities
アクティビティ	Amazon Scope コレクションを作成 (コレクションが既に存在する場合を除く) Face を追加 します (コレクションに識別したい顔が既に含まれている場合を除きます)。

属性

属性	詳細
入力データ型 (変数)	String プロパティに適用されます。 画像パス、画像 URL、 コレクション名
出力データ型 (変数)	Faces[] プロパティに適用されます。 面 詳細については、Amazon Rekognition API ドキュメントの 「Face datatype」をご覧ください。
使用する API	Amazon Rekognition - SearchFacesByImage
例	クイックスタート

プロパティ

以下のプロパティの値は、このアクティビティを UiPath Studio でプロジェクトに追加するときに指定します。

共通

表示名

アクティビティの表示名です。

属性	詳細
入力	String
Required	はい
既定値	Identify Face
許容値	String または String 型変数を入力します。
備考	N/A

入力

CollectionName

検出された顔の識別に使用する既存のコレクションの名前または ID です。

属性	詳細
入力	String
Required	はい
既定値	空
許容値	String または String 型変数を入力します。
備考	使用する既存のコレクションがある場合は、正確なコレクション名を入力します。 コレクション名のリストを取得するアクティビティはありませんが、 AWS CLI または AWS SDK API を使用して、 ListCollectionsAPI を直接呼び出すことができます。

画像パス

分析するローカル画像へのパスです。

属性	詳細
入力	String
Required	はい ( [画像 URL ] が空の場合)
既定値	空
許容値	String または String 型変数を入力します。
備考	[ 画像パス ] または [ 画像 URL] プロパティが必要です。 [ 画像パス ] と [ 画像 URL] の両方の値を入力した場合、[ 画像パス] の 値が使用されます。

画像の URL

分析する画像の URL です。

属性	詳細
入力	String
Required	はい ( 画像パス が空の場合)
既定値	空
許容値	String または String 型変数を入力します。
備考	[ 画像パス ] または [ 画像 URL] プロパティが必要です。 [ 画像パス ] と [ 画像 URL] の両方の値を入力した場合、[ 画像パス] の 値が使用されます。

その他

プライベート (Private)

選択すると、変数と引数の値が Verbose レベルでログ記録されなくなります。

属性	詳細
入力	チェックボックス
Required	いいえ
既定値	非選択
許容値	選択または非選択
備考	N/A

オプション

信頼度

顔が一致していると見なす最小信頼度の値 (すなわち、類似性の割合) です。

属性	詳細
入力	Double
Required	いいえ
既定値	0.70 (プロパティに表示されません)
許容値	類似性の割合を示す 0 から 1 の範囲の数値を入力します (例: 類似性を 80% にする場合は 「. 8」と入力します)。
備考	このプロパティを設定した場合、[ 顔] プロパティは、指定した値を満たすか超える顔のみを返します。 例: 値 .8 を入力した場合、アクティビティが信頼度レベル .8以上を返す場合は、 ImagePath または ImageURL 画像内の顔は コレクション 内の顔に対して識別されたと見なされます。 アクティビティが信頼度レベル .8 未満を返す場合、顔は識別されないと見なされ 、[Faces] プロパティは null 値を返します。

結果の最大数

応答でアクティビティが返す顔の最大数です。

属性	詳細
入力	Int32
Required	いいえ
既定値	空
許容値	Int32 または Int32 型変数を入力します。
備考	N/A

出力

顔

入力画像で指定した面に一致する顔の配列です。

属性	詳細
入力	Face[] UiPath.Amazon.Rekognition.Models.Face[]
Required	いいえ (後続のアクティビティで出力データを使用する予定がある場合に推奨)
既定値	空
許容値	Face[] 変数として値を入力します。
備考	信頼度 の値が設定されている場合、配列には指定された類似性のレベルを満たすまたは超える顔のみが含まれます。 [繰り返し ( コレクションの各要素)] アクティビティを使用して配列出力を処理する場合は、 TypeArgumentとして [UiPath.Amazon.Rekognition.Models.Face ] を選択します。