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

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

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