Freigeben über


FaceOperations.FindSimilarWithHttpMessagesAsync Methode

Definition

Hiermit können Sie anhand der faceId des abgefragten Gesichts ähnliche Gesichter aus einem faceId-Array, einer Gesichterliste oder einer umfangreichen Gesichterliste suchen. das faceId-Array enthält die von Face – Detect erstellten Gesichter, die 24 Stunden nach der Erstellung ablaufen. Eine "faceListId" wird von FaceList – Create erstellt, die persistedFaceIds enthält, die nicht ablaufen. Und eine "largeFaceListId" wird von LargeFaceList erstellt– Create mit persistedFaceIds, die ebenfalls nicht ablaufen. Abhängig von der Eingabe enthält die zurückgegebene Liste ähnlicher Gesichter faceIds oder persistedFaceIds, die nach Ähnlichkeit sortiert werden. <br/>Find similar hat zwei Arbeitsmodi, "matchPerson" und "matchFace". "matchPerson" ist der Standardmodus, in dem versucht wird, Gesichter derselben Person wie möglich mithilfe interner Schwellenwerte derselben Person zu finden. Es ist nützlich, die anderen Fotos einer bekannten Person zu finden. Beachten Sie, dass eine leere Liste zurückgegeben wird, wenn keine Gesichter die internen Schwellenwerte überschreiten. Der "matchFace"-Modus ignoriert Schwellenwerte für die gleiche Person und gibt trotzdem ranggleiche Gesichter zurück, selbst wenn die Ähnlichkeit gering ist. Es kann in Fällen verwendet werden, wie z. B. das Durchsuchen von Prominenten aussehenden Gesichtern. <br/>Das "recognitionModel", das der faceId der Abfragegesicht zugeordnet ist, sollte mit dem "recognitionModel" identisch sein, das vom FaceId-Array, der Gesichtsliste oder der großen Gesichtsliste des Ziels verwendet wird.

public System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<System.Collections.Generic.IList<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SimilarFace>>> FindSimilarWithHttpMessagesAsync (Guid faceId, string faceListId = default, string largeFaceListId = default, System.Collections.Generic.IList<Guid?> faceIds = default, int? maxNumOfCandidatesReturned = 20, Microsoft.Azure.CognitiveServices.Vision.Face.Models.FindSimilarMatchMode mode = Microsoft.Azure.CognitiveServices.Vision.Face.Models.FindSimilarMatchMode.MatchPerson, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);
abstract member FindSimilarWithHttpMessagesAsync : Guid * string * string * System.Collections.Generic.IList<Nullable<Guid>> * Nullable<int> * Microsoft.Azure.CognitiveServices.Vision.Face.Models.FindSimilarMatchMode * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<System.Collections.Generic.IList<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SimilarFace>>>
override this.FindSimilarWithHttpMessagesAsync : Guid * string * string * System.Collections.Generic.IList<Nullable<Guid>> * Nullable<int> * Microsoft.Azure.CognitiveServices.Vision.Face.Models.FindSimilarMatchMode * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.HttpOperationResponse<System.Collections.Generic.IList<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SimilarFace>>>
Public Function FindSimilarWithHttpMessagesAsync (faceId As Guid, Optional faceListId As String = Nothing, Optional largeFaceListId As String = Nothing, Optional faceIds As IList(Of Nullable(Of Guid)) = Nothing, Optional maxNumOfCandidatesReturned As Nullable(Of Integer) = 20, Optional mode As FindSimilarMatchMode = Microsoft.Azure.CognitiveServices.Vision.Face.Models.FindSimilarMatchMode.MatchPerson, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of HttpOperationResponse(Of IList(Of SimilarFace)))

Parameter

faceId
Guid

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.

faceListId
String

Eine vorhandene vom Benutzer angegebene eindeutige Kandidaten-Gesichtsliste, die in der Gesichtserkennungsliste erstellt wurde

  • Erstellen Sie eine Gesichtserkennungsliste. Die Gesichtserkennungsliste enthält einen Satz von persistentedFaceIds, die beibehalten werden und nie ablaufen. Parameter faceListId, largeFaceListId und faceIds sollten nicht gleichzeitig bereitgestellt werden.
largeFaceListId
String

Eine vorhandene vom Benutzer angegebene liste mit einem eindeutigen eindeutigen Kandidaten für große Gesichter, die in LargeFaceList – Create erstellt wurde. Eine große Gesichtsliste enthält eine Reihe von persistedFaceIds, die beibehalten werden und nie ablaufen. Parameter faceListId, largeFaceListId und faceIds sollten nicht gleichzeitig bereitgestellt werden.

faceIds
IList<Nullable<Guid>>

Ein Array von Kandidaten-FaceIds. Alle werden von Face – Detect erstellt, und die faceIds laufen 24 Stunden nach dem Erkennungsaufruf ab. Die Anzahl der faceIds ist auf 1000 beschränkt. Parameter faceListId, largeFaceListId und faceIds sollten nicht gleichzeitig bereitgestellt werden.

maxNumOfCandidatesReturned
Nullable<Int32>

Die Anzahl der zurückgegebenen top ähnlichen Gesichter. Der gültige Bereich ist [1, 1000].

mode
FindSimilarMatchMode

Ähnlicher Gesichtssuche-Modus. Es kann "matchPerson" oder "matchFace" sein. Mögliche Werte: "matchPerson", "matchFace"

customHeaders
Dictionary<String,List<String>>

Header, die der Anforderung hinzugefügt werden.

cancellationToken
CancellationToken

Das Abbruchtoken.

Gibt zurück

Implementiert

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

Wird ausgelöst, wenn ein erforderlicher Parameter NULL ist

Gilt für: