SystemUIOverlayWindow 程式碼實驗室

本頁介紹如何在SystemUIOverlayWindow中建立檢視。

在你開始之前

以下提供的內容假定您已閱讀這些系統 UI 文章：

• 實現系統使用者介面
• SystemUIOverlay視窗管理系統

本文：

• 假設您熟悉 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在顯示或隱藏新視圖時觸發。

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

1. 若要將新的 OverlayViewMediator 新增至 OverlayWindowModule，請將下列程式碼新增至OverlayWindowModule ：

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

2. 若要將新的 OverlayViewMediator 新增至 config_carSystemUIOverlayViewsMediators，請將下列行新增至frameworks/base/packages/CarSystemUI/res/values/config.xml中的config_carSystemUIOverlayViewsMediators ：

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

結果

恭喜！您在SystemUIOverlayWindow中建立了一個檢視：

其他資源

要了解更多信息，請參閱下面提供的資源。

範例 OverlayViewController

將全螢幕使用者切換器視為SystemUIOverlayWindow:的簡單應用程式：

• 全螢幕使用者切換器視圖控制器
• 全螢幕UserSwitcherViewMediator

其他 OverlayViewController

OverlayPanelViewController

OverlayPanelViewController用於在SystemUIOverlayWindow內顯示和隱藏視圖時提供基本的拖曳動畫。請參閱通知面板以了解更多資訊：

• 通知面板視圖控制器
• 通知面板視圖中介器