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

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

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

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

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

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

تُعد واجهة برمجة تطبيقات طبقة البيانات مفيدة بشكل خاص في حالات استخدام اللياقة البدنية والوسائط.

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

غالبًا ما يحتاج إرسال بيانات التمارين من تطبيق Wear OS إلى تطبيقات اللياقة البدنية على الأجهزة الجوّالة إلى ما يلي: اكتب بيانات التمرين التي تم التقاطها بواسطة الساعة على تطبيق للأجهزة الجوّالة أو إلى Health اتصال. في حال استخدام 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 والتطبيق نفسه على جهاز محمول قريب:

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

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

ضبط إعدادات الجهاز

تعتمد واجهة برمجة التطبيقات لطبقة البيانات القابلة للارتداء على التبعيات التالية:

يجب تضمين الاعتمادية التالية في ملفbuild.gradle في وحدة Wear OS:

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

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

توفّر Horology العديد من المكتبات المساعدة في أعلى واجهات برمجة تطبيقات النظام الأساسي. وتضم مكتبة طبقة بيانات تساعد في إنشاء اتصال بين جهاز محمول وجهاز 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" أثناء الجري.