Identify Face

UiPath.AmazonRekognition.Activities.AddFace

Die Aktivität Identify Face verwendet die Amazon Rekognition SearchFacesByImage- API, um zuerst das größte Gesicht in Ihrem Eingabebild (ImagePath oder ImageURL) zu erkennen und dann die angegebene Sammlung (Collection) nach übereinstimmenden Gesichtern zu durchsuchen. Die Aktivität vergleicht die Merkmale des EingabeGesichts mit den Gesichtern in der Sammlung und gibt ein Array von Gesichtern (Faces) aus, die mit Ihrem Eingabebild übereinstimmen.

Zusammenfassung

Abhängigkeiten

Abhängigkeit	Details
Pakete	UiPath.Amazon.Rekognition.Activities
Aktivitäten	Amazon Scope Sammlung erstellen (es sei denn, es ist bereits eine Sammlung vorhanden) Gesicht hinzufügen (wenn die Sammlung nicht bereits die Gesichter enthält, die Sie identifizieren möchten)

Attribute

Attribut	Details
Eingabedatentypen (Variablen)	String Gilt für folgende Eigenschaft: ImagePath,ImageURL und CollectionName
Ausgabedatentypen (Variablen)	Faces[] Gilt für Eigenschaft: Gesichter Weitere Informationen finden Sie unter dem Datentyp Face in der Amazon Rekognition API-Dokumentation.
Verwendete API	Amazon Rekognition – SearchFacesByImage
Beispiele	Schnellstart

Eigenschaften

Die Werte für die folgenden Eigenschaften werden beim Hinzufügen dieser Aktivität zu Ihrem Projekt in UiPath Studio angegeben.

Allgemein

DisplayName

Der Anzeigename der Aktivität.

Attribute	Details
Typ	String
Erforderlich	Ja
Standardwert	Identify Face
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Keine Angabe

Eingabe

CollectionName

Der Name oder die ID einer vorhandenen Sammlung, die Sie zum Identifizieren erkannter Gesichter verwenden möchten.

Attribute	Details
Typ	String
Erforderlich	Ja
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Wenn Sie bereits eine Sammlung haben, die Sie verwenden möchten, geben Sie den genauen Sammlungsnamen ein. Es gibt keine Aktivität zum Abrufen einer Liste Ihrer Sammlungsnamen, aber Sie können die ListCollections- API direkt über die AWS CLI oder AWS SDK API aufrufen.

Bildpfad

Der Pfad zu einem lokalen Bild, das Sie analysieren möchten.

Attribute	Details
Typ	String
Erforderlich	Ja (wenn die Bild-URL leer ist)
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Entweder die Eigenschaft Bildpfad oder BildURL ist erforderlich. Wenn Sie Werte sowohl für Bildpfad als auch für BildURL eingeben, wird der Wert für Bildpfad verwendet.

BildURL

Die URL eines Bilds, das Sie analysieren möchten.

Attribute	Details
Typ	String
Erforderlich	Ja (wenn ImagePath leer ist)
Standardwert	Leer
Zulässige Werte	Geben Sie eine String oder String -Variable ein.
Hinweise	Entweder die Eigenschaft Bildpfad oder BildURL ist erforderlich. Wenn Sie Werte sowohl für Bildpfad als auch für BildURL eingeben, wird der Wert für Bildpfad verwendet.

Sonstiges

Private

Falls ausgewählt werden die Werte von Variablen und Argumenten nicht mehr auf ausführlicher Ebene protokolliert.

Attribute	Details
Typ	Kontrollkästchen
Erforderlich	Nein
Standardwert	nicht ausgewählt
Zulässige Werte	Ausgewählt oder nicht ausgewählt
Hinweise	Keine Angabe

Optionen

Confidence

Der minimale Konfidenzwert (d. h. Prozentsatz der Ähnlichkeit), für den die Gesichter als übereinstimmend betrachtet werden.

Attribute	Details
Typ	Double
Erforderlich	Nein
Standardwert	0,70 (nicht in der Eigenschaft angezeigt)
Zulässige Werte	Geben Sie eine Zahl zwischen 0 und 1 ein, um den prozentualen Anteil der Ähnlichkeit anzugeben (geben Sie z. B. 0,8 ein, wenn die Ähnlichkeit 80 % betragen soll).
Hinweise	Wenn diese Eigenschaft festgelegt ist, gibt die Eigenschaft „ Gesichter “ nur die Gesichter zurück, die den angegebenen Wert erfüllen oder überschreiten Beispiel: Wenn Sie den Wert .8 eingeben, werden die Gesichter im ImagePath- oder ImageURL -Bild als gegenüber den Gesichtern in der Sammlung identifiziert, wenn die Aktivität ein Konfidenzniveau von .8 oder höher zurückgibt. Wenn die Aktivität ein Konfidenzniveau von weniger als 0,8 zurückgibt, gelten die Gesichter als nicht identifiziert, und die Faces -Eigenschaft gibt einen NULL-Wert zurück.

MaxErgebnisse

Die maximale Anzahl von Gesichtern, die die Aktivität in der Antwort zurückgeben soll.

Attribute	Details
Typ	Int32
Erforderlich	Nein
Standardwert	Leer
Zulässige Werte	Geben Sie eine Int32 oder Int32 -Variable ein.
Hinweise	Keine Angabe

Ausgabe

Gesichter

Ein Array von Gesichtern, die mit dem im Eingabebild angegebenen Gesicht übereinstimmen.

Attribute	Details
Typ	Face[] UiPath.Amazon.Rekognition.Models.Face[]
Erforderlich	Nein (empfohlen, wenn Sie die Ausgabedaten in nachfolgenden Aktivitäten verwenden möchten)
Standardwert	Leer
Zulässige Werte	Geben Sie Ihren Wert als Face[] -Variable ein.
Hinweise	Wenn der Wert für Konfidenz festgelegt ist, enthält das Array nur die Gesichter, die die angegebene Ähnlichkeit erfüllen oder übertreffen. Wenn Sie die Aktivität For Each zum Verarbeiten der Array-Ausgabe verwenden möchten, wählen Sie UiPath.Amazon.Rekognition.Models.Face als Argumenttyp aus.