Compare Faces

UiPath.AmazonRekognition.Activities.CompareFaces

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

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

概要

依存関係

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

属性

属性	詳細
入力 (変数)	String プロパティに適用されます。 SourceImagePath、SourceImageURL、TargetImagePath、 および TargetImageURL
出力 (変数)	FaceMatch[] プロパティに適用されます: [照合インターフェイス]
使用する API	Amazon Rekognition - CompareFaces
例	クイックスタート

プロパティ

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

共通

表示名

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

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

入力

SourceImagePath

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

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

SourceImageURL

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

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

TargetImagePath

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

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

TargetImageURL

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

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

その他

プライベート (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 ] を選択します。