เพิ่มการรองรับ 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 แอปที่ทำงานในสัดส่วนภาพแนวนอนโดยมีแถบสีดำด้านข้างน้อยที่สุดบนหน้าจอแนวนอนนั้นเป็นที่ยอมรับ เช่นเดียวกับแอปที่ทำงานในสัดส่วนภาพแนวนอนโดยมีแถบสีดำด้านบนและด้านล่างบนหน้าจอแนวตั้ง

ทดสอบกับขนาดหน้าจอ Canonical

เมื่อสร้างและทดสอบแอปสำหรับ Android Auto คุณสามารถใช้การกำหนดค่า Desktop Head Unit (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 displayId = context.display?.displayId ?: DEFAULT_DISPLAY
isRunningOnAndroidAuto = (connectionType == CONNECTION_TYPE_PROJECTION) && (displayId != DEFAULT_DISPLAY)