Associando faces a um usuário - Amazon Rekognition

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Associando faces a um usuário

Você pode usar a AssociateFacesoperação para associar várias faces individuais a um único usuário. Para associar um rosto a um usuário, você deve primeiro criar uma coleção e um usuário. Observe que os vetores de face devem residir na mesma coleção em que o vetor do usuário reside.

Para associar faces (SDK)
  1. Se ainda não tiver feito isso:

    1. Crie ou atualize um usuário com permissões AmazonRekognitionFullAccess. Para obter mais informações, consulte Etapa 1: Configure uma conta da AWS e crie um usuário.

    2. Instale e configure o AWS CLI e AWS SDKs o. Para obter mais informações, consulte Etapa 2: Configurar a AWS e os AWS CLI SDKs.

  2. Use os exemplos a seguir para chamar a operação AssociateFaces.

    Java

    Este exemplo de código Java associa um rosto a um usuário.

    import java.util.Arrays; import java.util.List; import com.amazonaws.services.rekognition.AmazonRekognition; import com.amazonaws.services.rekognition.AmazonRekognitionClientBuilder; import com.amazonaws.services.rekognition.model.AssociateFacesRequest; import com.amazonaws.services.rekognition.model.AssociateFacesResult; public class AssociateFaces { public static void main(String[] args) throws Exception { AmazonRekognition rekognitionClient = AmazonRekognitionClientBuilder.defaultClient(); /* Replace the below configurations to allow you successfully run the example @collectionId: The collection where user and faces are stored @userId: The user which faces will get associated to @faceIds: The list of face IDs that will get associated to the given user @userMatchThreshold: Minimum User match confidence required for the face to be associated with a User that has at least one faceID already associated */ String collectionId = "MyCollection"; String userId = "demoUser"; String faceId1 = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"; String faceId2 = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"; List<String> faceIds = Arrays.asList(faceid1,faceid2); float userMatchThreshold = 0f; System.out.println("Associating faces to the existing user: " + userId); AssociateFacesRequest request = new AssociateFacesRequest() .withCollectionId(collectionId) .withUserId(userId) .withFaceIds(faceIds) .withUserMatchThreshold(userMatchThreshold); AssociateFacesResult result = rekognitionClient.associateFaces(request); System.out.println("Successful face associations: " + result.getAssociatedFaces().size()); System.out.println("Unsuccessful face associations: " + result.getUnsuccessfulFaceAssociations().size()); } }
    AWS CLI

    Esse AWS CLI comando associa um rosto a um usuário, usando a associate-faces CLI operação.

    aws rekognition associate-faces --user-id user-id --face-ids face-id-1 face-id-2 --collection-id collection-name --region region-name
    Python

    Este exemplo de código em Python associa uma face a um usuário.

    from botocore.exceptions import ClientError import boto3 import logging logger = logging.getLogger(__name__) session = boto3.Session(profile_name='profile-name') client = session.client('rekognition') def associate_faces(collection_id, user_id, face_ids): """ Associate stored faces within collection to the given user :param collection_id: The ID of the collection where user and faces are stored. :param user_id: The ID of the user that we want to associate faces to :param face_ids: The list of face IDs to be associated to the given user :return: response of AssociateFaces API """ logger.info(f'Associating faces to user: {user_id}, {face_ids}') try: response = client.associate_faces( CollectionId=collection_id, UserId=user_id, FaceIds=face_ids ) print(f'- associated {len(response["AssociatedFaces"])} faces') except ClientError: logger.exception("Failed to associate faces to the given user") raise else: print(response) return response def main(): face_ids = ["faceId1", "faceId2"] collection_id = "collection-id" user_id = "user-id" associate_faces(collection_id, user_id, face_ids) if __name__ == "__main__": main()

AssociateFaces resposta da operação

A resposta para AssociateFaces inclui o UserStatus, que é o status da solicitação de dissociação, bem como uma lista de itens FaceIds a serem associados. Uma lista de UnsuccessfulFaceAssociations também é retornada. Depois de enviar uma solicitação para AssociateFaces, a operação pode levar cerca de um minuto para ser concluída.

Por esse motivo, o UserStatus é retornado, que pode ter os seguintes valores:

  • CREATED- Indica que o 'Usuário' foi criado com sucesso e nenhum rosto está associado a ele atualmente. O 'usuário' estará nesse estado antes que qualquer chamada 'AssociateFaces' bem-sucedida seja feita.

  • UPDATING- Indica que o 'Usuário' está sendo atualizado para refletir as faces recém-associadas/desassociadas e se tornará em alguns segundos. ACTIVE Os resultados da pesquisa podem conter "Usuário" nesse estado e os clientes podem optar por ignorá-lo nos resultados retornados.

  • ACTIVE- Indica que o 'Usuário' está atualizado para refletir todas as faces associadas/desassociadas e está em um estado pesquisável.

{ "UnsuccessfulFaceAssociations": [ { "Reasons": [ "LOW_MATCH_CONFIDENCE" ], "FaceId": "f5817d37-94f6-0000-bfee-1a2b3c4d5e6f", "Confidence": 0.9375374913215637 }, { "Reasons": [ "ASSOCIATED_TO_A_DIFFERENT_IDENTITY" ], "FaceId": "851cb847-dccc-1111-bfee-1a2b3c4d5e6f", "UserId": "demoUser2" } ], "UserStatus": "UPDATING", "AssociatedFaces": [ { "FaceId": "35ebbb41-7f67-2222-bfee-1a2b3c4d5e6f" } ] }