פרופיל מכשיר נלווה, שהוצג באנדרואיד 12, הוא תכונה המאפשרת לאפליקציות נלוות לבקש קבוצה של הרשאות ספציפיות לסוג המכשיר הנלווה, למשל, שעון חכם. השימוש בפרופיל מכשיר נלווה מפשט את תהליך ההרשמה בכך שהוא מאפשר לאפליקציות להציג הנחיה בודדת למשתמשים במכשירים הניידים שלהם לבקש קבוצה מוגדרת של הרשאות במקום הנחיות מרובות המבקשות הרשאות בנפרד. זה יכול לאפשר חווית הגדרה יעילה יותר ושיעורי הצטרפות טובים יותר לאפליקציות נלוות.
כדי להשתמש בפרופילים של מכשירים נלווים, אפליקציות נלוות חייבות לעמוד בדרישות הבאות:
- נהל מכשיר נלווה (לדוגמה, שעון חכם).
- יש להקפיד על תכונות אפליקציה או להתקשר לממשקי API של Android הדורשים את כל ההרשאות שהוגדרו עבור פרופיל המכשיר הנלווה.
כל פרופיל מכשיר נלווה מתאים לתפקיד אנדרואיד. למידע נוסף על ההרשאות ותפקיד Android התואם של כל פרופיל, ראה פרופילי מכשירים נלווים עבור אפליקציות צד שלישי .
למידע נוסף על התקנים נלווים, ראה צימוד מכשירים נלווים .
התנהגות המכשיר
סעיף זה מתאר את התנהגות המכשיר כאשר נעשה שימוש בפרופילי מכשירים נלווים.
כאשר משתמש מקבל בקשת אפליקציה ליצור שיוך עם מכשיר נלווה, שירות CompanionDeviceManager
(CDM) מקצה את תפקיד פרופיל המכשיר (לדוגמה, שעון) לאפליקציה הנלווית, ומעניק את כל ההרשאות שהוגדרו עבור אותו תפקיד פרופיל שצוין. איור 1 מציג דוגמה לאפליקציה המבקשת הרשאות עבור פרופיל המכשיר COMPANION_DEVICE_WATCH
.
איור 1. דיאלוג המבקש הרשאות עבור פרופיל מכשיר השעון.
כאשר משתמש מנקה את נתוני החבילה בהגדרות או מסיר את כל המכשירים באפליקציה הנלווית, CDM מבטל את הפרופיל בזמן שהאפליקציה לא פועלת בחזית וגם לא פועלת שירות בחזית. ביטול הפרופיל מבטל גם את כל ההרשאות המוגדרות עבור הפרופיל.
לאחר שמשתמש מקבל בקשת אפליקציה להעניק הרשאות לפרופיל מכשיר מסוים, המשתמש יכול לבטל הרשאות בודדות שניתנו. כאשר הרשאה מבוטלת על ידי משתמש, האפליקציה נשארת משויכת למכשיר הנלווה אך תכונות מסוימות עשויות להפוך ללא זמינות. אם ההרשאה נדרשת כדי שהאפליקציה תפעל, על האפליקציה לבקש את ההרשאה באמצעות בקשת הרשאה רגילה.
פרופילי מכשירים נלווים עבור אפליקציות צד שלישי
צפה בפרופיל
פרופיל השעון מוצג באנדרואיד 12.
הטבלה הבאה מתארת את ההרשאות המוגדרות עבור פרופיל המכשיר COMPANION_DEVICE_WATCH
ואת הדרישות לשימוש בהן.
הרשאות | דרישות אפליקציה ומכשיר נלוות |
---|---|
התראותBIND_NOTIFICATION_LISTENER_SERVICE |
|
Phone |
|
SMS |
|
Contacts |
|
Calendar |
|
Nearby devices |
|
eSIM provisioning |
|
Managing ongoing calls |
|
פרופיל משקפיים
פרופיל המשקפיים מוצג באנדרואיד 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/
.