फ़ोटो की मदद से, होम स्क्रीन को मनमुताबिक बनाना

ध्यान दें: यह सुविधा, वॉच फ़ेस फ़ॉर्मैट के वर्शन 4 और इसके बाद के वर्शन पर उपलब्ध है.

उपयोगकर्ता को स्मार्टवॉच की होम स्क्रीन पर दिखाने के लिए फ़ोटो चुनने की अनुमति देने से, उसे अपनी दिलचस्पी के हिसाब से होम स्क्रीन को सेट करने में मदद मिलती है.

इमेज इस्तेमाल करने के सेक्शन में, पहले से ही यह बताया गया है कि वॉच फ़ेस में इमेज कैसे दिखाई जाती हैं. अगर आपको उपयोगकर्ता को पहले से तय की गई इमेज में से कोई इमेज चुनने की अनुमति देनी है, तो ListConfiguration का इस्तेमाल करें. इसके बारे में उपयोगकर्ता के लिए कॉन्फ़िगरेशन तय करना सेक्शन में बताया गया है.

अगर आपको अपनी स्मार्टवॉच की होम स्क्रीन पर ऐसी इमेज इस्तेमाल करनी हैं जिन्हें उपयोगकर्ता कॉन्फ़िगर कर सकता है, तो <PhotosConfiguration> एलिमेंट का इस्तेमाल करें. उदाहरण के लिए:

<!-- Under WatchFace element -->
<UserConfigurations>
    <PhotosConfiguration id="photoConfig" configType="SINGLE"/>
</UserConfigurations>watchface_photos.xml

configType की वैल्यू SINGLE या MULTIPLE हो सकती है. इससे पता चलता है कि उपयोगकर्ता, कंपैनियन डिवाइस में मौजूद किसी एक इमेज को चुन पाएगा या फ़ोटो के कलेक्शन को.

सिर्फ़ एक फ़ोटो का इस्तेमाल किया जा सकता है

एक इमेज के मामले में, फ़ोटो का इस्तेमाल PartImage एलिमेंट में इस तरह किया जा सकता है:

<PartImage x="100" y="50" width="100" height="100">
    <Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>
</PartImage>watchface_photos.xml

defaultImageResource पर ध्यान दें. यह तब दिखता है, जब उपयोगकर्ता ने कंपैनियन ऐप्लिकेशन में कोई फ़ोटो नहीं चुनी होती है. यह एक ज़रूरी एट्रिब्यूट है.

अगर उपयोगकर्ता को कोई दूसरी फ़ोटो चुननी है, तो उसे कंपैनियन डिवाइस का इस्तेमाल करके, मौजूदा फ़ोटो को दूसरी फ़ोटो से बदलना होगा.

एक से ज़्यादा फ़ोटो जोड़ने की सुविधा

configType="MULTIPLE" के साथ PhotosConfiguration का इस्तेमाल करने पर, वॉच फ़ेस पर किसी कलेक्शन की फ़ोटो दिखती है. इसे टैप करके या तय संख्या में व्यू मिलने के बाद अपने-आप बदला जा सकता है.

<PartImage x="100" y="250" width="100" height="100">
    <Photos change="ON_VISIBLE TAP" changeAfterEvery="5"
        source="[CONFIGURATION.galleryConfig]" defaultImageResource="default_image"/>
</PartImage>watchface_photos_multi.xml

ऊपर दिए गए उदाहरण में, MULTIPLE का इस्तेमाल करते समय उपलब्ध होने वाले दो विकल्प दिखाए गए हैं:

change एट्रिब्यूट की मदद से डेवलपर यह तय कर सकता है कि किन इवेंट की वजह से, फ़ोटो को उपलब्ध इमेज के बीच साइकल करना चाहिए.

ऊपर दिए गए उदाहरण में, TAP और ON_VISIBLE, दोनों को तय किया गया है. इसका मतलब है कि फ़ोटो में बदलाव या तो उपयोगकर्ता के फ़ोटो पर टैप करने पर होता है या फ़ोटो के दिखने पर होता है.

changeAfterEvery एट्रिब्यूट, सिर्फ़ ON_VISIBLE बदलाव इवेंट पर लागू होता है. इससे यह तय किया जाता है कि फ़ोटो बदलने से पहले, फ़ोटो कितनी बार दिखनी चाहिए. उदाहरण के लिए, आपको लग सकता है कि जब भी उपयोगकर्ता अपनी घड़ी चालू करे, तब फ़ोटो बदलना बहुत बार होता है. इसकी डिफ़ॉल्ट वैल्यू 3 होती है.

PhotosConfiguration के साथ काम करने के बारे में ज़्यादा जानकारी के लिए, GitHub पर दिए गए सैंपल देखें.