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

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

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

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

ज़्यादा जानकारी के लिए, 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 का रंग बदला जा सकता है.

नीचे दी गई टेबल में, खाली डेटा के लिए Android घड़ी के विजेट के टाइप के बारे में बताया गया है Android घड़ी के संकेत वाले किसी भी स्लॉट के लिए भेजा जा सकता है. इन टाइप में कोई फ़ील्ड नहीं होता और इन्हें काम करने वाले टाइप की सूची में शामिल करने की ज़रूरत नहीं होती. इस तरह के डिवाइस से स्मार्टवॉच चालू होती है नीचे दी गई तीन स्थितियों में अंतर करने के लिए चेहरे:

  • कोई सोर्स नहीं चुना गया
  • उपयोगकर्ता ने "खाली" चुना है स्लॉट के लिए
  • सोर्स में भेजने के लिए कोई डेटा नहीं है

सोर्स, अपडेट के अनुरोधों के जवाब में TYPE_EMPTY नहीं भेज सकते. इसके बजाय, TYPE_NO_DATA भेजें.

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

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

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

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

TYPE_NO_DATA सिस्टम से तब भेजा जाता है, जब सोर्स से असल डेटा मिलने से पहले, सोर्स से जुड़ी किसी कॉम्प्लीकेशन को हटाने के लिए कॉम्प्लीकेशन चालू हो जाती है.

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

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

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

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

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

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