تتألف واجهات برمجة التطبيقات لطبقة بيانات 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 إذا كان هو النوع الوحيد من الاتصال متاح | لا |