หน้านี้อธิบายวิธีสร้างมุมมองใน SystemUIOverlayWindow
ก่อนคุณเริ่ม
เนื้อหาที่ให้ไว้ด้านล่างนี้ถือว่าคุณได้อ่านบทความ System 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: เพิ่ม ViewStub ไปยัง SysUIOverlayWindow
เพิ่มมุมมองให้กับหน้าต่างของคุณโดยเพิ่ม ViewStub ให้กับ SystemUIOverlayWindow
เพิ่มโค้ดต่อไปนี้ใน frameworks/base/packages/CarSystemUI/res/layout/sysui_overlay_window.xml
ในรูท FrameLayout
:
<ViewStub android:id="@+id/codelab_stub" android:layout_width="match_parent" android:layout_height="match_parent" android:layout="@layout/codelab_layout"/>
ลำดับที่ ViewStubs ถูกกำหนดไว้ในรูท FrameLayout
จะกำหนดการเรียงลำดับ Z ของมุมมองในหน้าต่าง เนื่องจาก Codelab นี้ไม่เกี่ยวข้องกับการแบ่งชั้นมุมมอง คุณจึงเพิ่มข้อมูลโค้ดได้ทุกที่ใน FrameLayout
ระดับราก
ขั้นตอนที่ 3: สร้าง OverlayViewController
หากต้องการแสดงและซ่อน เค้าโครงใหม่จะต้องเชื่อมโยงกับ OverlayViewController
หากต้องการสร้าง OverlayViewController
แบบฉีดได้ชื่อ frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewController.java
โดยมีเนื้อหาต่อไปนี้:
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 เพื่อทริกเกอร์เมื่อมีการแสดงหรือซ่อนมุมมองใหม่
สร้างOverlayViewMediator
ที่สามารถฉีดได้ใหม่ชื่อ frameworks/base/packages/CarSystemUI/src/com/android/systemui/car/codelab/CodeLabViewMediator.java
โดยมีเนื้อหาต่อไปนี้: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: แสดงมุมมอง
เพื่อความสะดวกในการทำความเข้าใจและเรียกใช้มุมมองของเรา ให้ใช้บลูทูธเมื่อสถานะปิดอยู่
แทนที่ // no-op
ใน CodeLabViewMediator#registerListeners
ด้วยสิ่งต่อไปนี้:
// 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: ซ่อนมุมมอง
มุมมองจะถูกซ่อนไว้เมื่อ "ซ่อน!" คลิกปุ่มแล้ว เนื่องจากการกระทำนี้เฉพาะบนปุ่มของมุมมองที่สูงเกินจริง ให้เพิ่มสิ่งนี้ให้กับคุณโดยตรง OverlayViewController
เพิ่มวิธีการต่อไปนี้ใน CodeLabViewController
:
@Override protected void onFinishInflate() { getLayout().findViewById(R.id.codelab_button).setOnClickListener(v -> { stop(); }); }
ขั้นตอนที่ 7: กำหนดค่า OverlayViewMediator ใหม่
- หากต้องการเพิ่ม OverlayViewMediator ใหม่ให้กับ OverlayWindowModule ให้เพิ่มโค้ดต่อไปนี้ใน OverlayWindowModule :
/** Injects CodeLabViewMediator. */ @Binds @IntoMap @ClassKey(CodeLabViewMediator.class) public abstract OverlayViewMediator bindCodeLabViewMediator( CodeLabViewMediator overlayViewsMediator);
- หากต้องการเพิ่ม OverlayViewMediator ใหม่ให้กับ config_carSystemUIOverlayViewsMediators ให้เพิ่มบรรทัดต่อไปนี้ใน config_carSystemUIOverlayViewsMediators ใน
frameworks/base/packages/CarSystemUI/res/values/config.xml
:<item>com.android.systemui.car.codelab.CodeLabViewMediator</item>
ผลลัพธ์
ยินดีด้วย! คุณสร้างมุมมองใน SystemUIOverlayWindow
:
แหล่งข้อมูลเพิ่มเติม
หากต้องการเรียนรู้เพิ่มเติม โปรดดูแหล่งข้อมูลด้านล่าง
ตัวอย่าง OverlayViewController
ดูตัวสลับผู้ใช้แบบเต็มหน้าจอเป็นแอปพลิเคชันที่ตรงไปตรงมาของ SystemUIOverlayWindow:
:
OverlayViewControllers อื่น ๆ
โอเวอร์เลย์พาเนลวิวคอนโทรลเลอร์
OverlayPanelViewController ใช้เพื่อจัดเตรียมภาพเคลื่อนไหวการลากพื้นฐานเมื่อแสดงและซ่อนมุมมองภายใน SystemUIOverlayWindow
ดูแผงการแจ้งเตือนเพื่อเรียนรู้เพิ่มเติม: