Faces Interface

Pacote:

com.microsoft.azure.cognitiveservices.vision.faceapi

public interface Faces

Uma instância dessa classe fornece acesso a todas as operações definidas em Faces.

Resumo do método

Modificador e tipo	Método e descrição
FacesDetectWithStreamDefinitionStages.WithImage	detectWithStream() Detecte rostos humanos em uma imagem e retorna locais de rosto e, opcionalmente, com faceIds, pontos de referência e atributos.
List<DetectedFace>	detectWithStream(byte[] image, DetectWithStreamOptionalParameter detectWithStreamOptionalParameter) Detecte rostos humanos em uma imagem e retorna locais de rosto e, opcionalmente, com faceIds, pontos de referência e atributos.
Observable<List<DetectedFace>>	detectWithStreamAsync(byte[] image, DetectWithStreamOptionalParameter detectWithStreamOptionalParameter) Detecte rostos humanos em uma imagem e retorna locais de rosto e, opcionalmente, com faceIds, pontos de referência e atributos.
FacesDetectWithUrlDefinitionStages.WithUrl	detectWithUrl() Detecte rostos humanos em uma imagem e retorna locais de rosto e, opcionalmente, com faceIds, pontos de referência e atributos.
List<DetectedFace>	detectWithUrl(String url, DetectWithUrlOptionalParameter detectWithUrlOptionalParameter) Detecte rostos humanos em uma imagem e retorna locais de rosto e, opcionalmente, com faceIds, pontos de referência e atributos.
Observable<List<DetectedFace>>	detectWithUrlAsync(String url, DetectWithUrlOptionalParameter detectWithUrlOptionalParameter) Detecte rostos humanos em uma imagem e retorna locais de rosto e, opcionalmente, com faceIds, pontos de referência e atributos.
FacesFindSimilarDefinitionStages.WithFaceId	findSimilar() Dada a faceId da face da consulta, localize os rostos de aparência semelhante de uma matriz faceId ou faceListId.
List<SimilarFace>	findSimilar(UUID faceId, FindSimilarOptionalParameter findSimilarOptionalParameter) Dada a faceId da face da consulta, localize os rostos de aparência semelhante de uma matriz faceId ou faceListId.
Observable<List<SimilarFace>>	findSimilarAsync(UUID faceId, FindSimilarOptionalParameter findSimilarOptionalParameter) Dada a faceId da face da consulta, localize os rostos de aparência semelhante de uma matriz faceId ou faceListId.
GroupResult	group(List<UUID> faceIds) Dividir os rostos candidatos em grupos com base na semelhança de rosto.
Observable<GroupResult>	groupAsync(List<UUID> faceIds) Dividir os rostos candidatos em grupos com base na semelhança de rosto.
FacesIdentifyDefinitionStages.WithPersonGroupId	identify() Identifique rostos desconhecidos de um grupo de pessoas.
List<IdentifyResult>	identify(String personGroupId, List<UUID> faceIds, IdentifyOptionalParameter identifyOptionalParameter) Identifique rostos desconhecidos de um grupo de pessoas.
Observable<List<IdentifyResult>>	identifyAsync(String personGroupId, List<UUID> faceIds, IdentifyOptionalParameter identifyOptionalParameter) Identifique rostos desconhecidos de um grupo de pessoas.
VerifyResult	verifyFaceToFace(UUID faceId1, UUID faceId2) Verificar se dois rostos pertencem à mesma pessoa ou se um rosto pertence a uma pessoa.
Observable<VerifyResult>	verifyFaceToFaceAsync(UUID faceId1, UUID faceId2) Verificar se dois rostos pertencem à mesma pessoa ou se um rosto pertence a uma pessoa.
VerifyResult	verifyFaceToPerson(UUID faceId, String personGroupId, UUID personId) Verifique se dois rostos pertencem a uma mesma pessoa. Compara uma ID de rosto com uma ID de Pessoa.
Observable<VerifyResult>	verifyFaceToPersonAsync(UUID faceId, String personGroupId, UUID personId) Verifique se dois rostos pertencem a uma mesma pessoa. Compara uma ID de rosto com uma ID de Pessoa.

Detalhes do método

detectWithStream

public FacesDetectWithStreamDefinitionStages.WithImage detectWithStream()

Detecte rostos humanos em uma imagem e retorna locais de rosto e, opcionalmente, com faceIds, pontos de referência e atributos.

Returns:

o primeiro estágio da chamada detectWithStream

detectWithStream

public List detectWithStream(byte[] image, DetectWithStreamOptionalParameter detectWithStreamOptionalParameter)

Detecte rostos humanos em uma imagem e retorna locais de rosto e, opcionalmente, com faceIds, pontos de referência e atributos.

Parameters:

image - Um fluxo de imagem.

detectWithStreamOptionalParameter - o objeto que representa os parâmetros opcionais a serem definidos antes de chamar essa API

Returns:

o objeto List<DetectedFace> se tiver êxito.

Throws:

IllegalArgumentException - gerado se os parâmetros falharem na validação

APIErrorException - gerado se a solicitação for rejeitada pelo servidor

RuntimeException - todas as outras exceções verificadas encapsuladas se a solicitação não for enviada

detectWithStreamAsync

public Observable> detectWithStreamAsync(byte[] image, DetectWithStreamOptionalParameter detectWithStreamOptionalParameter)

Detecte rostos humanos em uma imagem e retorna locais de rosto e, opcionalmente, com faceIds, pontos de referência e atributos.

Parameters:

image - Um fluxo de imagem.

detectWithStreamOptionalParameter - o objeto que representa os parâmetros opcionais a serem definidos antes de chamar essa API

Returns:

o observável para o objeto List<DetectedFace>

Throws:

IllegalArgumentException - gerado se os parâmetros falharem na validação

detectWithUrl

public FacesDetectWithUrlDefinitionStages.WithUrl detectWithUrl()

Detecte rostos humanos em uma imagem e retorna locais de rosto e, opcionalmente, com faceIds, pontos de referência e atributos.

Returns:

o primeiro estágio da chamada detectWithUrl

detectWithUrl

public List detectWithUrl(String url, DetectWithUrlOptionalParameter detectWithUrlOptionalParameter)

Detecte rostos humanos em uma imagem e retorna locais de rosto e, opcionalmente, com faceIds, pontos de referência e atributos.

Parameters:

url - URL acessível publicamente de uma imagem.

detectWithUrlOptionalParameter - o objeto que representa os parâmetros opcionais a serem definidos antes de chamar essa API

Returns:

o objeto List<DetectedFace> se tiver êxito.

Throws:

IllegalArgumentException - gerado se os parâmetros falharem na validação

APIErrorException - gerado se a solicitação for rejeitada pelo servidor

RuntimeException - todas as outras exceções verificadas encapsuladas se a solicitação não for enviada

detectWithUrlAsync

public Observable> detectWithUrlAsync(String url, DetectWithUrlOptionalParameter detectWithUrlOptionalParameter)

Detecte rostos humanos em uma imagem e retorna locais de rosto e, opcionalmente, com faceIds, pontos de referência e atributos.

Parameters:

url - URL acessível publicamente de uma imagem.

detectWithUrlOptionalParameter - o objeto que representa os parâmetros opcionais a serem definidos antes de chamar essa API

Returns:

o observável para o objeto List<DetectedFace>

Throws:

IllegalArgumentException - gerado se os parâmetros falharem na validação

findSimilar

public FacesFindSimilarDefinitionStages.WithFaceId findSimilar()

Dada a faceId da face da consulta, localize os rostos de aparência semelhante de uma matriz faceId ou faceListId.

Returns:

o primeiro estágio da chamada findSimilar

findSimilar

public List findSimilar(UUID faceId, FindSimilarOptionalParameter findSimilarOptionalParameter)

Dada a faceId da face da consulta, localize os rostos de aparência semelhante de uma matriz faceId ou faceListId.

Parameters:

faceId - 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.

findSimilarOptionalParameter - o objeto que representa os parâmetros opcionais a serem definidos antes de chamar essa API

Returns:

o objeto List<SimilarFace> se tiver êxito.

Throws:

IllegalArgumentException - gerado se os parâmetros falharem na validação

APIErrorException - gerado se a solicitação for rejeitada pelo servidor

RuntimeException - todas as outras exceções verificadas encapsuladas se a solicitação não for enviada

findSimilarAsync

public Observable> findSimilarAsync(UUID faceId, FindSimilarOptionalParameter findSimilarOptionalParameter)

Dada a faceId da face da consulta, localize os rostos de aparência semelhante de uma matriz faceId ou faceListId.

Parameters:

faceId - 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.

findSimilarOptionalParameter - o objeto que representa os parâmetros opcionais a serem definidos antes de chamar essa API

Returns:

o observável para o objeto List<SimilarFace>

Throws:

IllegalArgumentException - gerado se os parâmetros falharem na validação

group

public GroupResult group(List faceIds)

Dividir os rostos candidatos em grupos com base na semelhança de rosto.

Parameters:

faceIds - Matriz de faceId candidata criada por Face – Detectar. O máximo é de 1000 faces.

Returns:

o objeto GroupResult se tiver êxito.

Throws:

IllegalArgumentException - gerado se os parâmetros falharem na validação

APIErrorException - gerado se a solicitação for rejeitada pelo servidor

RuntimeException - todas as outras exceções verificadas encapsuladas se a solicitação não for enviada

groupAsync

public Observable groupAsync(List faceIds)

Dividir os rostos candidatos em grupos com base na semelhança de rosto.

Parameters:

faceIds - Matriz de faceId candidata criada por Face – Detectar. O máximo é de 1000 faces.

Returns:

o observável para o objeto GroupResult

Throws:

IllegalArgumentException - gerado se os parâmetros falharem na validação

identify

public FacesIdentifyDefinitionStages.WithPersonGroupId identify()

Identifique rostos desconhecidos de um grupo de pessoas.

Returns:

o primeiro estágio da chamada de identificação

identify

public List identify(String personGroupId, List faceIds, IdentifyOptionalParameter identifyOptionalParameter)

Identifique rostos desconhecidos de um grupo de pessoas.

Parameters:

personGroupId - PersonGroupId do grupo de pessoas de destino, criado por PersonGroups.Create.

faceIds - Matriz de faceIds de rostos de consulta, criada pelo Face – Detect. Cada um dos rostos é identificado de forma independente. O número válido de faceIds está entre [1, 10].

identifyOptionalParameter - o objeto que representa os parâmetros opcionais a serem definidos antes de chamar essa API

Returns:

o objeto List<IdentifiResult> se tiver êxito.

Throws:

IllegalArgumentException - gerado se os parâmetros falharem na validação

APIErrorException - gerado se a solicitação for rejeitada pelo servidor

RuntimeException - todas as outras exceções verificadas encapsuladas se a solicitação não for enviada

identifyAsync

public Observable> identifyAsync(String personGroupId, List faceIds, IdentifyOptionalParameter identifyOptionalParameter)

Identifique rostos desconhecidos de um grupo de pessoas.

Parameters:

personGroupId - PersonGroupId do grupo de pessoas de destino, criado por PersonGroups.Create.

faceIds - Matriz de faceIds de rostos de consulta, criada pelo Face – Detect. Cada um dos rostos é identificado de forma independente. O número válido de faceIds está entre [1, 10].

identifyOptionalParameter - o objeto que representa os parâmetros opcionais a serem definidos antes de chamar essa API

Returns:

o observável para o objeto List<IdentifiResult>

Throws:

IllegalArgumentException - gerado se os parâmetros falharem na validação

verifyFaceToFace

public VerifyResult verifyFaceToFace(UUID faceId1, UUID faceId2)

Verificar se dois rostos pertencem à mesma pessoa ou se um rosto pertence a uma pessoa.

Parameters:

faceId1 - FaceId do primeiro rosto, vem de Face – Detectar.

faceId2 - FaceId da segunda face, vem de Face – Detectar.

Returns:

o objeto VerifyResult se tiver êxito.

Throws:

IllegalArgumentException - gerado se os parâmetros falharem na validação

APIErrorException - gerado se a solicitação for rejeitada pelo servidor

RuntimeException - todas as outras exceções verificadas encapsuladas se a solicitação não for enviada

verifyFaceToFaceAsync

public Observable verifyFaceToFaceAsync(UUID faceId1, UUID faceId2)

Verificar se dois rostos pertencem à mesma pessoa ou se um rosto pertence a uma pessoa.

Parameters:

faceId1 - FaceId do primeiro rosto, vem de Face – Detectar.

faceId2 - FaceId da segunda face, vem de Face – Detectar.

Returns:

o observável para o objeto VerifyResult

Throws:

IllegalArgumentException - gerado se os parâmetros falharem na validação

verifyFaceToPerson

public VerifyResult verifyFaceToPerson(UUID faceId, String personGroupId, UUID personId)

Verifique se dois rostos pertencem a uma mesma pessoa. Compara uma ID de rosto com uma ID de Pessoa.

Parameters:

faceId - FaceId o rosto, vem de Face – Detectar.

personGroupId - Usando personGroupId e personId existentes para carregar rapidamente uma pessoa especificada. personGroupId é criado em Grupos de Pessoas.Criar.

personId - Especifique uma determinada pessoa em um grupo de pessoas. personId é criado em Persons.Create.

Returns:

o objeto VerifyResult se tiver êxito.

Throws:

IllegalArgumentException - gerado se os parâmetros falharem na validação

APIErrorException - gerado se a solicitação for rejeitada pelo servidor

RuntimeException - todas as outras exceções verificadas encapsuladas se a solicitação não for enviada

verifyFaceToPersonAsync

public Observable verifyFaceToPersonAsync(UUID faceId, String personGroupId, UUID personId)

Verifique se dois rostos pertencem a uma mesma pessoa. Compara uma ID de rosto com uma ID de Pessoa.

Parameters:

faceId - FaceId o rosto, vem de Face – Detectar.

personGroupId - Usando personGroupId e personId existentes para carregar rapidamente uma pessoa especificada. personGroupId é criado em Grupos de Pessoas.Criar.

personId - Especifique uma determinada pessoa em um grupo de pessoas. personId é criado em Persons.Create.

Returns:

o observável para o objeto VerifyResult

Throws:

IllegalArgumentException - gerado se os parâmetros falharem na validação