Na tej stronie 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 użytkownika systemu:
Ten artykuł:
- Zakłada się, że znasz przypadki użycia systemu operacyjnego Android Automotive 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 zastąpić w klasach podstawowych. Raczej opisuje tylko te, które są potrzebne do skonfigurowania podstawowego widoku.
Ukończ ćwiczenia z kodowania
Krok 1: Utwórz układ dla kontrolera OverlayViewController
Utwórz plik o nazwie frameworks/base/packages/CarSystemUI/res/layout/codelab_layout.xml
który będzie 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:
Krok 2: Dodaj 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 ViewStubs są zdefiniowane w głównym FrameLayout
definiuje kolejność Z widoków w oknie. Ponieważ te ćwiczenia z programowania nie obejmują widoków warstwowych, możesz dodać fragment kodu w dowolnym miejscu w katalogu głównym FrameLayout
.
Krok 3: Utwórz kontroler OverlayViewController
Aby nowy układ mógł być pokazywany i ukryty, musi być połączony z kontrolerem 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 mediator OverlayView
Wymagany jest OverlayViewMediator uruchamiany po wyświetleniu lub ukryciu nowego widoku.
Utwórz nowy wstrzykiwalnyOverlayViewMediator
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 uruchomić nasz widok, użyj Bluetooth, gdy status jest wyłączony.
Zamień // no-op
w CodeLabViewMediator#registerListeners
na następujący:
// 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 zostanie wyświetlony komunikat „Ukryj!” przycisk został kliknięty. Ponieważ ta akcja dotyczy tylko przycisku zawyżonego widoku, dodaj ją 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
- 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);
- 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
:
Dodatkowe zasoby
Aby dowiedzieć się więcej, zapoznaj się z zasobami podanymi poniżej.
Przykładowy kontroler OverlayViewController
Zobacz pełnoekranowy przełącznik użytkowników jako prostą aplikację SystemUIOverlayWindow:
::
Inne kontrolery OverlayView
Kontroler OverlayPanelView
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: