เพิ่มการรองรับ 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 คุณสามารถใช้การกำหนดค่า 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 connectionType = ...
val displayId = context.display.displayId
isRunningOnAndroidAuto = connectionType == CONNECTION_TYPE_PROJECTION and displayId != DEFAULT_DISPLAY