פרופיל המכשיר הנלווה שהוצג ב-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
|
|
Phone |
|
SMS |
|
Contacts |
|
Calendar |
|
Nearby devices |
|
eSIM provisioning |
|
Managing ongoing calls |
|
פרופיל משקפיים
פרופיל המשקפיים חדש ב-Android 14.
הטבלה הבאה מתארת את ההרשאות המוגדרות עבור
COMPANION_DEVICE_GLASSES
פרופיל המכשיר והדרישות לשימוש בהם.
הרשאות | דרישות לגבי אפליקציות נלוות ומכשירים |
---|---|
התראותBIND_NOTIFICATION_LISTENER_SERVICE POST_NOTIFICATIONS |
|
Phone |
|
SMS |
|
Contacts |
|
Microphone |
|
Nearby devices |
|
Managing ongoing calls |
|
הטמעה
למפתחי צד שלישי שמטמיעים אפליקציה נלווית שמבקשת את
DEVICE_PROFILE_WATCH
הפרופיל, בצעו את הפעולות הבאות:
קוראים לפונקציה
setDeviceProfile
.העברה של פרופיל (לדוגמה:
DEVICE_PROFILE_WATCH
כשבוניםAssociationRequest
המכשיר מייצר לדלג על הצגת תיבת הדו-שיח להבעת הסכמה של המשתמש
ליצרני מכשירים שמטמיעים אפליקציה נלווית עם יש להשתמש בהגדרות הנדרשות הבאות של מערכת Android כדי לאשר אפליקציה נלווית, שמאפשרת לאפליקציה לדלג על הצגת ההסכמה של המשתמש למשתמשים.
מאחזרים את האישור באמצעות הפקודה הבאה:
keytool -printcert -jarfile PATH/TO/APK
צריך להחליף את שם החבילה ואת האישור כפי שמוצג בהמשך קלט לדוגמה בקובץ התצורה:
<!-- 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>
כדאי להשתמש
AssociationRequest
לשלוח בקשת שיוך למכשיר נלווה אחד.
אימות
כדי לבדוק את ההתנהגות של התכונה של פרופיל המכשיר הנלווה, צריך להשתמש ב-CTS
בדיקות ב:
cts/tests/tests/companion/