ContactKeyClient

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

Возвращает поток обновлений ключей контактов учетной записи.

Данный алгоритм будет запускаться при обновлении, добавлении или удалении любого ключа для любого предоставленного accountId. Он выведет список всех ключей для предоставленных accountId, а не только тех, которые были обновлены.

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

Возвращает Intent для действия "Сканировать QR-код".

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

Возвращает намерение для действия "Сканировать QR-код" для конкретной учетной записи.

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

Возвращает Intent для действия "Показать 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. Он будет вызываться со списком всех ключей для предоставленных accountId, а не только тех, которые были обновлены.

@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 также попытается получить имя, номер телефона и адрес электронной почты контакта из Contacts Provider. При получении ключа приложения для управления контактами должны использовать эту информацию, чтобы убедиться, что ключ используется только для того контакта, для которого он был предназначен.

Приложение Android Key Verification хранит эту информацию на устройстве и предоставляет к ней доступ только тем пользователям API, которые имеют разрешение READ_CONTACTS .

Если для ключа не указан 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 Key Verification хранит эту информацию на устройстве и предоставляет к ней доступ только тем пользователям API, которые имеют разрешение READ_CONTACTS .

@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 Key Verification хранит эту информацию на устройстве и предоставляет к ней доступ только тем пользователям API, которые имеют разрешение READ_CONTACTS .

Если список ключей поиска пуст, этот API сохранит ключ, не связанный ни с одним контактом.

Вызов этого API с одним или несколькими ключами поиска обновит метаданные ключа, связав его с указанными контактами, но не удалит существующие связи для контактов, не указанных в списке. Чтобы удалить связь между контактом и ключом, вызовите метод removeE2eeContactKey с соответствующим ключом поиска.

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

Вставляет новую запись в таблицу самоключа сквозного шифрования или обновляет существующую, если она уже есть.