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