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

선택사항 속성

다음 속성은 선택사항입니다.

pivotY pivotX
2차원 피벗 지점으로, 이 지점을 중심으로 요소가 회전합니다. 두 값 모두 $ [0, 1] $ 범위에 들어맞게 조정되는 부동 소수점 수입니다.
angle
요소가 피벗 지점을 중심으로 시계 방향으로 회전할 각도입니다.
alpha
이 요소에 필요한 투명도 수준을 설정합니다. 값 0은 요소가 완전히 투명해야 함을 나타냅니다. 값 255는 요소가 완전히 불투명해야 함을 나타냅니다.
scaleX
이 요소에 적용할 가로 배율입니다.
scaleY
이 요소에 적용할 세로 배율입니다.
tintColor
요소에 색조 색상 필터를 적용합니다. ARGB 형식(#ff000000 = 불투명한 검은색) 또는 RGB 형식(#000000 = 검은색)을 사용하여 색상을 지정해야 합니다.
displayName
정보 표시 자리의 현지화된 이름에 해당하는 리소스 ID로, 시계 화면 편집기에 표시됩니다.
isCustomizable
사용자가 시계 화면 편집기에서 이 정보 표시 자리의 제공자를 변경할 수 있는지 여부를 지정합니다. 기본값은 TRUE입니다.

내부 요소

ComplicationSlot 요소는 정확히 하나의 경계 영역 요소를 포함해야 합니다.

ComplicationSlot 요소는 지원되는 정보 표시 유형당 하나 이상의 Complication 요소를 포함해야 합니다. ComplicationSlot 요소에는 Variant 요소를 사용한 모양 변경을 지원할 수 있도록, 선택적으로 더 많은 Complication 요소를 포함할 수 있습니다.

ComplicationSlot 요소는 다음과 같은 내부 요소도 포함할 수 있습니다.