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

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

لاستخدام ملفات تعريف الجهاز المرافق، يجب أن تستوفي التطبيقات المرافقة المتطلبات التالية:

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

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

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

سلوك الجهاز

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

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

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

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

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

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

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

مشاهدة الملف الشخصي

تم تقديم ملف تعريف الساعة في Android 12.

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

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

BIND_NOTIFICATION_LISTENER_SERVICE
  • كن جهازًا متصلاً باستخدام Bluetooth و/أو Wi-Fi
  • يحتوي على شاشة قادرة على عرض الإشعارات (يتم استبعاد الأجهزة التي تستخدم اللمس بدلاً من الشاشة)
  • يوفر تجربة إشعارات تواجه المستخدم، على سبيل المثال، عرض إشعارات الهاتف على شاشة الجهاز المصاحب.
Phone
  • كن جهازًا متصلاً باستخدام Bluetooth و/أو Wi-Fi
  • يحتوي على ميكروفون ومكبر صوت مدمجين يتيحان المحادثة الصوتية
  • تحتوي على شاشة تعرض معلومات المتصل
  • يوفر تجربة اتصال هاتفية مباشرة للمستخدم (التطبيق المصاحب يربط بين المكالمات الهاتفية)
SMS
  • كن جهازًا متصلاً باستخدام Bluetooth و/أو Wi-Fi
  • يحتوي على شاشة تعرض الرسائل القصيرة
  • توفير تجربة الرسائل القصيرة التي تواجه المستخدم
Contacts
  • كن جهازًا متصلاً باستخدام Bluetooth و/أو Wi-Fi
  • تحتوي على شاشة عرض
  • يستخدم معلومات الاتصال كجزء من تجربة الاتصال أو المراسلة
Calendar
  • كن جهازًا متصلاً باستخدام Bluetooth و/أو Wi-Fi
  • تحتوي على شاشة عرض
  • توفير تجربة تقويم تواجه المستخدم على الساعة
Nearby devices
  • كن جهازًا متصلاً باستخدام Bluetooth و/أو Wi-Fi
  • تحتوي على شاشة عرض
  • توفير تجربة الاقتران/الاتصال التي تواجه المستخدم على الساعة
eSIM provisioning
  • كن جهازًا متصلاً باستخدام Bluetooth و/أو Wi-Fi
  • تحتوي على شاشة عرض
  • توفير تجربة مواجهة للمستخدم تدير خدمات المشترك من شركة الاتصالات على الساعة
Managing ongoing calls
  • كن جهازًا متصلاً باستخدام Bluetooth و/أو Wi-Fi
  • يحتوي على ميكروفون ومكبر صوت مدمجين يتيحان المحادثة الصوتية
  • تحتوي على شاشة تعرض معلومات المتصل
  • يوفر تجربة اتصال هاتفية مباشرة للمستخدم (التطبيق المصاحب يربط بين المكالمات الهاتفية)

الملف الشخصي للنظارات

تم تقديم ملف تعريف النظارات في Android 14.

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

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

BIND_NOTIFICATION_LISTENER_SERVICE

POST_NOTIFICATIONS
  • كن جهازًا متصلاً باستخدام Bluetooth و/أو Wi-Fi
  • يحتوي على شاشة قادرة على عرض الإشعارات (يتم استبعاد الأجهزة التي تستخدم اللمس بدلاً من الشاشة)
  • يوفر تجربة إشعارات تواجه المستخدم، على سبيل المثال، عرض إشعارات الهاتف على شاشة الجهاز المصاحب.
  • نشر إشعارات الهاتف لإدارة الجهاز، على سبيل المثال، عند توصيل جهاز النظارات أو عند تمكين ميزة معينة.
Phone
  • كن جهازًا متصلاً باستخدام Bluetooth و/أو Wi-Fi
  • يحتوي على ميكروفون ومكبر صوت مدمجين يتيحان المحادثة الصوتية
  • تحتوي على شاشة تعرض معلومات المتصل
  • يوفر تجربة اتصال هاتفية مباشرة للمستخدم (التطبيق المصاحب يربط بين المكالمات الهاتفية)
SMS
  • كن جهازًا متصلاً باستخدام Bluetooth و/أو Wi-Fi
  • يحتوي على شاشة تعرض الرسائل القصيرة
  • توفير تجربة الرسائل القصيرة التي تواجه المستخدم
Contacts
  • كن جهازًا متصلاً باستخدام Bluetooth و/أو Wi-Fi
  • تحتوي على شاشة عرض
  • يستخدم معلومات الاتصال كجزء من تجربة الاتصال أو المراسلة
Microphone
  • كن جهازًا متصلاً باستخدام Bluetooth و/أو Wi-Fi
  • تحتوي على شاشة عرض
  • يوفر تجربة ميكروفون مواجهة للمستخدم على النظارات
Nearby devices
  • كن جهازًا متصلاً باستخدام Bluetooth و/أو Wi-Fi
  • تحتوي على شاشة عرض
  • يوفر تجربة الاقتران/الاتصال التي تواجه المستخدم على النظارات
Managing ongoing calls
  • كن جهازًا متصلاً باستخدام Bluetooth و/أو Wi-Fi
  • يحتوي على ميكروفون ومكبر صوت مدمجين يتيحان المحادثة الصوتية
  • تحتوي على شاشة تعرض معلومات المتصل
  • يوفر تجربة اتصال هاتفية مباشرة للمستخدم (التطبيق المصاحب يربط بين المكالمات الهاتفية)

تطبيق

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

  1. اتصل بأسلوب setDeviceProfile .

  2. قم بتمرير ملف تعريف (على سبيل المثال، DEVICE_PROFILE_WATCH عند إنشاء 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/ .