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:

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

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

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:

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:

SystemUIOverlayPencere Yönetim Sistemi