SystemUIOverlayWindow Codelab

W tym artykule wyjaśniono, jak utworzyć widok w SystemUIOverlayWindow .

Zanim zaczniesz

Treść podana poniżej zakłada, że ​​przeczytałeś następujące artykuły dotyczące interfejsu systemu:

Ten artykuł:

  • Zakładamy, że znasz przypadki użycia systemu Android Automotive OS i jego SystemUIOverlayWindow .
  • Zawiera przykłady niektórych podklas OverlayViewController .
  • Nie dotyczy podklas OverlayViewController .
  • Nie wyjaśnia, jak skonfigurować Androida do programowania.
  • Nie opisuje każdej opcji, którą można przesłonić w klasach bazowych. Raczej opisuje tylko te, które są potrzebne do skonfigurowania podstawowego widoku.

Ukończ ćwiczenia z programowania

Krok 1: Utwórz układ dla OverlayViewController

Utwórz plik o nazwie frameworks/base/packages/CarSystemUI/res/layout/codelab_layout.xml , aby zawierał następujące elementy:

<?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>

Ten układ tworzy następujący widok:

Kontroler widoku nakładki
Rysunek 1. OverlayViewController

Krok 2: Dodaj ViewStub do SysUIOverlayWindow

Dodaj widok do okna, dodając ViewStub do SystemUIOverlayWindow .

Dodaj następujący kod do frameworks/base/packages/CarSystemUI/res/layout/sysui_overlay_window.xml w głównym FrameLayout :

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

Kolejność, w jakiej ViewStubs są zdefiniowane w głównym FrameLayout definiuje kolejność Z widoków w oknie. Ponieważ to laboratorium nie obejmuje widoków warstw, możesz dodać fragment kodu w dowolnym miejscu w głównym FrameLayout .

Krok 3: Utwórz OverlayViewController

Aby był wyświetlany i ukryty, nowy układ musi być połączony z OverlayViewController .

Aby utworzyć wstrzykiwalny OverlayViewController o nazwie frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewController.java z następującą zawartością:

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

Krok 4: Utwórz OverlayViewMediator

Wymagany jest OverlayViewMediator do wyzwalania, gdy nowy widok jest wyświetlany lub ukrywany.

Utwórz nowy wstrzykiwalny OverlayViewMediator o nazwie frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewMediator.java z następującą zawartością:
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 } }

Krok 5: Pokaż widok

Aby ułatwić zrozumienie i wywołać nasz widok, używaj Bluetooth, gdy status jest wyłączony.

Zastąp // no-op w CodeLabViewMediator#registerListeners następującym:

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

Krok 6: Ukryj widok

Widok zostanie ukryty, gdy „Ukryj!” przycisk jest kliknięty. Ponieważ ta akcja tylko na przycisku zawyżonego widoku, dodaj to bezpośrednio do OverlayViewController .

Dodaj następującą metodę do CodeLabViewController :

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

Krok 7: Skonfiguruj nowy OverlayViewMediator

  1. Aby dodać nowy OverlayViewMediator do OverlayWindowModule, dodaj następujący kod do OverlayWindowModule :
    /** Injects CodeLabViewMediator. */
    @Binds
    @IntoMap
    @ClassKey(CodeLabViewMediator.class)
    public abstract OverlayViewMediator bindCodeLabViewMediator(
            CodeLabViewMediator overlayViewsMediator);
    
  2. Aby dodać nowy OverlayViewMediator do config_carSystemUIOverlayViewsMediators, dodaj następujący wiersz do config_carSystemUIOverlayViewsMediators w frameworks/base/packages/CarSystemUI/res/values/config.xml :
    <item>com.android.systemui.car.codelab.CodeLabViewMediator</item>
    

Wynik

Gratulacje! Utworzyłeś widok w SystemUIOverlayWindow :

Okno nakładki systemowej
Rysunek 2. Okno SystemUIOverlay

Dodatkowe zasoby

Aby dowiedzieć się więcej, zapoznaj się z zasobami podanymi poniżej.

Przykładowy kontroler widoku nakładki

Zobacz pełnoekranowy przełącznik użytkowników jako prostą aplikację SystemUIOverlayWindow: :

Inne kontrolery OverlayView

OverlayPanelViewController

OverlayPanelViewController służy do zapewnienia podstawowej animacji przeciągania podczas pokazywania i ukrywania widoków wewnątrz SystemUIOverlayWindow . Zobacz panel powiadomień, aby dowiedzieć się więcej: