Sistem Arayüzü YerleşimiPenceresi codelab'i

Bu sayfada, SystemUIOverlayWindow kullanarak nasıl görünüm oluşturacağınız açıklanmaktadır.

Başlamadan önce

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

Bu makale:

  • Android Automotive OS'in ve Android Automotive OS'in kullanım alanları hakkında bilgi sahibi olduğunuz SystemUIOverlayWindow
  • OverlayViewController öğesinin belirli alt sınıflarına örnekler verir.
  • OverlayViewController alt sınıflarını ele almaz.
  • Android'in geliştirme için nasıl kurulacağı açıklanmıyor.
  • Temel sınıflarda geçersiz kılınabilecek seçeneklerin her birini açıklamaz. Bunun yerine temel bir görünüm oluşturmak için gerekli olanlar

Codelab'i tamamlama

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

Şu adla bir dosya oluşturun: frameworks/base/packages/CarSystemUI/res/layout/codelab_layout.xml. şunları içermelidir: 

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

Bindirme Görüntüleme Denetleyicisi
Şekil 1. OverlayViewController
'nı inceleyin.

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

Pencereye görünüm eklemek için ViewStub - SystemUIOverlayWindow.

Aşağıdaki kodu şuraya ekleyin: frameworks/base/packages/CarSystemUI/res/layout/sysui_overlay_window.xml. kök FrameLayout içinde: 

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

ViewStubs'ların kökte (FrameLayout) tanımlanma sırası Penceredeki görünümlerin Z-sıralaması Bu codelab, görünüm katmanları içermediğinden kod snippet'ini kök FrameLayout dosyasında herhangi bir yere ekleyin.

3. Adım: Bir OverlayViewController oluşturun

Yeni düzenin gösterilmesi ve gizlenmesi için OverlayViewController hakkında daha fazla bilgi edinebilirsiniz.

Adlandırılmış, eklenebilir OverlayViewController oluşturmak için frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewController.java aşağıdaki içerikle:

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. Adım: Bir OverlayViewMediator oluşturun

OverlayViewMediator için tetikleyici oluşturma seçeneğine sahip olursunuz.

Adlandırılmış yeni bir eklenebilir OverlayViewMediator oluşturun frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewMediator.java aşağıdaki içerikle: 
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. Adım: Görünümü gösterin

Anlama kolaylığı ve görünümün tetiklenmesi için durum kapalı olduğunda Bluetooth'u kullanın.

CodeLabViewMediator#registerListeners içindeki // no-op değerini şununla değiştir: şu:

// 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ü gizleyin

"Gizle!" düğmesi eklendiğinde görünüm gizlenir. düğmesi tıklanır. Bu işlemden bu yana bunu yalnızca şişirilmiş görünümün düğmesinde doğrudan size ekleyin OverlayViewController.

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

Sonuç

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

Sistem Arayüzü Yer PaylaşımlıPenceresi
Şekil 2. SystemUIOverlayWindow
'nı inceleyin.

Ek kaynaklar

Daha fazla bilgi edinmek için aşağıda verilen kaynaklara göz atın.

Örnek OverlayViewController

Tam ekran kullanıcı değiştiriciyi basit bir SystemUIOverlayWindow::

Diğer OverlayViewController'lar

Bindirme Paneli Görünümü Denetleyicisi

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