Codelab SystemUIOverlayWindow

Questa pagina spiega come creare una vista in SystemUIOverlayWindow .

Prima che inizi

Il contenuto fornito di seguito presuppone che tu abbia letto questi articoli sull'interfaccia utente del sistema:

Questo articolo:

  • Si presuppone che tu abbia familiarità con i casi d'uso del sistema operativo Android Automotive e del relativo SystemUIOverlayWindow .
  • Fornisce esempi di alcune sottoclassi di OverlayViewController .
  • Non risolve le sottoclassi di OverlayViewController .
  • Non spiega come configurare Android per lo sviluppo.
  • Non descrive ogni opzione che può essere sovrascritta nelle classi base. Piuttosto descrive solo quelli necessari per impostare una visualizzazione di base.

Completa il codelab

Passaggio 1: crea un layout per OverlayViewController

Crea un file denominato frameworks/base/packages/CarSystemUI/res/layout/codelab_layout.xml per contenere quanto segue:

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@+id/codelab_container"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@android:color/black">
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">
        <TextView
            android:layout_width="match_parent"
            android:layout_height="0dp"
            android:layout_weight="1"
            android:gravity="center"
            android:text="Code Lab View!"
            android:color="@*android:color/car_accent"
            android:textStyle="italic"
            android:textSize="34sp"/>
        <Button
            android:id="@+id/codelab_button"
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            android:layout_weight="0"
            android:text="Hide!"
            android:background="@*android:color/car_accent"/>
    </LinearLayout>
</FrameLayout>

Questo layout crea la seguente vista:

OverlayViewController
Figura 1. OverlayViewController

Passaggio 2: aggiungi un ViewStub a SysUIOverlayWindow

Aggiungi la vista alla tua finestra aggiungendo un ViewStub a SystemUIOverlayWindow .

Aggiungi il seguente codice a frameworks/base/packages/CarSystemUI/res/layout/sysui_overlay_window.xml nella root FrameLayout :

<ViewStub android:id="@+id/codelab_stub"
          android:layout_width="match_parent"
          android:layout_height="match_parent"
          android:layout="@layout/codelab_layout"/>

L'ordine in cui i ViewStub sono definiti nella radice FrameLayout definisce l'ordine Z delle viste nella finestra. Poiché questo codelab non prevede visualizzazioni su più livelli, puoi aggiungere lo snippet di codice ovunque nella radice FrameLayout .

Passaggio 3: crea un OverlayViewController

Per essere mostrato e nascosto, il nuovo layout deve essere collegato a un OverlayViewController .

Per creare un OverlayViewController iniettabile denominato frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewController.java con il seguente contenuto:

package com.android.systemui.car.codelab;

import com.android.systemui.R;
import com.android.systemui.car.window.OverlayViewController;
import com.android.systemui.car.window.OverlayViewGlobalStateController;
import com.android.systemui.dagger.SysUISingleton;

import javax.inject.Singleton;

@SysUISingleton
public class CodeLabViewController extends OverlayViewController {

    @Inject
    public CodeLabViewController(
            OverlayViewGlobalStateController overlayViewGlobalStateController) {
        super(R.id.codelab_stub, overlayViewGlobalStateController);
    }
}

Passaggio 4: crea un OverlayViewMediator

È richiesto un OverlayViewMediator da attivare quando viene mostrata o nascosta una nuova visualizzazione.

Crea un nuovo OverlayViewMediator iniettabile denominato frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewMediator.java con il seguente contenuto:
package com.android.systemui.car.codelab;


import android.bluetooth.BluetoothAdapter;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;


import com.android.systemui.car.window.OverlayViewMediator;
import com.android.systemui.dagger.SysUISingleton;


import javax.inject.Inject;


@SysUISingleton
public class CodeLabViewMediator implements OverlayViewMediator {
    Context mContext;
    CodeLabViewController mCodeLabViewController;


    @Inject
    public CodeLabViewMediator(Context context, CodeLabViewController codeLabViewController) {
        mContext = context;
        mCodeLabViewController = codeLabViewController;
    }


    @Override
    public void registerListeners() {
        // no-op
    }


    @Override
    public void setupOverlayContentViewControllers() {
        // no-op
    }
}

Passaggio 5: mostra la vista

Per facilitare la comprensione e attivare la nostra visualizzazione, utilizzare il Bluetooth quando lo stato è disattivato.

Sostituisci // no-op in CodeLabViewMediator#registerListeners con quanto segue:

// Register Show Listener
mContext.registerReceiver(new BroadcastReceiver() {
    @Override
    public void onReceive(Context context, Intent intent) {
        final String action = intent.getAction();


        if (action.equals(BluetoothAdapter.ACTION_STATE_CHANGED)) {
            final int state = intent.getIntExtra(BluetoothAdapter.EXTRA_STATE,
                    BluetoothAdapter.ERROR);
            switch (state) {
                case BluetoothAdapter.STATE_OFF:
                    // Show OverlayViewController
                    mCodeLabViewController.start();
                    break;
            }
        }
    }
}, new IntentFilter(BluetoothAdapter.ACTION_STATE_CHANGED));

Passaggio 6: nascondi la vista

La vista verrà nascosta quando il pulsante "Nascondi!" viene fatto clic sul pulsante. Poiché questa azione è disponibile solo sul pulsante della vista ingrandita, aggiungila direttamente a OverlayViewController .

Aggiungi il seguente metodo a CodeLabViewController :

@Override
protected void onFinishInflate() {
    getLayout().findViewById(R.id.codelab_button).setOnClickListener(v -> {
        stop();
    });
}

Passaggio 7: configura il nuovo OverlayViewMediator

  1. Per aggiungere il nuovo OverlayViewMediator a OverlayWindowModule, aggiungi il seguente codice a OverlayWindowModule :
    /** Injects CodeLabViewMediator. */
@Binds
@IntoMap
@ClassKey(CodeLabViewMediator.class)
public abstract OverlayViewMediator bindCodeLabViewMediator(
        CodeLabViewMediator overlayViewsMediator);
  2. Per aggiungere il nuovo OverlayViewMediator a config_carSystemUIOverlayViewsMediators, aggiungi la seguente riga a config_carSystemUIOverlayViewsMediators in frameworks/base/packages/CarSystemUI/res/values/config.xml :
    <item>com.android.systemui.car.codelab.CodeLabViewMediator</item>

Risultato

Congratulazioni! Hai creato una vista in SystemUIOverlayWindow :

SystemUIOverlayWindow
Figura 2. Finestra SystemUIOverlay

Risorse addizionali

Per saperne di più, consulta le risorse fornite di seguito.

Esempio OverlayViewController

Visualizza il cambio utente a schermo intero come una semplice applicazione di SystemUIOverlayWindow: ::

Altri OverlayViewController

OverlayPanelViewController

Un OverlayPanelViewController viene utilizzato per fornire un'animazione di trascinamento di base quando si mostrano e si nascondono visualizzazioni all'interno di SystemUIOverlayWindow . Consulta il pannello delle notifiche per saperne di più: