SystemUIOverlayWindow Codelab

Bu makale, SystemUIOverlayWindow bir görünümün nasıl oluşturulacağını açıklar.

Başlamadan önce

Aşağıda sağlanan içerik, bu Sistem Kullanıcı Arayüzü makalelerini okuduğunuzu varsaymaktadır:

Bu makale:

  • Android Automotive OS ve SystemUIOverlayWindow için kullanım örneklerine aşina olduğunuzu varsayar.
  • OverlayViewController belirli alt sınıflarının örneklerini sağlar.
  • OverlayViewController alt sınıflarını ele almaz.
  • Geliştirme için Android'in nasıl kurulacağını açıklamıyor.
  • Temel sınıflarda geçersiz kılınabilecek her seçeneği açıklamaz. Bunun yerine, yalnızca temel bir görünüm oluşturmak için gerekenleri açıklar.

Codelab'i tamamlayın

Adım 1: OverlayViewController için bir düzen oluşturun

Aşağıdakileri içerecek şekilde frameworks/base/packages/CarSystemUI/res/layout/codelab_layout.xml adlı bir dosya oluşturun:

<?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>

Bu düzen aşağıdaki görünümü oluşturur:

OverlayViewController
Şekil 1. OverlayViewController

2. Adım: SysUIOverlayWindow'a bir ViewStub ekleyin

SystemUIOverlayWindow öğesine bir ViewStub ekleyerek görünümü pencerenize ekleyin.

FrameLayout kök dizinindeki frameworks/base/packages/CarSystemUI/res/layout/sysui_overlay_window.xml FrameLayout kodu ekleyin:

<ViewStub android:id="@+id/codelab_stub"
          android:layout_width="match_parent"
          android:layout_height="match_parent"
          android:layout="@layout/codelab_layout"/>

ViewStub'ların FrameLayout kökünde tanımlanma sırası, penceredeki görünümlerin Z sıralamasını tanımlar. Bu codelab, katmanlama görünümleri içermediğinden, kod parçacığını FrameLayout kökünün herhangi bir yerine ekleyebilirsiniz.

3. Adım: Bir OverlayViewController oluşturun

Gösterilmesi ve gizlenmesi için yeni düzen bir OverlayViewController ile bağlantılı olmalıdır.

Aşağıdaki içeriğe sahip frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewController.java OverlayViewController adlı enjekte edilebilir bir OverlayViewController oluşturmak için:

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);
    }
}

Adım 4: Bir OverlayViewMediator Oluşturun

Yeni görünüm gösterildiğinde veya gizlendiğinde tetiklenecek bir OverlayViewMediator gerekli.

frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewMediator.java OverlayViewMediator adlı yeni bir enjekte edilebilir OverlayViewMediator oluşturun:
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 } }

Adım 5: Görünümü Göster

Anlamayı kolaylaştırmak ve görüşümüzü tetiklemek için durum kapalıyken Bluetooth'u kullanın.

// no-op CodeLabViewMediator#registerListeners aşağıdakiyle değiştirin:

// 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. Adım: Görünümü Gizle

Görünüm "Gizle!" butonu tıklanır. Bu işlem yalnızca şişirilmiş görünümün düğmesinde olduğundan, bunu doğrudan OverlayViewController .

CodeLabViewController aşağıdaki yöntemi ekleyin:

@Override
protected void onFinishInflate() {
    getLayout().findViewById(R.id.codelab_button).setOnClickListener(v -> {
        stop();
    });
}

7. Adım: Yeni OverlayViewMediator'ı yapılandırın

  1. Yeni OverlayViewMediator'ı OverlayWindowModule'a eklemek için OverlayWindowModule'a şu kodu ekleyin:
    /** Injects CodeLabViewMediator. */
    @Binds
    @IntoMap
    @ClassKey(CodeLabViewMediator.class)
    public abstract OverlayViewMediator bindCodeLabViewMediator(
            CodeLabViewMediator overlayViewsMediator);
    
  2. Yeni OverlayViewMediator'ı config_carSystemUIOverlayViewsMediators'a eklemek için frameworks/base/packages/CarSystemUI/res/values/config.xml içindeki config_carSystemUIOverlayViewsMediators'a aşağıdaki satırı ekleyin:
    <item>com.android.systemui.car.codelab.CodeLabViewMediator</item>
    

Sonuç

Tebrikler! SystemUIOverlayWindow bir görünüm oluşturdunuz:

SystemUIOverlayWindow
Şekil 2. SystemUIOverlayWindow

Ek kaynaklar

Daha fazla bilgi edinmek için aşağıda sağlanan kaynaklara bakın.

Örnek OverlayViewController

SystemUIOverlayWindow: :

Diğer OverlayViewControllers

OverlayPanelViewController

SystemUIOverlayWindow içinde görünümleri gösterirken ve SystemUIOverlayWindow temel sürükleme animasyonu sağlamak için bir OverlayPanelViewController kullanılır. Daha fazla bilgi edinmek için Bildirim paneline bakın: