Wear OS पर कॉन्फ़िगरेशन गतिविधियां उपलब्ध कराना

स्मार्टवॉच की कुछ होम स्क्रीन, कॉन्फ़िगरेशन पैरामीटर के साथ काम करती हैं. इससे उपयोगकर्ता, होम स्क्रीन को अपनी पसंद के मुताबिक बना सकते हैं देखने और काम करने का तरीका. उदाहरण के लिए, स्मार्टवॉच की कुछ होम स्क्रीन में उपयोगकर्ता अपने हिसाब से बैकग्राउंड का रंग चुन सकते हैं. किसी और तरीके से स्मार्टवॉच की इन होम स्क्रीन पर, दो अलग-अलग टाइम ज़ोन का समय बताया जाता है. इनकी मदद से, लोग यह चुन सकते हैं कि कौनसे टाइम ज़ोन को देखा जा सकता है जिनमें उनकी दिलचस्पी हो.

स्मार्टवॉच की ऐसी होम स्क्रीन जो कॉन्फ़िगरेशन पैरामीटर के साथ काम करती हैं उनसे उपयोगकर्ता, स्मार्टवॉच की होम स्क्रीन को पसंद के मुताबिक बना सकते हैं. इसके लिए, कोई गतिविधि. उपयोगकर्ता, पहने जाने वाले डिवाइस पर कॉन्फ़िगरेशन से जुड़ी गतिविधि शुरू कर सकते हैं. वे ये काम कर सकते हैं साथ ही, अगर हैंडहेल्ड ऐप्लिकेशन इंस्टॉल किया गया है, तो वह कंपैनियन कॉन्फ़िगरेशन गतिविधि भी शुरू कर सकता है. इसके अलावा, उपयोगकर्ता Wear OS 3 के लिए, डिवाइस के साथी ऐप्लिकेशन में स्मार्टवॉच की होम स्क्रीन को कॉन्फ़िगर कर सकते हैं डिवाइस.

ध्यान दें: डिवाइस के साथी ऐप्लिकेशन का कॉन्फ़िगरेशन, यहां उपलब्ध है एपीआई लेवल 30 और उसके बाद के लेवल को टारगेट करने वाले डिवाइस. हैंडहेल्ड ऐप्लिकेशन का कॉन्फ़िगरेशन इन सभी डिवाइसों पर उपलब्ध है डिवाइस.

एडिटर सेशन का इस्तेमाल करें

हमारा सुझाव है कि आप स्मार्टवॉच पर कॉन्फ़िगरेशन का समर्थन करें, ताकि उपयोगकर्ता, साथी डिवाइस की ज़रूरत के बिना भी अपनी स्मार्टवॉच की होम स्क्रीन को पसंद के मुताबिक बना सकते हैं.

यह सुविधा देने के लिए, स्मार्टवॉच की होम स्क्रीन पर कॉन्फ़िगरेशन Activity दिया जा सकता है और उपयोगकर्ता, इनसे मिले EditorSession का इस्तेमाल करके सेटिंग बदलता है EditorSession.createOnWatchEditorSession. जैसे ही उपयोगकर्ता बदलाव करता है, कॉल करने की सुविधा EditorSession.renderWatchFaceToBitmap इसकी मदद से, एडिटर Activity में स्मार्टवॉच की होम स्क्रीन की लाइव झलक देखी जा सकती है.

कॉन्फ़िगरेशन गतिविधियों के लिए कोई इंटेंट तय करें

अगर आपकी स्मार्टवॉच की होम स्क्रीन में कॉन्फ़िगरेशन गतिविधियां शामिल हैं और आपने स्मार्टवॉच की होम स्क्रीन को कॉन्फ़िगर किया है डिवाइस के साथी ऐप्लिकेशन से, सेवा के एलान में ये मेटाडेटा एंट्री जोड़ें तो:

<service>
    <meta-data
        android:name="com.google.android.wearable.watchface.wearableConfigurationAction"
        android:value="androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR" />
    <meta-data
        android:name="com.google.android.wearable.watchface.companionBuiltinConfigurationEnabled"
        android:value="true" />
</service>

कॉन्फ़िगरेशन गतिविधियां इस इंटेंट के लिए इंटेंट फ़िल्टर रजिस्टर करती हैं और सिस्टम इसे सक्रिय करता है इंटेंट तय करें.

अगर आपकी स्मार्टवॉच की होम स्क्रीन में सिर्फ़ कोई साथी या पहने जाने वाला कॉन्फ़िगरेशन शामिल है, तो पिछले उदाहरण से संबंधित मेटाडेटा एंट्री को शामिल करना ज़रूरी है.

पहने जाने वाले कॉन्फ़िगरेशन से जुड़ी गतिविधि बनाएं

पहने जाने वाले कॉन्फ़िगरेशन से जुड़ी गतिविधियां, ऐप्लिकेशन को पसंद के मुताबिक बनाने के सीमित विकल्प उपलब्ध कराती हैं. स्मार्टवॉच की होम स्क्रीन, क्योंकि छोटी स्क्रीन पर मुश्किल मेन्यू को नेविगेट करना मुश्किल होता है. आपके पहने जाने वाले डिवाइस में कॉन्फ़िगरेशन गतिविधि, बाइनरी विकल्प दें, और कस्टमाइज़ करने के लिए कुछ विकल्प दें वॉच की होम स्क्रीन के खास पहलू बताए गए हों.

पहने जाने वाले डिवाइस से जुड़ी कॉन्फ़िगरेशन गतिविधि बनाने के लिए, अपने पहने जाने वाले ऐप्लिकेशन मॉड्यूल में एक नई गतिविधि जोड़ें और पहने जाने वाले ऐप्लिकेशन की मेनिफ़ेस्ट फ़ाइल में इस इंटेंट फ़िल्टर का एलान करें:

<activity
    android:name=".DigitalWatchFaceWearableConfigActivity"
    android:label="@string/digital_config_name">
    <intent-filter>
        <action android:name="androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR" />
        <category android:name=
        "com.google.android.wearable.watchface.category.WEARABLE_CONFIGURATION" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

इस इंटेंट फ़िल्टर में कार्रवाई का नाम यह होना चाहिए androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR.

अपनी कॉन्फ़िगरेशन गतिविधि में, एक ऐसा सरल यूज़र इंटरफ़ेस (यूआई) बनाएं जो उपयोगकर्ताओं को होम स्क्रीन को पसंद के मुताबिक़ बनाएँ.

कंपैनियन कॉन्फ़िगरेशन गतिविधि बनाएं

कंपैनियन कॉन्फ़िगरेशन गतिविधियां, उपयोगकर्ताओं को कॉन्फ़िगरेशन के सभी विकल्पों का ऐक्सेस देती हैं क्योंकि बड़ी स्क्रीन पर कॉम्प्लेक्स मेन्यू के साथ इंटरैक्ट करना आसान होता है. हैंडहेल्ड डिवाइस मिलता है. उदाहरण के लिए, हैंडहेल्ड डिवाइस पर कॉन्फ़िगरेशन गतिविधि की मदद से ऐप्लिकेशन की मदद से लोग, रंग चुनने वाले टूल की मदद से किसी स्मार्टवॉच की होम स्क्रीन के बैकग्राउंड का रंग चुन सकते हैं.

ध्यान दें: कॉन्फ़िगरेशन गतिविधियां सिर्फ़ हैंडहेल्ड के लिए लिखी जा सकती हैं Android पर चलने वाले डिवाइस, जैसे कि फ़ोन, टैबलेट, और फ़ोल्ड किए जा सकने वाले डिवाइस.

साथी कॉन्फ़िगरेशन गतिविधि बनाने के लिए, अपने हैंडहेल्ड ऐप्लिकेशन मॉड्यूल में कोई नई गतिविधि जोड़ें और हैंडहेल्ड ऐप्लिकेशन की मेनिफ़ेस्ट फ़ाइल में, इस इंटेंट फ़िल्टर के बारे में जानकारी दें:

<activity
    android:name=".DigitalWatchFaceCompanionConfigActivity"
    android:label="@string/app_name">
    <intent-filter>
        <action android:name=
            "com.example.android.wearable.watchface.CONFIG_DIGITAL" />
        <category android:name=
        "com.google.android.wearable.watchface.category.COMPANION_CONFIGURATION" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

अपनी कॉन्फ़िगरेशन गतिविधि में, ऐसा यूज़र इंटरफ़ेस (यूआई) बनाएं जो आपकी स्मार्टवॉच की होम स्क्रीन के कॉन्फ़िगर किए जा सकने वाले एलिमेंट. उपयोगकर्ताओं के चुनने के बाद, Wearable डेटा लेयर API का इस्तेमाल करके कॉन्फ़िगरेशन में हुए बदलाव के बारे में, स्मार्टवॉच की होम स्क्रीन पर होने वाली गतिविधि के बारे में बता सकते हैं.

यहां दिए गए मिलते-जुलते संसाधनों को देखें: