เพิ่มการรองรับ 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 แต่จะวางไว้ในตัวกรอง Intent อื่นก็ได้หากต้องการ

รายการไฟล์ Manifest เฉพาะหมวดหมู่

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

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

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

ตัวอย่างเช่น หากแอปทำงานในอัตราส่วนแนวตั้งโดยมีการใส่แถบด้านข้างบนหน้าจอแนวนอน ระบบจะปฏิเสธแอปดังกล่าวระหว่างการตรวจสอบใน 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 displayId = context.display?.displayId ?: DEFAULT_DISPLAY
isRunningOnAndroidAuto = (connectionType == CONNECTION_TYPE_PROJECTION) && (displayId != DEFAULT_DISPLAY)