تقديم بيانات مفيدة من خلال الإضافات

الإضافات هي ميزة في خلفيات شاشة الساعات العادية والساعات الذكية تعرض معلومات إضافية. يختار المستخدم عادةً المعلومات التي تظهر في إحدى الإضافات.

تتوفّر الإضافات عادةً بعدد من الأشكال:

مستطيل
دائري
أقواس على طول حافة خلفية شاشة الساعة
الخلفية التي تغطي شاشة الساعة بأكملها

في Wear OS، يمكن تقسيم نظام "العناصر الإضافية" إلى جزأين:

مصدر بيانات "التعقيد"
عرض الإضافة

على سبيل المثال، قد ينفّذ تطبيق صحة ولياقة بدنية مصدر بيانات لتعقيد "الخطوات اليومية". يمكن عرض ذلك من خلال خلفية شاشة الساعة WFF.

مصادر البيانات في الإضافات

تحدّد مصادر بيانات الإضافات البيانات التي سيتم عرضها فقط، ونوع الإضافة. لا يؤدي مصدر البيانات أي دور في تحديد كيفية عرض البيانات على خلفية شاشة الساعة.

على سبيل المثال، قد ينتج مصدر بيانات أداة "الخطوات اليومية" المرتبطة بالصحة واللياقة البدنية البيانات التالية للإشارة إلى أنّ المستخدم قد اتّخذ 2400 خطوة من الهدف المحدد بـ 10000 خطوة اليوم:

النوع: GOAL_PROGRESS
القيمة: 2400
TargetValue: 10000

لاحظ أنّه لا يوجد في هذه البيانات ما يشير إلى كيفية عرضها.

يحدّد خلفية شاشة الساعة أنواع البيانات المعقّدة التي يمكنها عرضها. ويُحدّد ذلك مصادر البيانات التي يمكن للمستخدم الاختيار من بينها.

في مثال "الخطوات اليومية"، يمكنك تحديد كيفية عرض Value وTargetValue في تعريف خلفية شاشة الساعة: هل سيتم عرضها كنص أم كمؤشر تقدّم؟ ويعود إليك كمصمّم لخلفية شاشة الساعة تحديد ذلك.

تحديد الإضافات

يمكن أن تكون إمكانية عرض البيانات الموجزة على خلفية شاشة الساعة مفيدة للمستخدمين، لأنّها تتيح لهم الاطّلاع على مجموعة أكبر من المعلومات في لمحة وتخصيصها حسب احتياجاتهم.

حدِّد ما إذا كنت تريد توفير عدد من الإضافات على خلفية شاشة الساعة وكيفية توفيرها، وما هي أشكالها ومواضعها، وأنواع البيانات التي توفّرها.

يتم تعريف كل مساحة على خلفية شاشة الساعة مخصّصة لعنصر واجهة مستخدم على أنّه ComplicationSlot يتم فيه تحديد مساحة محيطة لعرض عنصر واجهة المستخدم:

<ComplicationSlot slotId="1" supportedTypes="SHORT_TEXT SMALL_IMAGE EMPTY"
    x="100" y="100" width="100" height="100">
    <BoundingOval x="0"  y="0" width="100" height="100" />
    <Complication type="SHORT_TEXT">
        <!-- Complication content for rendering SHORT_TEXT data goes here -->
    </Complication>
    <Complication type="SMALL_IMAGE">
        <!-- Complication content for rendering SMALL_IMAGE data goes here -->
    </Complication>
</ComplicationSlot>watchface_complications.xml

يمكن تطبيق أسلوب مشابه على الأشكال المحيطة الأخرى، مثل المستطيل والقطع الناقص.

ضبط نوع الإضافة والإعدادات التلقائية

يوفّر نظام الإضافات عددًا من الأنواع المختلفة، ما يتيح لخلفية شاشة الساعة التعبير عن نوع البيانات التي يمكنها تمثيلها على الشاشة. على سبيل المثال، لا يتناسب أحد أنواع التعقيدات على شكل قوس، كما هو موضّح سابقًا، مع نوع بيانات التعقيدات المستندة إلى الصور، مثل SMALL_IMAGE، ولكنّه قد يكون مناسبًا جدًا للبيانات الرقمية، مثل RANGED_VALUE.

في بيان ComplicationSlot، اضبط supportedTypes على قائمة مفصولة بمسافات لأنواع الإعلانات التي يمكن عرضها في هذه الخانة.

يجب أيضًا ضبط المصدر التلقائي لـ ComplicationSlot ما لم تسمح بنوع EMPTY، وفي هذه الحالة يكون ضبط مصدر تلقائي أمرًا اختياريًا:

<ComplicationSlot slotId="2" supportedTypes="SHORT_TEXT SMALL_IMAGE EMPTY"
    x="250" y="100" width="100" height="100">
    <DefaultProviderPolicy
        defaultSystemProvider="STEP_COUNT"
        defaultSystemProviderType="SHORT_TEXT" />
    <!-- ... -->
</ComplicationSlot>watchface_complications.xml

بالإضافة إلى ضرورة تحديد موفّري النظام، يمكنك اختياريًا تحديد موفّري خدمات غير تابعين للنظام، مثل موفّري خدمات تابعين لجهات خارجية لاستخدامهم تلقائيًا، إذا كانوا مثبّتين مسبقًا.

عرض بيانات الإضافة

بعد تحديد ComplicationSlot والحدود وعنصر Complication الحاوي، استخدِم مكوّنات WFF العادية، مثل PartDraw, PartImage وPartText، لعرض بيانات "البيانات المختصرة".

يمكن للعناصر ضِمن بيانات Complication الوصول إلى مصدر بيانات خاص: COMPLICATION، والذي يوفّر خصائص البيانات المختلفة التي يضبطها مصدر بيانات التطبيق المصغّر.

على سبيل المثال، يمكن أن يضبط عنصر SMALL_IMAGE المعقّد القيمتَين COMPLICATION.SMALL_IMAGE وCOMPLICATION.SMALL_IMAGE_AMBIENT. يمكن استخدام هذه القيم بدلاً من "المصدر" في عنصر Image:

<Complication type="SMALL_IMAGE">
    <PartImage x="0" y="0" width="100" height="100">
        <Image resource="[COMPLICATION.SMALL_IMAGE]" />
    </PartImage>
</Complication>watchface_complications.xml

لكل نوع من أنواع البيانات المعروضة مجموعة مختلفة من السمات المتاحة التي يمكن ضبطها. وللاطّلاع على قائمة كاملة بكل نوع، راجِع مرجع Complication. يعرض هذا المثال النص من إحدى SHORT_TEXT الإضافات:

<Complication type="SHORT_TEXT">
    <PartText x="0" y="0" width="100" height="100">
        <Text>
            <Font size="32">
                <Template>
                    <![CDATA[%s]]><Parameter expression="[COMPLICATION.TEXT]" />
                </Template>
            </Font>
        </Text>
    </PartText>
</Complication>watchface_complications.xml

زيادة الفائدة إلى أقصى حد عند عرض البيانات الموجزة

هناك عدد من التحديات عند إضافة ComplicationSlots إلى خلفية شاشة ساعتك، وهي:

هناك العديد من أنواع بيانات Complication. قد يوفّر تطبيق واحد أو أكثر من هذه الميزات.
يحتوي كل نوع بيانات Complication، بالإضافة إلى السمات الإلزامية، على العديد من السمات الاختيارية. تأكَّد من أنّ العرض الأكثر فائدة يتم إنشاؤه من الخصائص المتاحة، مع الأخذ في الاعتبار المجموعات المختلفة.

لحلّ هذه المشاكل، تتضمّن بعض الاستراتيجيات ما يلي:

إتاحة أنواع متعددة من البيانات المعقّدة لكل خانة على سبيل المثال، يتوافق SHORT_TEXT مع معظم مصادر بيانات الإضافات، لذا فإنّ توفير عدد من الأنواع المختلفة، مثل SHORT_TEXT RANGED_VALUE لإضافة دائرية صغيرة، يزيد من التوافق.
تقديم أنواع مختلفة من الإضافات على خلفية شاشة الساعة على سبيل المثال، يمكنك عرض RANGED_VALUE وGOAL_PROGRESS في إضافات Arc الموضوعة على الحافة، وSHORT_TEXT وSMALL_IMAGE في الإضافات الدائرية في نص خلفية شاشة الساعة.
ابحث عن العناصر الاختيارية لكل نوع بيانات. على سبيل المثال، تتيح السمة SHORT_TEXT بشكل اختياري استخدام سمة العنوان والصورة. قد يختلف تصميم عرض البيانات المتاحة حسب ما إذا كانت الصورة أو العنوان متوفّرَين أم لا.

تقديم بيانات مفيدة من خلال الإضافات تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.