پیدا کردن دستگاه‌ها در شبکه بااستفاده از Data Layer APIs

دستگاه‌ها ممکن است اتصال به اینترنت را به‌طور مستقیم بااستفاده از اتصال Wi-Fi یا شبکه تلفن همراه، یا به‌طور غیرمستقیم ازطریق دستگاه بلوتوث جفت‌شده برقرار کنند.

گره‌های قابل‌دسترسی و نزدیک

دستگاه زمانی قابل‌دسترس درنظر گرفته می‌شود که آنلاین باشد و بتواند با دستگاه دیگری ارتباط برقرار کند، چه مستقیماً ازطریق بلوتوث و چه به‌طور غیرمستقیم بااستفاده از فضای ابری به‌عنوان واسطه.

دستگاهی نزدیک درنظر گرفته می‌شود که بتواند مستقیماً ازطریق بلوتوث و بدون استفاده از فضای ابری متصل شود.

فعالیت‌هایی که بر زمان اتصال مجدد تأثیر می‌گذارند

در شرایط خاص، ممکن است دستگاه‌ها برای برقراری مجدد اتصال به حداکثر ۴ دقیقه زمان نیاز داشته باشند. این سناریوها شامل موارد زیر است:

  • غیرفعال بودن دستگاه Wear OS: اگر دستگاه Wear OS از مچ کاربر باز شود یا به‌مدت طولانی به‌طور فعال استفاده نشود، ممکن است زمان اتصال مجدد طولانی‌تر شود.
  • حالت چرت زدن: حالت چرت زدن صرفه‌جویی در مصرف برق دستگاه دستی می‌تواند فرایندهای پس‌زمینه را محدود کند و به‌طور بالقوه زمان اتصال مجدد دستگاه را افزایش دهد.
  • تعامل کاربر: اگر کاربر تقریباً هم‌زمان با دستگاه دستی و دستگاه Wear OS تعامل برقرار کند، این کار اغلب فرایند اتصال مجدد را تسریع می‌کند.

کاوش کردن همه دستگاه‌ها بااستفاده از کلاینت گره

شیء NodeClient فهرست دستگاه‌های مجهز به Android متصل به شبکه را شناسایی و به آن‌ها همه‌فرستی می‌کند، صرف‌نظر از قابلیت هر دستگاه. همه برنامه‌های موجود در دستگاه این اعلان‌های رویداد را دریافت می‌کنند، مثلاً وقتی دستگاه جدیدی به شبکه می‌پیوندد یا دستگاه موجودی آفلاین می‌شود.

کلاس NodeClient به‌ویژه برای پیدا کردن دستگاه‌هایی که برنامه شما را نصب نکرده‌اند مفید است.

برای ثبت‌نام در رویدادهای اتصال و قطع اتصال دستگاه، می‌توانید از کلاس Horologist DataLayerAppHelper استفاده کنید. این کلاس یک 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، هیچ دستگاه دیگری نباید در نتایج نشان داده شود.