FaceOperations.FindSimilarWithHttpMessagesAsync Método

Referencia

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:: FaceOperations.cs

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

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 "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 no hay caras que superen 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 de celebridad. <br/>The 'recognitionModel' associated with the query face's faceId should be the same as the 'recognitionModel' used by the target faceId array, face list or large face list.

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

Parámetros

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 candidatas únicas especificada por el usuario, creada en La lista de caras

Cree una lista de caras. La lista de caras contiene un conjunto de persistedFaceIds que se conservan y 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 persistedFaceIds que se conservan y 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 : detecte y faceIds expirará 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.