風味

フレーバーは、プリセットとしてグループ化された一連の構成値を指定します。 通常、ユーザーはコンパニオン アプリでこれらのフレーバーから選択できます。

Flavor には、次のような既存の構成の値を含めることができます。 次のタイプがあります。

  • BooleanConfiguration
  • ColorConfiguration
  • ListConfiguration
  • ComplicationSlot

バージョン 2 以降

構文

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

UserConfigurations 要素内に Flavor 要素を含められます。 次のように指定します。

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

  <!-- The defaultValue is required. Set this attribute to the ID
       of the flavor that the system should show by default. -->
  <Flavors defaultValue="1">
    <Flavor id="1" displayName="1st flavor" icon="flavor_1_preview">
        <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">
        <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 の一意の識別子。
displayName
コンパニオンに表示されるテキストに対応したリソース ID。

オプションの属性

次の属性は省略可能です。

icon
次のドローアブル リソースに対応するリソース ID。 作成できます。サイズは 360 x 360 ピクセル以下にしてください。
screenReaderText
ユーザーが TalkBack を有効にしている場合に使用されるテキストに対応したリソース ID。

内部要素

Flavor 要素には 1 つ以上の Configuration 要素を含める必要があり、 必要に応じて ComplicationSlot 要素を含めることができます。

  • Configuration 要素が、以前に定義された構成を参照する id 属性を使用して、BooleanConfiguration などの要素を追加します。「 Configuration 要素は、この設定オプションに選択した値を設定します optionId 属性を使用します。

  • ComplicationSlot 要素を使用すると、 指定された Flavor に対する DefaultProviderPolicy。