FaceLists Schnittstelle

Paket:

com.microsoft.azure.cognitiveservices.vision.faceapi

public interface FaceLists

Ein instance dieser Klasse bietet Zugriff auf alle in FaceLists definierten Vorgänge.

Methodenzusammenfassung

Modifizierer und Typ	Methode und Beschreibung
FaceListsAddFaceFromStreamDefinitionStages.WithFaceListId	addFaceFromStream() Fügen Sie einer Gesichtsliste ein Gesicht hinzu. Die Eingabefläche wird als Bild mit einem TargetFace-Rechteck angegeben. Sie gibt eine persistedFaceId zurück, die das hinzugefügte Gesicht darstellt, und persistedFaceId läuft nicht ab.
PersistedFace	addFaceFromStream(String faceListId, byte[] image, AddFaceFromStreamOptionalParameter addFaceFromStreamOptionalParameter) Fügen Sie einer Gesichtsliste ein Gesicht hinzu. Die Eingabefläche wird als Bild mit einem TargetFace-Rechteck angegeben. Sie gibt eine persistedFaceId zurück, die das hinzugefügte Gesicht darstellt, und persistedFaceId läuft nicht ab.
Observable<PersistedFace>	addFaceFromStreamAsync(String faceListId, byte[] image, AddFaceFromStreamOptionalParameter addFaceFromStreamOptionalParameter) Fügen Sie einer Gesichtsliste ein Gesicht hinzu. Die Eingabefläche wird als Bild mit einem targetFace-Rechteck angegeben. Es gibt eine persistedFaceId zurück, die das hinzugefügte Gesicht darstellt, und persistedFaceId läuft nicht ab.
FaceListsAddFaceFromUrlDefinitionStages.WithFaceListId	addFaceFromUrl() Fügen Sie einer Gesichtsliste ein Gesicht hinzu. Die Eingabefläche wird als Bild mit einem targetFace-Rechteck angegeben. Es gibt eine persistedFaceId zurück, die das hinzugefügte Gesicht darstellt, und persistedFaceId läuft nicht ab.
PersistedFace	addFaceFromUrl(String faceListId, String url, AddFaceFromUrlOptionalParameter addFaceFromUrlOptionalParameter) Fügen Sie einer Gesichtsliste ein Gesicht hinzu. Die Eingabefläche wird als Bild mit einem targetFace-Rechteck angegeben. Es gibt eine persistedFaceId zurück, die das hinzugefügte Gesicht darstellt, und persistedFaceId läuft nicht ab.
Observable<PersistedFace>	addFaceFromUrlAsync(String faceListId, String url, AddFaceFromUrlOptionalParameter addFaceFromUrlOptionalParameter) Fügen Sie einer Gesichtsliste ein Gesicht hinzu. Die Eingabefläche wird als Bild mit einem targetFace-Rechteck angegeben. Es gibt eine persistedFaceId zurück, die das hinzugefügte Gesicht darstellt, und persistedFaceId läuft nicht ab.
FaceListsCreateDefinitionStages.WithFaceListId	create() Erstellen Sie eine leere Gesichtsliste. In einem Abonnement dürfen bis zu 64 Gesichtslisten vorhanden sein.
void	create(String faceListId, CreateFaceListsOptionalParameter createOptionalParameter) Erstellen Sie eine leere Gesichtsliste. In einem Abonnement dürfen bis zu 64 Gesichtslisten vorhanden sein.
Observable<Void>	createAsync(String faceListId, CreateFaceListsOptionalParameter createOptionalParameter) Erstellen Sie eine leere Gesichtsliste. In einem Abonnement dürfen bis zu 64 Gesichtslisten vorhanden sein.
void	delete(String faceListId) Löschen Sie eine vorhandene Gesichtsliste gemäß faceListId. Beibehaltene Gesichtsbilder in der Gesichtserkennungsliste werden ebenfalls gelöscht.
Observable<Void>	deleteAsync(String faceListId) Löschen Sie eine vorhandene Gesichtsliste gemäß faceListId. Beibehaltene Gesichtsbilder in der Gesichtserkennungsliste werden ebenfalls gelöscht.
void	deleteFace(String faceListId, UUID persistedFaceId) Löschen Sie ein vorhandenes Gesicht aus einer Gesichtsliste (angegeben durch eine persisitedFaceId und eine faceListId). Persistente Bilder, die sich auf das Gesicht beziehen, werden ebenfalls gelöscht.
Observable<Void>	deleteFaceAsync(String faceListId, UUID persistedFaceId) Löschen Sie ein vorhandenes Gesicht aus einer Gesichtsliste (angegeben durch eine persisitedFaceId und eine faceListId). Persistente Bilder, die sich auf das Gesicht beziehen, werden ebenfalls gelöscht.
FaceList	get(String faceListId) Ruft die Informationen einer Gesichtsliste ab.
Observable<FaceList>	getAsync(String faceListId) Ruft die Informationen einer Gesichtsliste ab.
List<FaceList>	list() Ruft Informationen zu allen vorhandenen Gesichtslisten ab. Nur faceListId, name und userData werden zurückgegeben.
Observable<List<FaceList>>	listAsync() Ruft Informationen zu allen vorhandenen Gesichtslisten ab. Nur faceListId, name und userData werden zurückgegeben.
FaceListsUpdateDefinitionStages.WithFaceListId	update() Aktualisieren sie die Informationen einer Gesichtsliste.
void	update(String faceListId, UpdateFaceListsOptionalParameter updateOptionalParameter) Aktualisieren sie die Informationen einer Gesichtsliste.
Observable<Void>	updateAsync(String faceListId, UpdateFaceListsOptionalParameter updateOptionalParameter) Aktualisieren der Informationen einer Gesichtserkennungsliste.

Details zur Methode

addFaceFromStream

public FaceListsAddFaceFromStreamDefinitionStages.WithFaceListId addFaceFromStream()

Fügen Sie einer Gesichtsliste ein Gesicht hinzu. Die Eingabefläche wird als Bild mit einem TargetFace-Rechteck angegeben. Sie gibt eine persistedFaceId zurück, die das hinzugefügte Gesicht darstellt, und persistedFaceId läuft nicht ab.

Returns:

die erste Phase des addFaceFromStream-Aufrufs

addFaceFromStream

public PersistedFace addFaceFromStream(String faceListId, byte[] image, AddFaceFromStreamOptionalParameter addFaceFromStreamOptionalParameter)

Fügen Sie einer Gesichtsliste ein Gesicht hinzu. Die Eingabefläche wird als Bild mit einem TargetFace-Rechteck angegeben. Sie gibt eine persistedFaceId zurück, die das hinzugefügte Gesicht darstellt, und persistedFaceId läuft nicht ab.

Parameters:

faceListId - Id, die auf eine bestimmte Gesichtsliste verweist.

image - Ein Bildstream.

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

Returns:

das PersistedFace-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

addFaceFromStreamAsync

public Observable addFaceFromStreamAsync(String faceListId, byte[] image, AddFaceFromStreamOptionalParameter addFaceFromStreamOptionalParameter)

Fügen Sie einer Gesichtsliste ein Gesicht hinzu. Die Eingabefläche wird als Bild mit einem targetFace-Rechteck angegeben. Es gibt eine persistedFaceId zurück, die das hinzugefügte Gesicht darstellt, und persistedFaceId läuft nicht ab.

Parameters:

faceListId - Id, die auf eine bestimmte Gesichtsliste verweist.

image - Ein Bildstream.

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

Returns:

die für das PersistedFace-Objekt erkennbar ist

Throws:

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

addFaceFromUrl

public FaceListsAddFaceFromUrlDefinitionStages.WithFaceListId addFaceFromUrl()

Fügen Sie einer Gesichtsliste ein Gesicht hinzu. Die Eingabefläche wird als Bild mit einem targetFace-Rechteck angegeben. Es gibt eine persistedFaceId zurück, die das hinzugefügte Gesicht darstellt, und persistedFaceId läuft nicht ab.

Returns:

die erste Phase des addFaceFromUrl-Aufrufs

addFaceFromUrl

public PersistedFace addFaceFromUrl(String faceListId, String url, AddFaceFromUrlOptionalParameter addFaceFromUrlOptionalParameter)

Fügen Sie einer Gesichtsliste ein Gesicht hinzu. Die Eingabefläche wird als Bild mit einem targetFace-Rechteck angegeben. Es gibt eine persistedFaceId zurück, die das hinzugefügte Gesicht darstellt, und persistedFaceId läuft nicht ab.

Parameters:

faceListId - Id, die auf eine bestimmte Gesichtsliste verweist.

url - Öffentlich zugängliche URL eines Bilds.

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

Returns:

das PersistedFace-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

addFaceFromUrlAsync

public Observable addFaceFromUrlAsync(String faceListId, String url, AddFaceFromUrlOptionalParameter addFaceFromUrlOptionalParameter)

Fügen Sie einer Gesichtsliste ein Gesicht hinzu. Die Eingabefläche wird als Bild mit einem targetFace-Rechteck angegeben. Es gibt eine persistedFaceId zurück, die das hinzugefügte Gesicht darstellt, und persistedFaceId läuft nicht ab.

Parameters:

faceListId - Id, die auf eine bestimmte Gesichtsliste verweist.

url - Öffentlich zugängliche URL eines Bilds.

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

Returns:

die für das PersistedFace-Objekt erkennbar ist

Throws:

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

create

public FaceListsCreateDefinitionStages.WithFaceListId create()

Erstellen Sie eine leere Gesichtsliste. In einem Abonnement dürfen bis zu 64 Gesichtslisten vorhanden sein.

Returns:

die erste Phase des Create-Aufrufs

create

public void create(String faceListId, CreateFaceListsOptionalParameter createOptionalParameter)

Erstellen Sie eine leere Gesichtsliste. In einem Abonnement dürfen bis zu 64 Gesichtslisten vorhanden sein.

Parameters:

faceListId - Id, die auf eine bestimmte Gesichtsliste verweist.

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

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

createAsync

public Observable createAsync(String faceListId, CreateFaceListsOptionalParameter createOptionalParameter)

Erstellen Sie eine leere Gesichtsliste. In einem Abonnement dürfen bis zu 64 Gesichtslisten vorhanden sein.

Parameters:

faceListId - Id, die auf eine bestimmte Gesichtsliste verweist.

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

Returns:

eine Darstellung der verzögerten Berechnung dieses Aufrufs bei erfolgreicher Ausführung.

Throws:

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

delete

public void delete(String faceListId)

Löschen Sie eine vorhandene Gesichtsliste gemäß faceListId. Beibehaltene Gesichtsbilder in der Gesichtserkennungsliste werden ebenfalls gelöscht.

Parameters:

faceListId - Id, die auf eine bestimmte Gesichtsliste verweist.

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

deleteAsync

public Observable deleteAsync(String faceListId)

Löschen Sie eine vorhandene Gesichtsliste gemäß faceListId. Beibehaltene Gesichtsbilder in der Gesichtserkennungsliste werden ebenfalls gelöscht.

Parameters:

faceListId - Id, die auf eine bestimmte Gesichtsliste verweist.

Returns:

eine Darstellung der verzögerten Berechnung dieses Aufrufs bei erfolgreicher Ausführung.

Throws:

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

deleteFace

public void deleteFace(String faceListId, UUID persistedFaceId)

Löschen Sie ein vorhandenes Gesicht aus einer Gesichtsliste (angegeben durch eine persisitedFaceId und eine faceListId). Persistente Bilder, die sich auf das Gesicht beziehen, werden ebenfalls gelöscht.

Parameters:

faceListId - Id, die auf eine bestimmte Gesichtsliste verweist.

persistedFaceId - Id, die auf eine bestimmte persistedFaceId eines vorhandenen Gesichts verweist.

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

deleteFaceAsync

public Observable deleteFaceAsync(String faceListId, UUID persistedFaceId)

Löschen Sie ein vorhandenes Gesicht aus einer Gesichtsliste (angegeben durch eine persisitedFaceId und eine faceListId). Persistente Bilder, die sich auf das Gesicht beziehen, werden ebenfalls gelöscht.

Parameters:

faceListId - Id, die auf eine bestimmte Gesichtsliste verweist.

persistedFaceId - Id, die auf eine bestimmte persistedFaceId eines vorhandenen Gesichts verweist.

Returns:

eine Darstellung der verzögerten Berechnung dieses Aufrufs bei erfolgreicher Ausführung.

Throws:

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

get

public FaceList get(String faceListId)

Ruft die Informationen einer Gesichtsliste ab.

Parameters:

faceListId - Id, die auf eine bestimmte Gesichtsliste verweist.

Returns:

das FaceList-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

getAsync

public Observable getAsync(String faceListId)

Ruft die Informationen einer Gesichtsliste ab.

Parameters:

faceListId - Id, die auf eine bestimmte Gesichtsliste verweist.

Returns:

das für das FaceList-Objekt beobachtbare

Throws:

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

list

public List list()

Ruft Informationen zu allen vorhandenen Gesichtslisten ab. Nur faceListId, name und userData werden zurückgegeben.

Returns:

das List<FaceList-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

listAsync

public Observable<>> listAsync()

Ruft Informationen zu allen vorhandenen Gesichtslisten ab. Nur faceListId, name und userData werden zurückgegeben.

Returns:

das mit dem List<FaceList-Objekt> beobachtbare

Throws:

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

update

public FaceListsUpdateDefinitionStages.WithFaceListId update()

Aktualisieren sie die Informationen einer Gesichtsliste.

Returns:

die erste Phase des Updateaufrufs

update

public void update(String faceListId, UpdateFaceListsOptionalParameter updateOptionalParameter)

Aktualisieren sie die Informationen einer Gesichtsliste.

Parameters:

faceListId - Id, die auf eine bestimmte Gesichtsliste verweist.

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

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

updateAsync

public Observable updateAsync(String faceListId, UpdateFaceListsOptionalParameter updateOptionalParameter)

Aktualisieren der Informationen einer Gesichtserkennungsliste.

Parameters:

faceListId - Id, die auf eine bestimmte Gesichtsliste verweist.

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

Returns:

eine Darstellung der verzögerten Berechnung dieses Aufrufs bei erfolgreicher Ausführung.

Throws:

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