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