SystemUIOverlayWindow Codelab

يشرح هذا المقال كيفية إنشاء طريقة عرض في SystemUIOverlayWindow .

قبل ان تبدا

يفترض المحتوى الوارد أدناه أنك قرأت مقالات واجهة مستخدم النظام هذه:

هذه المقالة:

يفترض أنك على دراية بحالات استخدام نظام التشغيل Android Automotive ونظام التشغيل 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 .

أضف الكود التالي إلى 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: إظهار العرض

لسهولة الفهم ولإثارة وجهة نظرنا ، استخدم البلوتوث عند إيقاف الحالة.

استبدل // 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 الجديد

لإضافة OverlayViewMediator الجديد إلى OverlayWindowModule ، أضف التعليمات البرمجية التالية إلى OverlayWindowModule :

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

لإضافة OverlayViewMediator الجديد إلى config_carSystemUIOverlayViewsMediators ، أضف السطر التالي إلى config_carSystemUIOverlayViewsMediators في frameworks/base/packages/CarSystemUI/res/values/config.xml :
```
<item>com.android.systemui.car.codelab.CodeLabViewMediator</item>
```

نتيجة

تهانينا! قمت بإنشاء عرض في SystemUIOverlayWindow :

نظام التشغيل — **الشكل 2.** SystemUIOverlayWindow

مصادر إضافية

لمعرفة المزيد ، راجع الموارد المتوفرة أدناه.

عينة OverlayViewController

انظر إلى مبدل المستخدم بملء الشاشة كتطبيق مباشر لنظام SystemUIOverlayWindow: :

أخرى OverlayViewControllers

OverlayPanelViewController

يتم استخدام OverlayPanelViewController لتوفير الرسوم المتحركة الأساسية للسحب عند إظهار وإخفاء العروض داخل SystemUIOverlayWindow . انظر لوحة الإخطارات لمعرفة المزيد:

SystemUIOverlayWindow نظام إدارة