SystemUIOverlayWindow Lab code

דף זה מסביר כיצד ליצור תצוגה ב- SystemUIOverlayWindow .

לפני שאתה מתחיל

התוכן המופיע להלן מניח שקראת את המאמרים הבאים של ממשק המערכת:

• הטמעת ממשק המשתמש של המערכת
• SystemUIOverlay מערכת ניהול חלונות

המאמר הזה:

• מניח שאתה מכיר מקרי שימוש עבור מערכת ההפעלה Android Automotive ו- SystemUIOverlayWindow שלה.
• מספק דוגמאות של תת-מחלקות מסוימות של OverlayViewController .
• אינו מתייחס לסוגי משנה של OverlayViewController .
• לא מסביר איך להגדיר את אנדרואיד לפיתוח.
• לא מתאר כל אפשרות שניתן לעקוף במחלקות בסיס. במקום זאת, הוא מתאר רק את אלה הדרושים להגדרת תצוגה בסיסית.

השלם את מעבדת הקוד

שלב 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 .

הוסף את הקוד הבא ל- 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"/>

הסדר שבו מוגדרים ViewStubs בבסיס FrameLayout מגדיר את סדר ה-Z של התצוגות בחלון. מכיוון שמעבדת קוד זה אינה כרוכה בתצוגות שכבות, אתה יכול להוסיף את קטע הקוד בכל מקום בבסיס 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

נדרש 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: הצג את התצוגה

כדי להקל על ההבנה וכדי להפעיל את התצוגה שלנו, השתמש ב-Bluetooth כאשר המצב כבוי.

החלף את // 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 :

משאבים נוספים

למידע נוסף, עיין במשאבים המופיעים להלן.

דגם OverlayViewController

ראה את מחליף המשתמשים במסך מלא כיישום פשוט של SystemUIOverlayWindow: :

• FullScreenUserSwitcherViewController
• FullscreenUserSwitcherViewMediator

OverlayViewControllers אחרים

OverlayPanelViewController

OverlayPanelViewController משמש כדי לספק אנימציית גרירה בסיסית בעת הצגת והסתרה של תצוגות בתוך SystemUIOverlayWindow . עיין בלוח ההתראות למידע נוסף:

• NotificationPanelViewController
• NotificationPanelViewMediator