ComplicationSlot

表盘格式版本 <ph type="x-smartling-placeholder"></ph> 版本 2 版本 1

---

复杂功能显示槽是表盘上的一个区域，用户可在此区域内添加复杂功能。复杂功能显示槽包含 Complication 元素，这些元素用于定义针对不同复杂功能类型和不同表盘模式呈现复杂功能的方式。

注意：一个表盘最多只能有八个 ComplicationSlot 实例。

此元素在 Wear OS 4 中推出。

语法

<ComplicationSlot x="integer" y="integer" width="integer"
             height="integer" pivotX="float" pivotY="float"
             angle="float-degrees" alpha="integer" slotId="integer"
             name="string" displayName="string" scaleX="float" scaleY="float"
             supportedTypes="string" isCustomizable="boolean"
             tintColor="argb-color | rgb-color" />

属性

ComplicationSlot 具有以下属性。

必需属性

以下属性是必需属性：

x、y、width、height

用于指定元素的尺寸和位置的整数集合。

slotId

槽的唯一数字标识符。

supportedTypes

可用于填充槽的支持的复杂功能类型的列表。 支持的值包括 SHORT_TEXT、LONG_TEXT、MONOCHROMATIC_IMAGE、SMALL_IMAGE、PHOTO_IMAGE、RANGED_VALUE 和 EMPTY。可以支持多种复杂功能类型，只需以空格进行分隔即可（例如，SHORT_TEXT RANGED_VALUE）。

可选属性

以下属性是可选属性：

pivotX、pivotY

表示元素围绕其旋转的二维轴心点。这两个值都是浮点数，且均会经过调整以符合 $ [0, 1] $ 这一范围。

angle

表示元素围绕轴心点顺时针旋转时应遵循的角度值。

alpha

用于设置此元素应具有的透明度。值 0 表示此元素应是完全透明的。值 255 表示此元素应是完全不透明的。

scaleX

要应用于此元素的横向缩放比例。

scaleY

要应用于此元素的纵向缩放比例。

tintColor

对此元素应用色调滤镜。您必须使用 ARGB 格式（#ff000000 = 不透明的黑色）或 RGB 格式（#000000 = 黑色）指定颜色。

displayName

与复杂功能显示槽的本地化名称对应的资源 ID，此 ID 会显示在表盘编辑器中。

isCustomizable

决定用户是否可以在表盘编辑器中更改此槽的提供程序。默认设置为 TRUE。

内部元素

ComplicationSlot 元素必须只包含一个边界区域元素。

对于每个支持的复杂功能类型，ComplicationSlot 元素必须至少包含一个 Complication 元素。ComplicationSlot 元素可以选择包含更多 Complication 元素，以支持使用 Variant 元素更改外观。

ComplicationSlot 元素还可以包含以下内部元素：

• DefaultProviderPolicy
• Variant
• ScreenReader