Creare elenchi su Wear OS

Gli elenchi consentono agli utenti di selezionare facilmente un articolo da una serie di opzioni sui dispositivi Wear OS.

La libreria di UI Wearable include la classe WearableRecyclerView, che è un'implementazione RecyclerView per la creazione di elenchi ottimizzati per i dispositivi indossabili. Puoi utilizzare questa interfaccia nella tua app indossabile creando un nuovo contenitore WearableRecyclerView.

Utilizza WearableRecyclerView per un lungo elenco di elementi semplici, ad esempio un'Avvio applicazioni o un elenco di contatti. Ogni elemento potrebbe avere una stringa corta e un'icona associata. In alternativa, ogni elemento potrebbe avere solo una stringa o un'icona.

Nota:evita layout complessi. Gli utenti dovrebbero solo dare un'occhiata a un articolo per capire di cosa si tratta, in particolare nel caso di schermi di dimensioni limitate degli indossabili.

Estendendo la classe RecyclerView esistente, le API WearableRecyclerView mostrano per impostazione predefinita un elenco di elementi scorrevoli verticalmente in un elenco diretto. Puoi anche utilizzare le API WearableRecyclerView per attivare un layout curvo e un gesto di scorrimento circolare nelle tue app indossabili.

Figura 1. Visualizzazione elenco predefinita su Wear OS.

Questa guida illustra come utilizzare la classe WearableRecyclerView per creare elenchi nelle app per Wear OS, attivare un layout curvo per gli elementi scorrevoli e personalizzare l'aspetto dei bambini durante lo scorrimento.

Aggiungi WearableRecyclerView a un'attività utilizzando il formato XML

Il seguente layout aggiunge un WearableRecyclerView a un'attività:

<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" />

L'esempio seguente mostra l'oggetto WearableRecyclerView applicato a un'attività:

class MainActivity : Activity() {

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

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

Creare un layout curvo

Per creare un layout curvo per gli elementi scorrevoli nella tua app indossabile:

• Utilizza WearableRecyclerView come contenitore principale nel layout XML pertinente.
• Imposta il metodo setEdgeItemsCenteringEnabled(boolean) su true. In questo modo, centra verticalmente il primo e l'ultimo elemento dell'elenco sullo schermo.
• Utilizza il metodo WearableRecyclerView.setLayoutManager() per impostare il layout degli elementi sullo schermo.

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

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

Se la tua app ha requisiti specifici per personalizzare l'aspetto dei bambini durante lo scorrimento, ad esempio ridimensionando le icone e il testo mentre gli elementi scorrono lontano dal centro, estendi la classe WearableLinearLayoutManager.LayoutCallback e sostituisci il metodo onLayoutFinished.

I seguenti snippet di codice mostrano un esempio di personalizzazione dello scorrimento degli elementi per scalare lontano dal centro estendendo la classe WearableLinearLayoutManager.LayoutCallback:

/** 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
        }
    }
}

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);
    }
}

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

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