نظرة عامة على Data Layer API

يتم التحكّم في العُقدة المستنِدة إلى السحابة الإلكترونية من خلال خادم تملكه Google
الشكل 1. عينة من شبكة العُقد التي تتضمّن أجهزة محمولة وأجهزة Wear OS

توفّر واجهة برمجة التطبيقات Wearable Data Layer API، وهي جزء من "خدمات Google Play"، قناة اتصال بين الأجهزة القابلة للارتداء (مثل الساعات الذكية) والأجهزة المحمولة المرتبطة (عادةً الهواتف الذكية). وهي طريقة لمزامنة البيانات ونقلها بين الأجهزة.

ملاحظة: لا تتوفّر واجهة برمجة التطبيقات هذه إلا على ساعات Wear OS وأجهزة Android المقترنة. بالنسبة إلى ساعات Wear OS المقترنة بهواتف iOS، يمكن للتطبيقات طلب بيانات من واجهات برمجة تطبيقات أخرى مستندة إلى السحابة الإلكترونية إذا كان الاتصال بالإنترنت متاحًا. لمزيد من المعلومات حول واجهات برمجة التطبيقات الأخرى هذه، يُرجى الانتقال إلى الوصول إلى الشبكة والمزامنة على Wear OS.

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

حالات الاستخدام الشائعة

تُعدّ Data Layer API مفيدة بشكل خاص لحالات استخدام اللياقة البدنية والوسائط.

تطبيقات لياقة بدنية

إرسال بيانات التمارين الرياضية من تطبيق Wear OS إلى تطبيق الأجهزة الجوّالة: تحتاج تطبيقات اللياقة البدنية غالبًا إلى كتابة بيانات التمارين الرياضية التي تم تسجيلها بواسطة ساعة إلى تطبيق على الجهاز الجوّال أو إلى Health Connect. في حال استخدام Data Layer API لنقل البيانات، استخدِم برنامجًا للتعامل مع الرسائل لإرسال بيانات التمارين الرياضية من تطبيق Wear OS إلى تطبيق الأجهزة الجوّالة من أجل الكتابة إلى Health Connect.

بث البيانات المباشرة إلى الجهاز الجوّال أثناء ممارسة التمارين الرياضية في المنزل

أحد سيناريوهات التمرين الشائعة في المنزل هو بث بيانات معدل ضربات القلب من جهاز Wear OS إلى جهاز جوّال وعرض معلومات معدل ضربات القلب الحديثة للمستخدم على شاشة الجهاز الجوّال. لبث هذه البيانات، استخدِم عميل قناة.

تطبيقات الوسائط

للتحكّم في مشغّل وسائط من خلال إجراء الإيقاف المؤقت أو الاستئناف أو البدء أو الإنهاء من الساعة إلى الهاتف، استخدِم برنامج مراسلة.

خيارات التواصل

يتم نقل البيانات بإحدى الطرق التالية:

  1. مباشرةً، عندما يكون هناك اتصال بلوتوث بين جهاز Wear OS وجهاز آخر
  2. عبر شبكة متاحة، مثل شبكة LTE أو Wi-Fi، باستخدام عقدة شبكة على خوادم Google كوسيط

يمكن لجميع عملاء "طبقة البيانات" تبادل البيانات إما باستخدام البلوتوث أو باستخدام السحابة الإلكترونية، وذلك حسب الاتصالات المتاحة للأجهزة. يُرجى العِلم أنّ البيانات التي يتم إرسالها باستخدام "طبقة البيانات" قد تستخدم في مرحلة ما خوادم تملكها Google.

البلوتوث

عند ربط الأجهزة باستخدام البلوتوث، تستخدم "طبقة البيانات" هذا الاتصال. تتوفّر قناة مشفّرة واحدة بين الأجهزة، باستخدام تشفير البلوتوث العادي، وتديرها "خدمات Google Play".

السحابة الإلكترونية

يتم توجيه البيانات تلقائيًا من خلال Google Cloud عندما لا يكون البلوتوث متاحًا. يتم تشفير جميع البيانات المنقولة من خلال Google Cloud بشكل تام بين الأطراف.

أمان الاتصالات

تفرض "خدمات Google Play" القيود التالية لتوفير تواصل أكثر أمانًا بين التطبيق المثبَّت على جهاز Wear OS والتطبيق نفسه المثبَّت على جهاز جوّال قريب:

  • يجب أن يتطابق اسم الحزمة على جميع الأجهزة.
  • يجب أن يتطابق توقيع الحزمة على جميع الأجهزة.

ولا يمكن لأي تطبيقات أخرى الوصول إلى البيانات بغض النظر عن نوع الاتصال.

ضبط إعدادات الميزة

تتضمّن واجهة برمجة التطبيقات Wearable Data Layer التبعيات التالية:

أدرِج الاعتمادية التالية في ملف build.gradle الخاص بوحدة Wear:

dependencies {
    ...
    implementation("com.google.android.gms:play-services-wearable:19.0.0")
}

تسهيل عملية الإقران الأولية

توفّر Horologist العديد من مكتبات الأدوات المساعدة التي تستند إلى واجهات برمجة التطبيقات الخاصة بالمنصة. وتتضمّن مكتبة طبقة البيانات التي تساعد في إنشاء اتصال بين جهاز جوّال وجهاز Wear OS. بالإضافة إلى ذلك، توفّر واجهات برمجة تطبيقات ملائمة لإجراء ما يلي:

  • ثبِّت التطبيق على الجهاز الآخر.
  • افتح التطبيق على الجهاز الآخر.
  • تشغيل نشاط معيّن على الجهاز الآخر
  • افتح التطبيق المصاحب.

الوصول إلى طبقة البيانات

لاستدعاء Data Layer API، استخدِم الفئة Wearable للحصول على مثيلات من فئات العملاء المختلفة، مثل DataClient وMessageClient.

لمزيد من المعلومات، يُرجى الاطّلاع على نموذج DataLayer.

استخدام برنامج بسيط للعميل

لإنشاء عميل، اطّلِع على نموذج الرمز التالي:

Kotlin

val dataClient: DataClient = Wearable.getDataClient(context)

Java

DataClient dataClient = Wearable.getDataClient(context);

يمكن أن يكون السياق أي سياق صالح لنظام Android. إذا كنت تستخدم واجهة برمجة التطبيقات ضمن نطاق Activity، استخدِم طريقة getDataClient() للفئة Wearable. يتيح ذلك ظهور بعض التفاعلات على شكل مربّعات حوار بدلاً من إشعارات، مثل عندما يُطلب من المستخدم تحديث إصدار "خدمات Google Play".

يتم تلقائيًا تنفيذ عمليات معاودة الاتصال بالمستمعين في سلسلة واجهة المستخدم الرئيسية للتطبيق. لإجراء عمليات ردّ الاتصال على سلسلة محادثات مختلفة، استخدِم عنصر WearableOptions لتحديد Looper مخصّص:

Kotlin

runBlocking {
    Wearable.getDataClient(context, options)
}

Java

WearableOptions options = new WearableOptions.Builder().setLooper(myLooper).build();
DataClient dataClient = Wearable.getDataClient(context, options);

لمزيد من المعلومات، اطّلِع على مرجع WearableOptions.Builder.

إعادة إنشاء مثيلات العميل حسب الضرورة

إنّ إنشاء برامج واجهة برمجة التطبيقات للأجهزة القابلة للارتداء، مثل DataClient وMessageClient، غير مكلف. لذلك، بدلاً من الاحتفاظ بالعملاء، أعِد إنشاءهم حسب الحاجة باستخدام النمط المناسب لتطبيقك.

تتم مشاركة حالة العميل، مثل مجموعة أدوات معالجة الأحداث المسجّلة، بين جميع العملاء ويتم الاحتفاظ بها في حال تعديل "خدمات Google Play" أثناء تشغيل أحد التطبيقات.