Faces Interfaz

Paquete:

com.microsoft.azure.cognitiveservices.vision.faceapi

public interface Faces

Una instancia de esta clase proporciona acceso a todas las operaciones definidas en Caras.

Resumen del método

Modificador y tipo	Método y descripción
FacesDetectWithStreamDefinitionStages.WithImage	detectWithStream() Detecte caras humanas en una imagen y devuelva ubicaciones de caras y, opcionalmente, con faceIds, puntos de referencia y atributos.
List<DetectedFace>	detectWithStream(byte[] image, DetectWithStreamOptionalParameter detectWithStreamOptionalParameter) Detecte caras humanas en una imagen y devuelva ubicaciones de caras y, opcionalmente, con faceIds, puntos de referencia y atributos.
Observable<List<DetectedFace>>	detectWithStreamAsync(byte[] image, DetectWithStreamOptionalParameter detectWithStreamOptionalParameter) Detecte caras humanas en una imagen y devuelva ubicaciones de caras y, opcionalmente, con faceIds, puntos de referencia y atributos.
FacesDetectWithUrlDefinitionStages.WithUrl	detectWithUrl() Detecte caras humanas en una imagen y devuelva ubicaciones de caras y, opcionalmente, con faceIds, puntos de referencia y atributos.
List<DetectedFace>	detectWithUrl(String url, DetectWithUrlOptionalParameter detectWithUrlOptionalParameter) Detecte caras humanas en una imagen y devuelva ubicaciones de caras y, opcionalmente, con faceIds, puntos de referencia y atributos.
Observable<List<DetectedFace>>	detectWithUrlAsync(String url, DetectWithUrlOptionalParameter detectWithUrlOptionalParameter) Detecte caras humanas en una imagen y devuelva ubicaciones de caras y, opcionalmente, con faceIds, puntos de referencia y atributos.
FacesFindSimilarDefinitionStages.WithFaceId	findSimilar() Dado el faceId de la cara de consulta, busque las caras similares de una matriz faceId o faceListId.
List<SimilarFace>	findSimilar(UUID faceId, FindSimilarOptionalParameter findSimilarOptionalParameter) Dado el faceId de la cara de consulta, busque las caras similares de una matriz faceId o faceListId.
Observable<List<SimilarFace>>	findSimilarAsync(UUID faceId, FindSimilarOptionalParameter findSimilarOptionalParameter) Dado el faceId de la cara de consulta, busque las caras similares de una matriz faceId o faceListId.
GroupResult	group(List<UUID> faceIds) Divide las caras de los candidatos en grupos en función de la similitud de la cara.
Observable<GroupResult>	groupAsync(List<UUID> faceIds) Divide las caras de los candidatos en grupos en función de la similitud de la cara.
FacesIdentifyDefinitionStages.WithPersonGroupId	identify() Identificar caras desconocidas de un grupo de personas.
List<IdentifyResult>	identify(String personGroupId, List<UUID> faceIds, IdentifyOptionalParameter identifyOptionalParameter) Identificar caras desconocidas de un grupo de personas.
Observable<List<IdentifyResult>>	identifyAsync(String personGroupId, List<UUID> faceIds, IdentifyOptionalParameter identifyOptionalParameter) Identificar caras desconocidas de un grupo de personas.
VerifyResult	verifyFaceToFace(UUID faceId1, UUID faceId2) Comprueba si dos caras pertenecen a una misma persona o si una cara pertenece a una persona.
Observable<VerifyResult>	verifyFaceToFaceAsync(UUID faceId1, UUID faceId2) Comprueba si dos caras pertenecen a una misma persona o si una cara pertenece a una persona.
VerifyResult	verifyFaceToPerson(UUID faceId, String personGroupId, UUID personId) Compruebe si dos caras pertenecen a una misma persona. Compara un identificador de cara con un identificador de persona.
Observable<VerifyResult>	verifyFaceToPersonAsync(UUID faceId, String personGroupId, UUID personId) Compruebe si dos caras pertenecen a una misma persona. Compara un identificador de cara con un identificador de persona.

Detalles del método

detectWithStream

public FacesDetectWithStreamDefinitionStages.WithImage detectWithStream()

Detecte caras humanas en una imagen y devuelva ubicaciones de caras y, opcionalmente, con faceIds, puntos de referencia y atributos.

Returns:

la primera fase de la llamada detectWithStream

detectWithStream

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

Detecte caras humanas en una imagen y devuelva ubicaciones de caras y, opcionalmente, con faceIds, puntos de referencia y atributos.

Parameters:

image - Una secuencia de imágenes.

detectWithStreamOptionalParameter - el objeto que representa los parámetros opcionales que se van a establecer antes de llamar a esta API.

Returns:

El objeto List<DetectedFace> si se ejecuta correctamente.

Throws:

IllegalArgumentException - se produce si los parámetros producen un error en la validación.

APIErrorException - se produce si el servidor rechaza la solicitud.

RuntimeException - todas las demás excepciones activadas ajustadas si no se puede enviar la solicitud

detectWithStreamAsync

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

Detecte caras humanas en una imagen y devuelva ubicaciones de caras y, opcionalmente, con faceIds, puntos de referencia y atributos.

Parameters:

image - Una secuencia de imágenes.

detectWithStreamOptionalParameter - el objeto que representa los parámetros opcionales que se van a establecer antes de llamar a esta API.

Returns:

observable para el objeto List<DetectedFace>

Throws:

IllegalArgumentException - se produce si los parámetros producen un error en la validación.

detectWithUrl

public FacesDetectWithUrlDefinitionStages.WithUrl detectWithUrl()

Detecte caras humanas en una imagen y devuelva ubicaciones de caras y, opcionalmente, con faceIds, puntos de referencia y atributos.

Returns:

la primera fase de la llamada detectWithUrl

detectWithUrl

public List detectWithUrl(String url, DetectWithUrlOptionalParameter detectWithUrlOptionalParameter)

Detecte caras humanas en una imagen y devuelva ubicaciones de caras y, opcionalmente, con faceIds, puntos de referencia y atributos.

Parameters:

url - Dirección URL accesible públicamente de una imagen.

detectWithUrlOptionalParameter - el objeto que representa los parámetros opcionales que se van a establecer antes de llamar a esta API.

Returns:

El objeto List<DetectedFace> si se ejecuta correctamente.

Throws:

IllegalArgumentException - se produce si los parámetros producen un error en la validación.

APIErrorException - se produce si el servidor rechaza la solicitud.

RuntimeException - todas las demás excepciones activadas ajustadas si no se puede enviar la solicitud

detectWithUrlAsync

public Observable> detectWithUrlAsync(String url, DetectWithUrlOptionalParameter detectWithUrlOptionalParameter)

Detecte caras humanas en una imagen y devuelva ubicaciones de caras y, opcionalmente, con faceIds, puntos de referencia y atributos.

Parameters:

url - Dirección URL accesible públicamente de una imagen.

detectWithUrlOptionalParameter - el objeto que representa los parámetros opcionales que se van a establecer antes de llamar a esta API.

Returns:

observable para el objeto List<DetectedFace>

Throws:

IllegalArgumentException - se produce si los parámetros producen un error en la validación.

findSimilar

public FacesFindSimilarDefinitionStages.WithFaceId findSimilar()

Dado el faceId de la cara de consulta, busque las caras similares de una matriz faceId o faceListId.

Returns:

la primera fase de la llamada findSimilar

findSimilar

public List findSimilar(UUID faceId, FindSimilarOptionalParameter findSimilarOptionalParameter)

Dado el faceId de la cara de consulta, busque las caras similares de una matriz faceId o faceListId.

Parameters:

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

findSimilarOptionalParameter - el objeto que representa los parámetros opcionales que se van a establecer antes de llamar a esta API.

Returns:

El objeto List<SimilarFace> si se ejecuta correctamente.

Throws:

IllegalArgumentException - se produce si los parámetros producen un error en la validación.

APIErrorException - se produce si el servidor rechaza la solicitud.

RuntimeException - todas las demás excepciones activadas ajustadas si no se puede enviar la solicitud

findSimilarAsync

public Observable> findSimilarAsync(UUID faceId, FindSimilarOptionalParameter findSimilarOptionalParameter)

Dado el faceId de la cara de consulta, busque las caras similares de una matriz faceId o faceListId.

Parameters:

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

findSimilarOptionalParameter - el objeto que representa los parámetros opcionales que se van a establecer antes de llamar a esta API.

Returns:

observable para el objeto List<SimilarFace>

Throws:

IllegalArgumentException - se produce si los parámetros producen un error en la validación.

group

public GroupResult group(List faceIds)

Divide las caras de los candidatos en grupos en función de la similitud de la cara.

Parameters:

faceIds - Matriz de faceId candidata creada por Face - Detect. El máximo es de 1000 caras.

Returns:

El objeto GroupResult si se ejecuta correctamente.

Throws:

IllegalArgumentException - se produce si los parámetros producen un error en la validación.

APIErrorException - se produce si el servidor rechaza la solicitud.

RuntimeException - todas las demás excepciones activadas ajustadas si no se puede enviar la solicitud

groupAsync

public Observable groupAsync(List faceIds)

Divide las caras de los candidatos en grupos en función de la similitud de la cara.

Parameters:

faceIds - Matriz de faceId candidata creada por Face - Detect. El máximo es de 1000 caras.

Returns:

que se puede observar en el objeto GroupResult

Throws:

IllegalArgumentException - se produce si los parámetros producen un error en la validación.

identify

public FacesIdentifyDefinitionStages.WithPersonGroupId identify()

Identificar caras desconocidas de un grupo de personas.

Returns:

la primera fase de la llamada de identificación

identify

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

Identificar caras desconocidas de un grupo de personas.

Parameters:

personGroupId - PersonGroupId del grupo de personas de destino, creado por PersonGroups.Create.

faceIds - Matriz de caras de consulta faceIds, creada por Face - Detect. Cada una de las caras se identifica de forma independiente. El número válido de faceIds está entre [1, 10].

identifyOptionalParameter - el objeto que representa los parámetros opcionales que se van a establecer antes de llamar a esta API.

Returns:

El objeto List<IdentifyResult> si se ejecuta correctamente.

Throws:

IllegalArgumentException - se produce si los parámetros producen un error en la validación.

APIErrorException - se produce si el servidor rechaza la solicitud.

RuntimeException - todas las demás excepciones activadas ajustadas si la solicitud no se puede enviar

identifyAsync

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

Identificar caras desconocidas de un grupo de personas.

Parameters:

personGroupId - PersonGroupId del grupo de personas de destino, creado por PersonGroups.Create.

faceIds - Matriz de caras de consulta faceIds, creada por Face - Detect. Cada una de las caras se identifica de forma independiente. El número válido de faceIds está entre [1, 10].

identifyOptionalParameter - el objeto que representa los parámetros opcionales que se van a establecer antes de llamar a esta API.

Returns:

que se puede observar en el objeto List<IdentifyResult>

Throws:

IllegalArgumentException - se produce si los parámetros producen un error en la validación.

verifyFaceToFace

public VerifyResult verifyFaceToFace(UUID faceId1, UUID faceId2)

Comprueba si dos caras pertenecen a una misma persona o si una cara pertenece a una persona.

Parameters:

faceId1 - FaceId de la primera cara, proviene de Face - Detect.

faceId2 - FaceId de la segunda cara, proviene de Face - Detect.

Returns:

El objeto VerifyResult si se ejecuta correctamente.

Throws:

IllegalArgumentException - se produce si los parámetros producen un error en la validación.

APIErrorException - se produce si el servidor rechaza la solicitud.

RuntimeException - todas las demás excepciones activadas ajustadas si la solicitud no se puede enviar

verifyFaceToFaceAsync

public Observable verifyFaceToFaceAsync(UUID faceId1, UUID faceId2)

Comprueba si dos caras pertenecen a una misma persona o si una cara pertenece a una persona.

Parameters:

faceId1 - FaceId de la primera cara, proviene de Face - Detect.

faceId2 - FaceId de la segunda cara, proviene de Face - Detect.

Returns:

observable para el objeto VerifyResult.

Throws:

IllegalArgumentException - se produce si los parámetros producen un error en la validación.

verifyFaceToPerson

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

Compruebe si dos caras pertenecen a una misma persona. Compara un identificador de cara con un identificador de persona.

Parameters:

faceId - FaceId la cara viene de Face - Detect.

personGroupId - Usar personGroupId y personId existentes para cargar rápidamente una persona especificada. personGroupId se crea en Person Groups.Create.

personId - Especifique una determinada persona en un grupo de personas. personId se crea en Persons.Create.

Returns:

El objeto VerifyResult si se ejecuta correctamente.

Throws:

IllegalArgumentException - se produce si los parámetros producen un error en la validación.

APIErrorException - se produce si el servidor rechaza la solicitud.

RuntimeException - todas las demás excepciones activadas ajustadas si la solicitud no se puede enviar

verifyFaceToPersonAsync

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

Compruebe si dos caras pertenecen a una misma persona. Compara un identificador de cara con un identificador de persona.

Parameters:

faceId - FaceId la cara viene de Face - Detect.

personGroupId - Usar personGroupId y personId existentes para cargar rápidamente una persona especificada. personGroupId se crea en Person Groups.Create.

personId - Especifique una determinada persona en un grupo de personas. personId se crea en Persons.Create.

Returns:

observable para el objeto VerifyResult.

Throws:

IllegalArgumentException - se produce si los parámetros producen un error en la validación.