Konfiguracja logiczna

Konfiguracja logiczna daje użytkownikowi opcję, którą można włączyć lub wyłączyć podczas dostosowywania tarczy zegarka w edytorze tarczy zegarka.

Wprowadzone w Wear OS 4.

Składnia

<BooleanConfiguration id="string" displayName="string" icon="string"
                         screenReaderText="string" defaultValue="TRUE | FALSE"
/>

Element BooleanConfiguration możesz umieścić w elemencie Scene, jak w tym przykładowym kodzie:

<UserConfigurations>
  <BooleanConfiguration id="show_date"
      displayName="show_date_label"
      screenReaderText="show_date_label"
      defaultValue="TRUE"
  />
</UserConfigurations>

<!-- ... -->

<Scene backgroundColor="#ff000000">
  <!-- ... -->

  <BooleanConfiguration id="show_date">
    <BooleanOption id="TRUE">
      <Group ...>
        <!-- ...Content to show date -->
      </Group>
    </BooleanOption>
    <BooleanOption id="FALSE">
      <Group ...>
        <!-- ...Content when date not required -->
      </Group>
    </BooleanOption>
  </BooleanConfiguration>

  <!-- ... -->
</Scene>

Uwaga: elementów BooleanConfiguration nie można zagnieżdżać w elementach Scene, gdy próbujesz wybrać treści na podstawie wartości 2 lub większej liczby opcji konfiguracji. Aby używać opcji konfiguracji w połączeniu z innymi wartościami, użyj zamiast tego parametru Condition. Przykład:

<Condition>
  <Expressions>
    <Expression name="show_date_and_time">
      <![CDATA[[CONFIGURATION.show_date] == "TRUE" && [CONFIGURATION.show_time] == "TRUE"]]>
    </Expression>
  </Expressions>
  ...
</Condition>

Atrybuty

Element BooleanConfiguration ma te atrybuty:

Atrybuty wymagane

Wymagane są te atrybuty:

id

Unikalny identyfikator wartości konfiguracji.

displayName

Identyfikator zasobu odpowiadający tekstowi wyświetlanemu w edytorze tarczy zegarka.

defaultValue

Domyślna wartość konfiguracji używana, jeśli użytkownik nie zmienił konfiguracji w edytorze tarczy zegarka.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

icon

Identyfikator zasobu odpowiadający zasobowi rysunkowemu, który jest wyświetlany w edytorze tarczy zegarka. Maksymalny rozmiar to 400 x 400 pikseli.

screenReaderText

Identyfikator zasobu odpowiadający tekstowi, który jest używany, jeśli użytkownik ma włączoną usługę TalkBack.