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

ध्यान दें: यह सुविधा, वॉच फ़ेस फ़ॉर्मैट के वर्शन 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 पर दिए गए सैंपल देखें.