टेक्स्ट के साथ काम करना

डिजिटल घड़ियों के लिए, जहां भी हो सके वहां 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
```

इसके अलावा, BitmapFont को 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

ध्यान दें कि वर्णों के क्रम को किस तरह खास तरीके से दिखाया जा सकता है. उदाहरण के लिए, अगर "12" को एक साथ जुड़े हुए 1 और 2 के तौर पर दिखाना है, तो इसके लिए 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

इससे अलग-अलग संसाधन क्वालिफ़ायर का इस्तेमाल करके, स्मार्टवॉच की होम स्क्रीन को स्थानीय भाषा में भी दिखाया जा सकता है.

हैंडल के बीच की दूरी

एक्सएमएल में टेक्स्ट के बीच की दूरी को मैनेज करना मुश्किल हो सकता है. टेक्स्ट के आस-पास ज़्यादा जगह होने से, फ़ॉर्मैटिंग से जुड़ी समस्याएं हो सकती हैं. जैसे, टेक्स्ट का सही तरीके से सेंटर में न होना. इसके अलावा, इससे आपका ऐप्लिकेशन, 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