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