Wear OS पर सूचियाँ बनाना

सूचियों की मदद से उपयोगकर्ता, Wear OS डिवाइसों पर आसानी से उपलब्ध विकल्पों में से कोई आइटम चुन सकते हैं.

पहने जाने वाले डिवाइस की यूज़र इंटरफ़ेस (यूआई) लाइब्रेरी में WearableRecyclerView क्लास, जो RecyclerView पहने जाने वाले डिवाइसों के लिए ऑप्टिमाइज़ की गई सूचियां बनाने के लिए लागू किया गया. आप इसका इस्तेमाल कर सकते हैं इंटरफ़ेस करने के लिए एक नया WearableRecyclerView कंटेनर बनाएं.

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

ध्यान दें: जटिल लेआउट इस्तेमाल न करें. इस सुविधा का इस्तेमाल करने के लिए, लोगों को सिर्फ़ आपके आइटम की झलक देखनी चाहिए, यह समझना कि वह क्या है, खास तौर पर पहने जाने वाले डिवाइसों पर' सीमित स्क्रीन साइज़.

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

पहला डायग्राम. Wear OS पर डिफ़ॉल्ट सूची के तौर पर देखें.

इस गाइड में, WearableRecyclerView क्लास इस्तेमाल करने का तरीका बताया गया है Wear OS ऐप्लिकेशन में सूचियों की सूची, घुमावदार लेआउट के लिए ऑप्ट-इन करने का तरीका और वे आइटम जिन्हें स्क्राेल किया जा सकता है, उनके रंग-रूप को स्क्रोल करते समय बच्चों को दिखाया जा सकता है.

एक्सएमएल का इस्तेमाल करके, किसी गतिविधि में WearableRecyclerView को जोड़ना

यह लेआउट किसी गतिविधि में WearableRecyclerView जोड़ता है: 

<androidx.wear.widget.WearableRecyclerView
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:id="@+id/recycler_launcher_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:scrollbars="vertical" />

यहां दिए गए उदाहरण में, WearableRecyclerView को दिखाया गया है किसी गतिविधि पर लागू किया जाता है:

Kotlin


class MainActivity : Activity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
    }
    ...
}

Java

public class MainActivity extends Activity {
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
    }
    ...
}

घुमावदार लेआउट बनाना

पहने जाने वाले अपने ऐप्लिकेशन में, स्क्रोल किए जा सकने वाले आइटम का कर्व्ड लेआउट बनाने के लिए, यह तरीका अपनाएं:

Kotlin

wearableRecyclerView.apply {
    // To align the edge children (first and last) with the center of the screen.
    isEdgeItemsCenteringEnabled = true
    ...
    layoutManager = WearableLinearLayoutManager(this@MainActivity)
}

Java

// To align the edge children (first and last) with the center of the screen.
wearableRecyclerView.setEdgeItemsCenteringEnabled(true);
...
wearableRecyclerView.setLayoutManager(
                new WearableLinearLayoutManager(this));

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

नीचे दिए गए कोड स्निपेट, आइटम की स्क्रोलिंग को स्केल करने के लिए पसंद के मुताबिक बनाने का एक उदाहरण दिखाते हैं केंद्र से दूर जाने के लिए WearableLinearLayoutManager.LayoutCallback क्लास:

Kotlin

/** How much icons should scale, at most.  */
private const val MAX_ICON_PROGRESS = 0.65f

class CustomScrollingLayoutCallback : WearableLinearLayoutManager.LayoutCallback() {

    private var progressToCenter: Float = 0f

    override fun onLayoutFinished(child: View, parent: RecyclerView) {
        child.apply {
            // Figure out % progress from top to bottom.
            val centerOffset = height.toFloat() / 2.0f / parent.height.toFloat()
            val yRelativeToCenterOffset = y / parent.height + centerOffset

            // Normalize for center.
            progressToCenter = Math.abs(0.5f - yRelativeToCenterOffset)
            // Adjust to the maximum scale.
            progressToCenter = Math.min(progressToCenter, MAX_ICON_PROGRESS)

            scaleX = 1 - progressToCenter
            scaleY = 1 - progressToCenter
        }
    }
}

Java

public class CustomScrollingLayoutCallback extends WearableLinearLayoutManager.LayoutCallback {
    /** How much icons should scale, at most. */
    private static final float MAX_ICON_PROGRESS = 0.65f;

    private float progressToCenter;

    @Override
    public void onLayoutFinished(View child, RecyclerView parent) {

        // Figure out % progress from top to bottom.
        float centerOffset = ((float) child.getHeight() / 2.0f) / (float) parent.getHeight();
        float yRelativeToCenterOffset = (child.getY() / parent.getHeight()) + centerOffset;

        // Normalize for center.
        progressToCenter = Math.abs(0.5f - yRelativeToCenterOffset);
        // Adjust to the maximum scale.
        progressToCenter = Math.min(progressToCenter, MAX_ICON_PROGRESS);

        child.setScaleX(1 - progressToCenter);
        child.setScaleY(1 - progressToCenter);
    }
}

Kotlin

wearableRecyclerView.layoutManager =
        WearableLinearLayoutManager(this, CustomScrollingLayoutCallback())

Java

CustomScrollingLayoutCallback customScrollingLayoutCallback =
                new CustomScrollingLayoutCallback();
wearableRecyclerView.setLayoutManager(
                new WearableLinearLayoutManager(this, customScrollingLayoutCallback));