本頁介紹如何在SystemUIOverlayWindow
中建立檢視。
在你開始之前
以下提供的內容假定您已閱讀這些系統 UI 文章:
本文:
- 假設您熟悉 Android Automotive OS 及其
SystemUIOverlayWindow
的用例。 - 提供
OverlayViewController
的某些子類別的範例。 - 不涉及
OverlayViewController
的子類別。 - 沒有解釋如何設定 Android 進行開發。
- 沒有描述可以在基類中重寫的每個選項。相反,它僅描述建立基本視圖所需的內容。
完成代碼實驗室
步驟 1:為 OverlayViewController 建立佈局
建立名為frameworks/base/packages/CarSystemUI/res/layout/codelab_layout.xml
的檔案以包含以下內容:
<?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>
此佈局建立以下視圖:
步驟2:將ViewStub加入SysUIOverlayWindow
透過將ViewStub新增至SystemUIOverlayWindow
來將檢視新增至視窗。
將下列程式碼加入根FrameLayout
中的frameworks/base/packages/CarSystemUI/res/layout/sysui_overlay_window.xml
中:
<ViewStub android:id="@+id/codelab_stub" android:layout_width="match_parent" android:layout_height="match_parent" android:layout="@layout/codelab_layout"/>
ViewStub 在根FrameLayout
中定義的順序定義了視窗中視圖的 Z 順序。由於此 Codelab 不涉及分層視圖,因此您可以將程式碼片段新增至根FrameLayout
中的任何位置。
第三步:建立一個OverlayViewController
要顯示和隱藏,新版面必須連結到OverlayViewController 。
建立一個名為frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewController.java
可注入OverlayViewController
,其內容如下:
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); } }
步驟4:創建一個OverlayViewMediator
需要一個OverlayViewMediator在顯示或隱藏新視圖時觸發。
建立一個名為frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewMediator.java
新可注入OverlayViewMediator
,其中包含以下內容: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 } }
第 5 步:顯示視圖
為了便於理解並觸發我們的視圖,請在狀態關閉時使用藍牙。
將CodeLabViewMediator#registerListeners
中的// no-op
替換為以下內容:
// 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));
第 6 步:隱藏視圖
當“隱藏!”時,視圖將被隱藏。單擊按鈕。由於此操作僅針對膨脹視圖的按鈕,因此將其直接添加到您的OverlayViewController
中。
將以下方法加入CodeLabViewController
:
@Override protected void onFinishInflate() { getLayout().findViewById(R.id.codelab_button).setOnClickListener(v -> { stop(); }); }
步驟7:設定新的OverlayViewMediator
- 若要將新的 OverlayViewMediator 新增至 OverlayWindowModule,請將下列程式碼新增至OverlayWindowModule :
/** Injects CodeLabViewMediator. */ @Binds @IntoMap @ClassKey(CodeLabViewMediator.class) public abstract OverlayViewMediator bindCodeLabViewMediator( CodeLabViewMediator overlayViewsMediator);
- 若要將新的 OverlayViewMediator 新增至 config_carSystemUIOverlayViewsMediators,請將下列行新增至
frameworks/base/packages/CarSystemUI/res/values/config.xml
中的config_carSystemUIOverlayViewsMediators :<item>com.android.systemui.car.codelab.CodeLabViewMediator</item>
結果
恭喜!您在SystemUIOverlayWindow
中建立了一個檢視:
其他資源
要了解更多信息,請參閱下面提供的資源。
範例 OverlayViewController
將全螢幕使用者切換器視為SystemUIOverlayWindow:
的簡單應用程式:
其他 OverlayViewController
OverlayPanelViewController
OverlayPanelViewController用於在SystemUIOverlayWindow
內顯示和隱藏視圖時提供基本的拖曳動畫。請參閱通知面板以了解更多資訊: