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

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

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

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

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

لمزيد من المعلومات عن الأجهزة المصاحبة، يُرجى الاطّلاع على إقران الجهاز المصاحب:

سلوك الجهاز

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

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

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

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

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

الملفات الشخصية للأجهزة المصاحبة للتطبيقات التابعة لجهات خارجية

الملف الشخصي على الساعة

يتم تقديم الملف الشخصي للساعة في نظام التشغيل Android 12.

يوضّح الجدول التالي الأذونات المحدَّدة COMPANION_DEVICE_WATCH ملف الجهاز ومتطلبات استخدامها.

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

ملف شخصي على Glass

تم تقديم الملف الشخصي للنظارات في Android 14.

يوضّح الجدول التالي الأذونات المحدَّدة COMPANION_DEVICE_GLASSES ملف الجهاز ومتطلبات استخدامها.

الأذونات	متطلبات الأجهزة والتطبيقات المصاحبة
الإشعارات BIND_NOTIFICATION_LISTENER_SERVICE POST_NOTIFICATIONS	أن يكون جهازًا متصلاً ويستخدم بلوتوث و/أو Wi-Fi لديه شاشة يمكنها عرض الإشعارات (الأجهزة التي تستخدم يتم استبعاد تقنية اللمس بدلاً من الشاشة) توفر تجربة إشعار موجَّهة للمستخدمين، مثل عرض إشعارات الهاتف على شاشة الجهاز المصاحب نشر إشعارات على الهاتف بشأن إدارة الأجهزة، مثلاً عند توصيل جهاز نظارات أو تفعيل ميزة معيّنة
Phone	أن يكون جهازًا متصلاً ويستخدم بلوتوث و/أو Wi-Fi يحتوي على ميكروفون ومكبّر صوت مُدمَجَين يتيحان إجراء محادثة صوتية. يتضمّن شاشة تعرض معلومات المتصل لتوفير تجربة اتصال هاتفية موجَّهة للمستخدم (التطبيق المصاحب جسر المكالمات الهاتفية)
SMS	أن يكون جهازًا متصلاً ويستخدم بلوتوث و/أو Wi-Fi يتضمّن شاشة تعرض الرسائل القصيرة. توفير تجربة رسائل قصيرة SMS موجّهة للمستخدمين
Contacts	أن يكون جهازًا متصلاً ويستخدم بلوتوث و/أو Wi-Fi يحتوي على شاشة عرض استخدام معلومات الاتصال كجزء من تجربة الاتصال أو المراسلة
Microphone	أن يكون جهازًا متصلاً ويستخدم بلوتوث و/أو Wi-Fi يحتوي على شاشة عرض توفر تجربة استخدام الميكروفون موجَّهة للمستخدمين على النظارات
Nearby devices	أن يكون جهازًا متصلاً ويستخدم بلوتوث و/أو Wi-Fi يحتوي على شاشة عرض توفر تجربة إقران/اتصال موجَّهة للمستخدم على النظارات
Managing ongoing calls	أن يكون جهازًا متصلاً ويستخدم بلوتوث و/أو 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/