复杂功能插槽

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

在 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元素还可以包含以下内部元素