Ćwiczenie z programowania dotyczące nakładki SystemUIOverlayWindow

Z tego artykułu dowiesz się, jak utworzyć widok w SystemUIOverlayWindow.

Zanim rozpoczniesz

Poniżej zakładamy, że znasz te artykuły dotyczące interfejsu systemu:

• Implementowanie interfejsu systemu
• System zarządzaniaUIOverlayWindow

Ten artykuł:

• Zakładamy, że znasz przypadki użycia systemu operacyjnego Android Automotive SystemUIOverlayWindow
• Zawiera przykłady określonych podklas klasy OverlayViewController.
• Nie obejmuje podklas klasy OverlayViewController.
• Nie wyjaśnia, jak skonfigurować Androida na potrzeby programowania.
• Nie opisuje żadnej opcji, którą można zastąpić w klasach podstawowych. Opisuje on raczej potrzebne do skonfigurowania widoku podstawowego.

Wykonaj ćwiczenia z programowania

Krok 1. Utwórz układ dla kontrolera OverlayViewController

Utwórz plik o nazwie frameworks/base/packages/CarSystemUI/res/layout/codelab_layout.xml musi zawierać:

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

Rysunek 1. OverlayViewController

Krok 2. Dodaj obiekt ViewStub do SysUIOverlayWindow

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

Dodaj następujący kod do frameworks/base/packages/CarSystemUI/res/layout/sysui_overlay_window.xml w katalogu 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 zdefiniowano obiekty ViewStubs w katalogu głównym FrameLayout, definiuje Kolejność wyświetleń w oknie na osi Z. Ponieważ to ćwiczenie w Codelabs nie obejmuje widoków warstw, możesz dodaj fragment kodu w dowolnym miejscu w katalogu głównym FrameLayout.

Krok 3. Utwórz obiekt OverlayViewController

Aby nowy układ był widoczny lub ukryty, musi być połączony z elementem OverlayViewController.

Aby utworzyć element OverlayViewController o nazwie do wstrzykiwania frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewController.java z następującą treś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 obiekt OverlayViewMediator

An OverlayViewMediator, do aktywowania, gdy potrzebny jest nowy widok lub ukryty.

Utwórz nowy komponent OverlayViewMediator do wstrzykiwania o nazwie frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewMediator.java z następującą treś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ć sobie zrozumienie i aktywowanie widoku, używaj Bluetootha, gdy stan jest wyłączony.

Zamień // no-op w CodeLabViewMediator#registerListeners na następujące:

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

Gdy klikniesz „Ukryj!”, widok zostanie ukryty. kliknięty przycisk. Od tego działania w przycisku widoku powiększonego, dodaj tę wartość bezpośrednio do OverlayViewController.

Dodaj do CodeLabViewController tę metodę:

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

Krok 7. Skonfiguruj nowy obiekt OverlayViewMediator

1. Aby dodać nowy element OverlayViewMediator do komponentu OverlayWindowModule, dodaj do OverlayWindowModule:

   /** Injects CodeLabViewMediator. */
   @Binds
   @IntoMap
   @ClassKey(CodeLabViewMediator.class)
   public abstract OverlayViewMediator bindCodeLabViewMediator(
           CodeLabViewMediator overlayViewsMediator);
   

2. Aby dodać nowy obiekt OverlayViewMediator do obiektu config_carSystemUIOverlayViewsMediators: dodaj następujący wiersz do config_carSystemUIOverlayViewsMediators (w języku angielskim) w frameworks/base/packages/CarSystemUI/res/values/config.xml:

   <item>com.android.systemui.car.codelab.CodeLabViewMediator</item>
   

Wynik

Gratulacje! Utworzono widok w SystemUIOverlayWindow:

Rysunek 2. SystemUIOverlayWindow

Dodatkowe materiały

Aby dowiedzieć się więcej, zapoznaj się z materiałami poniżej.

Przykładowy kontroler OverlayView

Pełnoekranowy przełącznik użytkowników to prosty sposób na to, SystemUIOverlayWindow::

• FullScreenUserSwitcherViewController
• FullscreenUserSwitcherViewMediator

Inne elementy sterujące OverlayView

kontroler OverlayPanelViewView

An NakładkaPanelViewController służy do podstawowej animacji przeciągania podczas pokazywania i ukrywania widoków wewnątrz SystemUIOverlayWindow Więcej informacji znajdziesz w panelu powiadomień:

• notificationPanelViewController
• notificationPanelViewMediator