ContactKeyClient

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

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")
abstract @NonNull Task<@NonNull E2eeContactKeyListParcelable> getAllE2eeContactKeys(@NonNull String lookupKey)

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")
abstract @NonNull Task<@NonNull E2eeSelfKeyListParcelable> getAllE2eeSelfKeys()

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")
abstract @NonNull Task<@NonNull ImmutableList<@NonNull E2eeAccountContactKeyParcelable>> getAllOwnerE2eeAccountContactKeys()

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")
abstract @NonNull Task<@NonNull E2eeContactKeyListParcelable> getAllOwnerE2eeContactKeys()

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")
abstract @NonNull Task<@NonNull ImmutableList<@NonNull E2eeAccountContactKeyParcelable>> getE2eeAccountKeysForAccount(@NonNull String accountId)

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")
abstract @NonNull Task<E2eeContactKeyParcelable> getE2eeContactKey(
    @NonNull String lookupKey,
    @NonNull String deviceId,
    @NonNull String accountId
)

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")
abstract @NonNull Task<E2eeSelfKeyParcelable> getE2eeSelfKey(@NonNull String deviceId, @NonNull String accountId)

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.

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

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

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

İlk katılım etkinliğini gösterme amaçlı bir niyet 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")
abstract @NonNull Task<@NonNull E2eeContactKeyListParcelable> getOwnerE2eeContactKeys(@NonNull String lookupKey)

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")
abstract @NonNull Task<@NonNull E2eeSelfKeyListParcelable> getOwnerE2eeSelfKeys()

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

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

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

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

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

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

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

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

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")
abstract @NonNull Task<@NonNull Void> registerAccountContactKeysListener(
    @NonNull List<@NonNull String> accountIds,
    @NonNull OnAccountContactKeysUpdatedListener listener
)

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")
abstract @NonNull Task<@NonNull Void> removeE2eeAccountContactKey(
    @NonNull String deviceId,
    @NonNull String accountId
)

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

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

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

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

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
abstract @NonNull Task<@NonNull Boolean> unregisterAccountContactKeysListener(
    @NonNull OnAccountContactKeysUpdatedListener listener
)

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

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

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"])
abstract @NonNull Task<@NonNull Void> updateOrInsertE2eeContactKey(
    @NonNull String lookupKey,
    @NonNull String deviceId,
    @NonNull String accountId,
    @NonNull byte[] keyValue
)

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"])
abstract @NonNull Task<@NonNull Void> updateOrInsertE2eeContactKey(
    @NonNull List<@NonNull String> lookupKeys,
    @NonNull String deviceId,
    @NonNull String accountId,
    @NonNull byte[] keyValue
)

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")
abstract @NonNull Task<@NonNull Void> updateOrInsertE2eeSelfKey(
    @NonNull String deviceId,
    @NonNull String accountId,
    @NonNull byte[] keyValue
)

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