ContactKeyClient

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

fun getMaxKeySizeBytes(): Task<Int>

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

fun getOnboardingIntent(
    nextActivity: OnboardingNextActivity,
    lookupKey: String?,
    packageName: String?
): Task<PendingIntent>

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

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

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

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

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

fun getScanQrCodeIntent(lookupKey: String, skipOnboarding: Boolean = false): Task<PendingIntent>

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

fun getScanQrCodeIntentForAccount(packageName: String, accountId: String): Task<PendingIntent>

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

fun getShowQrCodeIntent(packageName: String?, skipOnboarding: Boolean = false): Task<PendingIntent>

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

fun isEnabled(): Task<Boolean>

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

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

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

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

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

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

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

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

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

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

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

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

@CanIgnoreReturnValue
fun unregisterAccountContactKeysListener(
    listener: OnAccountContactKeysUpdatedListener
): Task<Boolean>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@RequiresPermission(value = "android.permission.WRITE_CONTACTS")
fun updateOrInsertE2eeSelfKey(
    deviceId: String,
    accountId: String,
    keyValue: ByteArray
): Task<Void>

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