Tamamlayıcı cihaz profilleri

Android 12'de kullanıma sunulan tamamlayıcı cihaz profili Bu özellik, tamamlayıcı uygulamaların tamamlayıcı cihazın türü (ör. akıllı saat). Tamamlayıcı kullanma cihaz profili, uygulamaların bir cihazda oturum açmalarına izin vererek tek bir istem kullanarak tanımlanmış bir grup daha fazla erişim izni isteyebilir. Bu, daha kolay bir kurulum deneyimi ve daha yüksek etkinleştirme oranları sağlayabilir. izin modudur.

Tamamlayıcı cihaz profillerini kullanmak için tamamlayıcı uygulamaların aşağıdaki koşulları karşılaması gerekir: koşullar:

  • Tamamlayıcı bir cihazı (örneğin, akıllı saat) yönetin.
  • Tüm özellikleri gerektiren uygulama özelliklerine sahip olma veya Android API'lerini çağırma Tamamlayıcı cihaz profili için tanımlanmış izinler.

Her tamamlayıcı cihaz profili bir Android rolüne karşılık gelir. Daha fazla her kullanıcının izinleri ve ilgili Android rolü hakkında Üçüncü taraf uygulamaları için tamamlayıcı cihaz profilleri bölümüne bakın.

Tamamlayıcı cihazlar hakkında daha fazla bilgi için bkz. Tamamlayıcı cihaz eşleme.

Cihaz davranışı

Bu bölümde, tamamlayıcı cihaz profilleri kullanıldığında cihaz davranışı açıklanmaktadır.

Kullanıcı, bir uygulamanın tamamlayıcıyla ilişkilendirme oluşturma isteğini kabul ettiğinde cihaz, CompanionDeviceManager (CDM) hizmeti, cihaz profili rolünü (örneğin, saat) tamamlayıcı uygulamasında tanımlanmış tüm izinleri vermelidir. Şekil 1'de COMPANION_DEVICE_WATCH cihaz profiline dokunun.

Kol saati cihazı profili iletişim kutusu istemi

Şekil 1. Saat cihazı profili için izin isteyen iletişim kutusu.

Kullanıcı, Ayarlar'dan paket verilerini temizlediğinde veya CDM profili iptal ederken, uygulama ön planda çalışmıyor ve ön plana sahip değil gerçekten değerlidir. Profilin iptal edilmesi, tanımlı olanların tümünü de iptal eder profil izinleri.

Kullanıcı, bir uygulamanın belirli bir için izin verme isteğini kabul ettikten sonra kullanıcı, verilen izinleri tek tek iptal edebilir. Bir izin kullanıcı tarafından iptal edildiğinde, uygulama ancak belirli özellikler kullanılamayabilir. Öğe uygulamanın çalışması için izin gerekiyorsa uygulama, normal bir şekilde izin isteyebilirsiniz.

Üçüncü taraf uygulamaları için tamamlayıcı cihaz profilleri

İzleme profili

Saat profili, Android 12'de kullanıma sunulmuştur.

Aşağıdaki tabloda COMPANION_DEVICE_WATCH cihaz profiline ve bunların kullanımına ilişkin gereksinimlere.

İzinler Tamamlayıcı uygulama ve cihaz gereksinimleri
Bildirimler

. BIND_NOTIFICATION_LISTENER_SERVICE

POST_NOTIFICATIONS (added in Android 15)
  • Bluetooth ve/veya kablosuz ağ kullanan bağlı bir cihaz olmalıdır.
  • Bildirimleri görüntüleyebilen bir ekranı vardır ( ekran yerine dokunma teknolojisi hariç tutulur)
  • Kullanıcıya yönelik bir bildirim deneyimi sunar. Örneğin, telefon bildirimleri alabilirsiniz.
  • Cihaz yönetimi için telefon bildirimleri yayınlar. Örneğin, bir saat bağlandığında veya belirli bir özellik etkinleştirildiğinde.
Phone
  • Bluetooth ve/veya kablosuz ağ kullanan bağlı bir cihaz olmalıdır.
  • Sesli görüşmeyi etkinleştiren dahili mikrofon ve hoparlör bulunur
  • Arayan bilgilerinin gösterildiği bir ekran var
  • Kullanıcıya telefonla arama deneyimi sunar (tamamlayıcı uygulama köprü niteliğindeki telefon aramaları)
SMS
  • Bluetooth ve/veya kablosuz ağ kullanan bağlı bir cihaz olmalıdır.
  • SMS mesajlarını gösteren bir ekran var
  • Kullanıcılara yönelik bir SMS deneyimi sunma
Contacts
  • Bluetooth ve/veya kablosuz ağ kullanan bağlı bir cihaz olmalıdır.
  • Ekran ekranı var
  • Arama veya mesajlaşma deneyiminin bir parçası olarak iletişim bilgilerini kullanır.
Calendar
  • Bluetooth ve/veya kablosuz ağ kullanan bağlı bir cihaz olmalıdır.
  • Ekran ekranı var
  • Kol saatinde kullanıcılara yönelik bir takvim deneyimi sunun
Nearby devices
  • Bluetooth ve/veya kablosuz ağ kullanan bağlı bir cihaz olmalıdır.
  • Ekran ekranı var
  • Kol saatinde kullanıcılara yönelik bir eşleme/bağlantı deneyimi sunun.
eSIM provisioning
  • Bluetooth ve/veya kablosuz ağ kullanan bağlı bir cihaz olmalıdır.
  • Ekran ekranı var
  • Abonelerin hizmetlerini yöneten kullanıcılara yönelik bir deneyim sunma saatteki operatörden
Managing ongoing calls
  • Bluetooth ve/veya kablosuz ağ kullanan bağlı bir cihaz olmalıdır.
  • Sesli görüşmeyi etkinleştiren dahili mikrofon ve hoparlör bulunur
  • Arayan bilgilerinin gösterildiği bir ekran var
  • Kullanıcıya telefonla arama deneyimi sunar (tamamlayıcı uygulama köprü niteliğindeki telefon aramaları)

Gözlük profili

Gözlük profili, Android 14'te kullanıma sunuldu.

Aşağıdaki tabloda COMPANION_DEVICE_GLASSES cihaz profiline ve bunların kullanımına ilişkin gereksinimlere.

İzinler Tamamlayıcı uygulama ve cihaz gereksinimleri
Bildirimler

. BIND_NOTIFICATION_LISTENER_SERVICE

POST_NOTIFICATIONS
  • Bluetooth ve/veya kablosuz ağ kullanan bağlı bir cihaz olmalıdır.
  • Bildirimleri görüntüleyebilen bir ekranı vardır ( ekran yerine dokunma teknolojisi hariç tutulur)
  • Kullanıcıya yönelik bir bildirim deneyimi sunar. Örneğin, telefon bildirimleri alabilirsiniz.
  • Cihaz yönetimi için telefon bildirimleri yayınlar (ör. bir gözlük cihaz bağlandığında veya belirli bir özellik etkinleştirildiğinde).
Phone
  • Bluetooth ve/veya kablosuz ağ kullanan bağlı bir cihaz olmalıdır.
  • Sesli görüşmeyi etkinleştiren dahili mikrofon ve hoparlör bulunur
  • Arayan bilgilerinin gösterildiği bir ekran var
  • Kullanıcıya telefonla arama deneyimi sunar (tamamlayıcı uygulama köprü niteliğindeki telefon aramaları)
SMS
  • Bluetooth ve/veya kablosuz ağ kullanan bağlı bir cihaz olmalıdır.
  • SMS mesajlarını gösteren bir ekran var
  • Kullanıcılara yönelik bir SMS deneyimi sunma
Contacts
  • Bluetooth ve/veya kablosuz ağ kullanan bağlı bir cihaz olmalıdır.
  • Ekran ekranı var
  • Arama veya mesajlaşma deneyiminin bir parçası olarak iletişim bilgilerini kullanır.
Microphone
  • Bluetooth ve/veya kablosuz ağ kullanan bağlı bir cihaz olmalıdır.
  • Ekran ekranı var
  • Kullanıcılara gözlükte mikrofon deneyimi sunar.
Nearby devices
  • Bluetooth ve/veya kablosuz ağ kullanan bağlı bir cihaz olmalıdır.
  • Ekran ekranı var
  • Kullanıcılara gözlükte eşleme/bağlama deneyimi sunar.
Managing ongoing calls
  • Bluetooth ve/veya kablosuz ağ kullanan bağlı bir cihaz olmalıdır.
  • Sesli görüşmeyi etkinleştiren dahili mikrofon ve hoparlör bulunur
  • Arayan bilgilerinin gösterildiği bir ekran var
  • Kullanıcıya telefonla arama deneyimi sunar (tamamlayıcı uygulama köprü niteliğindeki telefon aramaları)

Uygulama

Şu istekte bulunan tamamlayıcı uygulamayı uygulayan üçüncü taraf geliştiriciler için: DEVICE_PROFILE_WATCH profilinizde aşağıdaki adımları uygulayın:

  1. Şunu çağırın: setDeviceProfile yöntemidir.

  2. Bir profili (örneğin, DEVICE_PROFILE_WATCH oluştururken AssociationRequest.

Belirli bir spesifik özellik içeren tamamlayıcı uygulama uygulayan cihaz üreticileri için aşağıdaki gerekli Android sistem yapılandırmalarını kullanarak Bu, uygulamanın, kullanıcı izni görüntüleme adımını atlamasına olanak tanıyan tamamlayıcı uygulama iletişim kutusu bulunuyor.

  1. Aşağıdaki komutu kullanarak sertifikayı alın:

    keytool  -printcert -jarfile PATH/TO/APK
    
  2. Paket adını ve sertifikayı aşağıda gösterildiği gibi değiştirin yapılandırma dosyasında örnek giriş:

    <!-- 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. Tekliflerinizi otomatikleştirmek ve optimize etmek için AssociationRequest kullanarak tek bir tamamlayıcı cihaza ilişkilendirme isteği gönderebilir.

Doğrulama

Tamamlayıcı cihaz profili özelliğinin davranışını test etmek için CTS'yi kullanın için yapılan testler cts/tests/tests/companion/.