FaceOperationsExtensions.FindSimilarAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.CognitiveServices.Vision.Face

Ensamblado:

Microsoft.Azure.CognitiveServices.Vision.Face.dll

Paquete:

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

Source:

FaceOperationsExtensions.cs

Dado el elemento faceId de un cara de la consulta, busca las caras similares en una matriz de elementos faceId, una lista de caras o una lista de caras de gran tamaño. La matriz faceId contiene las caras creadas por Face - Detect, que expirarán 24 horas después de la creación. FaceList- Create que contiene persistedFaceIds crea un elemento "faceListId" que no expirará. Y LargeFaceListId crea un elemento "largeFaceListId" que contiene persistedFaceIds que tampoco expirará. Dependiendo de la entrada, la lista de caras similares devuelta contiene faceIds o persistedFaceIds clasificados por similitud. <br/>Find similar tiene dos modos de trabajo, "matchPerson" y "matchFace". "matchPerson" es el modo predeterminado que intenta encontrar caras de la misma persona como sea posible mediante umbrales internos de la misma persona. Es útil encontrar otras fotos de una persona conocida. Tenga en cuenta que se devolverá una lista vacía si ninguna cara supera los umbrales internos. El modo "matchFace" omite los umbrales de la misma persona y devuelve caras similares clasificadas de todos modos, incluso la similitud es baja. Se puede usar en los casos como buscar caras con celebridad. <br/>The 'recognitionModel' associated with the query faceId should be the same as the 'recognitionModel' used by the target faceId array, face list or large face list.

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

Parámetros

operations

IFaceOperations

El grupo de operaciones de este método de extensión.

faceId

Guid

FaceId de la cara de consulta. El usuario debe llamar a Face : detecte primero para obtener un faceId válido. Tenga en cuenta que este faceId no se conserva y expirará 24 horas después de la llamada de detección.

faceListId

String

Una lista de caras candidata única especificada por el usuario existente, creada en La lista de caras

• Cree una lista de caras. La lista de caras contiene un conjunto de elementos persistedFaceId que se conservan y que nunca expirarán. No se deben proporcionar los parámetros faceListId, largeFaceListId y faceIds al mismo tiempo.

largeFaceListId

String

Una lista de caras grandes candidata única especificada por el usuario, creada en LargeFaceList - Create. La lista de caras grandes contiene un conjunto de elementos persistedFaceId que se conservan y que nunca expirarán. No se deben proporcionar los parámetros faceListId, largeFaceListId y faceIds al mismo tiempo.

faceIds

IList<Nullable<Guid>>

Matriz de faceIds candidatos. Todos ellos se crean mediante Face- Detect y faceIds expirarán 24 horas después de la llamada de detección. El número de faceIds está limitado a 1000. No se deben proporcionar los parámetros faceListId, largeFaceListId y faceIds al mismo tiempo.

maxNumOfCandidatesReturned

Nullable<Int32>

Número de caras similares superiores devueltas. El intervalo válido es [1, 1000].

mode

FindSimilarMatchMode

Modo de búsqueda facial similar. Puede ser "matchPerson" o "matchFace". Entre los valores posibles se incluyen: 'matchPerson', 'matchFace'

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task<IList<SimilarFace>>