Faces Schnittstelle

Paket:

com.microsoft.azure.cognitiveservices.vision.faceapi

public interface Faces

Eine instance dieser Klasse bietet Zugriff auf alle in Gesichter definierten Vorgänge.

Methodenzusammenfassung

Modifizierer und Typ	Methode und Beschreibung
FacesDetectWithStreamDefinitionStages.WithImage	detectWithStream() Erkennen sie menschliche Gesichter in einem Bild und gibt Gesichtspositionen zurück, und optional mit faceIds, Wahrzeichen und Attributen.
List<DetectedFace>	detectWithStream(byte[] image, DetectWithStreamOptionalParameter detectWithStreamOptionalParameter) Erkennen sie menschliche Gesichter in einem Bild und gibt Gesichtspositionen zurück, und optional mit faceIds, Wahrzeichen und Attributen.
Observable<List<DetectedFace>>	detectWithStreamAsync(byte[] image, DetectWithStreamOptionalParameter detectWithStreamOptionalParameter) Erkennen sie menschliche Gesichter in einem Bild und gibt Gesichtspositionen zurück, und optional mit faceIds, Wahrzeichen und Attributen.
FacesDetectWithUrlDefinitionStages.WithUrl	detectWithUrl() Erkennen sie menschliche Gesichter in einem Bild und gibt Gesichtspositionen zurück, und optional mit faceIds, Wahrzeichen und Attributen.
List<DetectedFace>	detectWithUrl(String url, DetectWithUrlOptionalParameter detectWithUrlOptionalParameter) Erkennen sie menschliche Gesichter in einem Bild und gibt Gesichtspositionen zurück, und optional mit faceIds, Wahrzeichen und Attributen.
Observable<List<DetectedFace>>	detectWithUrlAsync(String url, DetectWithUrlOptionalParameter detectWithUrlOptionalParameter) Erkennen sie menschliche Gesichter in einem Bild und gibt Gesichtspositionen zurück, und optional mit faceIds, Wahrzeichen und Attributen.
FacesFindSimilarDefinitionStages.WithFaceId	findSimilar() Suchen Sie bei der faceId der Abfrage nach den ähnlich aussehenden Gesichtern aus einem faceId-Array oder einer faceListId.
List<SimilarFace>	findSimilar(UUID faceId, FindSimilarOptionalParameter findSimilarOptionalParameter) Suchen Sie bei der faceId der Abfrage nach den ähnlich aussehenden Gesichtern aus einem faceId-Array oder einer faceListId.
Observable<List<SimilarFace>>	findSimilarAsync(UUID faceId, FindSimilarOptionalParameter findSimilarOptionalParameter) Suchen Sie bei der faceId der Abfrage nach den ähnlich aussehenden Gesichtern aus einem faceId-Array oder einer faceListId.
GroupResult	group(List<UUID> faceIds) Hiermit unterteilen Sie die Gesichter der Kandidaten basierend auf der Gesichterähnlichkeit in Gruppen.
Observable<GroupResult>	groupAsync(List<UUID> faceIds) Hiermit unterteilen Sie die Gesichter der Kandidaten basierend auf der Gesichterähnlichkeit in Gruppen.
FacesIdentifyDefinitionStages.WithPersonGroupId	identify() Identifizieren Sie unbekannte Gesichter aus einer Personengruppe.
List<IdentifyResult>	identify(String personGroupId, List<UUID> faceIds, IdentifyOptionalParameter identifyOptionalParameter) Identifizieren Sie unbekannte Gesichter aus einer Personengruppe.
Observable<List<IdentifyResult>>	identifyAsync(String personGroupId, List<UUID> faceIds, IdentifyOptionalParameter identifyOptionalParameter) Identifizieren Sie unbekannte Gesichter aus einer Personengruppe.
VerifyResult	verifyFaceToFace(UUID faceId1, UUID faceId2) Hiermit überprüfen Sie, ob zwei Gesichter zu derselben Person gehören oder ob je ein Gesicht zu einer Person gehört.
Observable<VerifyResult>	verifyFaceToFaceAsync(UUID faceId1, UUID faceId2) Hiermit überprüfen Sie, ob zwei Gesichter zu derselben Person gehören oder ob je ein Gesicht zu einer Person gehört.
VerifyResult	verifyFaceToPerson(UUID faceId, String personGroupId, UUID personId) Überprüfen Sie, ob zwei Gesichter zu derselben Person gehören. Vergleicht eine Gesichts-ID mit einer Personen-ID.
Observable<VerifyResult>	verifyFaceToPersonAsync(UUID faceId, String personGroupId, UUID personId) Überprüfen Sie, ob zwei Gesichter zu derselben Person gehören. Vergleicht eine Gesichts-ID mit einer Personen-ID.

Details zur Methode

detectWithStream

public FacesDetectWithStreamDefinitionStages.WithImage detectWithStream()

Erkennen sie menschliche Gesichter in einem Bild und gibt Gesichtspositionen zurück, und optional mit faceIds, Wahrzeichen und Attributen.

Returns:

die erste Phase des detectWithStream-Aufrufs

detectWithStream

public List detectWithStream(byte[] image, DetectWithStreamOptionalParameter detectWithStreamOptionalParameter)

Erkennen sie menschliche Gesichter in einem Bild und gibt Gesichtspositionen zurück, und optional mit faceIds, Wahrzeichen und Attributen.

Parameters:

image - Ein Bildstream.

detectWithStreamOptionalParameter - das -Objekt, das die optionalen Parameter darstellt, die vor dem Aufruf dieser API festgelegt werden sollen

Returns:

das List<DetectedFace-Objekt> , wenn erfolgreich.

Throws:

IllegalArgumentException - wird ausgelöst, wenn parameter bei der Überprüfung fehlschlagen

APIErrorException - wird ausgelöst, wenn die Anforderung vom Server abgelehnt wird.

RuntimeException - alle anderen umschlossenen überprüften Ausnahmen, wenn die Anforderung nicht gesendet werden kann

detectWithStreamAsync

public Observable> detectWithStreamAsync(byte[] image, DetectWithStreamOptionalParameter detectWithStreamOptionalParameter)

Erkennen sie menschliche Gesichter in einem Bild und gibt Gesichtspositionen zurück, und optional mit faceIds, Wahrzeichen und Attributen.

Parameters:

image - Ein Bildstream.

detectWithStreamOptionalParameter - das -Objekt, das die optionalen Parameter darstellt, die vor dem Aufruf dieser API festgelegt werden sollen

Returns:

die für das List<DetectedFace-Objekt> erkennbare

Throws:

IllegalArgumentException - wird ausgelöst, wenn parameter bei der Überprüfung fehlschlagen

detectWithUrl

public FacesDetectWithUrlDefinitionStages.WithUrl detectWithUrl()

Erkennen sie menschliche Gesichter in einem Bild und gibt Gesichtspositionen zurück, und optional mit faceIds, Wahrzeichen und Attributen.

Returns:

die erste Phase des detectWithUrl-Aufrufs

detectWithUrl

public List detectWithUrl(String url, DetectWithUrlOptionalParameter detectWithUrlOptionalParameter)

Erkennen sie menschliche Gesichter in einem Bild und gibt Gesichtspositionen zurück, und optional mit faceIds, Wahrzeichen und Attributen.

Parameters:

url - Öffentlich erreichbare URL eines Bilds.

detectWithUrlOptionalParameter - das -Objekt, das die optionalen Parameter darstellt, die vor dem Aufruf dieser API festgelegt werden sollen

Returns:

das List<DetectedFace-Objekt> , wenn erfolgreich.

Throws:

IllegalArgumentException - wird ausgelöst, wenn parameter bei der Überprüfung fehlschlagen

APIErrorException - wird ausgelöst, wenn die Anforderung vom Server abgelehnt wird.

RuntimeException - alle anderen umschlossenen überprüften Ausnahmen, wenn die Anforderung nicht gesendet werden kann

detectWithUrlAsync

public Observable> detectWithUrlAsync(String url, DetectWithUrlOptionalParameter detectWithUrlOptionalParameter)

Erkennen sie menschliche Gesichter in einem Bild und gibt Gesichtspositionen zurück, und optional mit faceIds, Wahrzeichen und Attributen.

Parameters:

url - Öffentlich erreichbare URL eines Bilds.

detectWithUrlOptionalParameter - das -Objekt, das die optionalen Parameter darstellt, die vor dem Aufruf dieser API festgelegt werden sollen

Returns:

die für das List<DetectedFace-Objekt> erkennbare

Throws:

IllegalArgumentException - wird ausgelöst, wenn parameter bei der Überprüfung fehlschlagen

findSimilar

public FacesFindSimilarDefinitionStages.WithFaceId findSimilar()

Suchen Sie bei der faceId der Abfrage nach den ähnlich aussehenden Gesichtern aus einem faceId-Array oder einer faceListId.

Returns:

die erste Phase des findSimilar-Aufrufs

findSimilar

public List findSimilar(UUID faceId, FindSimilarOptionalParameter findSimilarOptionalParameter)

Suchen Sie bei der faceId der Abfrage nach den ähnlich aussehenden Gesichtern aus einem faceId-Array oder einer faceListId.

Parameters:

faceId - FaceId des Abfragegesichts. Der Benutzer muss zuerst Face – Detect aufrufen, um eine gültige faceId zu erhalten. Beachten Sie, dass diese faceId nicht beibehalten wird und 24 Stunden nach dem Erkennungsaufruf abläuft.

findSimilarOptionalParameter - das -Objekt, das die optionalen Parameter darstellt, die vor dem Aufruf dieser API festgelegt werden sollen

Returns:

das SimilarFace-Objekt> auflisten<, wenn erfolgreich.

Throws:

IllegalArgumentException - wird ausgelöst, wenn parameter bei der Überprüfung fehlschlagen

APIErrorException - wird ausgelöst, wenn die Anforderung vom Server abgelehnt wird.

RuntimeException - alle anderen umschlossenen überprüften Ausnahmen, wenn die Anforderung nicht gesendet werden kann

findSimilarAsync

public Observable> findSimilarAsync(UUID faceId, FindSimilarOptionalParameter findSimilarOptionalParameter)

Suchen Sie bei der faceId der Abfrage nach den ähnlich aussehenden Gesichtern aus einem faceId-Array oder einer faceListId.

Parameters:

faceId - FaceId des Abfragegesichts. Der Benutzer muss zuerst Face – Detect aufrufen, um eine gültige faceId zu erhalten. Beachten Sie, dass diese faceId nicht beibehalten wird und 24 Stunden nach dem Erkennungsaufruf abläuft.

findSimilarOptionalParameter - das -Objekt, das die optionalen Parameter darstellt, die vor dem Aufruf dieser API festgelegt werden sollen

Returns:

für das List<SimilarFace-Objekt> sichtbar ist

Throws:

IllegalArgumentException - wird ausgelöst, wenn parameter bei der Überprüfung fehlschlagen

group

public GroupResult group(List faceIds)

Hiermit unterteilen Sie die Gesichter der Kandidaten basierend auf der Gesichterähnlichkeit in Gruppen.

Parameters:

faceIds - Array von Candidate faceId erstellt von Face – Detect. Der Höchstwert beträgt 1.000 Gesichter.

Returns:

das GroupResult-Objekt, wenn erfolgreich.

Throws:

IllegalArgumentException - wird ausgelöst, wenn parameter bei der Überprüfung fehlschlagen

APIErrorException - wird ausgelöst, wenn die Anforderung vom Server abgelehnt wird.

RuntimeException - alle anderen umschlossenen überprüften Ausnahmen, wenn die Anforderung nicht gesendet werden kann

groupAsync

public Observable groupAsync(List faceIds)

Hiermit unterteilen Sie die Gesichter der Kandidaten basierend auf der Gesichterähnlichkeit in Gruppen.

Parameters:

faceIds - Array von Candidate faceId erstellt von Face – Detect. Der Höchstwert beträgt 1.000 Gesichter.

Returns:

die für das GroupResult-Objekt beobachtbare

Throws:

IllegalArgumentException - wird ausgelöst, wenn parameter bei der Überprüfung fehlschlagen

identify

public FacesIdentifyDefinitionStages.WithPersonGroupId identify()

Identifizieren Sie unbekannte Gesichter aus einer Personengruppe.

Returns:

die erste Phase des Anrufs identifizieren

identify

public List identify(String personGroupId, List faceIds, IdentifyOptionalParameter identifyOptionalParameter)

Identifizieren Sie unbekannte Gesichter aus einer Personengruppe.

Parameters:

personGroupId - PersonGroupId der Zielpersonsgruppe, erstellt von PersonGroups.Create.

faceIds - Array von Abfragegesichts-FaceIds, erstellt von Face – Detect. Jedes der Gesichter wird unabhängig voneinander identifiziert. Die gültige Anzahl von faceIds liegt zwischen [1, 10].

identifyOptionalParameter - das Objekt, das die optionalen Parameter darstellt, die vor dem Aufrufen dieser API festgelegt werden sollen

Returns:

das List<IdentifyResult-Objekt> , falls erfolgreich.

Throws:

IllegalArgumentException - wird ausgelöst, wenn parameter bei der Überprüfung fehlschlagen

APIErrorException - wird ausgelöst, wenn die Anforderung vom Server abgelehnt wird.

RuntimeException - alle anderen umschlossenen überprüften Ausnahmen, wenn die Anforderung nicht gesendet werden kann

identifyAsync

public Observable> identifyAsync(String personGroupId, List faceIds, IdentifyOptionalParameter identifyOptionalParameter)

Identifizieren Sie unbekannte Gesichter aus einer Personengruppe.

Parameters:

personGroupId - PersonGroupId der Zielpersonsgruppe, erstellt von PersonGroups.Create.

faceIds - Array von Abfragegesichts-FaceIds, erstellt von Face – Detect. Jedes der Gesichter wird unabhängig voneinander identifiziert. Die gültige Anzahl von faceIds liegt zwischen [1, 10].

identifyOptionalParameter - das Objekt, das die optionalen Parameter darstellt, die vor dem Aufrufen dieser API festgelegt werden sollen

Returns:

das für das List<IdentifyResult-Objekt> beobachtbare

Throws:

IllegalArgumentException - wird ausgelöst, wenn parameter bei der Überprüfung fehlschlagen

verifyFaceToFace

public VerifyResult verifyFaceToFace(UUID faceId1, UUID faceId2)

Hiermit überprüfen Sie, ob zwei Gesichter zu derselben Person gehören oder ob je ein Gesicht zu einer Person gehört.

Parameters:

faceId1 - FaceId des ersten Gesichts stammt von Face - Detect.

faceId2 - FaceId des zweiten Gesichts stammt von Face - Detect.

Returns:

das VerifyResult-Objekt, falls erfolgreich.

Throws:

IllegalArgumentException - wird ausgelöst, wenn parameter bei der Überprüfung fehlschlagen

APIErrorException - wird ausgelöst, wenn die Anforderung vom Server abgelehnt wird.

RuntimeException - alle anderen umschlossenen überprüften Ausnahmen, wenn die Anforderung nicht gesendet werden kann

verifyFaceToFaceAsync

public Observable verifyFaceToFaceAsync(UUID faceId1, UUID faceId2)

Hiermit überprüfen Sie, ob zwei Gesichter zu derselben Person gehören oder ob je ein Gesicht zu einer Person gehört.

Parameters:

faceId1 - FaceId des ersten Gesichts stammt von Face - Detect.

faceId2 - FaceId des zweiten Gesichts stammt von Face - Detect.

Returns:

die für das VerifyResult-Objekt beobachtbare

Throws:

IllegalArgumentException - wird ausgelöst, wenn parameter bei der Überprüfung fehlschlagen

verifyFaceToPerson

public VerifyResult verifyFaceToPerson(UUID faceId, String personGroupId, UUID personId)

Überprüfen Sie, ob zwei Gesichter zu derselben Person gehören. Vergleicht eine Gesichts-ID mit einer Personen-ID.

Parameters:

faceId - FaceId das Gesicht, stammt von Face - Detect.

personGroupId - Verwenden vorhandener personGroupId und personId zum schnellen Laden einer angegebenen Person. personGroupId wird in Person Groups.Create erstellt.

personId - Geben Sie eine bestimmte Person in einer Personengruppe an. personId wird in Persons.Create erstellt.

Returns:

das VerifyResult-Objekt, falls erfolgreich.

Throws:

IllegalArgumentException - wird ausgelöst, wenn parameter bei der Überprüfung fehlschlagen

APIErrorException - wird ausgelöst, wenn die Anforderung vom Server abgelehnt wird.

RuntimeException - alle anderen umschlossenen überprüften Ausnahmen, wenn die Anforderung nicht gesendet werden kann

verifyFaceToPersonAsync

public Observable verifyFaceToPersonAsync(UUID faceId, String personGroupId, UUID personId)

Überprüfen Sie, ob zwei Gesichter zu derselben Person gehören. Vergleicht eine Gesichts-ID mit einer Personen-ID.

Parameters:

faceId - FaceId das Gesicht, stammt von Face - Detect.

personGroupId - Verwenden vorhandener personGroupId und personId zum schnellen Laden einer angegebenen Person. personGroupId wird in Person Groups.Create erstellt.

personId - Geben Sie eine bestimmte Person in einer Personengruppe an. personId wird in Persons.Create erstellt.

Returns:

die für das VerifyResult-Objekt beobachtbare

Throws:

IllegalArgumentException - wird ausgelöst, wenn parameter bei der Überprüfung fehlschlagen