ContactKeyClient

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

Zwraca strumień aktualizacji kluczy kontaktowych konta.

Strumień będzie emitowany, gdy dowolny klucz dla dowolnego podanego identyfikatora konta zostanie zaktualizowany, dodany lub usunięty. Zwróci listę wszystkich kluczy dla podanych identyfikatorów kont, a nie tylko tych, które zostały zaktualizowane.

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

Pobiera wszystkie wpisy kluczy kontaktów do pełnego szyfrowania, które należą do aplikacji widocznych dla elementu wywołującego. Klucze zostaną pozbawione danych deviceId, timeUpdated i keyValue.

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

Zwraca wszystkie wpisy kluczy własnych szyfrowania pełnego należące do aplikacji widocznych dla elementu wywołującego. Klucze zostaną pozbawione danych deviceId, timeUpdated i keyValue.

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

Pobiera wszystkie klucze kontaktów konta z pełnym szyfrowaniem należące do aplikacji wywołującej, niezależnie od tego, czy są powiązane z kontaktem.

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

Pobiera wszystkie klucze kontaktów do pełnego szyfrowania należące do aplikacji wywołującej we wszystkich kontaktach.

Ta metoda powinna być używana tylko do pobierania kluczy, z którymi jest powiązany co najmniej 1 kontakt. Jeśli chcesz odzyskać klucze, które nie są powiązane z żadnymi kontaktami, użyj getAllOwnerE2eeAccountContactKeys.

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

Pobiera wszystkie wpisy kluczy kontaktów do szyfrowania pełnego należące do aplikacji wywołującej i konta wywołującego we wszystkich kontaktach. Obejmuje klucze, które nie są powiązane z żadnym kontaktem.

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

Pobiera wpis klucza kontaktu pełnego szyfrowania na podstawie lookupKey, deviceId, accountId i nazwy pakietu dzwoniącego.

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

Zwraca wpis klucza własnego pełnego szyfrowania na podstawie deviceId, accountId i wywnioskowanej nazwy pakietu elementu wywołującego.

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

Zwraca maksymalny dozwolony rozmiar klucza w bajtach.

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

Zwraca intencję wyświetlenia aktywności wprowadzającej i oznacza, że została ona wyświetlona na tym urządzeniu. Wymaga to wartości nextActivity, która może być ciągiem znaków show lub scan. Jeśli scan, wymagany jest lookupKey kontaktu, który ma zostać zeskanowany.

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

Pobiera wszystkie wpisy kluczy kontaktów do pełnego szyfrowania dla danego lookupKey należące do aplikacji wywołującej.

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

Zwraca wszystkie wpisy klucza własnego pełnego szyfrowania należące do aplikacji wywołującej.

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

Zwraca intencję do aktywności „Skanuj kod QR”.

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

Zwraca intencję do działania „Skanuj kod QR” dla określonego konta.

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

Zwraca intencję do działania „Pokaż kod QR”.

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

Zwraca zadanie, które zostanie wykonane niezależnie od tego, czy interfejs API jest dostępny.

Jeśli interfejs API jest dostępny, zwrócone zadanie będzie miało wynik „true”, a w przeciwnym razie „false”.

Wyjątki zwykle zgłaszane, gdy interfejs API jest niedostępny, zostaną przechwycone, a zamiast nich zostanie zwrócone zadanie, które zakończyło się powodzeniem i zwróciło wartość false.

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

Rejestruje detektor aktualizacji kluczy kontaktowych konta.

Detektor zostanie wywołany, gdy dowolny klucz dla dowolnego podanego identyfikatora accountId zostanie zaktualizowany, dodany lub usunięty. Zostanie wywołana z listą wszystkich kluczy dla podanych identyfikatorów kont, a nie tylko tych, które zostały zaktualizowane.

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

Usuwa wpis klucza kontaktu konta pełnego szyfrowania należący do aplikacji wywołującej.

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

Usuwa wpis klucza kontaktu do pełnego szyfrowania należący do aplikacji wywołującej.

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

Usuwa wpis klucza własnego pełnego szyfrowania na podstawie identyfikatora urządzenia i wywnioskowanej nazwy pakietu wywołującego.

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

Anuluje rejestrację detektora aktualizacji kluczy kontaktowych konta.

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

Wstawia partię kluczy kontaktów do konta.

Działa podobnie do updateOrInsertE2eeContactKey, ale umożliwia wstawianie i aktualizowanie wielu kluczy jednocześnie. Każdy klucz jest wstawiany w osobnej transakcji, więc niektóre klucze mogą zostać wstawione nawet wtedy, gdy zadanie zgłosi wyjątek.

Klienci mogą obsługiwać tymczasowe błędy, ponownie wysyłając całą partię, ponieważ ten interfejs API nie wpłynie na stan już wstawionych kluczy.

W przypadku każdego klucza, jeśli podano lookupKey, ale nie podano podstawowych informacji o kontakcie (displayName, phoneNumber, emailAddress), ten interfejs API spróbuje też pobrać nazwę, numer telefonu i adres e-mail kontaktu od dostawcy kontaktów. Podczas pobierania klucza aplikacje do zarządzania kontaktami powinny używać tych informacji, aby mieć pewność, że klucz jest używany tylko w przypadku kontaktu, dla którego został przeznaczony.

Aplikacja do weryfikacji kluczy na Androidzie przechowuje te informacje na urządzeniu i udostępnia je tylko wywołującym interfejs API, którzy mają uprawnienie READ_CONTACTS.

Jeśli dla klucza nie podano parametru lookupKey, ten interfejs API zapisze klucz, który nie jest powiązany z żadnym kontaktem.

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

Wstawia nowy wpis do tabeli kluczy kontaktów do szyfrowania end-to-end lub aktualizuje istniejący wpis. Wstawiony lub zaktualizowany klucz kontaktu zaszyfrowany w pełni należy do aplikacji dzwoniącej.

Ten interfejs API będzie też przechowywać imię i nazwisko, numer telefonu i adres e-mail kontaktu od dostawcy kontaktów wraz z kluczem. Podczas pobierania klucza aplikacje do zarządzania kontaktami powinny używać tych informacji, aby mieć pewność, że klucz jest używany tylko w przypadku kontaktu, dla którego został przeznaczony.

Aplikacja do weryfikacji kluczy na Androidzie przechowuje te informacje na urządzeniu i udostępnia je tylko wywołującym interfejs API, którzy mają uprawnienie 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
)

Wstawia nowy wpis do tabeli kluczy kontaktów do szyfrowania end-to-end lub aktualizuje istniejący wpis. Wstawiony lub zaktualizowany klucz kontaktu zaszyfrowany w pełni należy do aplikacji dzwoniącej.

W przypadku każdego podanego klucza wyszukiwania ten interfejs API będzie też przechowywać nazwę kontaktu, numer telefonu i adres e-mail od dostawcy kontaktów wraz z kluczem. Podczas pobierania klucza aplikacje do zarządzania kontaktami powinny używać tych informacji, aby mieć pewność, że klucz jest używany tylko w przypadku kontaktu, dla którego został przeznaczony.

Aplikacja do weryfikacji kluczy na Androidzie przechowuje te informacje na urządzeniu i udostępnia je tylko wywołującym interfejs API, którzy mają uprawnienie READ_CONTACTS.

Jeśli lista kluczy wyszukiwania jest pusta, ten interfejs API zapisze klucz, który nie jest powiązany z żadnym kontaktem.

Wywołanie tego interfejsu API z co najmniej jednym kluczem wyszukiwania spowoduje zaktualizowanie metadanych klucza w celu powiązania go z podanymi kontaktami, ale nie usunie żadnych istniejących powiązań z kontaktami, które nie znajdują się na liście. Aby usunąć powiązanie między kontaktem a kluczem, wywołaj funkcję removeE2eeContactKey z odpowiednim kluczem wyszukiwania.

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

Wstawia nowy wpis do tabeli kluczy własnych szyfrowania end-to-end lub aktualizuje istniejący wpis.