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

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

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

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

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

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

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





टाइप ज़रूरी फ़ील्ड वैकल्पिक फ़ील्ड नोट
SHORT_TEXT संक्षिप्त लेख आइकॉन
बर्न-इन सुरक्षा का आइकॉन
छोटा टाइटल
कॉन्टेंट का ब्यौरा

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

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है 		इसका इस्तेमाल तब किया जाता है जब टेक्स्ट की ज़रूरत न हो. आइकन एक ही रंग का होना चाहिए और वॉच की होम स्क्रीन पर रंग किया गया हो.
RANGED_VALUE वैल्यू
कम से कम मान
अधिकतम मान
 मोनोक्रोमैटिक इमेज
बर्न-इन सुरक्षा का आइकॉन
संक्षिप्त लेख
छोटा टाइटल
कलर रैंप
डाइनैमिक वैल्यू
कॉन्टेंट का ब्यौरा

अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है 		अगर आपको अपना प्रोग्रेस बार बनाना है, तो प्रोग्रेस बार छिपाने का isRangedValueProgressHidden() तरीका कंपनी ComplicationDrawable क्लास.
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 Android घड़ी के संकेत के चालू होने पर, सिस्टम यह सूचना भेजता है. इससे उपयोगकर्ता को यह सूचना मिलती है "खाली" चुनता है सोर्स के बजाय या वॉच की होम स्क्रीन पर कोई सोर्स नहीं चुनता और Android स्मार्टवॉच के विजेट को डिफ़ॉल्ट के तौर पर चुनता है.

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

TYPE_NO_DATA सिस्टम से तब भेजा जाता है, जब किसी Android घड़ी के विजेट के साथ सोर्स मौजूद होता है असल डेटा मिलने से पहले, Android स्मार्टवॉच की स्क्रीन पर विजेट को बंद किया जाता है को स्रोत से निकालता है.

ऐसे सोर्स से भेजा जा सकता है जिनके पास भेजने के लिए कोई असल डेटा न हो.

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

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

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

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

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