เพิ่มการรองรับ Android Auto ลงในแอปที่หยุดทำงาน

ในอุปกรณ์ที่ใช้ Android 15 ขึ้นไป Android Auto รองรับการเรียกใช้แอปในหมวดหมู่แอปที่หยุดไว้ชั่วคราวที่รองรับบนหน้าจอของจอภาพโดยตรง ดูข้อมูลเพิ่มเติมเกี่ยวกับประสบการณ์ของผู้ใช้แอปที่จอดไว้ใน Android Auto ได้ที่แอปที่จอดไว้

ประกาศการรองรับ Android Auto

หากต้องการประกาศว่าแอปของคุณรองรับ Android Auto คุณต้องใส่องค์ประกอบ <category> ต่อไปนี้ในตัวกรอง Intent ของกิจกรรมในไฟล์ Manifest ของแอป

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        ...
        <category android:name="android.intent.category.CAR_LAUNCHER" />
    </intent-filter>
</activity>

โดยทั่วไป องค์ประกอบหมวดหมู่ android.intent.category.CAR_LAUNCHER สามารถวางไว้ในตัวกรอง Intent เดียวกับองค์ประกอบ android.intent.category.LAUNCHER ได้ แต่อาจวางไว้ในตัวกรองอื่นก็ได้หากต้องการ

รายการไฟล์ Manifest สำหรับหมวดหมู่ที่เฉพาะเจาะจง

นอกเหนือจากข้อกำหนดข้างต้นแล้ว เกมยังมีข้อกำหนดเพิ่มเติม ดูทําเครื่องหมายแอปเป็นเกม

รองรับขนาดหน้าจอ Android Auto ทั่วไป

เพื่อให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่ดีที่สุด เราขอแนะนำให้คุณทำให้แอปปรับขนาดได้อย่างเต็มที่กับหน้าจอขนาดต่างๆ อย่างน้อยที่สุด แอปต้องไม่แสดงแถบดำในแนวตั้งอย่างเห็นได้ชัดบนหน้าจอแนวนอนเพื่อให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่มีคุณภาพสูงในรถยนต์หลากหลายรุ่นที่รองรับ Android Auto ตามที่ระบุไว้ในหลักเกณฑ์ด้านคุณภาพสำหรับแอปรถยนต์ DO-2

ตัวอย่างเช่น หากแอปทำงานในอัตราส่วนภาพแนวตั้งโดยมีการเว้นขอบในแนวตั้งบนหน้าจอแนวนอน ระบบจะปฏิเสธแอประหว่างการตรวจสอบของ Play Store แอปที่ทำงานในอัตราส่วนภาพแนวนอนที่มีแถบดำแนวตั้งน้อยที่สุดบนหน้าจอแนวนอนเป็นที่ยอมรับ เช่นเดียวกับแอปที่ทำงานในอัตราส่วนภาพแนวนอนที่มีแถบดำแนวนอนบนหน้าจอแนวตั้ง

ทดสอบกับขนาดหน้าจอตามแบบฉบับ

เมื่อสร้างและทดสอบแอปสำหรับ Android Auto คุณสามารถใช้การกำหนดค่าส่วนหัวของเดสก์ท็อป (DHU) ต่อไปนี้เพื่อยืนยันว่าแอปเป็นไปตามข้อกำหนดข้างต้น

แนวนอนขนาดเล็ก

[general]
resolution = 800x480
dpi = 160
...

แนวนอนกว้าง

[general]
resolution = 1920x1080
dpi = 160
marginheight = 596
normalizedpi = true
cropmargins = true
...

ภาพบุคคล

[general]
resolution = 1920x1080
dpi = 160
marginwidth = 878
normalizedpi = true
cropmargins = true
...

ตรวจหาการใช้งานใน Android Auto

หากต้องการตรวจจับเมื่อมีการใช้แอปผ่าน Android Auto (เช่น เพื่อวัตถุประสงค์ด้านการวิเคราะห์) ให้ดูสัญญาณ 2 รายการต่อไปนี้

  • สถานะการเชื่อมต่อที่ CarConnection API รายงาน เมื่อเชื่อมต่อ Android Auto ไอคอนนี้จะเปลี่ยนเป็น CONNECTION_TYPE_PROJECTION
  • รหัสที่แสดงของจอแสดงผลที่ใช้งานอยู่ เมื่อแอปทำงานบนจอแสดงผลที่ไม่ใช่หน้าจอในตัว เช่น เมื่อใช้ผ่าน Android Auto ค่านี้จะไม่ใช่ DEFAULT_DISPLAY

ข้อมูลโค้ดต่อไปนี้แสดงวิธีรวมสัญญาณเหล่านี้เข้าด้วยกันเพื่อตรวจหาการใช้งานผ่าน Android Auto

val connectionType = ...
val displayId = context.display.displayId
isRunningOnAndroidAuto = connectionType == CONNECTION_TYPE_PROJECTION and displayId != DEFAULT_DISPLAY