复杂功能插槽

复杂功能插槽是表盘上的一个区域，用户可以在其中添加复杂功能。复杂功能插槽包含 复杂功能 元素，这些元素定义了复杂功能如何针对不同的复杂功能类型以及在不同的表盘模式下呈现。

在 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，该名称显示在表盘编辑器中。
isCustomizable
确定用户是否可以在表盘编辑器中更改此插槽的提供程序。默认为 TRUE。

内部元素

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

每个受支持的复杂功能类型，ComplicationSlot 元素都必须包含至少一个 复杂功能 元素。ComplicationSlot 元素还可以选择包含更多 复杂功能 元素，以支持使用 变体 元素更改外观。

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