SystemUIOverlayWindow Codelab

หน้านี้จะอธิบายวิธีสร้างข้อมูลพร็อพเพอร์ตี้ใน SystemUIOverlayWindow

ก่อนจะเริ่มต้น

เนื้อหาด้านล่างนี้ถือว่าคุณได้อ่านบทความเกี่ยวกับ UI ของระบบเหล่านี้แล้ว

บทความนี้ประกอบด้วย

  • สมมติว่าคุณคุ้นเคยกับกรณีการใช้งานของ Android Automotive OS และ SystemUIOverlayWindow
  • ให้ตัวอย่างคลาสย่อยบางรายการของ OverlayViewController
  • ไม่ระบุคลาสย่อยของ OverlayViewController
  • ไม่ได้อธิบายวิธีตั้งค่า Android สำหรับการพัฒนา
  • ไม่อธิบายแต่ละตัวเลือกซึ่งลบล้างได้ในคลาสพื้นฐาน แต่เป็นการอธิบาย เฉพาะรายการที่จําเป็นในการตั้งค่ามุมมองพื้นฐาน

ทำ Codelab ให้เสร็จ

ขั้นตอนที่ 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>

เลย์เอาต์นี้จะสร้างมุมมองต่อไปนี้

วันที่ OverlayViewController
รูปที่ 1 OverlayViewController

ขั้นตอนที่ 2: เพิ่ม ViewStub ลงใน SysUIOverlayWindow

เพิ่มมุมมองลงในหน้าต่างด้วยการเพิ่ม ViewStub เป็น SystemUIOverlayWindow

เพิ่มโค้ดต่อไปนี้ลงใน frameworks/base/packages/CarSystemUI/res/layout/sysui_overlay_window.xml ในราก FrameLayout:

<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

ขั้นตอนที่ 3: สร้าง OverlayViewController

หากต้องการให้แสดงและซ่อน เลย์เอาต์ใหม่จะต้องลิงก์กับ OverlayViewController

วิธีสร้าง OverlayViewController แบบแทรกชื่อ วันที่ frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewController.java ที่มีเนื้อหาต่อไปนี้

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

CANNOT TRANSLATE OverlayViewMediator เพื่อทริกเกอร์เมื่อจำเป็นต้องแสดงหรือซ่อนมุมมองใหม่

สร้าง OverlayViewMediator ที่แทรกใหม่ชื่อ วันที่ frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewMediator.java ที่มีเนื้อหาต่อไปนี้
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: แสดงมุมมอง

ใช้บลูทูธเมื่อสถานะปิดอยู่เพื่อให้ง่ายต่อการทำความเข้าใจและทริกเกอร์มุมมองของเรา

แทนที่ // no-op ใน CodeLabViewMediator#registerListeners ด้วย ดังต่อไปนี้

// 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 เพิ่มบรรทัดต่อไปนี้ใน config_carSystemUIOverlayViewsMediators ใน frameworks/base/packages/CarSystemUI/res/values/config.xml:
    <item>com.android.systemui.car.codelab.CodeLabViewMediator</item>

ผลลัพธ์

ยินดีด้วย คุณได้สร้างข้อมูลพร็อพเพอร์ตี้ใน SystemUIOverlayWindow:

วันที่ SystemUIOverlayWindow
รูปที่ 2 SystemUIOverlayWindow

แหล่งข้อมูลเพิ่มเติม

หากต้องการเรียนรู้เพิ่มเติม โปรดดูแหล่งข้อมูลด้านล่าง

OverlayViewController ตัวอย่าง

ดูตัวสลับผู้ใช้แบบเต็มหน้าจอว่าเป็นแอปพลิเคชันที่ใช้ง่าย SystemUIOverlayWindow::

OverlayViewController อื่นๆ

OverlayPanelViewController

CANNOT TRANSLATE OverlayPanelViewController ใช้เพื่อแสดงภาพเคลื่อนไหวการลากพื้นฐานเมื่อแสดงและซ่อนมุมมองภายใน SystemUIOverlayWindow ดูแผงการแจ้งเตือนเพื่อเรียนรู้เพิ่มเติม