Identify Face

UiPath.AmazonRekognition.Activities.AddFace

[ Identify Face] アクティビティは、Amazon Rekognition SearchFacesByImage API を使用して、まず入力画像 (ImagePath または ImageURL) で最大の顔を検出し、次に指定したコレクション ([コレクション]) で一致する顔を検索します。 このアクティビティは、入力された顔の特徴とコレクション内の顔を比較し、入力画像に一致する顔の配列 ([顔]) を出力します。

概要

依存関係

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

属性

属性	詳細
入力データ型 (変数)	String プロパティに適用されます。 画像パス、画像 URL、 コレクション名
出力データ型 (変数)	Faces[] プロパティに適用されます。 面 詳細については、Amazon Rekognition API ドキュメントの Face データ型をご覧ください。
使用する 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 を使用して ListCollections API を直接呼び出すことができます。

画像パス

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

属性	詳細
入力	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 ] を選択します。