Compartilhar via


IFaceOperations.FindSimilarWithHttpMessagesAsync Método

Definição

Dada a faceId do rosto da consulta, para pesquisar rostos de aparência similar em uma matriz de faceId, uma lista de rostos ou uma grande lista de rostos. A matriz faceId contém os rostos criados por Detecção Facial, que expirará 24 horas após a criação. Um "faceListId" é criado por FaceList – Criar contendo persistedFaceIds que não expirará. E um "largeFaceListId" é criado por LargeFaceList – Create contendo persistedFaceIds que também não expirará. Dependendo da entrada, a lista de rostos semelhantes retornada contém faceIds ou persistedFaceIds classificados por similaridade. <br/>Find semelhante tem dois modos de trabalho, "matchPerson" e "matchFace". "matchPerson" é o modo padrão que ele tenta encontrar rostos da mesma pessoa possível usando limites internos da mesma pessoa. É útil encontrar outras fotos de uma pessoa conhecida. Observe que uma lista vazia será retornada se nenhuma face passar pelos limites internos. O modo "matchFace" ignora os limites da mesma pessoa e retorna faces semelhantes classificadas de qualquer maneira, mesmo que a similaridade seja baixa. Pode ser usado em casos como pesquisar rostos de celebridades. <br/>O 'recognitionModel' associado à faceId da face da consulta deve ser o mesmo que o 'recognitionModel' usado pela matriz faceId de destino, lista de rostos ou lista de rostos grandes.

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 da face da consulta. O usuário precisa chamar Face – Detectar primeiro para obter uma faceId válida. Observe que essa faceId não é persistente e expirará 24 horas após a chamada de detecção

faceListId
String

Uma lista de rostos candidata exclusiva especificada pelo usuário existente, criada na Lista de Rostos – Criar uma Lista de Detecção Facial. A lista de rostos contém um conjunto de persistedFaceIds que são persistentes e nunca expirarão. Os parâmetros faceListId, largeFaceListId e faceIds não devem ser fornecidos ao mesmo tempo.

largeFaceListId
String

Uma lista de rostos grandes de candidatos exclusivos especificadas pelo usuário existente, criada em LargeFaceList – Create. A lista de rostos grandes contém um conjunto de persistedFaceIds que são persistentes e nunca expirarão. Os parâmetros faceListId, largeFaceListId e faceIds não devem ser fornecidos ao mesmo tempo.

faceIds
IList<Nullable<Guid>>

Uma matriz de faceIds candidatas. Todos eles são criados por Detecção Facial – Detectar e as faceIds expirarão 24 horas após a chamada de detecção. O número de faceIds é limitado a 1000. Os parâmetros faceListId, largeFaceListId e faceIds não devem ser fornecidos ao mesmo tempo.

maxNumOfCandidatesReturned
Nullable<Int32>

O número de faces semelhantes principais retornadas. O intervalo válido é [1, 1000].

mode
FindSimilarMatchMode

Modo de pesquisa facial semelhante. Pode ser "matchPerson" ou "matchFace". Os valores possíveis incluem: 'matchPerson', 'matchFace'

customHeaders
Dictionary<String,List<String>>

Os cabeçalhos que serão adicionados à solicitação.

cancellationToken
CancellationToken

O token de cancelamento.

Retornos

Exceções

Gerada quando a operação retornou um código de status inválido

Gerada quando não é possível desserializar a resposta

Gerado quando um parâmetro necessário é nulo

Aplica-se a