يتيح لك UserConfigurations إنشاء خيارات يمكن للمستخدم الاختيار
من بينها. يمكنك تعديل مظهر عناصر خلفية شاشة الساعة
استنادًا إلى القيم التي تم اختيارها.
يمكن أن تكون خيارات ضبط المستخدم:
-
BooleanConfiguration: تُستخدَم عادةً عندما يكون لدى المستخدم خيار عرض عنصر أو عدم عرضه، أو الاختيار بين نمطَين -
ListConfiguration: يوفّر للمستخدم مجموعة من الخيارات. على سبيل المثال، إذا كانت خلفية شاشة الساعة تحتوي على أربع صور خلفية مختلفة للاختيار من بينها -
ColorConfiguration: يحدّد نُسُق الألوان التي يمكن للمستخدم اختيار النسق المفضّل لديه من بينها
الخيارات المنطقية
تُعدّ الخيارات المنطقية من أبسط إعدادات المستخدم. ويمكن تعريفها على النحو التالي:
<!-- Under WatchFace element --> <UserConfigurations> <!-- show_date and show_date_label defined in res/values/strings.xml --> <BooleanConfiguration id="show_date" displayName="show_date_label" screenReaderText="show_date_label" defaultValue="TRUE" /> </UserConfigurations>
يمكن بعد ذلك استخدام الخيارات المنطقية بطريقتَين:
استخدام بنية
BooleanConfigurationضمن خلفية شاشة الساعةScene:<!-- Within the main Scene of the watch face --> <BooleanConfiguration id="show_date"> <BooleanOption id="TRUE"> <!-- ...Content when date required --> </BooleanOption> <BooleanOption id="FALSE"> <!-- ...Content when date not required --> </BooleanOption> </BooleanConfiguration>
يُرجى العِلم أنّه لا يمكن دمج خيارات الضبط في استخدامها.
بدلاً من ذلك، يمكن استخدام خيار الضبط في التعبيرات:
<Expressions> <Expression name="my_expression"> <!-- Use show_date as part of a more complex evaluation --> <![CDATA[[CONFIGURATION.show_date] == "TRUE" && [HOUR_0_23] < 15]] </Expression> </Expressions> <Compare expression="my_expression"> <!-- Content goes here --> </Compare> </Condition>
خيارات القوائم
تعمل خيارات القائمة بطريقة مشابهة جدًا للخيارات المنطقية. على سبيل المثال، لتقديم قائمة بصور الخلفية ليختار المستخدم من بينها:
<!-- Under WatchFace element --> <UserConfigurations> <ListConfiguration id="background_image" displayName="background_image_label" icon="background_option_icon" screenReaderText="background_image_label" defaultValue="0"> <ListOption id="0" displayName="background0_image_label" screenReaderText="background0_image_label" icon="background0_icon" /> <ListOption id="1" displayName="background1_image_label" screenReaderText="background1_image_label" icon="background1_icon" /> ... </ListConfiguration> </UserConfigurations>
على غرار الخيارات المنطقية، هناك طريقتان لاستخدام هذا:
استخدام العنصر
ListConfigurationفيScene:<!-- Within the main Scene of the watch face --> <ListConfiguration id="background_image"> <ListOption id="0"> <!-- ...Content for option 0 --> </ListOption> <ListOption id="1"> <!-- ...Content for option 1 --> </ListOption> </ListConfiguration>
بدلاً من ذلك، يمكن استخدام خيار الضبط في تعبيرات أكثر تعقيدًا:
<Expressions> <Expression name="background_zero_and_something_else"> <!-- Use as part of a more complex evaluation --> <![CDATA[[CONFIGURATION.background_image] == "0" && [HOUR_0_23] < 15]] </Expression> </Expressions> <Compare expression="background_zero_and_something_else"> <!-- Content goes here --> </Compare> </Condition>
نُسُق الألوان
يتيح لك تنسيق خلفية شاشة الساعة تحديد نُسُق الألوان من خلال ColorConfiguration.
يمكن للمستخدمين اختيار المظهر الذي يريدونه من أداة تعديل خلفية شاشة الساعة، ويمكن أن تظهر الألوان من هذا المظهر في جميع أنحاء تعريف خلفية شاشة الساعة.
على سبيل المثال، لتحديد مظهر يتضمّن إدخالَين وثلاثة ألوان،
حدِّد ColorConfiguration على النحو التالي:
<!-- Under WatchFace element --> <UserConfigurations> <ColorConfiguration id="myThemeColor" displayName="theme_label" defaultValue="0"> <ColorOption id="0" displayName="relaxed_label" colors="#3083dc #f8ffe5 #7dde92" /> <ColorOption id="1" displayName="urban_label" colors="#f4b393 #fc60a8 #7a28cb" /> </ColorConfiguration> </UserConfigurations>
ويمكن بعد ذلك استخدامها كمصادر بيانات بدلاً من قيم الألوان الست عشرية. لاحظ كيفية تحديد قيمة الفهرس لتحديد العنصر الأول أو الثاني أو الثالث من السمة:
<AnalogClock x="0" y="0" width="450" height="450"> <HourHand resource="hour" x="220" y="55" width="20" height="190" pivotX="0.5" pivotY="0.9210" tintColor="[CONFIGURATION.myThemeColor.0]"/> <MinuteHand resource="minute" x="222" y="30" width="16" height="220" pivotX="0.5" pivotY="0.9" tintColor="[CONFIGURATION.myThemeColor.1]"/> <SecondHand resource="second" x="226" y="20" width="8" height="245" pivotX="0.5" pivotY="0.8571" tintColor="[CONFIGURATION.myThemeColor.2]"/> </AnalogClock>
في الحالة المحدّدة التي يتم فيها تحديد لون واحد فقط لكل ColorOption، يمكن أيضًا الإشارة إليه على أنّه CONFIGURATION.myThemeColor، بدون الفهرس. ويمكن للمستخدم بعد ذلك اختيار المظهر الذي يريده في أداة تعديل خلفية شاشة الساعة.
النكهات
ملاحظة: تتوافق التصاميم مع الإصدار 2 والإصدارات الأحدث من تنسيق خلفية شاشة الساعة.
توفّر UserConfigurations للمستخدم قدرًا كبيرًا من المرونة، ولكن مع زيادة عدد عناصر الضبط التي تحدّدها، يمكن أن يزداد عدد المجموعات بشكل كبير.
تتيح لك ميزة "Flavors" تحديد إعدادات مسبقة لـ "UserConfigurations" التي
تستحق تسليط الضوء عليها.
يمكن للمستخدم بعد ذلك الاختيار من بين هذه الإعدادات المسبقة ضمن التطبيق المصاحب، أو الاستمرار في اختيار كل قيمة إعداد على حدة.
على سبيل المثال، لنفترض أنّ لديك خلفية شاشة ساعة تحدّد فيها ثلاثة إعدادات:
- إعداد نسق الألوان، ما يسمح للمستخدم باختيار نسق الألوان الذي يريد تطبيقه لقد حدّدت مظهرَين، أحدهما ملوّن والآخر أحادي اللون.
- قائمة بالخلفيات لقد حدّدت خيارَين يمكن للمستخدم الاختيار من بينهما.
- خيار يتيح عرض معدّل نبضات قلب المستخدم على خلفية شاشة الساعة
بالإضافة إلى ذلك، لديك ComplicationSlot على خلفية شاشة الساعة.
قررت أنّ هناك Flavors تريد إبرازهما للمستخدم.
هناك العديد من المجموعات الممكنة لكل هذه الإعدادات، ولكن هذه هي
التي تعتقد أنها تعمل بشكل أفضل:
- طابع رياضي: يتكوّن هذا الطابع من:
- نسق الألوان الساطعة، لتعزيز طاقتك ونشاطك (رقم التعريف: 0)
- صورة الخلفية الأولى (رقم التعريف: 0)
- معدّل نبضات القلب يظهر على خلفية شاشة الساعة كمرجع
- مساحة الإضافة التي تعرض عدد الخطوات
- نكهة متطوّرة: ستتألف من:
- نسق الألوان الأحادية الذي يتناسب مع أي ملابس (رقم التعريف: 1)
- صورة الخلفية الثانية (رقم التعريف: 1)
- عدم ظهور معدّل نبضات القلب على خلفية شاشة الساعة
- مساحة الإضافة غير مفعَّلة
تتطلّب الإصدارات تفعيلها في watch_face_info.xml، لذا يجب ضبط العنصر FlavorsSupported في ملف watch_face_info.xml على value="true".
يتم تحديد كل إصدار ضمن UserConfigurations على النحو التالي:
<!-- Under UserConfigurations --> <Flavors defaultValue="sporty_flavor"> <Flavor id="sporty_flavor" displayName="flavor_sporty_label" screenReaderText="flavor_sporty_label"> <Configuration id="theme_color" optionId="0"/> <Configuration id="background_image" optionId="0"/> <Configuration id="show_hr" optionId="TRUE"/> <ComplicationSlot slotId="0"> <DefaultProviderPolicy defaultSystemProvider="STEP_COUNT" defaultSystemProviderType="SHORT_TEXT"/> </ComplicationSlot> </Flavor> <Flavor id="sophisticated_flavor" displayName="flavor_sophisticated_label" screenReaderText="flavor_sophisticated_label"> <Configuration id="theme_color" optionId="1"/> <Configuration id="background_image" optionId="1"/> <Configuration id="show_hr" optionId="FALSE"/> <ComplicationSlot slotId="0"> <!-- Type here is set to empty to demonstrate how to hide a complication slot in Flavors. --> <DefaultProviderPolicy defaultSystemProvider="SUNRISE_SUNSET" defaultSystemProviderType="EMPTY"/> </ComplicationSlot> </Flavor> </Flavors>