स्मार्टवॉच की होम स्क्रीन

हर watchface.xml फ़ाइल का रूट एलिमेंट. इसमें उन एलिमेंट के बारे में जानकारी होती है जो Wear OS डिवाइसों पर, वॉच फ़ेस के इस्तेमाल को चुनते समय, वॉच फ़ेस की झलक में दिखने चाहिए.

Wear OS 4 में लॉन्च किया गया.

वाक्य-विन्यास

<WatchFace width="positive-integer" height="positive-integer"
           clipShape="NONE | CIRCLE | RECTANGLE" cornerRadiusX="float"
           cornerRadiusY="float">
  <!-- Only the required inner element is shown here. -->
  <Scene>
  </Scene>
</WatchFace>

विशेषताएं

WatchFace एलिमेंट में ये एट्रिब्यूट होने चाहिए:

width
वॉच फ़ेस के कॉम्पोनेंट जिस विज़ुअल स्क्रीन पर दिखाए जाते हैं उसकी चौड़ाई, पिक्सल में. आकार और जटिलताओं जैसे सभी चाइल्ड ज्यामितीय एलिमेंट का साइज़ और पोज़िशन, विज़ुअल स्क्रीन के साइज़ के हिसाब से सेट होती है. ध्यान दें कि विज़ुअल स्क्रीन का साइज़, Wear OS डिवाइस के डिसप्ले रिज़ॉल्यूशन से अलग हो सकता है.
height
वॉच की होम स्क्रीन के कॉम्पोनेंट को खींचने वाली विज़ुअल स्क्रीन की ऊंचाई, पिक्सल में. आकार और जटिलताओं जैसे सभी चाइल्ड ज्यामितीय एलिमेंट का साइज़ और पोज़िशन, विज़ुअल स्क्रीन के साइज़ के हिसाब से सेट होती है. ध्यान दें कि विज़ुअल स्क्रीन का साइज़, Wear OS डिवाइस के डिसप्ले रिज़ॉल्यूशन से अलग हो सकता है.

WatchFace एलिमेंट में ये एट्रिब्यूट भी शामिल हो सकते हैं:

clipShape

स्मार्टवॉच की होम स्क्रीन की झलक दिखाने के लिए, विज़ुअल स्क्रीन का आकार. अगर CIRCLE की वैल्यू का इस्तेमाल किया जाता है, तो हो सकता है कि कोनों के आस-पास मौजूद एलिमेंट का कुछ हिस्सा दिखे.

डिफ़ॉल्ट वैल्यू CIRCLE है.

cornerRadiusX

किसी दीर्घवृत्त के हॉरिज़ॉन्टल ऐक्सिस के आधे हिस्से की लंबाई, जिससे गोल कोने बनते हैं. राउंड-रेक्टैंगल इफ़ेक्ट बनाने के लिए, cornerRadiusY के साथ इस वैल्यू का इस्तेमाल करें.

इस वैल्यू का कोई असर तब तक नहीं पड़ता, जब तक RECTANGLE के लिए clipShape की वैल्यू नहीं दी जाती.

cornerRadiusY

दीर्घवृत्त के वर्टिकल ऐक्सिस के आधे हिस्से की लंबाई, जिससे किनारों पर गोल आकार बनता है. राउंड-रेक्टैंगल वाला इफ़ेक्ट बनाने के लिए, cornerRadiusY के साथ इस वैल्यू का इस्तेमाल करें.

इस वैल्यू का कोई असर तब तक नहीं पड़ता, जब तक RECTANGLE के लिए clipShape की वैल्यू नहीं दी जाती.

इनर एलिमेंट

WatchFace एलिमेंट में कम से कम एक Scene इनर एलिमेंट होना चाहिए.

WatchFace एलिमेंट में ये इनर एलिमेंट भी शामिल हो सकते हैं: