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

قد تنشئ الأجهزة اتصالاً بالإنترنت إما مباشرةً باستخدام شبكة Wi-Fi أو اتصال شبكة جوّال، أو بشكل غير مباشر من خلال جهاز مقترن يتضمّن بلوتوث.

العُقد التي يمكن الوصول إليها والعُقد المجاورة

يُعتبر الجهاز قابلاً للوصول إليه عندما يكون متصلاً بالإنترنت ومتاحًا للاتصال بجهاز آخر، إما مباشرةً من خلال البلوتوث أو بشكل غير مباشر باستخدام السحابة الإلكترونية كوسيط.

يُعتبر الجهاز قريبًا إذا كان من الممكن الاتصال به مباشرةً من خلال البلوتوث بدون استخدام السحابة الإلكترونية.

الأنشطة التي تؤثر في وقت إعادة الاتصال

في بعض الحالات، قد تتطلّب الأجهزة ما يصل إلى 4 دقائق لإعادة إنشاء الاتصال. وتشمل هذه الحالات ما يلي:

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

اكتشاف جميع الأجهزة باستخدام عميل عقدة

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

تُعدّ فئة NodeClient مفيدة بشكل خاص لاكتشاف الأجهزة التي لم يتم تثبيت تطبيقك عليها.

للتسجيل في أحداث اتصال الجهاز وفصله، يمكنك استخدام فئة DataLayerAppHelper في Horologist. ويوفّر connectedAndInstalledNodes Flow لمراقبة حالة الاتصال. بالإضافة إلى ذلك، تعرض طريقة connectedNodes() قائمة بالأجهزة المتصلة، وتجمع المعلومات من كل من NodeClient وCapabilityClient في عنصر واحد.

كيفية استكشاف أجهزة معيّنة باستخدام عميل إمكانات

يوفّر عنصر CapabilityClient معلومات حول الأجهزة المتوافقة مع إمكانات محدّدة للتطبيق على شبكة Wear OS. الإمكانية هي ميزة يحدّدها التطبيق في وقت الإنشاء أو يضبطها ديناميكيًا في وقت التشغيل.

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

لتحديد الإمكانات في وقت الإنشاء، يجب الإعلان عن مورد string-array باسم android_wear_capabilities في res/values/wear.xml، كما هو موضّح في تحديد أسماء الإمكانات لرصد تطبيقاتك. لمنع عملية تقليص الموارد من إزالة android_wear_capabilities كمورد غير مستخدم، حدِّد tools:keep="@array/android_wear_capabilities" في ملف منفصل للاحتفاظ بالموارد في دليل res/raw/ (على سبيل المثال، res/raw/keep.xml) بدلاً من res/values/wear.xml. للاطّلاع على بنية ملف الاحتفاظ، يُرجى مراجعة تخصيص الموارد المطلوب الاحتفاظ بها.

التحقّق من الإمكانات الجديدة لتطبيقك

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

تحديد ما إذا كان جهاز Wear OS هو الجهاز الوحيد على الشبكة

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