IFaceOperations.FindSimilarWithHttpMessagesAsync Methode

Referenz

Definition

Namespace:: Microsoft.Azure.CognitiveServices.Vision.Face

Assembly:: Microsoft.Azure.CognitiveServices.Vision.Face.dll

Paket:: Microsoft.Azure.CognitiveServices.Vision.Face v2.8.0-preview.3

Quelle:: IFaceOperations.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

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 Gesichtserkennungsliste – Erstellen einer Gesichtserkennungsliste erstellt wurde. 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.