ملفات تعريف الجهاز المصاحب

يعد ملف تعريف الجهاز المصاحب ، الذي تم تقديمه في Android 12 ، ميزة تسمح للتطبيقات المصاحبة بطلب مجموعة من الأذونات الخاصة بنوع الجهاز المرافق ، على سبيل المثال ، ساعة ذكية. يؤدي استخدام ملف تعريف جهاز مصاحب إلى تبسيط عملية التسجيل من خلال السماح للتطبيقات بعرض مطالبة واحدة للمستخدمين على أجهزتهم المحمولة لطلب مجموعة محددة من الأذونات بدلاً من المطالبات المتعددة التي تطلب الأذونات بشكل فردي. يمكن أن يتيح ذلك تجربة إعداد أكثر بساطة ومعدلات اشتراك أفضل للتطبيقات المصاحبة.

استخدام ملفات تعريف الأجهزة المصاحبة متاح فقط لمصنعي الأجهزة الذين لديهم أجهزة مصاحبة. حتى تتمكن الأجهزة المصاحبة من الوصول إلى الميزة ، يجب أن تفي بالمتطلبات وأن تتم الموافقة عليها.

تتوفر أنواع ملفات تعريف الأجهزة المصاحبة التالية في Android 12: COMPANION_DEVICE_WATCH .

لمزيد من المعلومات حول الأجهزة المصاحبة ، راجع اقتران الجهاز المصاحب .

سلوك الجهاز

يصف هذا القسم سلوك الجهاز عند استخدام ملفات تعريف الجهاز المصاحبة.

عندما يقبل المستخدم طلب أحد التطبيقات لإنشاء ارتباط بجهاز مصاحب ، تنتظر خدمة CompanionDeviceManager (CDM) اتصال الجهاز المرافق ، وعندما يتم الاتصال ، تقوم آلية التنمية النظيفة (CDM) بتعيين دور ملف تعريف الجهاز (على سبيل المثال ، مشاهدة) تطبيق مصاحب ، يمنح جميع الأذونات المحددة لدور الملف الشخصي المحدد. يوضح الشكل 1 مثالاً لتطبيق يطلب أذونات لملف تعريف الجهاز COMPANION_DEVICE_WATCH .

مشاهدة موجه حوار ملف تعريف الجهاز

الشكل 1. مربع حوار يطلب أذونات لملف تعريف جهاز الساعة.

عند إزالة الارتباط بين التطبيق والجهاز المرافق ، على سبيل المثال عند مسح بيانات الحزمة أو عند نسيان الجهاز ، فإن CDM تبطل دور ملف تعريف الجهاز للتطبيق ، مما يزيل جميع الأذونات المحددة لدور ملف التعريف من التطبيق.

بعد قبول المستخدم لطلب أحد التطبيقات بمنح أذونات لملف تعريف جهاز معين ، يمكن للمستخدم إبطال الأذونات الفردية التي تم منحها. عندما يتم إبطال الإذن من قبل المستخدم ، يظل التطبيق مرتبطًا بالجهاز المصاحب ولكن قد تصبح بعض الميزات غير متاحة. إذا كان الإذن مطلوبًا حتى يعمل التطبيق ، يجب أن يطلب التطبيق الإذن من خلال طلب إذن عادي.

متطلبات

لكي يتمكن التطبيق المصاحب من الوصول إلى واجهة برمجة تطبيقات الملف الشخصي للجهاز المصاحب ، يجب أن يفي التطبيق بالمتطلبات التالية:

  • امتلك جهازًا مصاحبًا (على سبيل المثال ، ساعة ذكية).
  • لديك سبب مشروع لطلب الأذونات المحددة لملف تعريف الجهاز المصاحب.

مشاهدة متطلبات الملف الشخصي للجهاز المصاحب

يصف الجدول التالي الأذونات المحددة لدور ملف تعريف الجهاز COMPANION_DEVICE_WATCH ومتطلبات استخدامها.

أذونات التطبيق المصاحب ومتطلبات الجهاز
إشعارات

BIND_NOTIFICATION_LISTENER_SERVICE
  • كن جهازًا متصلًا باستخدام Bluetooth و / أو Wi-Fi
  • لديه شاشة قادرة على عرض الإشعارات (يتم استبعاد الأجهزة التي تستخدم اللمس بدلاً من الشاشة)
  • يوفر تجربة إشعار مواجهة للمستخدم ، على سبيل المثال ، عرض إشعارات الهاتف على شاشة الجهاز المرافق
هاتف

phone
  • كن جهازًا متصلًا باستخدام Bluetooth و / أو Wi-Fi
  • يحتوي على ميكروفون ومكبر صوت مدمجين يتيحان المحادثة الصوتية
  • لديه شاشة تعرض معلومات المتصل
  • يوفر تجربة اتصال هاتفي تواجه المستخدم (التطبيق المصاحب يربط بين المكالمات الهاتفية)
رسالة قصيرة

sms
  • كن جهازًا متصلًا باستخدام Bluetooth و / أو Wi-Fi
  • يحتوي على شاشة تعرض رسائل SMS
  • توفير تجربة الرسائل النصية القصيرة للمستخدم
جهات الاتصال

contacts
  • كن جهازًا متصلًا باستخدام Bluetooth و / أو Wi-Fi
  • لديه شاشة عرض
  • يستخدم معلومات الاتصال كجزء من تجربة الاتصال أو المراسلة
التقويم

calendar
  • كن جهازًا متصلًا باستخدام Bluetooth و / أو Wi-Fi
  • لديه شاشة عرض
  • توفير تجربة تقويم تواجه المستخدم على الساعة
الأجهزة القريبة

nearby_devices
  • كن جهازًا متصلًا باستخدام Bluetooth و / أو Wi-Fi
  • لديه شاشة عرض
  • توفير تجربة الاقتران / الاتصال التي تواجه المستخدم على الساعة
توفير eSIM

USE_ICC_AUTH_WITH_DEVICE_IDENTIFIER
  • كن جهازًا متصلًا باستخدام Bluetooth و / أو Wi-Fi
  • لديه شاشة عرض
  • قدم تجربة مواجهة للمستخدم تدير خدمات المشترك من شركة الاتصالات على الساعة
إدارة المكالمات الجارية

MANAGE_ONGOING_CALLS
  • كن جهازًا متصلًا باستخدام Bluetooth و / أو Wi-Fi
  • يحتوي على ميكروفون ومكبر صوت مدمجين يتيحان المحادثة الصوتية
  • لديه شاشة تعرض معلومات المتصل
  • يوفر تجربة اتصال هاتفي تواجه المستخدم (التطبيق المصاحب يربط بين المكالمات الهاتفية)

الوصول

لتتمكن التطبيقات من الوصول إلى ملفات تعريف الجهاز المصاحب ، يجب الموافقة عليها وإضافتها إلى قائمة السماح. عند تلقي طلب لإضافته إلى قائمة السماح ، يقوم فريق Android بمراجعة التطبيق للتأكد من أنه يفي بمتطلبات ملف تعريف الجهاز المصاحب المقابل.

تطبيق

بالنسبة إلى الشركات المصنعة للأجهزة التي تنفذ تطبيقًا مصاحبًا بجهاز معين ، استخدم تكوينات نظام Android التالية المطلوبة للمصادقة على التطبيق المصاحب ، والذي يسمح للتطبيق بتخطي عرض مطالبة CDM للمستخدمين.

  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_COMAPNION_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 لتقديم طلب اقتران لجهاز مرافق واحد.

لمطوري الجهات الخارجية الذين يقومون بتنفيذ تطبيق مصاحب يطلب ملف تعريف DEVICE_PROFILE_WATCH ، قم بما يلي:

  1. قم باستدعاء طريقة setDeviceProfile .
  2. قم بالمرور في ملف DEVICE_PROFILE_WATCH الشخصي عند إنشاء AssociationRequest .

تصديق

لاختبار سلوك ميزة ملف تعريف الجهاز المصاحب ، استخدم اختبارات CTS التالية: