UserConfigurations ช่วยให้คุณสร้างตัวเลือกที่ผู้ใช้สามารถเลือกได้ คุณปรับลักษณะขององค์ประกอบหน้าปัดตามค่าที่เลือกได้
ตัวเลือกการกำหนดค่าของผู้ใช้มีดังนี้
BooleanConfiguration: โดยปกติจะใช้ในกรณีที่ผู้ใช้อาจมีตัวเลือกในการแสดงองค์ประกอบหรือไม่ หรือเลือกระหว่าง 2 รูปแบบListConfiguration: แสดงตัวเลือกต่างๆ ให้ผู้ใช้ เช่น หากหน้าปัดมีภาพพื้นหลังให้เลือก 4 ภาพ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>
จากนั้นคุณจะใช้ตัวเลือกบูลีนได้ 2 วิธีดังนี้
การใช้โครงสร้าง
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>
เช่นเดียวกับตัวเลือกบูลีน การใช้ตัวเลือกนี้มี 2 วิธี ดังนี้
การใช้องค์ประกอบ
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>
ธีมสี
Watch Face Format ช่วยให้คุณกำหนดธีมสีผ่าน ColorConfiguration ได้
ผู้ใช้สามารถเลือกธีมที่ต้องการจากเครื่องมือแก้ไขหน้าปัด และสีจากธีมนี้จะปรากฏในคำจำกัดความของหน้าปัด
ตัวอย่างเช่น หากต้องการกำหนดธีมที่มี 2 รายการและ 3 สีในธีม ให้กำหนด 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>
จากนั้นจะใช้ค่าเหล่านี้เป็นแหล่งข้อมูลแทนค่าสีเลขฐาน 16 ได้ โปรดสังเกตวิธีระบุค่าดัชนีเพื่อเลือกองค์ประกอบที่ 1, 2 หรือ 3 ของธีม
<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 โดยไม่มีดัชนีได้ด้วย จากนั้นผู้ใช้จะเลือกรายการธีมที่ต้องการในเครื่องมือแก้ไขหน้าปัดได้
รสชาติ
หมายเหตุ: Watch Face Format เวอร์ชัน 2 ขึ้นไปรองรับ Flavor
UserConfigurations ช่วยให้ผู้ใช้มีความยืดหยุ่นอย่างมาก แต่เมื่อคุณเพิ่มจำนวนองค์ประกอบการกำหนดค่าที่กำหนด จำนวนชุดค่าผสมก็อาจเพิ่มขึ้นอย่างมาก
Flavors ช่วยให้คุณกำหนดค่าที่กำหนดล่วงหน้าสำหรับUserConfigurationsที่คุณคิดว่าควรไฮไลต์
จากนั้นผู้ใช้จะเลือกจากรสชาติที่กำหนดล่วงหน้าเหล่านี้ภายในแอปที่ใช้ร่วมกัน หรือเลือกค่าการกำหนดค่าแต่ละค่าแยกกันต่อไปได้
ตัวอย่างเช่น ลองพิจารณาหน้าปัดที่คุณกำหนดการตั้งค่าไว้ 3 รายการดังนี้
- การกำหนดค่าธีมสี ซึ่งช่วยให้ผู้ใช้เลือกธีมสีที่จะใช้ได้ คุณได้กำหนดธีมไว้ 2 ธีม โดยเป็นธีมสีสันสดใส 1 ธีมและธีมสีเดียว 1 ธีม
- รายการพื้นหลัง คุณได้กำหนดตัวเลือก 2 รายการที่ผู้ใช้เลือกได้
- ตัวเลือกว่าจะแสดงอัตราการเต้นของหัวใจของผู้ใช้บนหน้าปัดหรือไม่
นอกจากนี้ คุณยังมีComplicationSlotบนหน้าปัดด้วย
คุณตัดสินใจว่ามี Flavors 2 รายการที่ต้องการไฮไลต์ให้ผู้ใช้เห็น
การตั้งค่าทั้งหมดนี้ยังสามารถนำมาผสมผสานกันได้อีกหลายแบบ แต่คุณคิดว่าการตั้งค่าต่อไปนี้เหมาะกับคุณที่สุด
- รสชาติแบบสปอร์ต: ประกอบด้วย
- ธีมสีสว่างเพื่อเพิ่มพลังและทำให้คุณกระฉับกระเฉง (รหัส: 0)
- ภาพพื้นหลังภาพแรก (รหัส: 0)
- อัตราการเต้นของหัวใจที่แสดงบนหน้าปัดเพื่อใช้อ้างอิง
- ช่องสำหรับข้อมูลแทรกที่แสดงจำนวนก้าว
- รสชาติที่ซับซ้อน: ประกอบด้วยสิ่งต่อไปนี้
- ธีมสีขาวดำที่เข้ากับทุกชุด (รหัส: 1)
- ภาพพื้นหลังที่ 2 (รหัส: 1)
- ไม่มีอัตราการเต้นของหัวใจแสดงบนหน้าปัด
- ไม่ได้เปิดใช้ช่องสำหรับข้อมูลแทรก
ต้องเปิดใช้ Flavor ใน watch_face_info.xml ดังนั้นควรตั้งค่าองค์ประกอบ FlavorsSupported ในไฟล์ watch_face_info.xml เป็น value="true"
แต่ละ Flavor จะกำหนดไว้ภายใน 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>