الإضافة هي أي ميزة يتم عرضها على خلفية شاشة الساعة بالإضافة إلى الوقت. على سبيل المثال، مؤشر البطارية هو إحدى الإضافات. تتوفّر واجهة برمجة التطبيقات الخاصة بالإضافات لكلّ من خلفيات شاشة الساعة وتطبيقات مصادر البيانات.
يتناول الجزء المتبقي من هذا المستند مصادر البيانات وخلفيات شاشة الساعة وأنواع البيانات المعروضة على الشاشة.
مصدر بيانات الإضافة
تُعرف التطبيقات التي توفّر بيانات مثل مستوى البطارية أو الطقس أو عدد الخطوات لواجهات الساعات من أجل عرضها كبيانات إضافية باسم مصادر بيانات إضافية. توفّر مصادر البيانات هذه بيانات أولية، وهي غير مسؤولة عن التحكّم في طريقة عرض بياناتها على خلفية شاشة الساعة. لمعرفة كيفية كتابة تطبيقات توفّر بيانات لخلفيات شاشة الساعة، راجِع مقالة كشف البيانات للإضافات.
يوضّح المخطّط التالي كيف تتوسّط منصة Wear OS by Google في تدفّق البيانات من المصادر إلى خلفيات شاشة الساعة.
الإضافات على خلفيات شاشة الساعة
تتلقّى خلفيات شاشة الساعة البيانات من مصادر بيانات الإضافات، ما يتيح لها تضمين إضافات بدون الحاجة إلى رموز برمجية للحصول على البيانات الأساسية. تتيح واجهات المراقبة للمطوّرين الاحتفاظ بالتحكّم في طريقة عرض البيانات، ما يتيح لهم دمج البيانات بشكل طبيعي مع تصميماتهم. لمزيد من المعلومات، يُرجى الاطّلاع على دليل التصميم حول العناصر الإضافية.
للتعرّف على كيفية إضافة إضافات إلى خلفية شاشة الساعة، يمكنك الاطّلاع على مقالة إضافة إضافات إلى خلفية شاشة الساعة.
أنواع الإضافات
تحدّد أنواع التطبيقات المصغّرة أنواع البيانات التي يمكن عرضها في تطبيق مصغّر أو التي يمكن أن يقدّمها مصدر بيانات. على سبيل المثال، استخدِم النوع SHORT_TEXT عندما تتألف البيانات بشكل أساسي من سلسلة قصيرة. يحتوي الكائن
ComplicationData دائمًا على نوع واحد من البيانات المعقّدة يحدّد الحقول المطلوبة والاختيارية. يمثّل الحقل المطلوب الجزء الأساسي من البيانات، وتستمد معظم الأنواع اسمها من الحقل المطلوب.
تستخدِم مصادر البيانات أنواع الإضافات بشكل مختلف عن خلفيات شاشة الساعة:
- يختار مصدر البيانات أنواع بيانات التطبيقات المصغّرة التي سيوفّرها،
بما في ذلك الحقول الاختيارية التي سيوفّرها من تلك الأنواع،
وعدد الأنواع المختلفة التي يمكن توفيرها. على سبيل المثال، قد يتيح مصدر عدد الخطوات النوعَين
RANGED_VALUEوSHORT_TEXT، وقد يتيح مصدر الاجتماع التالي النوعَينSHORT_TEXTوLONG_TEXT. - يمكنك اختيار عدد العناصر التي تريد تضمينها في خلفية شاشة الساعة
وأنواع العناصر التي تريد إتاحتها. على سبيل المثال، قد تتوافق إضافة على شكل قرص في خلفية شاشة الساعة مع الأنواع
SHORT_TEXTوSMALL_IMAGEوRANGED_VALUE. قد لا يتيح مقياس على خلفية شاشة الساعة سوى النوعRANGED_VALUE.
لمزيد من المعلومات حول أنواع البيانات المختلفة التي يمكن عرضها في الإضافات والحقول المتوافقة مع كل نوع، راجِع أنواع البيانات التي يمكن عرضها في الإضافات.