نمایه‌های دستگاه همپا

نمایه دستگاه همپا که در Android 12 معرفی شد، ویژگی‌ای است که به برنامه‌های همپا امکان می‌دهد مجموعه‌ای از اجازه‌های مختص نوع دستگاه همپا (مثلاً ساعت هوشمند) را درخواست کنند. استفاده از نمایه دستگاه همراه با نمایش یک پیام‌واره واحد به کاربران در دستگاه‌های همراهشان برای درخواست مجموعه‌ای از مجوزهای تعریف‌شده به‌جای پیام‌واره‌های متعدد که مجوزها را به‌صورت جداگانه درخواست می‌کنند، فرایند ثبت‌نام را ساده‌تر می‌کند. این کار می‌تواند به تجربه راه‌اندازی ساده‌تر و نرخ شرکت کردن بهتر برای برنامه‌های همراه منجر شود.

برای استفاده از نمایه‌های دستگاه همراه، برنامه‌های همراه باید شرایط زیر را داشته باشند:

• مدیریت دستگاه همپا (برای مثال، ساعت هوشمند).
• ویژگی‌های برنامه یا میاناهای برنامه‌سازی کاربردی Android را فراخوانی کنند که به همه اجازه‌های تعریف‌شده برای نمایه دستگاه همپا نیاز داشته باشند.

هر نمایه دستگاه همپا با یک نقش Android مطابقت دارد. برای اطلاعات بیشتر درباره اجازه‌ها و نقش Android مربوط به هر نمایه، نمایه‌های دستگاه همراه برای برنامه‌های طرف سوم را ببینید.

برای اطلاعات بیشتر درباره دستگاه‌های همراه، به جفت‌سازی دستگاه همراه مراجعه کنید.

عملکرد دستگاه

این بخش رفتار دستگاه را هنگام استفاده از نمایه‌های دستگاه همراه توضیح می‌دهد.

وقتی کاربر درخواست برنامه‌ای را برای ایجاد ارتباط با دستگاه همراه می‌پذیرد، سرویس CompanionDeviceManager (CDM) نقش نمایه دستگاه (برای مثال، ساعت) را به برنامه همراه اختصاص می‌دهد و همه اجازه‌های تعریف‌شده برای آن نقش نمایه مشخص‌شده را اعطا می‌کند. شکل ۱ نمونه‌ای از برنامه را نشان می‌دهد که برای COMPANION_DEVICE_WATCH نمایه دستگاه اجازه درخواست می‌کند.

شکل ۱. کادر گفتگویی که اجازه‌های نمایه دستگاه ساعت را درخواست می‌کند.

وقتی کاربر داده‌های بسته را در «تنظیمات» پاک می‌کند یا همه دستگاه‌ها را در برنامه همراه برمی‌دارد، CDM نمایه را لغو می‌کند درحالی‌که برنامه در پیش‌زمینه اجرا نمی‌شود و سرویس پیش‌زمینه‌ای در حال اجرا ندارد. لغو کردن نمایه همچنین همه مجوزهای تعریف‌شده برای نمایه را لغو می‌کند.

پس‌از اینکه کاربر درخواست برنامه برای اعطای اجازه‌های نمایه دستگاه خاصی را پذیرفت، کاربر می‌تواند اجازه‌های اعطاشده را به‌صورت جداگانه پس بگیرد. وقتی کاربری اجازه‌ای را پس می‌گیرد، برنامه همچنان با دستگاه همراه مرتبط می‌ماند اما ممکن است برخی‌از ویژگی‌ها دردسترس نباشند. اگر اجازه برای عملکرد برنامه ضروری باشد، برنامه باید اجازه را ازطریق درخواست اجازه عادی درخواست کند.

نمایه‌های دستگاه همپا برای برنامه‌های شخص ثالث

تماشای نمایه

نمایه ساعت در Android 12 معرفی شده است.

جدول زیر اجازه‌های تعریف‌شده برای نمایه دستگاه COMPANION_DEVICE_WATCH و الزامات استفاده از آن‌ها را شرح می‌دهد.

اجازه‌ها	الزامات دستگاه و برنامه همراه
اعلان‌ها POST_NOTIFICATIONS (added in Android 15)	دستگاه متصل بااستفاده از بلوتوث و/یا Wi-Fi باشد صفحه‌نمایشی دارد که می‌تواند اعلان‌ها را نمایش دهد (دستگاه‌هایی که به‌جای صفحه‌نمایش از بازخورد لمسی استفاده می‌کنند مستثنا هستند) تجربه اعلان رو به کاربر ارائه می‌دهد، برای مثال، اعلان‌های تلفن را در صفحه دستگاه همراه نمایش می‌دهد. اعلان‌های تلفن را برای مدیریت دستگاه ارسال می‌کند. برای مثال، وقتی ساعت متصل است یا وقتی ویژگی خاصی فعال است.
Phone	دستگاه متصل بااستفاده از بلوتوث و/یا Wi-Fi باشد دارای میکروفون و بلندگوی داخلی است که مکالمه صوتی را امکان‌پذیر می‌کند صفحه‌نمایشی دارد که اطلاعات تماس‌گیرنده را نشان می‌دهد تجربه تماس تلفنی کاربرپسندی را ارائه می‌دهد (برنامه همراه تماس‌های تلفنی را برقرار می‌کند)
SMS	دستگاه متصل بااستفاده از بلوتوث و/یا Wi-Fi باشد صفحه‌ای دارد که پیامک‌ها را نمایش می‌دهد ارائه تجربه پیامک سَمت کاربر
Contacts	دستگاه متصل بااستفاده از بلوتوث و/یا Wi-Fi باشد صفحه‌نمایش دارد از اطلاعات مخاطب به‌عنوان بخشی از تجربه تماس یا پیام‌رسانی استفاده می‌کند
Calendar	دستگاه متصل بااستفاده از بلوتوث و/یا Wi-Fi باشد صفحه‌نمایش دارد ارائه تجربه تقویم کاربرپسند در ساعت
Nearby devices	دستگاه متصل بااستفاده از بلوتوث و/یا Wi-Fi باشد صفحه‌نمایش دارد ارائه تجربه جفت‌سازی/اتصال سَمت کاربر در ساعت
eSIM provisioning	دستگاه متصل بااستفاده از بلوتوث و/یا Wi-Fi باشد صفحه‌نمایش دارد تجربه کاربری‌ای ارائه دهید که خدمات مشترک را از شرکت مخابراتی در ساعت مدیریت کند
Managing ongoing calls	دستگاه متصل بااستفاده از بلوتوث و/یا Wi-Fi باشد دارای میکروفون و بلندگوی داخلی است که مکالمه صوتی را امکان‌پذیر می‌کند صفحه‌نمایشی دارد که اطلاعات تماس‌گیرنده را نشان می‌دهد تجربه تماس تلفنی کاربرپسندی را ارائه می‌دهد (برنامه همراه تماس‌های تلفنی را برقرار می‌کند)

نمایه عینک

نمایه «عینک» در Android 14 معرفی شده است.

جدول زیر اجازه‌های تعریف‌شده برای نمایه دستگاه COMPANION_DEVICE_GLASSES و الزامات استفاده از آن‌ها را شرح می‌دهد.

اجازه‌ها	الزامات دستگاه و برنامه همراه
اعلان‌ها POST_NOTIFICATIONS	دستگاه متصل بااستفاده از بلوتوث و/یا Wi-Fi باشد صفحه‌نمایشی دارد که می‌تواند اعلان‌ها را نمایش دهد (دستگاه‌هایی که به‌جای صفحه‌نمایش از بازخورد لمسی استفاده می‌کنند مستثنا هستند) تجربه اعلان سَمت کاربر ارائه می‌دهد، برای مثال، نمایش اعلان‌های تلفن در صفحه دستگاه همپا. اعلان‌های تلفن را برای مدیریت دستگاه ارسال می‌کند، برای مثال، وقتی دستگاه عینک متصل می‌شود یا وقتی ویژگی خاصی فعال می‌شود.
Phone	دستگاه متصل بااستفاده از بلوتوث و/یا Wi-Fi باشد دارای میکروفون و بلندگوی داخلی است که مکالمه صوتی را امکان‌پذیر می‌کند صفحه‌نمایشی دارد که اطلاعات تماس‌گیرنده را نشان می‌دهد تجربه تماس تلفنی کاربرپسندی را ارائه می‌دهد (برنامه همراه تماس‌های تلفنی را برقرار می‌کند)
SMS	دستگاه متصل بااستفاده از بلوتوث و/یا Wi-Fi باشد صفحه‌ای دارد که پیامک‌ها را نمایش می‌دهد ارائه تجربه پیامک سَمت کاربر
Contacts	دستگاه متصل بااستفاده از بلوتوث و/یا Wi-Fi باشد صفحه‌نمایش دارد از اطلاعات مخاطب به‌عنوان بخشی از تجربه تماس یا پیام‌رسانی استفاده می‌کند
Microphone	دستگاه متصل بااستفاده از بلوتوث و/یا Wi-Fi باشد صفحه‌نمایش دارد تجربه میکروفون رو به کاربر در عینک ارائه می‌دهد
Nearby devices	دستگاه متصل بااستفاده از بلوتوث و/یا Wi-Fi باشد صفحه‌نمایش دارد تجربه جفت‌سازی/اتصال سَمت کاربر را در عینک ارائه می‌دهد
Managing ongoing calls	دستگاه متصل بااستفاده از بلوتوث و/یا Wi-Fi باشد دارای میکروفون و بلندگوی داخلی است که مکالمه صوتی را امکان‌پذیر می‌کند صفحه‌نمایشی دارد که اطلاعات تماس‌گیرنده را نشان می‌دهد تجربه تماس تلفنی کاربرپسندی را ارائه می‌دهد (برنامه همراه تماس‌های تلفنی را برقرار می‌کند)

پیاده‌سازی

برای توسعه‌دهندگان شخص ثالثی که برنامه همراهی را پیاده‌سازی می‌کنند که نمایه DEVICE_PROFILE_WATCH را درخواست می‌کند، کارهای زیر را انجام دهید:

1. روش setDeviceProfile را فراخوانی کنید.

2. Pass in a profile (for example, DEVICE_PROFILE_WATCH when building 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/ استفاده کنید.