In questa pagina viene spiegato come creare una vista in SystemUIOverlayWindow
.
Prima di iniziare
I contenuti forniti di seguito presuppongono che tu abbia letto i seguenti articoli sull'interfaccia utente di sistema:
Questo articolo:
- Presuppone che tu abbia familiarità con i casi d'uso del sistema operativo Android Automotive e delle sue
SystemUIOverlayWindow
. - Fornisce esempi di determinate sottoclassi di
OverlayViewController
. - Non indirizza le sottoclassi di
OverlayViewController
. - Non spiega come configurare Android per lo sviluppo.
- Non descrive ogni opzione che può essere sottoposta a override nelle classi base. Piuttosto descrive solo quelli necessari per impostare una vista 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 visualizzazione:
![OverlayViewController](https://source.android.com/static/docs/automotive/images/codelab_01.png?authuser=0&hl=it)
Passaggio 2: aggiungi un ViewStub a SysUIOverlayWindow
Aggiungi la vista alla finestra aggiungendo un elemento
ViewStub
in SystemUIOverlayWindow
.
Aggiungi il seguente codice a
frameworks/base/packages/CarSystemUI/res/layout/sysui_overlay_window.xml
nella radice 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 la
Ordinazione a Z delle visualizzazioni nella finestra. Poiché questo codelab non prevede la sovrapposizione di viste, puoi
aggiungi lo snippet di codice in qualsiasi punto della radice FrameLayout
.
Passaggio 3: crea un OverlayViewController
Per essere mostrato e nascosto, il nuovo layout deve essere collegato a una OverlayViewController.
Per creare un elemento OverlayViewController
iniettabile denominato
frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewController.java
con i seguenti contenuti:
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
Un OverlayViewMediator per attivarsi quando è richiesta una nuova visualizzazione o nasconderla.
Crea un nuovoOverlayViewMediator
iniettabile denominato
frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewMediator.java
con i seguenti contenuti:
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 visualizzazione
Per facilitare la comprensione e attivare la visualizzazione, utilizza il Bluetooth quando lo stato non è attivo.
Sostituisci // no-op
in CodeLabViewMediator#registerListeners
con
le seguenti:
// 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 visualizzazione
La visualizzazione verrà nascosta quando l'opzione "Nascondi!" viene fatto clic sul pulsante. Poiché questa azione
solo sul pulsante della visualizzazione gonfiata, aggiungilo 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
- Per aggiungere il nuovo OverlayViewMediator a OverlayWindowModule, aggiungi il codice seguente a
OverlayWindowModule:
/** Injects CodeLabViewMediator. */ @Binds @IntoMap @ClassKey(CodeLabViewMediator.class) public abstract OverlayViewMediator bindCodeLabViewMediator( CodeLabViewMediator overlayViewsMediator);
- Per aggiungere il nuovo OverlayViewMediator a config_carSystemUIOverlayViewsMediators:
aggiungi la seguente riga a
config_carSystemUIOverlayViewsMediators
tra
frameworks/base/packages/CarSystemUI/res/values/config.xml
:<item>com.android.systemui.car.codelab.CodeLabViewMediator</item>
Risultato
Complimenti! Hai creato una vista in SystemUIOverlayWindow
:
![FinestraSovrapposizione UISistema](https://source.android.com/static/docs/automotive/images/codelab_02.gif?authuser=0&hl=it)
Risorse aggiuntive
Per saperne di più, consulta le risorse fornite di seguito.
Esempio di OverlayViewController
Visualizza il selettore utente a schermo intero come un'applicazione semplice
SystemUIOverlayWindow:
:
Altri OverlayViewControllers
OverlaypanelViewController
Un
OverlaypanelViewController
viene utilizzato per fornire un'animazione di trascinamento di base quando mostri e nascondi le viste all'interno
SystemUIOverlayWindow
. Per ulteriori informazioni, vedi il riquadro Notifiche: