FaceOperationsExtensions.FindSimilarAsync Methode

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:

FaceOperationsExtensions.cs

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 erstellt – Create mit persistedFaceIds, die nicht ablaufen. Und eine "largeFaceListId" wird von LargeFaceList erstellt: Erstellen 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 sind. <br/>Find similar hat zwei Arbeitsmodi, "matchPerson" und "matchFace". "matchPerson" ist der Standardmodus, in dem versucht wird, Gesichter derselben Person so wie möglich zu finden, indem interne Schwellenwerte für dieselbe Person verwendet werden. Es ist nützlich, andere 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 dieselbe Person und gibt trotzdem ähnliche Gesichter zurück, auch wenn die Ähnlichkeit gering ist. Es kann in den Fällen verwendet werden, wie z. B. die Suche nach prominenten Gesichtern. <br/>Das "recognitionModel", das der faceId des Abfragegesichts zugeordnet ist, sollte mit dem "recognitionModel" identisch sein, das vom Ziel-FaceId-Array, der Gesichtsliste oder der großen Gesichtsliste verwendet wird.

public static System.Threading.Tasks.Task<System.Collections.Generic.IList<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SimilarFace>> FindSimilarAsync (this Microsoft.Azure.CognitiveServices.Vision.Face.IFaceOperations operations, 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.Threading.CancellationToken cancellationToken = default);

static member FindSimilarAsync : Microsoft.Azure.CognitiveServices.Vision.Face.IFaceOperations * Guid * string * string * System.Collections.Generic.IList<Nullable<Guid>> * Nullable<int> * Microsoft.Azure.CognitiveServices.Vision.Face.Models.FindSimilarMatchMode * System.Threading.CancellationToken -> System.Threading.Tasks.Task<System.Collections.Generic.IList<Microsoft.Azure.CognitiveServices.Vision.Face.Models.SimilarFace>>

<Extension()>
Public Function FindSimilarAsync (operations As IFaceOperations, 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 cancellationToken As CancellationToken = Nothing) As Task(Of IList(Of SimilarFace))

Parameter

operations

IFaceOperations

Die Vorgangsgruppe für diese Erweiterungsmethode.

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-Gesichtserkennungsliste, die in Der Gesichtserkennungsliste erstellt wurde

• Erstellen Sie eine Gesichtserkennungsliste. Gesichtserkennungsliste enthält eine Reihe von persistedFaceIds, die beibehalten werden und nie ablaufen. Parameter faceListId, largeFaceListId und faceIds sollten nicht gleichzeitig bereitgestellt werden.

largeFaceListId

String

Eine vorhandene vom Benutzer angegebene eindeutige Kandidatenliste mit großen Gesichtern, die in LargeFaceList – Create erstellt wurde. Die 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 begrenzt. Parameter faceListId, largeFaceListId und faceIds sollten nicht gleichzeitig bereitgestellt werden.

maxNumOfCandidatesReturned

Nullable<Int32>

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

mode

FindSimilarMatchMode

Ähnlicher Gesichtssuchemodus. Es kann "matchPerson" oder "matchFace" sein. Mögliche Werte: 'matchPerson', 'matchFace'

cancellationToken

CancellationToken

Das Abbruchtoken.

Gibt zurück

Task<IList<SimilarFace>>