FaceOperationsExtensions.FindSimilarAsync Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 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
O grupo de operações para esse método de extensão.
- 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 Rostos. 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.
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.
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'
- cancellationToken
- CancellationToken
O token de cancelamento.
Retornos
Aplica-se a
Azure SDK for .NET