कॉम्प्लीकेशन स्लॉट, वॉच फ़ेस का वह हिस्सा होता है जिसमें उपयोगकर्ता, कॉम्प्लीकेशन जोड़ सकता है. कॉम्प्लीकेशन स्लॉट में कॉम्प्लीकेशन एलिमेंट होते हैं. इनसे यह तय होता है कि कॉम्प्लीकेशन, अलग-अलग कॉम्प्लीकेशन टाइप और स्मार्टवॉच की होम स्क्रीन के अलग-अलग मोड में कैसे रेंडर की जाती है.
Wear OS 4 में लॉन्च किया गया.
वाक्य-विन्यास
<ComplicationSlot x="integer" y="integer" width="integer" height="integer" pivotX="float" pivotY="float" angle="float-degrees" alpha="integer" slotId="integer" name="string" displayName="string" scaleX="float" scaleY="float" supportedTypes="string" isCustomizable="boolean" tintColor="argb-color | rgb-color" />
विशेषताएं
ComplicationSlot में ये एट्रिब्यूट होते हैं:
ज़रूरी एट्रिब्यूट
यहां दिए गए एट्रिब्यूट ज़रूरी हैं:
x,y,width,height- इंटेजर का कलेक्शन, जो एलिमेंट के साइज़ और पोज़िशन की जानकारी देता है.
slotId- स्लॉट के लिए यूनीक अंकों वाला आइडेंटिफ़ायर.
supportedTypes- स्लॉट में जानकारी भरने के लिए, ऐसे कॉम्प्लीकेशन टाइप की सूची जिनका इस्तेमाल किया जा सकता है.
SHORT_TEXT,LONG_TEXT,MONOCHROMATIC_IMAGE,SMALL_IMAGE,PHOTO_IMAGE,RANGED_VALUE, औरEMPTYजैसी वैल्यू इस्तेमाल की जा सकती हैं. एक से ज़्यादा तरह की complication इस्तेमाल करने के लिए, उन्हें स्पेस से अलग करें. उदाहरण के लिए,SHORT_TEXT RANGED_VALUE.
ऐसे एट्रिब्यूट जो ज़रूरी नहीं हैं
यहां दिए गए एट्रिब्यूट की वैल्यू देना ज़रूरी नहीं है:
pivotX,pivotY- दो डाइमेंशन वाला पिवट पॉइंट, जिसके चारों ओर एलिमेंट घूमता है. दोनों वैल्यू, फ़्लोटिंग-पॉइंट नंबर होती हैं. इन्हें स्केल करके, $ [0, 1] $ की रेंज में फ़िट किया जाता है.
angle- घड़ी की दिशा में, एलिमेंट को पिवट पॉइंट के आस-पास घुमाने के लिए डिग्री की संख्या.
alpha- इस एलिमेंट के लिए पारदर्शिता का लेवल सेट करें.
0की वैल्यू से पता चलता है कि एलिमेंट पूरी तरह से पारदर्शी होना चाहिए.255की वैल्यू से पता चलता है कि एलिमेंट पूरी तरह से अपारदर्शी होना चाहिए. scaleX- इस एलिमेंट पर लागू होने वाला हॉरिज़ॉन्टल स्केलिंग फ़ैक्टर.
scaleY- इस एलिमेंट पर लागू होने वाला वर्टिकल स्केलिंग फ़ैक्टर.
tintColor- एलिमेंट पर कलर टोन वाला फ़िल्टर लागू करें. आपको रंग बताने के लिए, ARGB फ़ॉर्मैट (
#ff000000= अपारदर्शी काला) या आरजीबी फ़ॉर्मैट (#000000= काला) का इस्तेमाल करना होगा. displayName- यह रिसोर्स आईडी, कॉम्प्लीकेशन स्लॉट के लिए स्थानीय भाषा के हिसाब से दिए गए नाम से जुड़ा होता है. यह नाम, स्मार्टवॉच की होम स्क्रीन एडिटर में दिखता है.
isCustomizable- इससे यह तय होता है कि उपयोगकर्ता स्मार्टवॉच की होम स्क्रीन एडिटर में जाकर, इस स्लॉट के लिए सेवा देने वाली कंपनी को बदल सकता है या नहीं. डिफ़ॉल्ट रूप से, यह
TRUEपर सेट होती है.
इनर एलिमेंट
ComplicationSlot एलिमेंट में, बॉर्डरिंग एरिया एलिमेंट ज़रूर होना चाहिए.
ComplicationSlot एलिमेंट में, काम करने वाले हर कॉम्प्लीकेशन टाइप के लिए कम से कम एक Complication एलिमेंट होना चाहिए. ComplicationSlot एलिमेंट में ज़्यादा Complication एलिमेंट शामिल किए जा सकते हैं. इससे, वैरिएंट एलिमेंट की मदद से, होम स्क्रीन की दिखने की सेटिंग में बदलाव किया जा सकता है.
ComplicationSlot एलिमेंट में ये इनर एलिमेंट भी शामिल हो सकते हैं: