انتخاب نوع مشتری

«میاناهای برنامه‌سازی کاربردی» لایه داده Wear OS از چندین نوع مختلف مشتری تشکیل شده است که برای انواع مختلف داده و در شرایط مختلف اتصال مفید هستند.

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

زمان استفاده از «میانای برنامه‌سازی کاربردی لایه داده»

وقتی تعامل صرفاً بین ساعت محلی و تلفن محلی باشد، از «میانای برنامه‌سازی کاربردی لایه داده» استفاده کنید. برای نمونه‌های دقیق، به موارد استفاده رایج «لایه داده» مراجعه کنید.

کارخواه داده

شیء 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 استفاده کرد نه

برای اطلاعات بیشتر درباره کار با «میاناهای برنامه‌سازی کاربردی لایه داده»، راهنمای همگام‌سازی داده‌ها را ببینید. برای ملاحظات مربوط به مصرف انرژی هنگام استفاده از «میاناهای برنامه‌سازی کاربردی لایه داده»، راهنمای صرفه‌جویی در مصرف انرژی را ببینید.