시계 화면에 정보 표시 추가

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

ComplicationSlotsManager 사용

정보 표시를 시계 화면에 추가하려면 ComplicationSlotsManager를 사용합니다.

ComplicationSlotsManager는 시계 화면에서 지원하는 정보 표시 수와 정보 표시의 화면상 위치를 정의합니다. 정보 표시의 위치나 개수 변경을 지원하기 위해 ComplicationSlotsManager는 다음 예에서와 같이 CurrentUserStyleRepository도 사용합니다.

 override fun createComplicationSlotsManager(
        currentUserStyleRepository: CurrentUserStyleRepository
    ): ComplicationSlotsManager {
        val defaultCanvasComplicationFactory =
            CanvasComplicationFactory { watchState, listener ->
                // ...
            }

        val leftComplicationSlot = ComplicationSlot.createRoundRectComplicationSlotBuilder(
            id = 100,
            canvasComplicationFactory = defaultCanvasComplicationFactory,
            // ...
        )
            .setDefaultDataSourceType(ComplicationType.SHORT_TEXT)
            .build()

        val rightComplicationSlot = ComplicationSlot.createRoundRectComplicationSlotBuilder(
            id = 101,
            canvasComplicationFactory = defaultCanvasComplicationFactory,
            // ...
        )
            .setDefaultDataSourceType(ComplicationType.SHORT_TEXT)
            .build()

        return ComplicationSlotsManager(
            listOf(leftComplicationSlot, rightComplicationSlot),
            currentUserStyleRepository
        )
 }

유형 및 필드

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

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

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

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

자세한 내용은 GitHub의 시계 화면 샘플을 확인하세요.