میاناهای برنامه‌سازی کاربردی لایه داده Wear OS از چندین نوع مختلف مشتری تشکیل شده‌اند که برای انواع مختلف داده و در شرایط اتصال مختلف مفید هستند.
این صفحه هر نوع کارخواه را معرفی می‌کند و شامل جدولی است که قابلیت‌های کارخواهان مختلف را مقایسه می‌کند. بااستفاده از این اطلاعات، می‌توانید مجموعه انواع کارخواهی را که برای برنامه‌تان بهترین عملکرد را دارد انتخاب کنید.
زمان استفاده از Data Layer API
وقتی تعامل صرفاً بین ساعت محلی و تلفن محلی است، از Data Layer API استفاده کنید. برای نمونه‌های دقیق، موارد استفاده رایج از Data Layer را ببینید.
کارخواه داده
شیء DataClient به شما امکان می‌دهد در DataItem یا
Asset بخوانید یا بنویسید:
هر
DataItemواحدی از اطلاعات است که در همه دستگاه‌های اطراف متعلق به کاربر همگام‌سازی و همه‌فرستی می‌شود.DataItemبه‌طور دائم ذخیره می‌شود، و دستگاهتان می‌تواند محتوای آن را تا زمانی که مورد داده حذف شود بخواند.Assetبرای محموله‌های داده بزرگ‌تر، مانند تصاویر یا فایل‌های رسانه‌ای، درنظر گرفته شده است.
کارخواه پیام‌رسانی
شیء MessageClient می‌تواند پیام ارسال کند و برای فراخوانی‌های رویه از راه دور (RPC) مناسب است، مانند استفاده از دستگاه Wear OS برای کنترل نسخه برنامه‌تان که روی دستگاه دستی نصب شده است.
پیام‌ها برای درخواست‌های یک‌طرفه بااستفاده از sendMessage() یا برای مدل ارتباطی درخواست و پاسخ بااستفاده از sendRequest() عالی هستند. برخلاف کارخواه‌های داده، کارخواه‌های پیام برای ارسال پیام نیاز دارند که گره‌ها به شبکه متصل باشند.
روش sendMessage() بهترین تلاش برای تحویل به گره راه دور است و
هیچ سازوکار توکار تکرار مجددی ندارد. اگر دستگاه هدف
قبل‌از شروع انتقال شبکه قطع شود، روش
TARGET_NODE_NOT_CONNECTED را برمی‌گرداند.
مشتری کانال
شیء ChannelClient ارتباط جریان‌محور بین دستگاه‌ها را فراهم می‌کند. کانال یک لوله ارتباطی دوطرفه بین دو گره است،
که برای موارد استفاده‌ای مانند موارد زیر مفید است:
- انتقال فایل‌های داده بین دو یا چند دستگاه متصل‌شده وقتی اینترنت دردسترس نیست.
ChannelClientفضای دیسک بیشتری نسبت‌بهDataClientذخیره می‌کند، که قبل‌از همگام‌سازی با دستگاه‌های متصل، نسخه‌ای از دارایی‌ها را در دستگاه محلی ایجاد می‌کند. - فایلی را که برای ارسال با
MessageClientخیلی بزرگ است به‌طور مطمئن ارسال کنید. - انتقال داده‌های جاری‌سازی‌شده، مثل داده‌های صوتی از میکروفون.
پس‌از باز کردن کانال، می‌توانید داده‌ها را در جریان بایت پیوسته ارسال و دریافت کنید، نه در واحدهای مجزای DataItem که مشتریان داده نیاز دارند.
مسئولیت مدیریت جریان داده و حفظ سازگاری داده‌ها با شما است. کلاینت‌های کانال همان سطح همگام‌سازی خودکار داده‌ها را که کلاینت‌های داده ارائه می‌دهند، ارائه نمی‌کنند.
مقایسه کارخواه
جدول زیر قابلیت‌های کارخواه‌های مختلف را مقایسه می‌کند:
| نوع کارخواه | ماندگاری داده‌ها | از داده‌های بزرگ‌تر از ۱۰۰ کیلوبایت پشتیبانی می‌کند؟ | شبکه مورداستفاده | آیا به صورت آفلاین کار می‌کند؟ |
|---|---|---|---|---|
| مشتری داده | داده‌ها برای مدت نامحدود حفظ می‌شود | بله (از
Asset
شیء استفاده می‌کند) |
بلوتوث ترجیح داده می‌شود. داده‌ها در فضای ابری پشتیبان‌گیری می‌شود؛ اگر بلوتوث دردسترس باشد، این پشتیبان‌گیری به‌صورت ناهمگام انجام می‌شود | بله، برای خواندن و نوشتن |
| ارسال پیام به مشتری | بدون پایداری و بدون تکرار | نه | بلوتوث ترجیح داده می‌شود، اما اگر Wi-Fi تنها نوع اتصال دردسترس باشد، می‌توان از آن استفاده کرد | نه |
| مشتری کانال | بدون پایداری (اتصال‌گرا) | بله | بلوتوث ترجیح داده می‌شود، اما اگر Wi-Fi تنها نوع اتصال دردسترس باشد، می‌توان از آن استفاده کرد | نه |
برای اطلاعات بیشتر درباره کار با Data Layer API، راهنمای همگام‌سازی داده‌ها را ببینید. برای ملاحظات مصرف باتری هنگام استفاده از Data Layer API، راهنمای صرفه‌جویی در مصرف باتری را ببینید.