تتألف واجهات برمجة التطبيقات الخاصة بطبقة بيانات 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 إذا كان هذا هو نوع الاتصال الوحيد المتاح. | لا |
لمزيد من المعلومات حول استخدام واجهات برمجة التطبيقات الخاصة بطبقة البيانات، يُرجى الاطّلاع على دليل مزامنة البيانات. للاطّلاع على اعتبارات الطاقة عند استخدام واجهات برمجة التطبيقات الخاصة بطبقة البيانات، راجِع دليل توفير الطاقة.