FaceOperations.FindSimilarWithHttpMessagesAsync Método

Referência

Definição

Namespace:: Microsoft.Azure.CognitiveServices.Vision.Face

Assembly:: Microsoft.Azure.CognitiveServices.Vision.Face.dll

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

Origem:: FaceOperations.cs

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 pelo Face – Detect, que expirará 24 horas após a criação. Um "faceListId" é criado pelo FaceList – Criar contendo persistedFaceIds que não expirarão. E um "largeFaceListId" é criado por LargeFaceList – Criar contendo persistedFaceIds que também não expirarão. Dependendo da entrada, a lista de rostos semelhantes retornadas contém faceIds ou persistedFaceIds classificados por similaridade. <br/>Find similar 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 rostos semelhantes classificados de qualquer maneira, até mesmo a similaridade é baixa. Pode ser usado nos casos, como pesquisar rostos com aparência de celebridade. <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>>>
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 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 de candidato 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. FaceListId de parâmetro, largeFaceListId e faceIds não devem ser fornecidos ao mesmo tempo.

largeFaceListId: String

Uma lista de rostos grandes do candidato exclusivo especificado 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. FaceListId de parâmetro, largeFaceListId e faceIds não devem ser fornecidos ao mesmo tempo.

faceIds: IList<Nullable<Guid>>

Uma matriz de faceIds candidatas. Todas elas são criadas por Face – Detecte e as faceIds expirarão 24 horas após a chamada de detecção. O número de faceIds é limitado a 1000. FaceListId de parâmetro, largeFaceListId e faceIds não devem ser fornecidos ao mesmo tempo.