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