布尔配置

布尔型配置允许用户在表盘编辑器中自定义表盘时，启用或禁用某个选项。

Wear OS 4 中引入。

语法

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

您可以在Scene元素内包含一个BooleanConfiguration元素，如下面的代码片段所示：

<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>

属性

BooleanConfiguration元素具有以下属性：

必需属性

以下属性是必需的：

id
配置值的唯一标识符。
displayName
对应于在表盘编辑器中显示的文本的资源 ID。
defaultValue
如果用户未在表盘编辑器中显式更改配置，则使用此默认配置值。

可选属性

以下属性是可选的：

icon
对应于在表盘编辑器中显示的可绘制资源的资源 ID。其最大尺寸应为 400x400 像素。
screenReaderText
如果用户启用了TalkBack，则使用此资源 ID 对应的文本。