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