ContactKeyClient

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

Menampilkan alur pembaruan kunci kontak akun.

Alur akan dipancarkan saat kunci apa pun untuk accountId yang diberikan diperbarui, ditambahkan, atau dihapus. Tindakan ini akan memancarkan daftar semua kunci untuk accountId yang diberikan, bukan hanya kunci yang diperbarui.

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

Mengambil semua entri kunci kontak enkripsi end-to-end yang termasuk dalam aplikasi yang terlihat oleh pemanggil. Kunci akan dihapus dari data deviceId, timeUpdated, dan keyValue.

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

Menampilkan semua entri kunci mandiri enkripsi menyeluruh milik aplikasi yang terlihat oleh pemanggil. Kunci akan dihapus dari data deviceId, timeUpdated, dan keyValue.

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

Mengambil semua kunci kontak akun enkripsi end-to-end yang dimiliki aplikasi pemanggil, baik yang terkait dengan kontak maupun tidak.

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

Mengambil semua kunci kontak enkripsi end-to-end yang dimiliki aplikasi pemanggil, di semua kontak.

Metode ini hanya boleh digunakan untuk mengambil kunci yang memiliki setidaknya satu kontak terkait. Jika Anda perlu mengambil kunci yang tidak terkait dengan kontak mana pun, gunakan getAllOwnerE2eeAccountContactKeys.

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

Mengambil semua entri kunci kontak enkripsi end-to-end yang dimiliki aplikasi pemanggil dan akun pemanggil, di semua kontak. Mencakup kunci yang tidak dikaitkan dengan kontak mana pun.

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

Mengambil entri kunci kontak enkripsi end-to-end yang diberikan lookupKey, deviceId, accountId, dan nama paket pemanggil yang disimpulkan.

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

Menampilkan entri kunci mandiri enkripsi end-to-end yang diberikan deviceId, accountId, dan nama paket pemanggil yang disimpulkan.

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

Menampilkan ukuran maksimum yang diizinkan untuk kunci dalam byte.

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

Menampilkan intent untuk menampilkan aktivitas Orientasi, dan menandai bahwa Orientasi telah ditampilkan di perangkat ini. Hal ini memerlukan nextActivity, yang dapat berupa string show atau scan. Jika scan, lookupKey kontak yang akan dipindai harus ada.

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

Mengambil semua entri kunci kontak enkripsi end-to-end untuk lookupKey tertentu yang termasuk dalam aplikasi pemanggil.

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

Menampilkan semua entri kunci mandiri enkripsi end-to-end yang dimiliki oleh aplikasi pemanggil.

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

Menampilkan intent ke aktivitas "Pindai Kode QR".

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

Menampilkan intent ke aktivitas "Pindai Kode QR" untuk akun tertentu.

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

Menampilkan intent ke aktivitas "Tampilkan Kode QR".

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

Menampilkan Tugas yang berhasil diselesaikan, baik API tersedia maupun tidak.

Jika API tersedia, tugas yang ditampilkan akan memiliki hasil benar, dan salah jika tidak.

Pengecualian yang biasanya muncul saat API tidak tersedia akan ditangkap dan tugas yang berhasil menampilkan nilai salah akan ditampilkan sebagai gantinya.

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

Mendaftarkan pemroses untuk pembaruan kunci kontak akun.

Pemroses akan dipanggil saat kunci apa pun untuk accountId yang diberikan diperbarui, ditambahkan, atau dihapus. Fungsi ini akan dipanggil dengan daftar semua kunci untuk accountId yang diberikan, bukan hanya kunci yang diperbarui.

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

Menghapus entri kunci kontak akun enkripsi end-to-end milik aplikasi pemanggil.

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

Menghapus entri kunci kontak enkripsi menyeluruh yang dimiliki aplikasi pemanggil.

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

Menghapus entri kunci mandiri enkripsi end-to-end yang diberikan deviceId dan nama paket pemanggil yang disimpulkan.

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

Membatalkan pendaftaran pemroses untuk pembaruan kunci kontak akun.

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

Menyisipkan batch kunci kontak akun.

Berperilaku serupa dengan updateOrInsertE2eeContactKey, tetapi memungkinkan beberapa kunci disisipkan/diperbarui sekaligus. Setiap kunci dimasukkan dalam transaksinya sendiri, sehingga beberapa kunci dapat dimasukkan meskipun tugas memunculkan pengecualian.

Klien dapat memilih untuk menangani kegagalan sementara dengan mengirim ulang seluruh batch, karena API ini tidak akan memengaruhi status kunci yang sudah dimasukkan.

Untuk setiap kunci, jika lookupKey diberikan tetapi info dasar kontak (displayName, phoneNumber, emailAddress) tidak diberikan, API ini juga akan mencoba mengambil nama, nomor telepon, dan alamat email kontak dari Penyedia Kontak. Saat mengambil kunci, aplikasi pengelolaan kontak harus menggunakan informasi ini untuk memastikan bahwa kunci hanya digunakan untuk kontak yang ditujukan untuknya.

Aplikasi Verifikasi Kunci Android menyimpan informasi ini di perangkat dan hanya menunjukkannya kepada pemanggil API yang memiliki izin READ_CONTACTS.

Jika tidak ada lookupKey yang diberikan untuk kunci, API ini akan menyimpan kunci yang tidak terikat ke kontak mana pun.

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

Menyisipkan entri baru ke dalam tabel kunci kontak enkripsi end-to-end atau memperbarui entri jika sudah ada. Kunci kontak enkripsi end-to-end yang disisipkan/diperbarui dimiliki oleh aplikasi pemanggil.

API ini juga akan menyimpan nama, nomor telepon, dan alamat email kontak dari Penyedia Kontak, beserta kuncinya. Saat mengambil kunci, aplikasi pengelolaan kontak harus menggunakan informasi ini untuk memastikan bahwa kunci hanya digunakan untuk kontak yang ditujukan untuknya.

Aplikasi Verifikasi Kunci Android menyimpan informasi ini di perangkat dan hanya menunjukkannya kepada pemanggil API yang memiliki izin READ_CONTACTS.

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

Menyisipkan entri baru ke dalam tabel kunci kontak enkripsi end-to-end atau memperbarui entri jika sudah ada. Kunci kontak enkripsi end-to-end yang disisipkan/diperbarui dimiliki oleh aplikasi pemanggil.

Untuk setiap kunci penelusuran yang diberikan, API ini juga akan menyimpan nama, nomor telepon, dan alamat email kontak dari Penyedia Kontak, beserta kuncinya. Saat mengambil kunci, aplikasi pengelolaan kontak harus menggunakan informasi ini untuk memastikan bahwa kunci hanya digunakan untuk kontak yang ditujukan untuknya.

Aplikasi Verifikasi Kunci Android menyimpan informasi ini di perangkat dan hanya menunjukkannya kepada pemanggil API yang memiliki izin READ_CONTACTS.

Jika daftar kunci penelusuran kosong, API ini akan menyimpan kunci yang tidak terkait dengan kontak mana pun.

Memanggil API ini dengan satu atau beberapa kunci penelusuran akan memperbarui metadata kunci untuk mengaitkannya dengan kontak yang diberikan, tetapi tidak akan menghapus pengaitan yang ada untuk kontak yang tidak diberikan dalam daftar. Untuk menghapus atribusi antara kontak dan kunci, panggil removeE2eeContactKey dengan kunci penelusuran yang sesuai.

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

Menyisipkan entri baru ke dalam tabel kunci mandiri enkripsi end-to-end atau memperbarui entri jika sudah ada.