वॉच फ़ेस कॉम्प्लिकेशन, डेटा सोर्स से डेटा दिखाता है. वॉच फ़ेस फ़ॉर्मैट का इस्तेमाल करके, डेटा सोर्स चुने जा सकते हैं. इससे आपको डेटा मिल पाएगा. इससे आपकी स्मार्टवॉच की होम स्क्रीन पर, दिन के समय के अलावा अन्य जानकारी भी दिखती है. इसके लिए, डेटा पाने के लिए कोड की ज़रूरत नहीं होती.
Watch Face Format का इस्तेमाल करना
Complication एलिमेंट की मदद से, एक ही वॉच फ़ेस में ज़्यादा से ज़्यादा आठ विजेट तय किए जा सकते हैं. इस एलिमेंट की मदद से, यह भी तय किया जा सकता है कि वॉच फ़ेस पर हर विजेट कहां दिखेगा.
ज़्यादा जानकारी के लिए, GitHub पर WatchFaceFormat का सैंपल देखें.
टाइप और फ़ील्ड
यहां दी गई टेबल में, ComplicationData ऑब्जेक्ट के टाइप और फ़ील्ड के बारे में बताया गया है. अगर कोई वॉच फ़ेस, किसी ऐसे फ़ील्ड का अनुरोध करता है जो किसी कॉम्प्लिकेशन टाइप के लिए अमान्य है, तो फ़ील्ड के लिए डिफ़ॉल्ट वैल्यू दिखाई जाती है. उदाहरण के लिए, अगर कोई वॉच फ़ेस SHORT_TEXT टाइप में मौजूद LONG_TEXT फ़ील्ड को ऐक्सेस करने की कोशिश करता है, तो LONG_TEXT फ़ील्ड की डिफ़ॉल्ट वैल्यू, शून्य, दिखती है. ध्यान दें कि यह ज़रूरी नहीं है कि वैकल्पिक फ़ील्ड दिखाए जाएं.
| टाइप | ज़रूरी फ़ील्ड | वैकल्पिक फ़ील्ड | नोट |
|---|---|---|---|
SHORT_TEXT
|
छोटा टेक्स्ट |
आइकॉन बर्न-इन से बचाने वाला आइकॉन छोटा टाइटल कॉन्टेंट की जानकारी |
अगर आइकॉन या छोटा टाइटल या दोनों दिए गए हैं, तो सिर्फ़ एक आइकॉन या छोटा टाइटल दिखता है. |
MONOCHROMATIC_IMAGE
|
मोनोक्रोमैटिक इमेज |
बर्न-इन सुरक्षा का आइकॉन कॉन्टेंट का ब्यौरा |
इसका इस्तेमाल तब किया जाता है, जब टेक्स्ट की ज़रूरत नहीं होती. आइकॉन का रंग एक ही होना चाहिए. साथ ही, स्मार्टवॉच की होम स्क्रीन के हिसाब से इसका रंग बदल सकता है. |
RANGED_VALUE
|
वैल्यू कम से कम वैल्यू ज़्यादा से ज़्यादा वैल्यू |
मोनोक्रोमैटिक इमेज बर्न-इन से सुरक्षा देने वाला आइकॉन छोटा टेक्स्ट छोटा टाइटल कलर रैंप डाइनैमिक वैल्यू कॉन्टेंट का ब्यौरा |
अगर आपको अपना प्रोग्रेस बार बनाना है, तो
ComplicationDrawable क्लास से मिले प्रोग्रेस बार को छिपाने के लिए,
isRangedValueProgressHidden() तरीके का इस्तेमाल करें.
|
GOAL_PROGRESS
|
वैल्यू टारगेट वैल्यू |
मोनोक्रोमैटिक इमेज बर्न-इन से सुरक्षा देने वाला आइकॉन छोटा टेक्स्ट छोटा टाइटल कलर रैंप डाइनैमिक वैल्यू कॉन्टेंट का ब्यौरा |
GOAL_PROGRESS का इस्तेमाल, कदमों की संख्या जैसी चीज़ों के लिए किया जाता है. इसमें वैल्यू शून्य से शुरू होती है और इसे टारगेट वैल्यू से ज़्यादा होने की अनुमति होती है. |
LONG_TEXT
|
लंबा टेक्स्ट |
लंबा टाइटल मोनोक्रोमैटिक इमेज बर्न-इन प्रोटेक्शन आइकॉन छोटी इमेज कॉन्टेंट का ब्यौरा |
अगर लंबा टाइटल दिया गया है, तो उसे दिखाता है. |
SMALL_IMAGE
|
छोटी इमेज |
कॉन्टेंट का ब्यौरा |
छोटी इमेज, दो स्टाइल में से किसी एक में होती है: फ़ोटो स्टाइल या आइकॉन स्टाइल. फ़ोटो स्टाइल का मतलब है कि यह इमेज, तय की गई जगह के हिसाब से होनी चाहिए और इसे काटा जा सकता है. आइकॉन स्टाइल का मतलब है कि इसे काटा नहीं जा सकता और इसमें पैडिंग जोड़ी जा सकती है.
इमेज में बदलाव होने की वजह से, हो सकता है कि वह इमेज, बर्न-इन से सुरक्षा देने वाली सुविधा वाले डिवाइसों या कम बिट वाले ऐंबियंट मोड वाले डिवाइसों पर ऐंबियंट मोड में दिखाने के लिए सही न हो. बर्न-इन से सुरक्षा या लो-बिट ऐंबियंट मोड चालू होने पर, वॉच फ़ेस बर्न-इन से सुरक्षा वाली छोटी इमेज का इस्तेमाल कर सकता है, क्योंकि यह सुरक्षित होती है. ऐसा न करने पर, वॉच फ़ेस के लिए सही इमेज का पता लगाना मुश्किल हो जाता है. इसलिए, कोई इमेज नहीं दिखाई जाती.
|
LARGE_IMAGE
|
बड़ी इमेज |
कॉन्टेंट का ब्यौरा |
यह इमेज इतनी बड़ी होनी चाहिए कि स्मार्टवॉच की होम स्क्रीन पर पूरी तरह से दिख सके.
इमेज में बदलाव होने की वजह से, हो सकता है कि वह इमेज, बर्न-इन से सुरक्षा देने वाली सुविधा वाले डिवाइसों या कम बिट वाले ऐंबियंट मोड वाले डिवाइसों पर ऐंबियंट मोड में दिखाने के लिए सही न हो. वॉच फ़ेस के लिए यह तय करना मुश्किल होता है कि डिसप्ले के लिए कौनसी इमेज सही है. इसलिए, अगर बर्न-इन सुरक्षा या लो-बिट ऐम्बिएंट मोड चालू है, तो वॉच फ़ेस, ऐम्बिएंट मोड में कोई इमेज डिसप्ले नहीं करता.
|
WEIGHTED_ELEMENTS
|
एलिमेंट की सूची |
मोनोक्रोमैटिक इमेज बर्न-इन से बचाने वाला आइकॉन छोटा टेक्स्ट छोटा टाइटल कॉन्टेंट का ब्यौरा |
हर एलिमेंट में एक रंग और एक वज़न होता है. वज़न शून्य से ज़्यादा होना चाहिए. रेंडर किए जाने पर, एलिमेंट का साइज़ उसके महत्व के हिसाब से होना चाहिए. वज़न को किसी खास वैल्यू के हिसाब से जोड़ने की ज़रूरत नहीं होती. ध्यान दें कि स्मार्टवॉच की होम स्क्रीन को WEIGHTED_ELEMENTS का रंग बदलने की अनुमति है. |
नीचे दी गई टेबल में, खाली डेटा के लिए जटिलता के टाइप के बारे में बताया गया है. इस डेटा को किसी भी जटिलता वाले स्लॉट के लिए भेजा जा सकता है. इन टाइप में कोई फ़ील्ड नहीं होता और इन्हें काम करने वाले टाइप की सूची में शामिल करने की ज़रूरत नहीं होती. इन टाइप की मदद से, वॉच फ़ेस इन तीन मामलों में अंतर कर पाते हैं:
- कोई सोर्स नहीं चुना गया
- उपयोगकर्ता ने किसी स्लॉट के लिए "खाली" चुना है
- किसी सोर्स के पास भेजने के लिए कोई डेटा नहीं है
अपडेट के अनुरोधों के जवाब में, सोर्स TYPE_EMPTY नहीं भेज सकते. इसके बजाय, TYPE_NO_DATA भेजें.
| Android घड़ी के संकेत का टाइप | ब्यौरा |
|---|---|
TYPE_NOT_CONFIGURED
|
सिस्टम इस सूचना को तब भेजता है, जब कोई कॉम्प्लिकेशन चालू होता है, लेकिन उपयोगकर्ता ने कोई सोर्स नहीं चुना होता है और न ही कोई डिफ़ॉल्ट सोर्स सेट किया गया होता है.
सोर्स से नहीं भेजे जा सकते. |
TYPE_EMPTY
|
यह सिस्टम तब भेजता है, जब कोई कॉम्प्लिकेशन चालू होता है और उपयोगकर्ता किसी सोर्स के बजाय "खाली" विकल्प चुनता है. इसके अलावा, यह तब भी भेजा जाता है, जब वॉच फ़ेस कोई सोर्स नहीं चुनता है और इस कॉम्प्लिकेशन टाइप को डिफ़ॉल्ट के तौर पर चुनता है.
सोर्स से नहीं भेजे जा सकते. |
TYPE_NO_DATA
|
सिस्टम इस सूचना को तब भेजता है, जब सोर्स वाली कोई कॉम्प्लिकेशन सुविधा चालू होती है. ऐसा इसलिए किया जाता है, ताकि सोर्स से असल डेटा मिलने से पहले कॉम्प्लिकेशन को हटाया जा सके.
अगर सोर्स के पास भेजने के लिए कोई डेटा नहीं है, तो वे इस कुकी को भेज सकते हैं. |
कुछ डिवाइसों पर, वॉच फ़ेस और विजेट के लिए Watch Face Format का इस्तेमाल करना ज़रूरी है
अगर आपकी मौजूदा स्मार्टवॉच की होम स्क्रीन, Jetpack Watch Face library या Wearable Support Library का इस्तेमाल करती है, तो लोग इन डिवाइसों पर, स्मार्टवॉच की होम स्क्रीन के विजेट में सभी डेटा सोर्स से मिला डेटा देख सकते हैं:
- Wear OS 4 या इससे पहले के वर्शन पर काम करने वाले डिवाइस.
- ऐसे डिवाइस जिन्हें Wear OS 5 पर OTA अपग्रेड मिलता है.
इसके अलावा, अगर आपकी मौजूदा स्मार्टवॉच की होम स्क्रीन, Jetpack Watch Face लाइब्रेरी या Wearable Support Library का इस्तेमाल करती है और इनमें से किसी एक डिवाइस पर इंस्टॉल है, तो स्मार्टवॉच की होम स्क्रीन को अपडेट मिलते रहेंगे.
हालांकि, Wear OS 5 वाली नई स्मार्टवॉच पर, वॉच फ़ेस के लिए Watch Face Format का इस्तेमाल करना ज़रूरी है. इसलिए, हमारा सुझाव है कि आप वॉच फ़ेस फ़ॉर्मैट का इस्तेमाल करें.
आपके लिए सुझाव
- ध्यान दें: JavaScript बंद होने पर लिंक टेक्स्ट दिखता है
- Wear OS पर, वॉच फ़ेस के विजेट के लिए डेटा उपलब्ध कराना
- कॉम्प्लिकेशन
- DefaultProviderPolicy