กําหนดการกําหนดค่าผู้ใช้

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 วิธีดังนี้

  1. การใช้โครงสร้าง 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>

    โปรดทราบว่าตัวเลือกการกำหนดค่าไม่สามารถซ้อนกันในการใช้งานได้

  2. หรือจะใช้ตัวเลือกการกำหนดค่าในนิพจน์ก็ได้ ดังนี้

        <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 วิธี ดังนี้

  1. การใช้องค์ประกอบ 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>

  2. หรือจะใช้ตัวเลือกการกำหนดค่าในนิพจน์ที่ซับซ้อนมากขึ้นก็ได้ ดังนี้

        <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 รายการดังนี้

  1. การกำหนดค่าธีมสี ซึ่งช่วยให้ผู้ใช้เลือกธีมสีที่จะใช้ได้ คุณได้กำหนดธีมไว้ 2 ธีม โดยเป็นธีมสีสันสดใส 1 ธีมและธีมสีเดียว 1 ธีม
  2. รายการพื้นหลัง คุณได้กำหนดตัวเลือก 2 รายการที่ผู้ใช้เลือกได้
  3. ตัวเลือกว่าจะแสดงอัตราการเต้นของหัวใจของผู้ใช้บนหน้าปัดหรือไม่

นอกจากนี้ คุณยังมีComplicationSlotบนหน้าปัดด้วย

คุณตัดสินใจว่ามี Flavors 2 รายการที่ต้องการไฮไลต์ให้ผู้ใช้เห็น การตั้งค่าทั้งหมดนี้ยังสามารถนำมาผสมผสานกันได้อีกหลายแบบ แต่คุณคิดว่าการตั้งค่าต่อไปนี้เหมาะกับคุณที่สุด

  1. รสชาติแบบสปอร์ต: ประกอบด้วย
    1. ธีมสีสว่างเพื่อเพิ่มพลังและทำให้คุณกระฉับกระเฉง (รหัส: 0)
    2. ภาพพื้นหลังภาพแรก (รหัส: 0)
    3. อัตราการเต้นของหัวใจที่แสดงบนหน้าปัดเพื่อใช้อ้างอิง
    4. ช่องสำหรับข้อมูลแทรกที่แสดงจำนวนก้าว
  2. รสชาติที่ซับซ้อน: ประกอบด้วยสิ่งต่อไปนี้
    1. ธีมสีขาวดำที่เข้ากับทุกชุด (รหัส: 1)
    2. ภาพพื้นหลังที่ 2 (รหัส: 1)
    3. ไม่มีอัตราการเต้นของหัวใจแสดงบนหน้าปัด
    4. ไม่ได้เปิดใช้ช่องสำหรับข้อมูลแทรก

ต้องเปิดใช้ 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>