פרופילים של מכשירים נלווים

פרופיל המכשיר הנלווה שהוצג ב-Android 12 תכונה שמאפשרת לאפליקציות נלוות לבקש קבוצה של הרשאות ספציפיות סוג המכשיר הנלווה, לדוגמה: שעון חכם. שימוש במצב Companion פרופיל המכשיר מפשט את תהליך הרישום בכך שהוא מאפשר לאפליקציות להציג בקשה אחת למשתמשים במכשירים הניידים שלהם לבקש קבוצה מוגדרת הרשאות במקום מספר הנחיות שמבקשות הרשאות בנפרד. כך אפשר לשפר את תהליך ההגדרה ולייעל את שיעורי ההצטרפות לאפליקציות נלוות.

כדי להשתמש בפרופילים של מכשירים נלווים, האפליקציות הנלוות צריכות לעמוד בדרישות הבאות: דרישות:

• ניהול מכשיר נלווה (לדוגמה, שעון חכם).
• תכונות האפליקציה או קריאה לממשקי API של Android שמחייבים את כל הרשאות שהוגדרו לפרופיל המכשיר הנלווה.

כל פרופיל של מכשיר נלווה תואם לתפקיד ב-Android. לקבלת מידע נוסף מידע על ההרשאות והתפקיד התואם של Android של כל אחד מהתפקידים ב-Android מידע נוסף מופיע במאמר פרופילים של מכשירים נלווים לאפליקציות צד שלישי.

למידע נוסף על מכשירים נלווים: התאמת מכשירים נלווית.

התנהגות המכשיר

בקטע הזה מתוארת התנהגות המכשיר כשמשתמשים בפרופילים של מכשירים נלווים.

כשמשתמש מאשר בקשה מאפליקציה ליצור שיוך לחשבון נלווה במכשיר, CompanionDeviceManager (CDM) מקצה את התפקיד בפרופיל המכשיר (לדוגמה, שעון) מודעה נלווית אפליקציה, ותעניק את כל ההרשאות שהוגדרו לתפקיד הפרופיל שצוין. באיור 1 מוצגת דוגמה לאפליקציה שמבקשת הרשאות COMPANION_DEVICE_WATCH פרופיל המכשיר

איור 1. תיבת דו-שיח שבה מבקשים הרשאות לפרופיל של המכשיר בשעון.

כשמשתמש מנקה את נתוני החבילה בהגדרות או מסיר את כל מכשירים באפליקציה הנלווית, CDM מבטל את הפרופיל בזמן האפליקציה לא פועלת בחזית או שאין לה חזית השירות פועל. ביטול הפרופיל יוביל גם לביטול של כל ההגדרות עבור הפרופיל.

לאחר שמשתמש מאשר בקשה מאפליקציה להעניק הרשאות לאפליקציה מסוימת בפרופיל המכשיר, המשתמש יכול לבטל הרשאות ספציפיות שהוענקו. כשמשתמש מבטל הרשאה, האפליקציה נשארת משויכת מכשיר נלווה, אבל ייתכן שתכונות מסוימות לא יהיו זמינות. אם נדרשת הרשאה כדי שהאפליקציה תפעל, והיא צריכה לבקש את באישור בקשת הרשאה.

פרופילים של מכשירים נלווים לאפליקציות צד שלישי

פרופיל הצפייה

פרופיל השעון זמין ב-Android 12.

הטבלה הבאה מתארת את ההרשאות המוגדרות עבור COMPANION_DEVICE_WATCH פרופיל המכשיר והדרישות לשימוש בהם.

הרשאות	דרישות לגבי אפליקציות נלוות ומכשירים
התראות BIND_NOTIFICATION_LISTENER_SERVICE POST_NOTIFICATIONS (added in Android 15)	להיות מכשיר מחובר באמצעות Bluetooth או Wi-Fi יש מסך שיכול להציג התראות (מכשירים שמשתמשים המשוב הפיזי במקום המסך לא נכלל) מספק חוויה של התראות בפני המשתמש, לדוגמה, התראות בטלפון במסך של המכשיר הנלווה. מפרסם התראות בטלפון לגבי ניהול המכשיר. לדוגמה, כששעון מחובר או כשתכונה מסוימת מופעלת.
Phone	להיות מכשיר מחובר באמצעות Bluetooth או Wi-Fi כולל מיקרופון ורמקול מובנים שמאפשרים שיחה קולית כולל מסך שמציג את פרטי המתקשר מספקת חוויית שיחת טלפון גלויה למשתמשים (האפליקציה הנלווית) גשר על שיחות טלפון)
SMS	להיות מכשיר מחובר באמצעות Bluetooth או Wi-Fi יש מסך שמוצגות בו הודעות SMS שליחת הודעות SMS למשתמש
Contacts	להיות מכשיר מחובר באמצעות Bluetooth או Wi-Fi יש מסך תצוגה שימוש בפרטים ליצירת קשר כחלק מחוויית השיחה או העברת ההודעות
Calendar	להיות מכשיר מחובר באמצעות Bluetooth או Wi-Fi יש מסך תצוגה מספקים חוויית שימוש ביומן למשתמש בשעון
Nearby devices	להיות מכשיר מחובר באמצעות Bluetooth או Wi-Fi יש מסך תצוגה מתן חוויית התאמה או התחברות למשתמש בשעון
eSIM provisioning	להיות מכשיר מחובר באמצעות Bluetooth או Wi-Fi יש מסך תצוגה לספק חוויה גלויה למשתמשים שמנהלת את השירותים של המנוי מהספק בשעון
Managing ongoing calls	להיות מכשיר מחובר באמצעות Bluetooth או Wi-Fi כולל מיקרופון ורמקול מובנים שמאפשרים שיחה קולית כולל מסך שמציג את פרטי המתקשר מספקת חוויית שיחת טלפון גלויה למשתמשים (האפליקציה הנלווית) גשר על שיחות טלפון)

פרופיל משקפיים

פרופיל המשקפיים חדש ב-Android 14.

הטבלה הבאה מתארת את ההרשאות המוגדרות עבור COMPANION_DEVICE_GLASSES פרופיל המכשיר והדרישות לשימוש בהם.

הרשאות	דרישות לגבי אפליקציות נלוות ומכשירים
התראות BIND_NOTIFICATION_LISTENER_SERVICE POST_NOTIFICATIONS	להיות מכשיר מחובר באמצעות Bluetooth או Wi-Fi יש מסך שיכול להציג התראות (מכשירים שמשתמשים המשוב הפיזי במקום המסך לא נכלל) מספק חוויה של התראות בפני המשתמש, לדוגמה, התראות בטלפון במסך של המכשיר הנלווה. פרסום התראות בטלפון לגבי ניהול המכשיר, לדוגמה, כשמכשיר משקפיים מחובר או כשתכונה מסוימת מופעלת.
Phone	להיות מכשיר מחובר באמצעות Bluetooth או Wi-Fi כולל מיקרופון ורמקול מובנים שמאפשרים שיחה קולית כולל מסך שמציג את פרטי המתקשר מספקת חוויית שיחת טלפון גלויה למשתמשים (האפליקציה הנלווית) גשר על שיחות טלפון)
SMS	להיות מכשיר מחובר באמצעות Bluetooth או Wi-Fi יש מסך שמוצגות בו הודעות SMS שליחת הודעות SMS למשתמש
Contacts	להיות מכשיר מחובר באמצעות Bluetooth או Wi-Fi יש מסך תצוגה שימוש בפרטים ליצירת קשר כחלק מחוויית השיחה או העברת ההודעות
Microphone	להיות מכשיר מחובר באמצעות Bluetooth או Wi-Fi יש מסך תצוגה מספק חוויית שימוש במיקרופון במשקפיים
Nearby devices	להיות מכשיר מחובר באמצעות Bluetooth או Wi-Fi יש מסך תצוגה מתן חוויית התאמה או התחברות למשתמש במשקפיים
Managing ongoing calls	להיות מכשיר מחובר באמצעות Bluetooth או Wi-Fi כולל מיקרופון ורמקול מובנים שמאפשרים שיחה קולית כולל מסך שמציג את פרטי המתקשר מספקת חוויית שיחת טלפון גלויה למשתמשים (האפליקציה הנלווית) גשר על שיחות טלפון)

הטמעה

למפתחי צד שלישי שמטמיעים אפליקציה נלווית שמבקשת את DEVICE_PROFILE_WATCH הפרופיל, בצעו את הפעולות הבאות:

1. קוראים לפונקציה setDeviceProfile .

2. העברה של פרופיל (לדוגמה: DEVICE_PROFILE_WATCH כשבונים AssociationRequest

המכשיר מייצר לדלג על הצגת תיבת הדו-שיח להבעת הסכמה של המשתמש

ליצרני מכשירים שמטמיעים אפליקציה נלווית עם יש להשתמש בהגדרות הנדרשות הבאות של מערכת Android כדי לאשר אפליקציה נלווית, שמאפשרת לאפליקציה לדלג על הצגת ההסכמה של המשתמש למשתמשים.

1. מאחזרים את האישור באמצעות הפקודה הבאה:

   keytool  -printcert -jarfile PATH/TO/APK
   

2. צריך להחליף את שם החבילה ואת האישור כפי שמוצג בהמשך קלט לדוגמה בקובץ התצורה:

   <!-- 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. כדאי להשתמש AssociationRequest לשלוח בקשת שיוך למכשיר נלווה אחד.

אימות

כדי לבדוק את ההתנהגות של התכונה של פרופיל המכשיר הנלווה, צריך להשתמש ב-CTS בדיקות ב: cts/tests/tests/companion/