لطلب واجهة برمجة تطبيقات طبقة البيانات، استخدِم الفئة
Wearable
للحصول على مثيلات لفئات العملاء المختلفة،
مثل
DataClient
و
MessageClient
.
ارجع إلى الموارد التالية ذات الصلة:
ملاحظة: يمكن لواجهة برمجة التطبيقات Data Layer API إرسال الرسائل ومزامنتها
مع أجهزة Android أو ساعات Wear OS فقط. ويعني ذلك أنّه إذا تم إقران جهاز Wear OS
بجهاز iOS، لن تعمل واجهة Data Layer API.
لهذا السبب، تجنَّب
استخدام Data Layer API كطريقة أساسية للتواصل مع الشبكة. بدلاً من ذلك، اتّبِع النمط نفسه المستخدَم في التطبيقات المتوافقة مع الأجهزة الجوّالة، مع بعض الاختلافات الطفيفة.
استخدام عميل صغير
الحد الأدنى من العميل، كما هو موضح في المثال التالي، كافٍ للبدء. راجِع الوصول إلى Google APIs للحصول على معلومات إضافية.
Kotlin
val dataClient: DataClient = Wearable.getDataClient(context)
Java
DataClient dataClient = Wearable.getDataClient(context);
ويمكن أن يكون السياق أي سياق صالح في Android. إذا كنت تستخدم واجهة برمجة التطبيقات في نطاق Activity
، استخدِم طريقة getDataClient(activity)
من الفئة Wearable
. يتيح هذا الإجراء ظهور تفاعلات معيّنة
على شكل مربّعات حوار وليس كإشعارات، مثلاً عندما يُطلب من المستخدم
تحديث إصداره من "خدمات Google Play".
يتم تلقائيًا إجراء استدعاءات للمستمعين في سلسلة محادثات واجهة المستخدم الرئيسية للتطبيق.
لإجراء عمليات معاودة الاتصال على سلسلة محادثات مختلفة، استخدِم كائن
WearableOptions
لتحديد Looper
مخصّص:
Kotlin
val dataClient: DataClient = Wearable.WearableOptions.Builder().setLooper(myLooper).build().let { options -> 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" أثناء تشغيل التطبيق.