ContactKeyClient

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

Hesap kişisi anahtarı güncellemelerinin akışını döndürür.

Akış, sağlanan herhangi bir accountId için herhangi bir anahtar güncellendiğinde, eklendiğinde veya kaldırıldığında yayınlanır. Yalnızca güncellenenler değil, sağlanan accountId'ler için tüm anahtarların listesini verir.

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

Arayan tarafından görülebilen uygulamalara ait tüm uçtan uca şifreleme kişi anahtarı girişlerini alır. Anahtarlardan deviceId, timeUpdated ve keyValue verileri kaldırılır.

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

Arayan tarafından görülebilen uygulamalara ait tüm uçtan uca şifreleme kendi anahtar girişlerini döndürür. Anahtarlardan deviceId, timeUpdated ve keyValue verileri kaldırılır.

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

Arayan uygulamasına ait tüm uçtan uca şifreleme hesabı kişi anahtarlarını (bir kişiyle ilişkilendirilmiş olsun veya olmasın) alır.

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

Arayan uygulamasına ait tüm uçtan uca şifreleme iletişim anahtarlarını tüm kişilerde alır.

Bu yöntem yalnızca kendileriyle ilişkilendirilmiş en az bir kişi olan anahtarları almak için kullanılmalıdır. Herhangi bir kişiyle ilişkilendirilmemiş anahtarları almanız gerekiyorsa bunun yerine getAllOwnerE2eeAccountContactKeys simgesini kullanın.

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

Arayan uygulamasına ve arayanın hesabına ait tüm uçtan uca şifreleme kişi anahtarı girişlerini tüm kişilerde alır. Herhangi bir kişiyle ilişkilendirilmemiş anahtarlar dahildir.

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

lookupKey, deviceId, accountId ve çıkarılan arayan paket adı verildiğinde uçtan uca şifreleme kişi anahtarı girişini alır.

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

deviceId, accountId ve arayanın çıkarılan paket adı göz önüne alındığında uçtan uca şifreleme için kendi anahtar girişini döndürür.

fun getMaxKeySizeBytes(): Task<Int>

Bir anahtarın izin verilen maksimum boyutunu bayt cinsinden döndürür.

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

İlk katılım etkinliğini gösterme amacını döndürür ve ilk katılımın bu cihazda gösterildiğini işaretler. Bu işlem için nextActivity gerekir. Bu, show veya scan dizesi olabilir. scan ise taranacak kişinin lookupKey gereklidir.

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

Arayan uygulamasına ait belirli bir lookupKey için tüm uçtan uca şifreleme iletişim anahtarı girişlerini alır.

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

Arayan uygulamaya ait tüm uçtan uca şifreleme kendi anahtar girişlerini döndürür.

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

"QR Kodu Tara" etkinliğine yönelik bir amaç döndürür.

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

Belirli bir hesap için "QR Kodu Tara" etkinliğine bir amaç döndürür.

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

"QR kodu göster" etkinliğine bir amaç döndürür.

fun isEnabled(): Task<Boolean>

API'nin kullanılabilir olup olmamasından bağımsız olarak başarıyla tamamlanan bir Görev döndürür.

API kullanılabiliyorsa döndürülen görev doğru, aksi takdirde yanlış sonucunu verir.

API kullanılamadığında genellikle oluşturulan istisnalar yakalanır ve bunun yerine görevi başarıyla tamamlayıp false değerini döndüren bir görev döndürülür.

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

Hesap iletişim anahtarı güncellemeleri için bir işleyici kaydeder.

Sağlanan herhangi bir accountId için herhangi bir anahtar güncellendiğinde, eklendiğinde veya kaldırıldığında dinleyici çağrılır. Bu işlev, yalnızca güncellenenler değil, sağlanan accountId'ler için tüm anahtarların listesiyle birlikte çağrılır.

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

Arayan uygulamasına ait bir uçtan uca şifreleme hesabı kişi anahtarı girişini kaldırır.

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

Arayan uygulamasına ait bir uçtan uca şifreleme iletişim anahtarı girişini kaldırır.

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

Arayanın cihaz kimliği ve çıkarılan paket adı verildiğinde uçtan uca şifreleme için kendi kendine anahtar girişini kaldırır.

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

Hesap iletişim anahtarı güncellemeleri için bir dinleyici kaydını siler.

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

Bir grup hesap kişisi anahtarı ekler.

updateOrInsertE2eeContactKey ile benzer şekilde çalışır ancak birden fazla anahtarın aynı anda eklenmesine/güncellenmesine olanak tanır. Her anahtar kendi işlemine eklenir. Bu nedenle, görev bir istisna oluştursa bile bazı anahtarlar eklenebilir.

Bu API, önceden eklenmiş anahtarların durumunu etkilemeyeceğinden istemciler, geçici hataları tüm grubu yeniden göndererek işlemeyi tercih edebilir.

Her anahtar için, lookupKey sağlanmış ancak kişi temel bilgileri (displayName, phoneNumber, emailAddress) sağlanmamışsa bu API, kişinin adını, telefon numarasını ve e-posta adresini Contacts Provider'dan da almaya çalışır. Anahtar alınırken, anahtarın yalnızca amaçlandığı kişi için kullanıldığından emin olmak üzere kişi yönetimi uygulamaları bu bilgileri kullanmalıdır.

Android Key Verification uygulaması bu bilgileri cihaz üzerinde depolar ve yalnızca READ_CONTACTS iznine sahip API arayanlara gösterir.

Bir anahtar için lookupKey sağlanmazsa bu API, herhangi bir kişiye bağlı olmayan bir anahtar depolar.

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

Uçtan uca şifreleme iletişim anahtarları tablosuna yeni bir giriş ekler veya mevcut bir girişi günceller. Eklenen/güncellenen uçtan uca şifreleme iletişim anahtarı, arayan uygulamasına aittir.

Bu API, anahtarın yanı sıra Contacts Provider'dan alınan kişinin adını, telefon numarasını ve e-posta adresini de depolar. Anahtar alınırken, anahtarın yalnızca amaçlandığı kişi için kullanıldığından emin olmak üzere kişi yönetimi uygulamaları bu bilgileri kullanmalıdır.

Android Key Verification uygulaması bu bilgileri cihaz üzerinde depolar ve yalnızca READ_CONTACTS iznine sahip API arayanlara gösterir.

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

Uçtan uca şifreleme iletişim anahtarları tablosuna yeni bir giriş ekler veya mevcut bir girişi günceller. Eklenen/güncellenen uçtan uca şifreleme iletişim anahtarı, arayan uygulamasına aittir.

Bu API, sağlanan her arama anahtarı için anahtarla birlikte Contacts Provider'dan alınan kişinin adını, telefon numarasını ve e-posta adresini de depolar. Anahtar alınırken, anahtarın yalnızca amaçlandığı kişi için kullanıldığından emin olmak üzere kişi yönetimi uygulamaları bu bilgileri kullanmalıdır.

Android Key Verification uygulaması bu bilgileri cihaz üzerinde depolar ve yalnızca READ_CONTACTS iznine sahip API arayanlara gösterir.

Arama anahtarları listesi boşsa bu API, herhangi bir kişiyle ilişkilendirilmeyen bir anahtar depolar.

Bu API'yi bir veya daha fazla arama anahtarıyla çağırmak, anahtar meta verilerini güncelleyerek anahtarı sağlanan kişilerle ilişkilendirir ancak listede sağlanmayan kişiler için mevcut ilişkilendirmeleri kaldırmaz. Bir kişi ile anahtar arasındaki ilişkilendirmeyi kaldırmak için uygun arama anahtarıyla removeE2eeContactKey işlevini çağırın.

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

Uçtan uca şifreleme için kendi anahtarlarınızı içeren tabloya yeni bir giriş ekler veya mevcut bir girişi günceller.