ContactKeyClient

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Flow<@NonNull List<@NonNull E2eeAccountContactKeyParcelable>> getAccountContactKeysFlow(@NonNull List<@NonNull String> accountIds)

Retorna um fluxo de atualizações de chaves de contato da conta.

O fluxo será emitido quando qualquer chave de qualquer accountId fornecido for atualizada, adicionada ou removida. Ele vai emitir a lista de todas as chaves para os accountIds fornecidos, não apenas as que foram atualizadas.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<@NonNull E2eeContactKeyListParcelable> getAllE2eeContactKeys(@NonNull String lookupKey)

Recupera todas as entradas de chave de contato de criptografia de ponta a ponta pertencentes a apps visíveis para o autor da chamada. As chaves serão removidas dos dados de deviceId, timeUpdated e keyValue.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<@NonNull E2eeSelfKeyListParcelable> getAllE2eeSelfKeys()

Retorna todas as entradas de chave própria de criptografia de ponta a ponta pertencentes a apps visíveis para o autor da chamada. As chaves serão removidas dos dados de deviceId, timeUpdated e keyValue.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<@NonNull ImmutableList<@NonNull E2eeAccountContactKeyParcelable>> getAllOwnerE2eeAccountContactKeys()

Recupera todas as chaves de contato da conta de criptografia de ponta a ponta que pertencem ao app de chamada, estejam elas associadas a um contato ou não.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<@NonNull E2eeContactKeyListParcelable> getAllOwnerE2eeContactKeys()

Recupera todas as chaves de contato de criptografia de ponta a ponta que pertencem ao app de chamada em todos os contatos.

Esse método deve ser usado apenas para recuperar chaves que tenham pelo menos um contato associado a elas. Se você precisar recuperar chaves que não estão associadas a nenhum contato, use getAllOwnerE2eeAccountContactKeys.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<@NonNull ImmutableList<@NonNull E2eeAccountContactKeyParcelable>> getE2eeAccountKeysForAccount(@NonNull String accountId)

Recupera todas as entradas de chave de contato de criptografia de ponta a ponta que pertencem ao app e à conta do autor da chamada em todos os contatos. Inclui chaves não associadas a nenhum contato.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<E2eeContactKeyParcelable> getE2eeContactKey(
    @NonNull String lookupKey,
    @NonNull String deviceId,
    @NonNull String accountId
)

Recupera uma entrada de chave de contato de criptografia de ponta a ponta com base no lookupKey, deviceId, accountId e no nome do pacote do autor da chamada inferido.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<E2eeSelfKeyParcelable> getE2eeSelfKey(@NonNull String deviceId, @NonNull String accountId)

Retorna uma entrada de chave própria de criptografia de ponta a ponta com base no deviceId, no accountId e no nome do pacote inferido do autor da chamada.

abstract @NonNull Task<@NonNull Integer> getMaxKeySizeBytes()

Retorna o tamanho máximo permitido de uma chave em bytes.

abstract @NonNull Task<@NonNull PendingIntent> getOnboardingIntent(
    @NonNull OnboardingNextActivity nextActivity,
    String lookupKey,
    String packageName
)

Retorna uma intent para mostrar a atividade de integração e marca que a integração foi mostrada neste dispositivo. Isso requer um nextActivity, que pode ser a string show ou scan. Se scan, o lookupKey do contato a ser verificado é obrigatório.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<@NonNull E2eeContactKeyListParcelable> getOwnerE2eeContactKeys(@NonNull String lookupKey)

Recupera todas as entradas de chave de contato de criptografia de ponta a ponta para um determinado lookupKey que pertence ao app de chamada.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<@NonNull E2eeSelfKeyListParcelable> getOwnerE2eeSelfKeys()

Retorna todas as entradas de chave própria de criptografia de ponta a ponta pertencentes ao app de chamada.

abstract @NonNull Task<@NonNull PendingIntent> getScanQrCodeIntent(@NonNull String lookupKey, boolean skipOnboarding)

Retorna uma intent para a atividade "Ler o QR code".

abstract @NonNull Task<@NonNull PendingIntent> getScanQrCodeIntentForAccount(
    @NonNull String packageName,
    @NonNull String accountId
)

Retorna uma intent para a atividade "Ler o QR code" de uma conta específica.

abstract @NonNull Task<@NonNull PendingIntent> getShowQrCodeIntent(String packageName, boolean skipOnboarding)

Retorna uma intent para a atividade "Mostrar QR code".

abstract @NonNull Task<@NonNull Boolean> isEnabled()

Retorna uma tarefa que é concluída com êxito, esteja a API disponível ou não.

Se a API estiver disponível, a tarefa retornada terá um resultado verdadeiro. Caso contrário, será falso.

As exceções normalmente geradas quando a API está indisponível serão capturadas, e uma tarefa que retorna "false" será retornada.

@RequiresPermission(value = "android.permission.READ_CONTACTS")
abstract @NonNull Task<@NonNull Void> registerAccountContactKeysListener(
    @NonNull List<@NonNull String> accountIds,
    @NonNull OnAccountContactKeysUpdatedListener listener
)

Registra um listener para atualizações de chaves de contato da conta.

O listener será chamado quando qualquer chave de qualquer accountId fornecido for atualizada, adicionada ou removida. Ela será chamada com a lista de todas as chaves dos accountIds fornecidos, não apenas as que foram atualizadas.

@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
abstract @NonNull Task<@NonNull Void> removeE2eeAccountContactKey(
    @NonNull String deviceId,
    @NonNull String accountId
)

Remove uma entrada de chave de contato da conta de criptografia de ponta a ponta pertencente ao app de chamada.

@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
abstract @NonNull Task<@NonNull Void> removeE2eeContactKey(
    @NonNull String lookupKey,
    @NonNull String deviceId,
    @NonNull String accountId
)

Remove uma entrada de chave de contato de criptografia de ponta a ponta pertencente ao app de chamada.

@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
abstract @NonNull Task<@NonNull Void> removeE2eeSelfKey(@NonNull String deviceId, @NonNull String accountId)

Remove uma entrada de chave própria de criptografia de ponta a ponta usando o deviceId e o nome do pacote inferido do caller.

@CanIgnoreReturnValue
abstract @NonNull Task<@NonNull Boolean> unregisterAccountContactKeysListener(
    @NonNull OnAccountContactKeysUpdatedListener listener
)

Cancela o registro de um listener para atualizações de chaves de contato da conta.

@RequiresPermission(allOf = ["android.permission.READ_CONTACTS", "android.permission.WRITE_CONTACTS"])
abstract @NonNull Task<@NonNull Void> updateAllE2eeAccountKeys(
    @NonNull List<@NonNull E2eeAccountKeyInfo> accountKeyInfos
)

Insere um lote de chaves de contato da conta.

Funciona de maneira semelhante a updateOrInsertE2eeContactKey, mas permite que várias chaves sejam inseridas/atualizadas de uma só vez. Cada chave é inserida em uma transação própria. Portanto, algumas chaves podem ser inseridas mesmo que a tarefa gere uma exceção.

Os clientes podem optar por lidar com falhas temporárias reenviando todo o lote, já que essa API não afeta o status das chaves já inseridas.

Para cada chave, se um lookupKey for fornecido, mas as informações básicas do contato (displayName, phoneNumber, emailAddress) não forem, essa API também tentará recuperar o nome, o número de telefone e o endereço de e-mail do contato do provedor de contatos. Ao recuperar a chave, os apps de gerenciamento de contatos precisam usar essas informações para garantir que ela seja usada apenas para o contato a que se destina.

O app Android Key Verification armazena essas informações no dispositivo e as expõe apenas para chamadores de API que têm a permissão READ_CONTACTS.

Se nenhuma lookupKey for fornecida para uma chave, essa API vai armazenar uma chave que não está vinculada a nenhum contato.

@RequiresPermission(allOf = ["android.permission.READ_CONTACTS", "android.permission.WRITE_CONTACTS"])
abstract @NonNull Task<@NonNull Void> updateOrInsertE2eeContactKey(
    @NonNull String lookupKey,
    @NonNull String deviceId,
    @NonNull String accountId,
    @NonNull byte[] keyValue
)

Insere uma nova entrada na tabela de chaves de contato de criptografia de ponta a ponta ou atualiza uma se ela já existir. A chave de contato de criptografia de ponta a ponta inserida/atualizada pertence ao app autor da chamada.

Essa API também armazena o nome, o número de telefone e o endereço de e-mail do contato do Provedor de contatos, além da chave. Ao recuperar a chave, os apps de gerenciamento de contatos precisam usar essas informações para garantir que ela seja usada apenas para o contato a que se destina.

O app Android Key Verification armazena essas informações no dispositivo e as expõe apenas para chamadores de API que têm a permissão READ_CONTACTS.

@RequiresPermission(allOf = ["android.permission.READ_CONTACTS", "android.permission.WRITE_CONTACTS"])
abstract @NonNull Task<@NonNull Void> updateOrInsertE2eeContactKey(
    @NonNull List<@NonNull String> lookupKeys,
    @NonNull String deviceId,
    @NonNull String accountId,
    @NonNull byte[] keyValue
)

Insere uma nova entrada na tabela de chaves de contato de criptografia de ponta a ponta ou atualiza uma se ela já existir. A chave de contato de criptografia de ponta a ponta inserida/atualizada pertence ao app autor da chamada.

Para cada chave de pesquisa fornecida, essa API também armazena o nome, o número de telefone e o endereço de e-mail do contato do Provedor de contatos, junto com a chave. Ao recuperar a chave, os apps de gerenciamento de contatos precisam usar essas informações para garantir que ela seja usada apenas para o contato a que se destina.

O app Android Key Verification armazena essas informações no dispositivo e as expõe apenas para chamadores de API que têm a permissão READ_CONTACTS.

Se a lista de chaves de pesquisa estiver vazia, essa API vai armazenar uma chave que não está associada a nenhum contato.

Chamar essa API com uma ou mais chaves de pesquisa vai atualizar os metadados da chave para associá-la aos contatos fornecidos, mas não vai remover associações existentes para contatos que não estão na lista. Para remover uma associação entre um contato e uma chave, chame removeE2eeContactKey com a chave de pesquisa apropriada.

@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
abstract @NonNull Task<@NonNull Void> updateOrInsertE2eeSelfKey(
    @NonNull String deviceId,
    @NonNull String accountId,
    @NonNull byte[] keyValue
)

Insere uma nova entrada na tabela de autochaves de criptografia de ponta a ponta ou atualiza uma se ela já existir.