Compartir a través de


IFaceOperations.FindSimilarWithHttpMessagesAsync Método

Definición

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>>>
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 Lista de caras: crear 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.

maxNumOfCandidatesReturned
Nullable<Int32>

Número de caras superiores similares 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'

customHeaders
Dictionary<String,List<String>>

Encabezados que se agregarán a la solicitud.

cancellationToken
CancellationToken

Token de cancelación.

Devoluciones

Excepciones

Se produce cuando la operación devolvió un código de estado no válido

Se produce cuando no se puede deserializar la respuesta

Se produce cuando un parámetro obligatorio es NULL

Se aplica a