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