시계 모드에 정보 표시 추가

시계 화면의 정보 표시는 데이터 소스의 데이터를 표시합니다. 워치 페이스 형식을 사용하여 기본 데이터를 가져올 데이터 소스를 선택할 수 있습니다. 이렇게 하면 시계 화면에서 데이터를 가져오기 위한 코드가 없어도 그날의 시간뿐만 아니라 다른 정보도 표시할 수 있습니다.

워치 페이스 형식 사용

Complication 요소를 사용하면 단일 시계 화면 내에 최대 8개의 정보 표시를 정의할 수 있습니다. 또한 이 요소를 사용하여 시계 화면에서 각 정보 표시가 표시되는 위치를 정의할 수 있습니다.

자세한 내용은 GitHub의 WatchFaceFormat 샘플을 확인하세요.

유형 및 필드

다음 표는 ComplicationData 객체의 유형과 필드를 설명합니다. 정보 표시 유형에 맞지 않는 잘못된 필드를 시계 화면이 요청하는 경우, 해당 필드의 기본값이 반환됩니다. 예를 들어, 시계 화면이 SHORT_TEXT 유형의 LONG_TEXT 필드에 액세스를 시도하는 경우, LONG_TEXT 필드의 기본값(null)이 반환됩니다. 선택적 필드는 반드시 표시되는 것은 아닙니다.





유형 필수 입력란 선택적 필드 메모
SHORT_TEXT Short text Icon
Burn-in protection icon
Short title
Content description

 둘 중 하나 또는 둘 다 제공된 경우 아이콘 또는 짧은 제목 하나만 표시합니다.
MONOCHROMATIC_IMAGE Monochromatic image
 Burn-in protection icon
Content description

 텍스트가 불필요할 때 사용됩니다. 아이콘은 단색으로 예상되며, 시계 화면에서 색조가 조정될 수도 있습니다.
RANGED_VALUE Value
Min value
Max value
 Monochromatic image
Burn-in protection icon
Short text
Short title
Color ramp
Dynamic value
Content description

 직접 진행률 표시줄을 그리고 싶다면, isRangedValueProgressHidden() 메서드를 사용하여 ComplicationDrawable 클래스가 제공하는 진행률 표시줄을 숨길 수 있습니다.
GOAL_PROGRESS Value
Target value
 Monochromatic image
Burn-in protection icon
Short text
Short title
Color ramp
Dynamic value
Content description

 GOAL_PROGRESS는 값이 0에서 시작하고 타겟 값을 초과할 수 있는 걸음 수와 같은 항목을 위한 것입니다.
LONG_TEXT Long text
 Long title
Monochromatic image
Burn-in protection icon
Small image
Content description
 제공된 경우 긴 제목을 표시합니다.
SMALL_IMAGE Small image
 Content description
 Small image에는 사진 스타일 또는 아이콘 스타일의 두 스타일 중 하나가 있습니다. 사진 스타일은 공간을 채울 것으로 예상되며 자를 수 있습니다. 아이콘 스타일은 잘라낼 수 없으며 패딩을 적용할 수 있습니다. 이미지 가변성으로 인해 대기 모드에서 번인 보호 모드나 낮은 비트 대기 모드의 기기에 표시하기에 이미지가 부적합할 수 있습니다. 번인 보호 모드나 낮은 비트 대기 모드가 사용 설정된 경우 시계 화면이 안전한 Burn-in protection small image를 사용할 수도 있습니다. 그 외 경우에는 시계 화면이 적합성을 판별하기가 어려우므로 이미지가 표시되지 않습니다.
LARGE_IMAGE Large image
 Content description
 이 이미지는 시계 화면을 채울 정도로 충분히 클 것으로 예상됩니다. 이미지 가변성으로 인해 대기 모드에서 번인 보호 모드나 낮은 비트 대기 모드의 기기에 표시하기에 이미지가 부적합할 수 있습니다. 시계 화면이 표시 적합성을 판별하기가 어렵기 때문에, 대기 모드에서 번인 보호 모드나 낮은 비트 대기 모드가 활성화된 경우에는 시계 화면이 이미지를 표시하지 않습니다.
WEIGHTED_ELEMENTS Elements list
 Monochromatic image
Burn-in protection icon
Short text
Short title
Content description
 각 요소는 색상과 (0보다 큰) 두께로 구성됩니다. 렌더링 시 요소의 크기는 가중치에 비례합니다. 값을 합산하는 데는 가중치가 필요하지 않습니다. 시계 화면에서 WEIGHTED_ELEMENTS의 색상을 다시 지정할 수 있습니다.

다음 표에서는 모든 정보 표시 자리에 관해 전송할 수 있는 빈 데이터의 정보 표시 유형을 설명합니다. 이러한 유형에는 필드가 없으며 지원되는 유형 목록에 포함될 필요가 없습니다. 이들 유형을 통해 시계 화면에서 다음의 세 가지 경우를 구분할 수 있습니다.

  • 선택한 소스가 없음
  • 사용자가 자리에 대해 'empty'를 선택했음
  • 소스가 전송할 데이터가 없음

소스는 업데이트 요청에 대한 응답으로 TYPE_EMPTY를 전송할 수 없습니다. 대신 TYPE_NO_DATA를 전송하세요.

정보 표시 유형 설명
TYPE_NOT_CONFIGURED 정보 표시가 활성화되었지만 사용자가 소스를 선택하지 않았고 기본값이 설정되지 않은 경우 시스템에 의해 전송됩니다.

소스에서 전송할 수 없습니다.

TYPE_EMPTY 정보 표시가 활성화되었고 사용자가 소스 대신 'empty'를 선택한 경우 또는 시계 화면이 소스를 선택하지 않고 이 정보 표시 유형을 기본값으로 선택한 경우 시스템에 의해 전송됩니다.

소스에서 전송할 수 없습니다.

TYPE_NO_DATA 소스를 가진 정보 표시가 활성화된 경우, 실제 데이터가 소스로부터 수신되기 전에 정보 표시를 지우기 위해 시스템에 의해 전송됩니다.

전송할 실제 데이터가 없는 경우 소스에 의해 전송될 수 있습니다.

일부 기기에서는 시계 화면과 정보 표시가 워치 페이스 형식을 사용해야 합니다.

기존 시계 화면에서 Jetpack 워치 페이스 라이브러리 또는 웨어러블 지원 라이브러리를 사용하는 경우 사용자는 다음 기기에서 시계 화면 정보 표시의 모든 데이터 소스 데이터를 계속 볼 수 있습니다.

  • Wear OS 4 이하를 실행하는 기기
  • Wear OS 5로 OTA 업그레이드를 수신하는 기기

또한 기존 시계 화면이 Jetpack 시계 화면 라이브러리 또는 웨어러블 지원 라이브러리를 활용하고 이러한 기기 중 하나에 설치된 경우 시계 화면은 계속 업데이트를 받을 수 있습니다.

하지만 Wear OS 5와 함께 출시된 새 시계의 경우 시계 화면이 워치 페이스 형식을 사용해야 합니다. 따라서 워치 페이스 형식을 사용하는 것으로 이전하는 것이 좋습니다.