หน้านี้จะอธิบายวิธีสร้างข้อมูลพร็อพเพอร์ตี้ใน 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: เพิ่ม 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"/>
ลำดับการกำหนด ViewStub ในรูท 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
CANNOT TRANSLATE 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:
:
OverlayViewController อื่นๆ
OverlayPanelViewController
CANNOT TRANSLATE
OverlayPanelViewController
ใช้เพื่อแสดงภาพเคลื่อนไหวการลากพื้นฐานเมื่อแสดงและซ่อนมุมมองภายใน
SystemUIOverlayWindow
ดูแผงการแจ้งเตือนเพื่อเรียนรู้เพิ่มเติม