اختيار نوع العميل

تتألف واجهات برمجة التطبيقات الخاصة بطبقة بيانات Wear OS من عدة أنواع مختلفة من البرامج، وهي مفيدة لأنواع مختلفة من البيانات وفي ظروف اتصال مختلفة.

تقدّم هذه الصفحة كل نوع من أنواع العملاء، وتتضمّن جدولاً يقارن بين إمكانات العملاء المختلفين. باستخدام هذه المعلومات، يمكنك اختيار مجموعة أنواع العملاء التي تناسب تطبيقك على أفضل وجه.

حالات استخدام Data Layer API

استخدِم Data Layer API عندما يكون التفاعل بين الساعة المحلية والهاتف المحلي فقط. للاطّلاع على أمثلة تفصيلية، يُرجى الرجوع إلى حالات الاستخدام الشائعة لطبقة البيانات.

عميل البيانات

يتيح لك عنصر 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 إذا كان هذا هو نوع الاتصال الوحيد المتاح.	لا

لمزيد من المعلومات حول استخدام واجهات برمجة التطبيقات الخاصة بطبقة البيانات، يُرجى الاطّلاع على دليل مزامنة البيانات. للاطّلاع على اعتبارات الطاقة عند استخدام واجهات برمجة التطبيقات الخاصة بطبقة البيانات، راجِع دليل الحفاظ على الطاقة.