تتألف واجهات برمجة التطبيقات لطبقة البيانات في 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
|
يُفضَّل استخدام البلوتوث. يتم الاحتفاظ بنسخة احتياطية من البيانات على السحابة الإلكترونية، وإذا كان تقنية Bluetooth متاحة، يتم إجراء هذا الإجراء بشكل غير متزامن. | نعم، لكل من القراءة والكتابة |
| برنامج بريد إلكتروني | لا تُستخدَم ميزة الاحتفاظ بالبيانات ولا إعادة المحاولة. | لا | يُفضَّل استخدام البلوتوث، ولكن يمكن استخدام Wi-Fi إذا كان هو النوع الوحيد من الاتصال المتاح | لا |
| عميل القناة | لا تتوفّر ميزة الاحتفاظ بالبيانات (الطلبات الموجَّهة للاتصال) | نعم | يُفضَّل استخدام البلوتوث، ولكن يمكن استخدام Wi-Fi إذا كان هو النوع الوحيد من الاتصال المتاح | لا |