Profile urządzeń towarzyszących

Profil urządzenia towarzyszącego, wprowadzony w Androidzie 12, jest funkcję, która umożliwia aplikacjom towarzyszącym żądanie zestawu uprawnień specyficznych dla typ urządzenia towarzyszącego, np. smartwatch. Korzystanie z aplikacji towarzyszącej upraszcza proces rejestracji, umożliwiając aplikacjom wyświetlanie wyświetlana użytkownikom na urządzeniach mobilnych z prośbą o określony zestaw uprawnień, zamiast prosić o przyznanie uprawnień pojedynczo. Ułatwi to konfigurację i umożliwi uzyskanie wyższych współczynników akceptacji. w przypadku aplikacji towarzyszących.

Aby można było korzystać z profili urządzeń towarzyszących, aplikacje towarzyszące muszą spełniać te wymagania wymagania:

  • zarządzać urządzeniem towarzyszącym (np. zegarkiem).
  • mieć funkcje aplikacji lub wywoływać interfejsy API Androida, które wymagają wszystkich uprawnień zdefiniowanych dla profilu urządzenia towarzyszącego.

Każdy profil urządzenia towarzyszącego odpowiada roli Androida. Więcej informacje o uprawnieniach i odpowiadających im rolach w Androidzie znajdziesz w artykule o profilach urządzeń towarzyszących w przypadku aplikacji innych firm.

Więcej informacji o urządzeniach towarzyszących: Parowanie urządzenia towarzyszącego

Działanie urządzenia

W tej sekcji opisano zachowanie urządzenia w przypadku korzystania z profili urządzeń towarzyszących.

Gdy użytkownik zaakceptuje prośbę aplikacji o utworzenie powiązania z elementem towarzyszącym urządzenia, CompanionDeviceManager (CDM) przypisuje rolę profilu urządzenia (np. zegarek) do aplikacja towarzysząca aplikacji, przyznając wszystkie uprawnienia zdefiniowane dla danej roli profilu. Na ilustracji 1 przedstawiono przykład aplikacji żądającej uprawnień dla COMPANION_DEVICE_WATCH profil urządzenia.

Okno dialogowe profilu urządzenia zegarka

Rysunek 1. Okno z prośbą o uprawnienia do profilu zegarka.

Gdy użytkownik wyczyści dane pakietu w Ustawieniach lub usunie wszystkie elementy urządzeń w aplikacji towarzyszącej, CDM anuluje profil, aplikacja nie działa na pierwszym planie ani na pierwszym planie która działa. Unieważnienie profilu anuluje też wszystkie zdefiniowane uprawnień do profilu.

Gdy użytkownik zaakceptuje prośbę aplikacji o przyznanie uprawnień określonej aplikacji profilu urządzenia, użytkownik może cofnąć indywidualne uprawnienia. Po unieważnieniu uprawnień aplikacja pozostaje powiązana z na urządzeniu towarzyszącym, ale niektóre funkcje mogą stać się niedostępne. Jeśli aplikacji do działania, musi ona zażądać przez zwykły dostęp. prośby o zgodę.

Profile urządzeń towarzyszących w przypadku aplikacji innych firm

Profil odtwarzania

Profil zegarka został wprowadzony w Androidzie 12.

W poniższej tabeli opisano zdefiniowane uprawnienia dla COMPANION_DEVICE_WATCH profil urządzenia i wymagania dotyczące korzystania z nich.

Uprawnienia Wymagania dotyczące aplikacji towarzyszących i urządzeń
Powiadomienia

BIND_NOTIFICATION_LISTENER_SERVICE

POST_NOTIFICATIONS (added in Android 15)
  • być połączonym urządzeniem przez Bluetooth lub Wi-Fi,
  • Ma ekran, na którym można wyświetlać powiadomienia (urządzenia, na których czujniki haptyczne zamiast ekranu są wykluczone).
  • Wyświetla użytkownikom powiadomienia, np. o tym, powiadomienia z telefonu na ekranie urządzenia towarzyszącego.
  • Publikuje powiadomienia na telefonie w celu zarządzania urządzeniem. na przykład gdy zegarek jest połączony lub gdy włączona jest określona funkcja.
Phone
  • być połączonym urządzeniem przez Bluetooth lub Wi-Fi,
  • Ma wbudowany mikrofon i głośnik, który umożliwia rozmowę głosową
  • Ma ekran z informacjami o rozmówcy.
  • Możliwość nawiązywania połączeń telefonicznych (aplikacja towarzysząca) połączenia telefoniczne)
SMS
  • być połączonym urządzeniem przez Bluetooth lub Wi-Fi,
  • ma ekran, na którym wyświetlane są SMS-y.
  • Zapewnianie obsługi SMS-ów dla użytkownika
Contacts
  • być połączonym urządzeniem przez Bluetooth lub Wi-Fi,
  • Ma wyświetlacz
  • używa informacji kontaktowych do połączeń lub wiadomości,
Calendar
  • być połączonym urządzeniem przez Bluetooth lub Wi-Fi,
  • Ma wyświetlacz
  • Umożliwianie użytkownikom korzystania z kalendarza na zegarku
Nearby devices
  • być połączonym urządzeniem przez Bluetooth lub Wi-Fi,
  • Ma wyświetlacz
  • Zapewniają użytkownikom możliwość parowania i łączenia na zegarku.
eSIM provisioning
  • być połączonym urządzeniem przez Bluetooth lub Wi-Fi,
  • Ma wyświetlacz
  • muszą oferować użytkownikom dostęp do funkcji zarządzania usługami subskrybenta, od operatora na zegarku
Managing ongoing calls
  • być połączonym urządzeniem przez Bluetooth lub Wi-Fi,
  • Ma wbudowany mikrofon i głośnik, który umożliwia rozmowę głosową
  • Ma ekran z informacjami o rozmówcy.
  • Możliwość nawiązywania połączeń telefonicznych (aplikacja towarzysząca) połączenia telefoniczne)

Profil okularów

Profil okularów pojawia się w Androidzie 14.

W poniższej tabeli opisano zdefiniowane uprawnienia dla COMPANION_DEVICE_GLASSES profil urządzenia i wymagania dotyczące korzystania z nich.

Uprawnienia Wymagania dotyczące aplikacji towarzyszących i urządzeń
Powiadomienia

BIND_NOTIFICATION_LISTENER_SERVICE

POST_NOTIFICATIONS
  • być połączonym urządzeniem przez Bluetooth lub Wi-Fi,
  • Ma ekran, na którym można wyświetlać powiadomienia (urządzenia, na których czujniki haptyczne zamiast ekranu są wykluczone).
  • Wyświetla użytkownikom powiadomienia, np. o tym, powiadomienia z telefonu na ekranie urządzenia towarzyszącego.
  • Publikuje powiadomienia na telefonie, aby umożliwić zarządzanie urządzeniem, np. gdy podłączysz urządzenie okulary lub gdy włączysz określoną funkcję.
Phone
  • być połączonym urządzeniem przez Bluetooth lub Wi-Fi,
  • Ma wbudowany mikrofon i głośnik, który umożliwia rozmowę głosową
  • Ma ekran z informacjami o rozmówcy.
  • Możliwość nawiązywania połączeń telefonicznych (aplikacja towarzysząca) połączenia telefoniczne)
SMS
  • być połączonym urządzeniem przez Bluetooth lub Wi-Fi,
  • ma ekran, na którym wyświetlane są SMS-y.
  • Zapewnianie obsługi SMS-ów dla użytkownika
Contacts
  • być połączonym urządzeniem przez Bluetooth lub Wi-Fi,
  • Ma wyświetlacz
  • używa informacji kontaktowych do połączeń lub wiadomości,
Microphone
  • być połączonym urządzeniem przez Bluetooth lub Wi-Fi,
  • Ma wyświetlacz
  • Możliwość korzystania z mikrofonu w okularach.
Nearby devices
  • być połączonym urządzeniem przez Bluetooth lub Wi-Fi,
  • Ma wyświetlacz
  • Możliwość parowania i łączenia w okularach po stronie użytkownika.
Managing ongoing calls
  • być połączonym urządzeniem przez Bluetooth lub Wi-Fi,
  • Ma wbudowany mikrofon i głośnik, który umożliwia rozmowę głosową
  • Ma ekran z informacjami o rozmówcy.
  • Możliwość nawiązywania połączeń telefonicznych (aplikacja towarzysząca) połączenia telefoniczne)

Implementacja

Deweloperzy zewnętrzni, którzy implementują aplikację towarzyszącą, która wysyła żądanie DEVICE_PROFILE_WATCH profilu, wykonaj te czynności:

  1. Wywołaj funkcję setDeviceProfile .

  2. Prześlij profil (np. DEVICE_PROFILE_WATCH podczas tworzenia AssociationRequest

Producenci urządzeń wdrażający aplikację towarzyszącą z określonym na urządzeniu, użyj tych wymaganych konfiguracji systemu Android, aby certyfikować aplikacja towarzysząca, która pozwala pominąć wyświetlanie zgody użytkownika. dla użytkowników.

  1. Pobierz certyfikat za pomocą tego polecenia:

    keytool  -printcert -jarfile PATH/TO/APK
    
  2. Zastąp nazwę pakietu i certyfikat zgodnie z poniższym przykładem przykładowe dane wejściowe w pliku konfiguracyjnym:

    <!-- A list of packages managing companion device(s) by the same manufacturers as the main device.
    It will not create the association without prompting if the association has been called multiple
    times in a short period. Note that config_companionDeviceManagerPackage and config_companionDeviceCerts
    are parallel arrays. -->
    
    <string-array name="config_companionDevicePackages" translatable="false">
        <item>YOUR_COMPANION_APP_PACKAGE_NAME</item>
    </string-array>
    
    <!-- A list of SHA256 Certificates managing companion device(s) by the same manufacturers as the
    main device. It will fall back to showing a prompt if the association has been called multiple
    times in a short period. Note that config_companionDeviceCerts and config_companionDeviceManagerPackage
    are parallel arrays.
    Example: "1A:2B:3C:4D" -->
    
    <string-array name="config_companionDeviceCerts" translatable="false">
        <item>YOUR_COMPANION_APP_CERTIFICATE</item>
    </string-array>
    
  3. Używaj AssociationRequest , aby wysłać prośbę o powiązanie z jednym urządzeniem towarzyszącym.

Weryfikacja

Aby przetestować działanie funkcji profilu urządzenia towarzyszącego, użyj narzędzia CTS testy w: cts/tests/tests/companion/