FaceOperationsExtensions.FindSimilarAsync Méthode

Définition

Espace de noms:

Microsoft.Azure.CognitiveServices.Vision.Face

Assembly:

Microsoft.Azure.CognitiveServices.Vision.Face.dll

Paquet:

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

Source:

FaceOperationsExtensions.cs

En fonction du faceId de la requête, recherche les visages similaires à partir d’un tableau de faceId, d’une liste de visages ou d’une grande liste de visages. Le tableau faceId contient les visages créés par Face - Detect, qui expireront 24 heures après la création. Un « faceListId » est créé par FaceList - Create contenant desFaceIds persistants qui n’expireront pas. Et un « largeFaceListId » est créé par LargeFaceList - Create contenant desFaceIds persistants qui n’expireront pas non plus. En fonction de l’entrée, la liste de visages similaires retournée contient des faceIds ou desFaceIds persistants classés par similarité. <br/>Find similar a deux modes de travail, « matchPerson » et « matchFace ». « matchPerson » est le mode par défaut qu’il tente de trouver les visages de la même personne autant que possible en utilisant des seuils internes de même personne. Il est utile de trouver les autres photos d’une personne connue. Notez qu’une liste vide sera retournée si aucune face ne dépasse les seuils internes. Le mode « matchFace » ignore les seuils de même personne et retourne de toute façon des visages classés similaires, même la similarité est faible. Il peut être utilisé dans les cas comme la recherche de visages de célébrités. <br/>Le « recognitionModel » associé au faceId du visage de la requête doit être identique au « recognitionModel » utilisé par le tableau de visages cible, la liste de visages ou la liste de visages volumineux.

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

Paramètres

operations

IFaceOperations

Groupe d’opérations pour cette méthode d’extension.

faceId

Guid

FaceId de la face de requête. L’utilisateur doit d’abord appeler Visage - Détecter pour obtenir un faceId valide. Notez que ce faceId n’est pas persistant et expirera 24 heures après l’appel de détection

faceListId

String

Une liste de visages candidats unique spécifiée par l’utilisateur, créée dans La liste de visages

• Créez une liste de visages. La liste de visages contient un ensemble deFaceIds persistants qui sont conservés et n’expireront jamais. Les paramètres faceListId, largeFaceListId et faceIds ne doivent pas être fournis en même temps.

largeFaceListId

String

Une liste de visages candidat unique et unique spécifiée par l’utilisateur, créée dans LargeFaceList - Create. La liste de visages volumineux contient un ensemble deFaceIds persistants qui sont conservés et qui n’expireront jamais. Les paramètres faceListId, largeFaceListId et faceIds ne doivent pas être fournis en même temps.

faceIds

IList<Nullable<Guid>>

Tableau de faceIds candidats. Tous sont créés par Visage - Détecter et les faceIds expirent 24 heures après l’appel de détection. Le nombre de faceIds est limité à 1000. Les paramètres faceListId, largeFaceListId et faceIds ne doivent pas être fournis en même temps.

maxNumOfCandidatesReturned

Nullable<Int32>

Nombre de visages similaires les plus hauts retournés. La plage valide est [1, 1000].

mode

FindSimilarMatchMode

Mode de recherche de visage similaire. Il peut s’agir de « matchPerson » ou « matchFace ». Les valeurs possibles sont les suivantes : 'matchPerson', 'matchFace'

cancellationToken

CancellationToken

Jeton d'annulation.

Retours

Task<IList<SimilarFace>>