口味

「Flavor」會指定一組設定值，並分組為預設值。一般來說，使用者可以在隨附應用程式中選擇這些口味。

Flavor 可包含現有設定的值，包括下列類型：

  • BooleanConfiguration
  • ColorConfiguration
  • ListConfiguration
  • ComplicationSlot

自第 2 版起

語法

<Flavor id="string" displayName="string" icon="string"
    screenReaderText="string" defaultValue="">
    <!-- Flavor-specific child elements. -->
    <Configuration ... />
    <ComplicationSlot .../>
<Flavor/>>

您可以在 UserConfigurations 元素內加入 Flavor 元素，如以下範例所示：

<UserConfigurations>
  <!-- Configuration definitions go here -->
  <ColorConfiguration id="themeColor" ... />
  <!-- ... -->

  <Flavors>
    <Flavor id="1" displayName="1st flavor" icon="flavor_1_preview" defaultValue="">
        <Configuration id="themeColor" optionId="0"/>
        <ComplicationSlot slotId="0">
            <DefaultProviderPolicy
                defaultSystemProvider="DAY_OF_WEEK"
                defaultSystemProviderType="SHORT_TEXT"/>
        </ComplicationSlot>
    </Flavor>

    <Flavor id="2" displayName="2nd flavor" icon="flavor_2_preview" defaultValue="">
        <Configuration id="themeColor" optionId="1"/>
        <ComplicationSlot slotId="0">
            <DefaultProviderPolicy
                defaultSystemProvider="WATCH_BATTERY"
                defaultSystemProviderType="SHORT_TEXT"/>
        </ComplicationSlot>
    </Flavor>
  </Flavors>
</UserConfigurations>

如要使用 Flavors，必須在 res/xml/watch_face_info.xml 中新增以下內容：

<?xml version="1.0" encoding="utf-8"?>
<WatchFaceInfo>
    ...
    <MultipleInstancesAllowed value="true" />
    <FlavorsSupported value="true" />
</WatchFaceInfo>

屬性

Flavor 元素的屬性如下：

必要屬性

必要屬性包括：

id
Flavor 的專屬 ID。
displayName
與隨播廣告中顯示的文字相對應的資源 ID。
defaultValue
請勿使用這項屬性，因此應將其設為空白。

選用屬性

選用屬性包括：

icon
與隨播廣告中顯示的可繪製資源相對應的資源 ID。大小上限為 360x360 像素。
screenReaderText
在使用者已啟用 TalkBack 的情況下，與所使用文字相對應的資源 ID。

內部元素

Flavor 元素必須包含至少一個 Configuration 元素，且可選擇加入 ComplicationSlot 元素。

  • Configuration 元素會使用 id 屬性參照先前定義的設定元素，例如 BooleanConfiguration。Configuration 元素會使用 optionId 屬性設定這個設定選項的所選值。

  • ComplicationSlot 元素可用來指定特定 Flavor 的 DefaultProviderPolicy。