텍스트 사용

디지털 시계의 경우 가능한 경우 DigitalClock를 사용하는 것이 좋습니다. DigitalClock를 사용하여 나타낼 수 없는 다른 모든 텍스트 또는 시계의 경우 PartText은 텍스트 기반 렌더링을 위한 컨테이너입니다.

원형 텍스트를 표시할지 일반 텍스트를 표시할지에 따라 PartText에는 Text 또는 TextCircular 요소가 하나 포함되어야 합니다.

글꼴 및 비트맵 글꼴 사용

맞춤 글꼴을 사용하면 시계 화면이 고유한 스타일로 돋보일 수 있습니다.

TimeText 및 PartText 컨테이너 내에서 맞춤 글꼴을 사용하는 방법에는 두 가지가 있습니다.

Font 요소에서 맞춤 글꼴 family을 지정합니다. 일반적인 형식의 범위가 지원되며 res/font에 배치해야 합니다.

예를 들어 Google Fonts의 Pacifico 글꼴을 사용하고 애셋을 res/font/pacifico.ttf로 배치합니다.
```
<PartText x="0" y="50" width="450" height="250">
    <Text align="CENTER">
        <Font family="pacifico" size="96">Hello!</Font>
    </Text>
</PartText>watchface_text.xml
```

또는 res/drawable에서 비트맵 이미지를 제공하는 BitmapFont를 정의합니다.

<BitmapFonts>
    <BitmapFont name="myhandwriting">
        <Character name="1" resource="digit1" width="50" height="100" />
        <Character name="2" resource="digit2" width="50" height="100" />
        <Character name="3" resource="digit3" width="50" height="100" />
        <Character name="4" resource="digit4" width="50" height="100" />
        <!-- ... -->
        <!-- Treat "12" specially, instead of a 1 followed by a 2-->
        <Word name="12" resource="digit12" width="80" height="100" />
    </BitmapFont>
</BitmapFonts>watchface_text.xml

문자 시퀀스가 특별한 처리를 받을 수 있는 방법을 참고하세요. 예를 들어 1과 2를 결합하여 '12'를 표현하려면 Word 요소를 사용하면 됩니다.

정의된 글꼴을 사용하려면 다음 단계를 따르세요.

<DigitalClock x="125" y="120" width="200" height="50">
    <TimeText x="0" y="0" width="200" height="50" format="hh:mm">
        <BitmapFont family="myhandwriting" size="48" color="#FF00FF"/>
    </TimeText>
</DigitalClock>watchface_text.xml

텍스트 효과

워치 페이스 형식은 OutGlow, Shadow과 같은 적용 가능한 여러 텍스트 효과를 제공합니다. 이를 사용하려면 Font 요소의 하위 요소로 적용하세요.

<Font family="pacifico" size="96" color="#e2a0ff">
    <OutGlow color="#e8ffb7" radius="30">Hello!</OutGlow>
</Font>watchface_text.xml

템플릿 작업

정적 텍스트 대신 데이터 소스나 표현식에서 텍스트를 구성해야 할 수 있습니다.

Template 요소를 사용하면 다음 작업을 할 수 있습니다.

<Font family="pacifico" size="60" weight="BOLD" color="#ffffff">
    <Template>Day: %s<Parameter expression="[DAY_OF_WEEK_S]" /></Template>
</Font>watchface_text.xml

리소스 사용하기

정적 텍스트가 res/values/strings.xml와 같은 리소스에 정의된 경우 다음과 같이 참조할 수 있습니다.

<!-- greeting defined in res/values/strings.xml -->
<Font family="pacifico" size="60" weight="BOLD" color="#ffffff">greeting</Font>watchface_text.xml

또한 다양한 리소스 한정자를 사용하여 워치 페이스를 현지화할 수 있습니다.

핸들 간격

XML에서 텍스트 간격을 사용하는 것은 어려울 수 있습니다. 텍스트 주변의 추가 간격으로 인해 잘못된 가운데 정렬과 같은 서식 문제가 발생하거나 앱에서 Android 문자열 리소스를 찾지 못할 수 있습니다.

이러한 상황을 방지하려면 Font 콘텐츠를 CDATA 요소로 래핑하세요.

<Font family="pacifico" size="60" weight="BOLD" color="#ffffff">
    <![CDATA[Hello]]>
</Font>watchface_text.xml

여러 줄 텍스트

여러 줄 텍스트를 만들려면 Text에서 maxLines 속성을 사용합니다.

<Text align="CENTER" maxLines="2">
    <Font family="pacifico" size="60" weight="BOLD" color="#ffffff">
        <![CDATA[Hello Wear OS world]]>
    </Font>
</Text>watchface_text.xml

텍스트 사용 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.