Freigeben über


IFaceOperations.GroupWithHttpMessagesAsync Methode

Definition

Teilen Sie Kandidatengesichter basierend auf Gesichtsähnlichkeit in Gruppen auf.< Br/>

  • Die Ausgabe ist eine oder mehrere unzusammengelöste Gesichtsgruppen und eine ungeordnete Gruppe. Eine Gesichtsgruppe enthält Gesichter, die ähnlich aussehen, oft von derselben Person. Gesichtsgruppen werden nach Gruppengröße, d.h. der Anzahl der Gesichter, sortiert. Beachten Sie, dass Gesichter, die derselben Person gehören, im Ergebnis in mehrere Gruppen unterteilt werden können.
  • MessyGroup ist eine spezielle Gesichtsgruppe, die Gesichter enthält, die kein ähnliches Gegenstück von originalen Gesichtern finden können. Die messyGroup wird im Ergebnis nicht angezeigt, wenn alle Gesichter ihre Entsprechungen gefunden haben.
  • Die Gruppen-API benötigt mindestens 2 Kandidaten und maximal 1000 Gesichter. Es wird empfohlen, Face – Überprüfen Sie , wenn Sie nur 2 Kandidatengesichter haben.
  • Die faceIds "recognitionModel", die den FaceIds der Abfragegesichter zugeordnet sind, sollten identisch sein.
public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.GroupResult>> GroupWithHttpMessagesAsync (System.Collections.Generic.IList<Guid> faceIds, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);
abstract member GroupWithHttpMessagesAsync : System.Collections.Generic.IList<Guid> * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<Microsoft.Azure.CognitiveServices.Vision.Face.Models.GroupResult>>
Public Function GroupWithHttpMessagesAsync (faceIds As IList(Of Guid), Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpOperationResponse(Of GroupResult))

Parameter

faceIds
IList<Guid>

Array of Candidate FaceId created by Face – Detect. Das Maximum beträgt 1.000 Gesichter.

customHeaders
Dictionary<String,List<String>>

Die Header, die der Anforderung hinzugefügt werden.

cancellationToken
CancellationToken

Das Abbruchtoken.

Gibt zurück

Ausnahmen

Wird ausgelöst, wenn der Vorgang einen ungültigen status Code zurückgegeben hat.

Wird ausgelöst, wenn die Antwort nicht deserialisiert werden kann

Wird ausgelöst, wenn ein erforderlicher Parameter NULL ist

Gilt für: