WatchFace

모든 watchface.xml 파일의 루트 요소입니다. 여기에는 사용자가 Wear OS 기기에서 사용할 시계 화면을 선택했을 때 시계 화면 미리보기에 나타나야 하는 요소에 관한 정보가 포함되어 있습니다.

Wear OS 4에서 도입되었습니다.

문법

<WatchFace width="positive-integer" height="positive-integer"
           clipShape="NONE | CIRCLE | RECTANGLE" cornerRadiusX="float"
           cornerRadiusY="float">
  <!-- Only the required inner element is shown here. -->
  <Scene>
  </Scene>
</WatchFace>

속성

WatchFace 요소는 다음 속성을 포함해야 합니다.

width

시계 화면 구성요소가 그려지는 시각적 화면의 너비입니다(단위: 픽셀). 모든 하위 도형 요소(예: 도형 및 정보 표시)는 시각적 화면 크기를 기준으로 크기와 위치가 설정됩니다. 시각적 화면은 실제 Wear OS 기기의 디스플레이 해상도와 다른 크기일 수 있습니다.

height

시계 화면 구성요소가 그려지는 시각적 화면의 높이입니다(단위: 픽셀). 모든 하위 도형 요소(예: 도형 및 정보 표시)는 시각적 화면 크기를 기준으로 크기와 위치가 설정됩니다. 시각적 화면은 실제 Wear OS 기기의 디스플레이 해상도와 다른 크기일 수 있습니다.

WatchFace 요소는 다음 속성도 포함할 수 있습니다.

clipShape

시계 화면 미리보기에 사용할 시각적 화면의 모양입니다. CIRCLE 값을 사용하면 모서리 근처의 요소가 부분적으로 잘릴 수 있습니다.

기본값은 CIRCLE입니다.

cornerRadiusX

둥근 모서리를 만드는 타원 가로축 길이의 절반입니다. 이 값을 cornerRadiusY와 함께 사용하면 둥근 직사각형 효과가 만들어집니다.

이 값은 RECTANGLE의 clipShape를 지정하지 않으면 아무런 효과가 없습니다.

cornerRadiusY

둥근 모서리를 만드는 타원 세로축 길이의 절반입니다. 이 값을 cornerRadiusY와 함께 사용하면 둥근 직사각형 효과가 만들어집니다.

이 값은 RECTANGLE의 clipShape를 지정하지 않으면 아무런 효과가 없습니다.

내부 요소

WatchFace 요소는 하나 이상의 Scene 내부 요소를 포함해야 합니다.

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

• BitmapFonts
• Metadata
• UserConfigurations