ContactKeyClient

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

계정 연락처 키 업데이트의 흐름을 반환합니다.

제공된 accountId의 키가 업데이트, 추가 또는 삭제되면 흐름이 방출됩니다. 업데이트된 키뿐만 아니라 제공된 accountIds의 모든 키 목록을 내보냅니다.

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

호출자에게 표시되는 앱에 속하는 모든 엔드 투 엔드 암호화 연락처 키 항목을 가져옵니다. 키에서 deviceId, timeUpdated, keyValue 데이터가 삭제됩니다.

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

호출자에게 표시되는 앱에 속하는 모든 엔드 투 엔드 암호화 자체 키 항목을 반환합니다. 키에서 deviceId, timeUpdated, keyValue 데이터가 삭제됩니다.

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

연락처와 연결되었는지 여부와 관계없이 호출자 앱에 속하는 모든 엔드 투 엔드 암호화 계정 연락처 키를 가져옵니다.

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

모든 연락처에서 호출자 앱에 속하는 모든 엔드 투 엔드 암호화 연락처 키를 가져옵니다.

이 메서드는 연결된 연락처가 하나 이상 있는 키를 가져오는 데만 사용해야 합니다. 연락처와 연결되지 않은 키를 가져와야 하는 경우 getAllOwnerE2eeAccountContactKeys를 대신 사용하세요.

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

모든 연락처에서 호출자 앱과 호출자 계정에 속하는 모든 엔드 투 엔드 암호화 연락처 키 항목을 가져옵니다. 연락처와 연결되지 않은 키를 포함합니다.

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

lookupKey, deviceId, accountId 및 추론된 호출자 패키지 이름을 기반으로 엔드 투 엔드 암호화 연락처 키 항목을 가져옵니다.

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

deviceId, accountId, 호출자의 추론된 패키지 이름을 고려하여 엔드 투 엔드 암호화 자체 키 항목을 반환합니다.

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

허용되는 키의 최대 크기(바이트)를 반환합니다.

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

온보딩 활동을 표시하는 인텐트를 반환하고 이 기기에 온보딩이 표시되었음을 표시합니다. 이를 위해서는 nextActivity이 필요하며, 이는 문자열 show 또는 scan일 수 있습니다. scan인 경우 스캔할 연락처의 lookupKey이 필요합니다.

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

호출자 앱에 속하는 지정된 lookupKey의 모든 엔드 투 엔드 암호화 연락처 키 항목을 가져옵니다.

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

호출자 앱이 소유한 모든 엔드 투 엔드 암호화 자체 키 항목을 반환합니다.

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

'QR 코드 스캔' 활동의 인텐트를 반환합니다.

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

특정 계정의 'QR 코드 스캔' 활동에 대한 인텐트를 반환합니다.

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

'QR 코드 표시' 활동의 인텐트를 반환합니다.

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

API 사용 가능 여부와 관계없이 성공적으로 완료되는 작업을 반환합니다.

API를 사용할 수 있으면 반환된 작업의 결과가 true이고, 그렇지 않으면 false입니다.

API를 사용할 수 없을 때 일반적으로 발생하는 예외가 포착되고 대신 false를 반환하는 작업이 반환됩니다.

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

계정 연락처 키 업데이트의 리스너를 등록합니다.

제공된 accountId의 키가 업데이트, 추가 또는 삭제되면 리스너가 호출됩니다. 업데이트된 키뿐만 아니라 제공된 accountIds의 모든 키 목록과 함께 호출됩니다.

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

호출자 앱에 속한 엔드 투 엔드 암호화 계정 연락처 키 항목을 삭제합니다.

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

호출자 앱에 속한 엔드 투 엔드 암호화 연락처 키 항목을 삭제합니다.

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

deviceId와 호출자의 추론된 패키지 이름을 고려하여 엔드 투 엔드 암호화 자체 키 항목을 삭제합니다.

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

계정 연락처 키 업데이트 리스너를 등록 해제합니다.

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

계정 연락처 키를 일괄 삽입합니다.

updateOrInsertE2eeContactKey와 유사하게 동작하지만 한 번에 여러 키를 삽입/업데이트할 수 있습니다. 각 키는 자체 트랜잭션에 삽입되므로 작업에서 예외가 발생하더라도 일부 키가 삽입될 수 있습니다.

이 API는 이미 삽입된 키의 상태에 영향을 미치지 않으므로 클라이언트는 전체 일괄 처리를 다시 전송하여 임시 오류를 처리할 수 있습니다.

각 키에 대해 lookupKey가 제공되지만 연락처 기본 정보 (displayName, phoneNumber, emailAddress)가 제공되지 않으면 이 API는 연락처 제공자에서 연락처의 이름, 전화번호, 이메일 주소를 가져오려고 시도합니다. 키를 가져올 때 연락처 관리 앱은 이 정보를 사용하여 키가 의도된 연락처에만 사용되도록 해야 합니다.

Android 키 확인 앱은 이 정보를 기기에 저장하고 READ_CONTACTS 권한을 보유한 API 호출자에게만 노출합니다.

키에 lookupKey가 제공되지 않으면 이 API는 연락처에 연결되지 않은 키를 저장합니다.

@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
)

엔드 투 엔드 암호화 연락처 키 테이블에 새 항목을 삽입하거나 이미 있는 경우 업데이트합니다. 삽입/업데이트된 엔드 투 엔드 암호화 연락처 키는 호출자 앱이 소유합니다.

이 API는 키와 함께 연락처 제공자의 연락처 이름, 전화번호, 이메일 주소도 저장합니다. 키를 가져올 때 연락처 관리 앱은 이 정보를 사용하여 키가 의도된 연락처에만 사용되도록 해야 합니다.

Android 키 확인 앱은 이 정보를 기기에 저장하고 READ_CONTACTS 권한을 보유한 API 호출자에게만 노출합니다.

@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
)

엔드 투 엔드 암호화 연락처 키 테이블에 새 항목을 삽입하거나 이미 있는 경우 업데이트합니다. 삽입/업데이트된 엔드 투 엔드 암호화 연락처 키는 호출자 앱이 소유합니다.

제공된 각 조회 키에 대해 이 API는 키와 함께 연락처 제공자의 연락처 이름, 전화번호, 이메일 주소도 저장합니다. 키를 가져올 때 연락처 관리 앱은 이 정보를 사용하여 키가 의도된 연락처에만 사용되도록 해야 합니다.

Android 키 확인 앱은 이 정보를 기기에 저장하고 READ_CONTACTS 권한을 보유한 API 호출자에게만 노출합니다.

조회 키 목록이 비어 있으면 이 API는 연락처와 연결되지 않은 키를 저장합니다.

하나 이상의 조회 키로 이 API를 호출하면 키 메타데이터가 업데이트되어 제공된 연락처와 연결되지만 목록에 제공되지 않은 연락처의 기존 연결은 삭제되지 않습니다. 연락처와 키 간의 연결을 삭제하려면 적절한 조회 키를 사용하여 removeE2eeContactKey를 호출합니다.

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

엔드 투 엔드 암호화 자체 키 테이블에 새 항목을 삽입하거나 이미 있는 경우 업데이트합니다.