विजेट, ऐसी सुविधा होती है जो स्मार्टवॉच की होम स्क्रीन पर समय के साथ-साथ दिखती है. उदाहरण के लिए, बैटरी की जानकारी देने वाला संकेत एक जटिल जानकारी है. Complications API, स्मार्टवॉच की होम स्क्रीन और डेटा सोर्स ऐप्लिकेशन, दोनों के लिए है.
इस दस्तावेज़ के बाकी हिस्से में, डेटा सोर्स, स्मार्टवॉच की होम स्क्रीन, और जटिल जानकारी दिखाने वाले विजेट के टाइप के बारे में बताया गया है.
विजेट के लिए डेटा सोर्स
स्मार्टवॉच की होम स्क्रीन पर मौजूद कॉम्प्लीकेशन के लिए, बैटरी लेवल, मौसम या कदमों की संख्या जैसे डेटा उपलब्ध कराने वाले ऐप्लिकेशन को कॉम्प्लीकेशन डेटा सोर्स कहा जाता है. ये डेटा सोर्स, रॉ डेटा देते हैं. साथ ही, स्मार्टवॉच की होम स्क्रीन पर उनके डेटा को रेंडर करने के तरीके को कंट्रोल करने की ज़िम्मेदारी इनकी नहीं होती. स्मार्टवॉच की होम स्क्रीन को डेटा उपलब्ध कराने वाले ऐप्लिकेशन लिखने के बारे में जानने के लिए, Android घड़ी के विजेट के लिए डेटा दिखाएं देखें.
इस डायग्राम में दिखाया गया है कि Wear OS by Google, सोर्स से स्मार्टवॉच की होम स्क्रीन पर डेटा को कैसे भेजता है.
स्मार्टवॉच की होम स्क्रीन पर विजेट
वॉच फ़ेस को जटिलता वाले डेटा सोर्स से डेटा मिलता है. इससे, उन्हें डेटा पाने के लिए कोड की ज़रूरत के बिना, जटिलताएं शामिल करने में मदद मिलती है. स्मार्टवॉच की स्क्रीन पर दिखने वाली होम स्क्रीन पर, डेटा को रेंडर करने का तरीका कंट्रोल करने का विकल्प होता है. इससे, होम स्क्रीन के डिज़ाइन के साथ डेटा को आसानी से इंटिग्रेट किया जा सकता है. ज़्यादा जानकारी के लिए, Android घड़ी के विजेट के डिज़ाइन गाइड देखें.
स्मार्टवॉच की होम स्क्रीन पर विजेट जोड़ने का तरीका जानने के लिए, स्मार्टवॉच की होम स्क्रीन पर विजेट जोड़ना लेख पढ़ें.
Android स्मार्टवॉच के विजेट के टाइप
Android घड़ी के विजेट से यह तय होता है कि किसी Android घड़ी के विजेट में किस तरह का डेटा दिखाया जा सकता है या डेटा सोर्स से किस तरह का डेटा दिया जा सकता है. उदाहरण के लिए, SHORT_TEXT टाइप का इस्तेमाल तब करें, जब डेटा में मुख्य रूप से छोटी स्ट्रिंग हो.
ComplicationData ऑब्जेक्ट में हमेशा एक ही तरह का विजेट होता है. इससे ज़रूरी और वैकल्पिक फ़ील्ड के बारे में पता चलता है. ज़रूरी फ़ील्ड, डेटा के मुख्य हिस्से को दिखाता है. ज़्यादातर टाइप, ज़रूरी फ़ील्ड से अपना नाम लेते हैं.
डेटा सोर्स, Android स्मार्टवॉच की होम स्क्रीन से अलग तरह के विजेट का इस्तेमाल करते हैं:
- डेटा सोर्स यह चुनता है कि Android 'Android के लिए मुश्किलों से जुड़ा डेटा' किस तरह का है.
इसमें यह भी शामिल है कि इनमें से कौनसे फ़ील्ड को देना है और
कितने अलग-अलग तरह के डेटा को इस्तेमाल किया जा सकता है. उदाहरण के लिए,
RANGED_VALUEऔरSHORT_TEXTटाइप के सोर्स से, कदमों की संख्या का डेटा मिल सकता है. साथ ही, अगली मीटिंग का डेटाSHORT_TEXTऔरLONG_TEXTटाइप के सोर्स से मिल सकता है. - आपके पास यह चुनने का विकल्प होता है कि वॉच फ़ेस पर कितने विजेट जोड़ने हैं और कौनसे विजेट जोड़ने हैं. उदाहरण के लिए, हो सकता है कि स्मार्ट वॉच की होम स्क्रीन पर डायल के तौर पर मौजूद कोई कॉम्प्लीकेशन,
SHORT_TEXT,ICON, औरRANGED_VALUEटाइप के साथ काम करे. हो सकता है कि स्मार्टवॉच की होम स्क्रीन पर मौजूद गेज में सिर्फ़RANGED_VALUEटाइप का डेटा दिखे.
अलग-अलग तरह के कॉम्प्लीकेशन और हर तरह के कॉम्प्लीकेशन के साथ काम करने वाले फ़ील्ड के बारे में ज़्यादा जानने के लिए, कॉम्प्लीकेशन के टाइप देखें.