يعد ملف تعريف الجهاز المرافق، الذي تم تقديمه في نظام التشغيل Android 12، ميزة تسمح للتطبيقات المصاحبة بطلب مجموعة من الأذونات الخاصة بنوع الجهاز المصاحب، على سبيل المثال، ساعة ذكية. يؤدي استخدام ملف تعريف الجهاز المصاحب إلى تبسيط عملية التسجيل من خلال السماح للتطبيقات بعرض مطالبة واحدة للمستخدمين على أجهزتهم المحمولة لطلب مجموعة محددة من الأذونات بدلاً من المطالبات المتعددة التي تطلب أذونات بشكل فردي. يمكن أن يتيح ذلك تجربة إعداد أكثر انسيابية ومعدلات اشتراك أفضل للتطبيقات المصاحبة.
لاستخدام ملفات تعريف الجهاز المرافق، يجب أن تستوفي التطبيقات المرافقة المتطلبات التالية:
- إدارة جهاز مصاحب (على سبيل المثال، ساعة ذكية).
- احصل على ميزات التطبيق أو اتصل بواجهات برمجة تطبيقات 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/
.