ContactKeyClient

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

Gibt einen Stream mit Aktualisierungen von Kontokontaktschlüsseln zurück.

Der Stream wird ausgegeben, wenn ein Schlüssel für eine der angegebenen accountId aktualisiert, hinzugefügt oder entfernt wird. Es wird die Liste aller Schlüssel für die angegebenen accountIds ausgegeben, nicht nur die, die aktualisiert wurden.

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

Ruft alle Einträge für Kontaktschlüssel für die Ende-zu-Ende-Verschlüsselung ab, die zu Apps gehören, die für den Anrufer sichtbar sind. Die Schlüssel werden von deviceId-, timeUpdated- und keyValue-Daten bereinigt.

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

Gibt alle Einträge für selbst generierte Schlüssel für die Ende-zu-Ende-Verschlüsselung zurück, die zu Apps gehören, die für den Anrufer sichtbar sind. Die Schlüssel werden von deviceId-, timeUpdated- und keyValue-Daten bereinigt.

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

Ruft alle Kontakt-Ende-zu-Ende-Verschlüsselungsschlüssel ab, die zur Anrufer-App gehören, unabhängig davon, ob sie einem Kontakt zugeordnet sind oder nicht.

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

Ruft alle Kontaktschlüssel für die Ende-zu-Ende-Verschlüsselung ab, die zur Anrufer-App gehören, und zwar für alle Kontakte.

Mit dieser Methode sollten nur Schlüssel abgerufen werden, denen mindestens ein Kontakt zugeordnet ist. Wenn Sie Schlüssel abrufen müssen, die nicht mit Kontakten verknüpft sind, verwenden Sie stattdessen getAllOwnerE2eeAccountContactKeys.

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

Ruft alle Einträge für Ende-zu-Ende-Verschlüsselungs-Kontaktschlüssel ab, die zur Anrufer-App und zum Konto des Anrufers gehören, und zwar für alle Kontakte. Enthält Schlüssel, die keinem Kontakt zugeordnet sind.

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

Ruft einen Eintrag für den Ende-zu-Ende-Verschlüsselungskontaktschlüssel anhand von lookupKey, deviceId, accountId und dem abgeleiteten Paketnamen des Anrufers ab.

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

Gibt einen Eintrag für den selbst generierten Schlüssel für die Ende-zu-Ende-Verschlüsselung zurück, der auf deviceId, accountId und dem abgeleiteten Paketnamen des Aufrufers basiert.

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

Gibt die maximal zulässige Größe eines Schlüssels in Byte zurück.

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

Gibt einen Intent zurück, um die Onboarding-Aktivität anzuzeigen, und markiert, dass das Onboarding auf diesem Gerät angezeigt wurde. Dazu ist ein nextActivity erforderlich, der entweder der String show oder scan sein kann. Wenn scan, ist die lookupKey des zu scannenden Kontakts erforderlich.

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

Ruft alle Einträge für Ende-zu-Ende-Verschlüsselungs-Kontaktschlüssel für ein bestimmtes lookupKey ab, die zur aufrufenden App gehören.

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

Gibt alle Einträge für selbst generierte Ende-zu-Ende-Verschlüsselungsschlüssel zurück, die der aufrufenden App gehören.

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

Gibt einen Intent für die Aktivität „QR-Code scannen“ zurück.

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

Gibt einen Intent für die Aktivität „QR-Code scannen“ für ein bestimmtes Konto zurück.

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

Gibt einen Intent für die Aktivität „QR-Code anzeigen“ zurück.

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

Gibt eine Aufgabe zurück, die unabhängig davon, ob die API verfügbar ist oder nicht, erfolgreich abgeschlossen wird.

Wenn die API verfügbar ist, hat die zurückgegebene Aufgabe das Ergebnis „true“, andernfalls „false“.

Ausnahmen, die normalerweise ausgelöst werden, wenn die API nicht verfügbar ist, werden abgefangen und stattdessen wird eine Aufgabe zurückgegeben, die „false“ zurückgibt.

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

Registriert einen Listener für Aktualisierungen von Kontokontaktschlüsseln.

Der Listener wird aufgerufen, wenn ein Schlüssel für eine der angegebenen accountId aktualisiert, hinzugefügt oder entfernt wird. Sie wird mit der Liste aller Schlüssel für die angegebenen accountIds aufgerufen, nicht nur mit den aktualisierten.

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

Entfernt einen Kontakt-Schlüsseleintrag für ein Konto mit Ende-zu-Ende-Verschlüsselung, der zur Anrufer-App gehört.

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

Entfernt einen Eintrag für den Ende-zu-Ende-Verschlüsselungskontaktschlüssel, der zur Anrufer-App gehört.

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

Entfernt einen Eintrag für den selbst generierten Schlüssel für die Ende-zu-Ende-Verschlüsselung anhand der deviceId und des abgeleiteten Paketnamens des Aufrufers.

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

Hebt die Registrierung eines Listeners für Aktualisierungen von Konto-Kontaktschlüsseln auf.

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

Fügt eine Reihe von Kontokontaktschlüsseln ein.

Verhält sich ähnlich wie updateOrInsertE2eeContactKey, ermöglicht aber das gleichzeitige Einfügen/Aktualisieren mehrerer Schlüssel. Jeder Schlüssel wird in einer eigenen Transaktion eingefügt. Daher werden einige Schlüssel möglicherweise eingefügt, auch wenn für die Aufgabe eine Ausnahme ausgelöst wird.

Clients können vorübergehende Fehler beheben, indem sie den gesamten Batch noch einmal senden, da diese API den Status bereits eingefügter Schlüssel nicht ändert.

Für jeden Schlüssel wird, wenn ein „lookupKey“ angegeben ist, aber die grundlegenden Kontaktinformationen (displayName, phoneNumber, emailAddress) nicht, auch versucht, den Namen, die Telefonnummer und die E-Mail-Adresse des Kontakts vom Contacts Provider abzurufen. Beim Abrufen des Schlüssels sollten Kontaktverwaltungs-Apps diese Informationen verwenden, um sicherzustellen, dass der Schlüssel nur für den Kontakt verwendet wird, für den er vorgesehen war.

Die Android Key Verification App speichert diese Informationen auf dem Gerät und gibt sie nur an API-Aufrufer mit der Berechtigung READ_CONTACTS weiter.

Wenn für einen Schlüssel kein „lookupKey“ angegeben wird, speichert diese API einen Schlüssel, der nicht mit einem Kontakt verknüpft ist.

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

Fügt einen neuen Eintrag in die Tabelle mit den Kontakt-Ende-zu-Ende-Verschlüsselungsschlüsseln ein oder aktualisiert einen vorhandenen Eintrag. Der eingefügte/aktualisierte Kontaktschlüssel für die Ende-zu-Ende-Verschlüsselung gehört der Anrufer-App.

Über diese API werden auch der Name, die Telefonnummer und die E-Mail-Adresse des Kontakts aus dem Contacts Provider zusammen mit dem Schlüssel gespeichert. Beim Abrufen des Schlüssels sollten Kontaktverwaltungs-Apps diese Informationen verwenden, um sicherzustellen, dass der Schlüssel nur für den Kontakt verwendet wird, für den er vorgesehen war.

Die Android Key Verification App speichert diese Informationen auf dem Gerät und gibt sie nur an API-Aufrufer mit der Berechtigung READ_CONTACTS weiter.

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

Fügt einen neuen Eintrag in die Tabelle mit den Kontakt-Ende-zu-Ende-Verschlüsselungsschlüsseln ein oder aktualisiert einen vorhandenen Eintrag. Der eingefügte/aktualisierte Kontaktschlüssel für die Ende-zu-Ende-Verschlüsselung gehört der Anrufer-App.

Für jeden bereitgestellten Suchschlüssel werden mit dem Schlüssel auch der Name, die Telefonnummer und die E‑Mail-Adresse des Kontakts aus dem Contacts Provider gespeichert. Beim Abrufen des Schlüssels sollten Kontaktverwaltungs-Apps diese Informationen verwenden, um sicherzustellen, dass der Schlüssel nur für den Kontakt verwendet wird, für den er vorgesehen war.

Die Android Key Verification App speichert diese Informationen auf dem Gerät und gibt sie nur an API-Aufrufer mit der Berechtigung READ_CONTACTS weiter.

Wenn die Liste der Suchschlüssel leer ist, wird mit dieser API ein Schlüssel gespeichert, der keinem Kontakt zugeordnet ist.

Wenn Sie diese API mit einem oder mehreren Suchschlüsseln aufrufen, werden die Schlüsselmetadaten aktualisiert, um sie den angegebenen Kontakten zuzuordnen. Vorhandene Zuordnungen für Kontakte, die nicht in der Liste enthalten sind, werden jedoch nicht entfernt. Wenn Sie die Verknüpfung zwischen einem Kontakt und einem Schlüssel entfernen möchten, rufen Sie removeE2eeContactKey mit dem entsprechenden Suchschlüssel auf.

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

Fügt einen neuen Eintrag in die Tabelle mit den End-to-End-Verschlüsselungs-Selbstschlüsseln ein oder aktualisiert einen vorhandenen Eintrag.