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

لطلب واجهة برمجة تطبيقات طبقة البيانات، استخدِم الفئة 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" أثناء تشغيل التطبيق.