ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP
ภาพรวม
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
AppCard คือการจัดกลุ่มองค์ประกอบ UI ที่มีการจัดรูปแบบซึ่งควบคุมโดย OEM
และมีข้อมูลที่แอปให้ไว้ AppCard จะแสดงข้อมูลและฟังก์ชันการทำงานที่เกี่ยวข้องมากที่สุดของแอปต่อผู้ใช้ในลักษณะที่เข้าถึงได้และพร้อมใช้งานเสมอ
รูปที่ 1 คอมโพเนนต์ AppCard
นักพัฒนาแอปบุคคลที่สามสามารถใช้ AppCard เพื่อทำสิ่งต่อไปนี้ได้
- แสดงสถานะของคำสั่งซื้ออาหารแบบนำกลับบ้านต่อคนขับขณะที่กำลังเดินทาง
- แสดงรูปภาพต่อผู้โดยสารในยานพาหนะเพื่อสร้างบรรยากาศที่น่าพึงพอใจ
- ติดตามและอัปเดตราคาของเหรียญคริปโตเป็นระยะๆ สำหรับนักลงทุน
ตัวอย่างเช่น
รูปที่ 2 ตัวอย่าง AppCard
AppCard
แหล่งที่มา: AppCard.kt
AppCard คือออบเจ็กต์ที่เก็บข้อมูล เรารองรับ ImageAppCard ที่มี
2 สถานะ เมื่อกำหนด AppCard ประเภทใดก็ตาม องค์ประกอบแต่ละรายการต้องมี
รหัสที่ไม่ซ้ำกัน
รูปที่ 3 รูปภาพที่มีข้อความ
|
รูปที่ 4 แถบความคืบหน้าและปุ่มที่มีข้อความ
|
ContentProvider ของ AppCard
แหล่งที่มา: AppCardContentProvider.kt
ผู้ให้บริการเนื้อหาที่อยู่ในแอป สร้าง AppCard และได้รับการเริ่มต้น
และสื่อสารกับ AppCardHost ดูข้อมูลเพิ่มเติมได้ที่
AppCardContentProviderExtension
AppCard Host
แหล่งที่มา: AppCardHost.kt
แอปของระบบที่เชื่อมต่อกับ AppCardContentProvider เพื่อแสดงและจัดการ
การ์ดแอป ดูข้อมูลเพิ่มเติมได้ที่กำหนดค่าโฮสต์ AppCard
บริบทของ AppCard
แหล่งที่มา: AppCardContext.kt
ออบเจ็กต์ที่ให้คำแนะนำแก่ AppCardContentProvider เกี่ยวกับวิธีที่
AppCardHost อาจแสดง AppCard AppCardContext มีข้อมูลต่อไปนี้
ข้อมูลนี้ช่วยให้นักพัฒนา AppCard เพิ่มประสิทธิภาพข้อมูลที่ส่งไปยัง
โฮสต์ได้
ตัวอย่างเนื้อหาและโค้ดในหน้าเว็บนี้ขึ้นอยู่กับใบอนุญาตที่อธิบายไว้ในใบอนุญาตการใช้เนื้อหา Java และ OpenJDK เป็นเครื่องหมายการค้าหรือเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-27 UTC
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2025-07-27 UTC"],[],[],null,["# Overview\n\nAn *AppCard* is a grouping of UI elements with styling controlled by the OEM,\nand populated with information provided by apps. AppCards display an app's most\nrelevant data and functionality to users in a way that is accessible and always\navailable.\n\n**Figure 1.** AppCard components.\n\nThird-party developers can use AppCards to:\n\n- Display the status of a takeout food order to a driver while en route.\n- Show photos to passengers in vehicles to form a pleasant ambiance.\n- Track and periodically update the price of crypto coins for investors.\n\nExamples include:\n\n**Figure 2.** AppCard examples.\n\nAppCard\n-------\n\n**Source:** [`AppCard.kt`](https://android.googlesource.com/platform/packages/apps/Car/libs/+/refs/tags/ub-automotive-master-20250418/car-app-card-lib/app-card/src/main/java/com/android/car/appcard/AppCard.kt)\n\nAn AppCard is an object that holds data. We support an `ImageAppCard`, that has\ntwo states. When defining any type of AppCard, each component must have a\nunique ID.\n\n|--------------------------------|---------------------------------------------------|\n| **Figure 3.** Image with text. | **Figure 4.** Progress bar and buttons with text. |\n\nAppCard ContentProvider\n-----------------------\n\n**Source:** [`AppCardContentProvider.kt`](https://android.googlesource.com/platform/packages/apps/Car/libs/+/refs/tags/ub-automotive-master-20250418/car-app-card-lib/app-card/src/main/java/com/android/car/appcard/AppCardContentProvider.kt)\n\nA content provider that exists in an app, creates AppCards, and is instantiated\nand communicates with `AppCardHost`. To learn more, see\n[AppCardContentProviderExtension](/docs/automotive/unbundled_apps/appcards/appcard#override).\n\nAppCard Host\n------------\n\n**Source:** [`AppCardHost.kt`](https://android.googlesource.com/platform/packages/apps/Car/libs/+/refs/tags/ub-automotive-master-20250418/car-app-card-host-lib/app-card-host/src/main/java/com/android/car/appcard/host/AppCardHost.kt)\n\nA system app that connects to `AppCardContentProvider`(s) to display and manage\nApp Cards. To learn more, see [Configure an AppCard host](/docs/automotive/unbundled_apps/appcards/host).\n\nAppCard Context\n---------------\n\n**Source:** [`AppCardContext.kt`](https://android.googlesource.com/platform/packages/apps/Car/libs/+/refs/tags/ub-automotive-master-20250418/car-app-card-lib/app-card/src/main/java/com/android/car/appcard/AppCardContext.kt)\n\nAn object that provides hints to an `AppCardContentProvider` about how an\n`AppCardHost` might display an AppCard. `AppCardContext` contains this\ninformation:\n\n- API level\n- Refresh period for:\n\n - Complete AppCard updates\n - AppCard components tagged with `EnforceFastUpdateRate`\n- Is the host to support interactions with AppCard?\n\n- Maximum image size:\n\n - Center image\n - Button image\n - Header image\n- Minimum number of buttons expected to be displayed.\n\nThis information allows AppCard developers to optimize the information sent to\nhosts."]]
