이 페이지에서는 SystemUIOverlayWindow
에서 뷰를 만드는 방법을 설명합니다.
시작하기 전에
아래 제공된 콘텐츠는 귀하가 다음 시스템 UI 문서를 읽었다고 가정합니다.
이 기사:
- 여러분이 Android Automotive OS 및
SystemUIOverlayWindow
사용 사례에 익숙하다고 가정합니다. -
OverlayViewController
의 특정 하위 클래스 예를 제공합니다. -
OverlayViewController
의 하위 클래스를 다루지 않습니다. - 개발을 위해 Android를 설정하는 방법은 설명하지 않습니다.
- 기본 클래스에서 재정의할 수 있는 각 옵션을 설명하지 않습니다. 오히려 기본 보기를 설정하는 데 필요한 항목만 설명합니다.
Codelab 완료
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단계: SysUIOverlayWindow에 ViewStub 추가
SystemUIOverlayWindow
에 ViewStub을 추가하여 창에 뷰를 추가하세요.
FrameLayout
의 frameworks/base/packages/CarSystemUI/res/layout/sysui_overlay_window.xml
에 다음 코드를 추가합니다.
<ViewStub android:id="@+id/codelab_stub" android:layout_width="match_parent" android:layout_height="match_parent" android:layout="@layout/codelab_layout"/>
루트 FrameLayout
에 ViewStub이 정의되는 순서는 창에서 뷰의 Z 순서를 정의합니다. 이 Codelab에는 뷰 레이어링이 포함되지 않으므로 루트 FrameLayout
어디든 코드 스니펫을 추가할 수 있습니다.
3단계: OverlayViewController 생성
표시하거나 숨기려면 새 레이아웃을 OverlayViewController 에 연결해야 합니다.
다음 내용을 사용하여 frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewController.java
이름의 주입 가능한 OverlayViewController
생성하려면:
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 가 필요합니다.
다음 내용을 사용하여frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewMediator.java
라는 새 주입 가능한 OverlayViewMediator
만듭니다.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단계: 뷰 표시
이해를 쉽게 하고 뷰를 트리거하려면 상태가 꺼져 있을 때 Bluetooth를 사용하세요.
// no-op
CodeLabViewMediator#registerListeners
의 no-op를 다음으로 바꾸십시오.
// 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단계: 보기 숨기기
"Hide!"를 선택하면 뷰가 숨겨집니다. 버튼이 클릭되었습니다. 이 작업은 확장된 뷰의 버튼에서만 수행되므로 OverlayViewController
에 직접 추가하세요.
CodeLabViewController
에 다음 메서드를 추가합니다.
@Override protected void onFinishInflate() { getLayout().findViewById(R.id.codelab_button).setOnClickListener(v -> { stop(); }); }
7단계: 새 OverlayViewMediator 구성
- OverlayWindowModule에 새 OverlayViewMediator를 추가하려면 OverlayWindowModule 에 다음 코드를 추가하세요.
/** Injects CodeLabViewMediator. */ @Binds @IntoMap @ClassKey(CodeLabViewMediator.class) public abstract OverlayViewMediator bindCodeLabViewMediator( CodeLabViewMediator overlayViewsMediator);
- config_carSystemUIOverlayViewsMediators에 새 OverlayViewMediator를 추가하려면
frameworks/base/packages/CarSystemUI/res/values/config.xml
config_carSystemUIOverlayViewsMediators 에 다음 줄을 추가하세요.<item>com.android.systemui.car.codelab.CodeLabViewMediator</item>
결과
축하해요! SystemUIOverlayWindow
에서 뷰를 만들었습니다.
추가 리소스
자세한 내용은 아래 제공된 리소스를 참조하세요.
샘플 OverlayViewController
SystemUIOverlayWindow:
의 간단한 애플리케이션으로 전체 화면 사용자 전환기를 참조하세요.
기타 OverlayViewController
OverlayPanelViewController
OverlayPanelViewController 는 SystemUIOverlayWindow
내에서 뷰를 표시하거나 숨길 때 기본 드래그 애니메이션을 제공하는 데 사용됩니다. 자세한 내용은 알림 패널을 참조하세요.