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

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

वॉच फ़ेस फ़ॉर्मैट का इस्तेमाल करना

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 लाइब्रेरी या Wearable Support Library का इस्तेमाल करती है, तो उपयोगकर्ताओं को इन डिवाइसों पर स्मार्टवॉच की होम स्क्रीन के विजेट में, सभी डेटा सोर्स का डेटा दिखता रहेगा:

  • Wear OS 4 या उससे पहले के वर्शन वाले डिवाइस.
  • वे डिवाइस जिन्हें Wear OS 5 पर ओटीए अपग्रेड मिलता है.

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

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