स्मार्टवॉच की होम स्क्रीन पर Android घड़ी के विजेट जोड़ें

description: इस दस्तावेज़ में, Watch Face Format का इस्तेमाल करके, Wear OS में स्मार्टवॉच की होम स्क्रीन पर विजेट जोड़ने और उन्हें कॉन्फ़िगर करने का तरीका बताया गया है. इसमें, उपलब्ध विजेट के टाइप और उनके फ़ील्ड के बारे में भी जानकारी दी गई है. keywords_public: Android,Wear OS,watch faces,complications,Watch Face Format,ComplicationData,data sources

स्मार्टवॉच की होम स्क्रीन पर दिखने वाला विजेट, डेटा सोर्स से डेटा दिखाता है. Watch Face Format का इस्तेमाल करके, डेटा सोर्स चुने जा सकते हैं, ताकि उनसे जुड़ा डेटा पाया जा सके. इससे, आपकी स्मार्टवॉच की होम स्क्रीन पर, दिन के समय के अलावा अन्य जानकारी भी दिखती है. इसके लिए, डेटा पाने से जुड़ा कोड लिखने की ज़रूरत नहीं होती.

Watch Face Format का इस्तेमाल करना

The Complication एलिमेंट की मदद से, स्मार्टवॉच की एक होम स्क्रीन पर आठ विजेट तय किए जा सकते हैं. इस एलिमेंट की मदद से, यह भी तय किया जा सकता है कि स्मार्टवॉच की होम स्क्रीन पर हर विजेट कहां दिखेगा.

ज़्यादा जानकारी के लिए, GitHub पर WatchFaceFormat का सैंपल देखें.

टाइप और फ़ील्ड

यहां दी गई टेबल में, ComplicationData ऑब्जेक्ट के टाइप और फ़ील्ड के बारे में बताया गया है. अगर स्मार्टवॉच की होम स्क्रीन, किसी ऐसे फ़ील्ड का अनुरोध करती है जो विजेट के टाइप के लिए मान्य नहीं है, तो उस फ़ील्ड के लिए डिफ़ॉल्ट वैल्यू दिखाई जाती है. उदाहरण के लिए, अगर स्मार्टवॉच की होम स्क्रीन, SHORT_TEXT टाइप में LONG_TEXT फ़ील्ड को ऐक्सेस करने की कोशिश करती है, तो LONG_TEXT फ़ील्ड के लिए डिफ़ॉल्ट वैल्यू, null दिखाई जाती है. ध्यान दें कि ज़रूरी नहीं है कि वैकल्पिक फ़ील्ड दिखें.





टाइप ज़रूरी फ़ील्ड वैकल्पिक फ़ील्ड नोट
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 भेजें.

विजेट का टाइप जानकारी
TYPE_NOT_CONFIGURED जब कोई विजेट चालू होता है, लेकिन उपयोगकर्ता ने कोई सोर्स नहीं चुना होता और कोई डिफ़ॉल्ट सोर्स सेट नहीं किया गया होता, तब सिस्टम इसे भेजता है.

सोर्स इसे नहीं भेज सकते.

TYPE_EMPTY जब कोई विजेट चालू होता है और उपयोगकर्ता किसी सोर्स के बजाय "खाली" चुनता है या जब स्मार्टवॉच की होम स्क्रीन कोई सोर्स नहीं चुनती और इस विजेट के टाइप को डिफ़ॉल्ट के तौर पर चुनती है, तब सिस्टम इसे भेजता है.

सोर्स इसे नहीं भेज सकते.

TYPE_NO_DATA जब कोई ऐसा विजेट चालू होता है जिसका कोई सोर्स होता है तब सिस्टम इसे भेजता है, ताकि सोर्स से असली डेटा मिलने से पहले विजेट को साफ़ किया जा सके

अगर सोर्स के पास भेजने के लिए कोई असली डेटा नहीं है, तो वे इसे भेज सकते हैं.

कुछ डिवाइसों पर, स्मार्टवॉच की होम स्क्रीन और विजेट के लिए Watch Face Format का इस्तेमाल करना ज़रूरी है

अगर आपकी मौजूदा स्मार्टवॉच की होम स्क्रीन, Jetpack Watch Face लाइब्रेरी या Wearable Support Library का इस्तेमाल करती है, तो उपयोगकर्ता को इन डिवाइसों पर, स्मार्टवॉच की होम स्क्रीन के विजेट में सभी डेटा सोर्स का डेटा दिखता रहेगा:

  • Wear OS 4 या उससे पहले के वर्शन पर चलने वाले डिवाइस.
  • Wear OS 5 पर OTA अपग्रेड पाने वाले डिवाइस.

इसके अलावा, अगर आपकी मौजूदा स्मार्टवॉच की होम स्क्रीन, Jetpack Watch Face लाइब्रेरी या Wearable Support Library का इस्तेमाल करती है और वह इनमें से किसी डिवाइस पर इंस्टॉल है, तो स्मार्टवॉच की होम स्क्रीन को अपडेट मिलते रहेंगे.

हालांकि, Wear OS 5 वाली नई स्मार्टवॉच पर, स्मार्टवॉच की होम स्क्रीन के लिए Watch Face Format का इस्तेमाल करना ज़रूरी है. इसलिए, हमारा सुझाव है कि आप Watch Face Format का इस्तेमाल करें.