الإضافة هي أي ميزة تظهر على خلفية شاشة الساعة مع الوقت. مثلاً، يُعدّ مؤشر البطارية إحدى الإضافات. إنّ Complics API مخصّصة لكل من خلفيات شاشة الساعة وتطبيقات مصدر البيانات.
يشرح باقي هذا المستند مصادر البيانات وخلفيات شاشة الساعة وأنواع الإضافات.
مصدر البيانات الإضافي
إنّ التطبيقات التي توفّر بيانات، مثل مستوى البطارية أو الطقس أو عدد الخطوات، لاستخدامها في خلفيات شاشة الساعة الخاصة بالمضاعفات، تسمى مصادر بيانات الإضافات. توفر مصادر البيانات هذه بيانات أولية ولا تتحمل مسؤولية التحكم في كيفية عرض البيانات على خلفية شاشة الساعة. للاطّلاع على معلومات حول كتابة التطبيقات التي توفّر بيانات لخلفيات شاشة الساعة، يُرجى مراجعة تعرّض البيانات للتعقيدات.
يوضِّح المخطّط التالي طريقة توسّط "Wear OS من Google" في تدفّق البيانات من المصادر إلى خلفيات شاشة الساعة.
![إضافات تدفق البيانات إضافات تدفق البيانات](https://developer.android.com/static/wear/images/complications-data-flow.png?authuser=6&hl=ar)
إضافات على خلفيات شاشة الساعة
تتلقّى خلفيات شاشة الساعة بيانات من مصادر بيانات الإضافات، ما يتيح لها تضمين إضافات بدون الحاجة إلى رمز للحصول على البيانات الأساسية. وتحتفظ خلفيات شاشة الساعة بالتحكّم في طريقة عرض البيانات كي تتمكن من دمج البيانات بشكل طبيعي مع تصميمها. لمزيد من المعلومات، راجِع دليل التصميم حول الإضافات.
للحصول على معلومات حول كيفية إدراج الإضافات على خلفية شاشة الساعة، يمكنك الاطّلاع على إدراج إضافات إلى خلفية شاشة الساعة.
أنواع الإضافات
تحدّد أنواع الإضافات أنواع البيانات التي يمكن عرضها في الإضافة أو توفيرها من خلال مصدر بيانات. على سبيل المثال، يمكنك استخدام النوع SHORT_TEXT
عندما تتألف
البيانات بشكل أساسي من سلسلة قصيرة. يحتوي الكائن
ComplicationData
دائمًا على نوع إضافة واحد يحدّد الحقول المطلوبة والاختيارية. ويمثل الحقل المطلوب الجزء الأساسي من البيانات، وتأخذ معظم الأنواع أسماءها من الحقل المطلوب.
تستخدم مصادر البيانات أنواع الإضافات بشكل مختلف عن خلفيات شاشة الساعة:
- يختار مصدر البيانات أنواع بيانات الإضافة التي سيتم توفيرها، بما في ذلك الحقول الاختيارية من تلك الأنواع التي تريد توفيرها، وعدد الأنواع المختلفة التي يمكن توفيرها. على سبيل المثال، قد يتيح مصدر عدد الخطوات
النوعَين
RANGED_VALUE
وSHORT_TEXT
، وقد يتيح مصدر الاجتماع التالي النوعَينSHORT_TEXT
وLONG_TEXT
. - يمكنك اختيار عدد الإضافات التي تريد تضمينها في خلفية شاشة الساعة وأنواع الإضافات التي تريد توفيرها. على سبيل المثال، قد تتوافق إضافة الاتصال على خلفية شاشة الساعة مع الأنواع
SHORT_TEXT
وICON
وRANGED_VALUE
. قد يكون المقياس الظاهر على خلفية شاشة الساعة متوافقًا مع النوعRANGED_VALUE
فقط.
لمزيد من المعلومات حول أنواع الإضافات والحقول المختلفة المتاحة لكل نوع، يمكنك الاطّلاع على أنواع الإضافات.