Compare Faces

ソース入力画像で最も目立つ顔を、Amazon Rekognition のターゲット入力画像で検出された最も大きな 100 個の顔のそれぞれと比較するアクティビティ

UiPath.AmazonRekognition.Activities.CompareFaces

[ 顔を比較 ] アクティビティは、 CompareFaces API を使用して、ソース入力画像 (SourceImagePath または SourceImageURL) で最も目立つ顔を、ターゲット入力画像 (TargetImagePath または TargetImageURL) で検出された最大の顔 100 個それぞれと比較します。

それには、類似性スコアの降順で並べられた顔の一致の配列が返されます。 顔一致のそれぞれについて、応答は顔と信頼度の値の境界ボックスを提供します (顔の一致がどの程度近づくかを示すスコア)。

概要

依存関係

依存関係	詳細
パッケージ	UiPath.Amazon.Rekognition.Activities
Activities (アクティビティ)	Amazon Scope

属性

属性	詳細
入力 (変数)	String 適用対象プロパティ: SourceImagePath、SourceImageURL、TargetImagePath、 TargetImageURL
出力 (変数)	FaceMatch[] 適用対象プロパティ: MatchingFaces
使用する API	Amazon Rekognition - CompareFaces
例	クイックスタート

プロパティ

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

共通

表示名

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

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

入力

SourceImagePath

対象の入力画像と比較した顔を含むローカル 画像へのパスです。

属性	詳細
入力	String
Required	はい ( SourceImageURL が空の場合)
既定値	空
許容値	String または String 型変数を入力します。
備考	SourceImagePath プロパティまたは SourceImageURL プロパティのいずれかが必須です。 SourceImagePath と SourceImageURL の両方に値を入力すると、SourceImagePath の値が使用されます。

SourceImageURL

対象の入力画像と比較した顔を含むリモート 画像へのパスです。

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

TargetImagePath

ソース入力画像と比較した、必要な顔を含むローカル 画像へのパスです。

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

TargetImageURL

入力元の画像と比較した顔を含むリモート 画像へのパスです。

属性	説明
入力	String
Required	はい ( TargetImagePath が空の場合)
既定値	空
許容値	String または String 型変数を入力します。
備考	[TargetImagePath] プロパティまたは [TargetImageURL] プロパティのいずれかが必須です。 TargetImagePath と TargetImageURL の両方に値を入力すると、TargetImagePath の値が使用されます。

その他

プライベート (Private)

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

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

オプション

信頼度

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

属性	説明
入力	Double
Required	いいえ
既定値	空
許容値	類似性の割合を示すには、0 から 1 までの数値を入力します (たとえば、類似性を 80% にする場合は、「 .8 」と入力します)。
備考	このプロパティが設定されている場合、 MatchingFaces プロパティは、指定された値を満たすか超える面のみを返します 例: 値 .8 を入力した場合、アクティビティが .8 以上の信頼度レベルを返した場合、 TargetImagePath または TargetImageURL 画像内の顔は SourceImagePath または SourceImageURL 内の顔と一致すると見なされます。アクティビティが .8 未満の信頼度レベルを返した場合、顔は一致とは見なされず、 MatchingFaces プロパティは null 値を返します。

出力

MatchingFaces

元の画像の顔に一致する、ターゲット 画像内の顔の配列です。

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