ध्यान दें: यह सुविधा, स्मार्टवॉच की होम स्क्रीन के फ़ॉर्मैट के वर्शन 4 और उसके बाद के वर्शन पर उपलब्ध है.
स्मार्टवॉच की होम स्क्रीन पर फ़ोटो जोड़ने की सुविधा देने से, उपयोगकर्ता को अपनी पसंद के मुताबिक होम स्क्रीन बनाने में मदद मिलती है.
इमेज इस्तेमाल करने वाले सेक्शन में, स्मार्टवॉच की होम स्क्रीन पर इमेज दिखाने का तरीका पहले से मौजूद है. अगर आपको उपयोगकर्ता को पहले से तय की गई इमेज में से चुनने की अनुमति देनी है, तो उपयोगकर्ता कॉन्फ़िगरेशन तय करें सेक्शन में दिखाए गए तरीके के मुताबिक, ListConfiguration का इस्तेमाल करें.
स्मार्टवॉच की होम स्क्रीन पर ऐसी इमेज इस्तेमाल करने के लिए जिन्हें उपयोगकर्ता कॉन्फ़िगर कर सकता है, <PhotosConfiguration> एलिमेंट का इस्तेमाल करें. उदाहरण के लिए:
<UserConfigurations>
<PhotosConfiguration id="photoConfig" configType="SINGLE"/>
</UserConfigurations>
configType, SINGLE या MULTIPLE हो सकता है. इससे पता चलता है कि उपयोगकर्ता, साथी ऐप्लिकेशन में एक इमेज या फ़ोटो का कलेक्शन चुन सकता है या नहीं.
सिर्फ़ एक फ़ोटो का इस्तेमाल किया जा सकता है
एक इमेज के मामले में, फ़ोटो का इस्तेमाल PartImage एलिमेंट में इस तरह किया जा सकता है:
<PartImage ...>
<Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>
</PartImage>
defaultImageResource पर ध्यान दें. यह तब दिखता है, जब उपयोगकर्ता ने साथी ऐप्लिकेशन में कोई फ़ोटो नहीं चुनी है. यह एक ज़रूरी एट्रिब्यूट है.
अगर उपयोगकर्ता को कोई दूसरी फ़ोटो चुननी है, तो उसे मौजूदा फ़ोटो को किसी दूसरी फ़ोटो से बदलने के लिए, साथी ऐप्लिकेशन का इस्तेमाल करना होगा.
एक से ज़्यादा फ़ोटो अपलोड करने की सुविधा
configType="MULTIPLE" के साथ PhotosConfiguration का इस्तेमाल करने पर, स्मार्टवॉच की होम स्क्रीन पर किसी कलेक्शन की फ़ोटो दिख सकती है. इस फ़ोटो को टैप करके या तय व्यू के बाद अपने-आप बदला जा सकता है.
<Photos change="ON_VISIBLE TAP" changeAfterEvery="5"
source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>
ऊपर दिए गए उदाहरण में, MULTIPLE का इस्तेमाल करते समय दिखने वाले दो विकल्प दिखाए गए हैं:
changeएट्रिब्यूट की मदद से, डेवलपर यह तय कर सकता है कि किन इवेंट की वजह से फ़ोटो, उपलब्ध इमेज के बीच स्विच करे.
पिछले उदाहरण में, TAP और ON_VISIBLE, दोनों के बारे में बताया गया है. इसका मतलब है कि फ़ोटो में बदलाव, या तो उपयोगकर्ता के फ़ोटो पर टैप करने पर होता है या फ़ोटो दिखने पर होता है.
changeAfterEveryएट्रिब्यूट सिर्फ़ON_VISIBLEबदलाव के इवेंट पर लागू होता है. इससे यह पता चलता है कि फ़ोटो बदलने से पहले, फ़ोटो को कितनी बार दिखना चाहिए. उदाहरण के लिए, आपको ऐसा लग सकता है कि जब भी उपयोगकर्ता अपनी स्मार्टवॉच को चालू करता है, तो फ़ोटो बदलना बहुत ज़्यादा बार हो रहा है. यहां डिफ़ॉल्ट वैल्यू 3 है.
PhotosConfiguration के साथ काम करने के बारे में ज़्यादा जानकारी के लिए, GitHub पर सैंपल देखें.