Menggunakan teks

Untuk jam digital, Anda harus berupaya menggunakan DigitalClock jika memungkinkan. Untuk semua teks atau jam lain yang tidak dapat ditampilkan menggunakan DigitalClock, PartText adalah penampung untuk rendering berbasis teks.

Bergantung pada apakah Anda ingin menampilkan teks melingkar atau reguler, PartText harus berisi salah satu elemen Text atau TextCircular.

Menggunakan font dan font bitmap

Dengan menggunakan font kustom, tampilan jam Anda dapat tampil beda dengan gayanya sendiri.

Ada dua cara untuk menggunakan font kustom, baik dalam penampung TimeText maupun PartText.

  1. Tentukan family font kustom dalam elemen Font. Berbagai format umum didukung, yang harus ditempatkan di res/font

    Misalnya, menggunakan font Pacifico dari Google Fonts, dan menempatkan aset sebagai 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

  2. Atau, tentukan BitmapFont yang menyediakan gambar bitmap di res/drawable:

    <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

Perhatikan bagaimana urutan karakter dapat diberi perlakuan khusus. Misalnya, jika "12" akan ditampilkan dengan 1 dan 2 yang digabungkan, hal ini dapat dilakukan menggunakan elemen Word.

Untuk menggunakan font yang ditentukan:

<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

Efek teks

Format Tampilan Jam menyediakan beberapa efek teks yang dapat diterapkan, seperti OutGlow dan Shadow. Untuk menggunakannya, terapkan sebagai sub-elemen dari elemen Font:

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

Menggunakan template

Daripada teks statis, Anda mungkin perlu membuat teks dari sumber data atau ekspresi.

Elemen Template memungkinkan Anda melakukan hal ini:

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

Menggunakan resource

Jika teks statis Anda ditentukan dalam resource, seperti di res/values/strings.xml, teks tersebut dapat dirujuk sebagai berikut:

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

Hal ini juga memungkinkan Anda melokalkan tampilan jam menggunakan penentu kualitas resource yang berbeda.

Jarak pegangan

Bekerja dengan penspasian teks dalam XML bisa jadi sulit. Spasi ekstra di sekitar teks dapat menyebabkan masalah pemformatan, seperti penataan di tengah yang salah, atau mencegah aplikasi Anda menemukan resource string Android.

Untuk menghindari situasi ini, bungkus konten Font Anda dalam elemen CDATA:

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

Teks multibaris

Untuk membuat teks multiline, gunakan atribut maxLines pada Text:

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