Bu sayfada SystemUIOverlayWindow
nasıl görünüm oluşturulacağı 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 işletim sistemi ve onun
SystemUIOverlayWindow
yönelik kullanım senaryolarına aşina olduğunuzu varsayarız. -
OverlayViewController
belirli alt sınıflarının örneklerini sağlar. -
OverlayViewController
alt sınıflarını ele almaz. - Android'in geliştirme iç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:
Adım 2: SysUIOverlayWindow'a ViewStub ekleyin
SystemUIOverlayWindow
bir ViewStub ekleyerek görünümü pencerenize ekleyin.
Aşağıdaki kodu FrameLayout kökündeki frameworks/base/packages/CarSystemUI/res/layout/sysui_overlay_window.xml
FrameLayout
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 kök FrameLayout
tanımlanma sırası, penceredeki görünümlerin Z sıralamasını tanımlar. Bu codelab katman görünümlerini içermediğinden, kod pasajını kök FrameLayout
herhangi bir yere ekleyebilirsiniz.
3. Adım: OverlayViewController oluşturun
Gösterilmesi ve gizlenmesi için yeni düzenin bir OverlayViewController'a bağlanması gerekir.
Aşağıdaki içeriğe sahip frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewController.java
adında 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); } }
4. Adım: OverlayViewMediator oluşturun
Yeni görünüm gösterildiğinde veya gizlendiğinde tetiklenecek bir OverlayViewMediator gereklidir.
Aşağıdaki içeriğe sahipframeworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewMediator.java
adında 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 } }
5. Adım: Görünümü gösterin
Anlama kolaylığı sağlamak ve görünümümüzü tetiklemek için durum kapalıyken Bluetooth'u kullanın.
CodeLabViewMediator#registerListeners
dosyasındaki // no-op
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ü gizleyin
"Gizle!" seçeneği görüntülendiğinde görünüm gizlenecektir. butonuna tıklanır. Bu eylem yalnızca şişirilmiş görünümün düğmesinde olduğundan, bunu doğrudan OverlayViewController
ekleyin.
CodeLabViewController
aşağıdaki yöntemi ekleyin:
@Override protected void onFinishInflate() { getLayout().findViewById(R.id.codelab_button).setOnClickListener(v -> { stop(); }); }
Adım 7: Yeni OverlayViewMediator'ı yapılandırın
- Yeni OverlayViewMediator'ı OverlayWindowModule'a eklemek için OverlayWindowModule'a aşağıdaki 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
Tam ekran kullanıcı değiştiriciyi SystemUIOverlayWindow:
un basit bir uygulaması olarak görün:
Diğer OverlayView Kontrolörleri
OverlayPanelViewController
OverlayPanelViewController, SystemUIOverlayWindow
içindeki görünümleri gösterirken ve gizlerken temel sürükleme animasyonu sağlamak için kullanılır. Daha fazla bilgi edinmek için Bildirim paneline bakın: