สร้างประสบการณ์การรับส่งข้อความที่ใช้เทมเพลตสําหรับ Android Auto

ประสบการณ์การรับส่งข้อความแบบเทมเพลตเป็นเวอร์ชันเบต้า

ในขณะนี้ ทุกคนสามารถเผยแพร่แอปการสื่อสารที่มีประสบการณ์การรับส่งข้อความแบบเทมเพลตไปยังแทร็กการทดสอบภายในและการทดสอบแบบปิดใน Play Store ได้ โดยจะอนุญาตให้เผยแพร่ไปยังแทร็กการทดสอบแบบเปิดและแทร็กเวอร์ชันที่ใช้งานจริงในภายหลัง

เสนอชื่อตัวเองเพื่อเป็นพาร์ทเนอร์ที่ได้ทดลองใช้ก่อนเปิดตัว →

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

รองรับประสบการณ์การรับส่งข้อความที่ขับเคลื่อนด้วยการแจ้งเตือน

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

สร้างประสบการณ์การรับส่งข้อความแบบเทมเพลต

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

กำหนดค่าไฟล์ Manifest ของแอป

แอปต้องทำสิ่งต่อไปนี้เพื่อแจ้งให้ Android Auto ทราบถึงความสามารถของแอป

ประกาศการรองรับหมวดหมู่ในไฟล์ Manifest

แอปต้องประกาศandroidx.car.app.category.MESSAGING หมวดหมู่แอปในรถยนต์ในตัวกรอง Intent ของ CarAppService

<application>
    ...
   <service
       ...
        android:name=".MyCarAppService"
        android:exported="true">
      <intent-filter>
        <action android:name="androidx.car.app.CarAppService" />
        <category android:name="androidx.car.app.category.MESSAGING"/>
      </intent-filter>
    </service>
    ...
<application>

ตั้งค่าระดับ API ของแอปในรถยนต์ขั้นต่ำ

เนื่องจาก API ConversationItem รองรับเฉพาะใน Car API 7 ขึ้นไป คุณจึงควรตั้งค่าข้อมูลเมตา minCarApiLevel เป็นค่าดังกล่าวด้วย ดูข้อมูลเพิ่มเติมได้ที่ ระดับ API ของแอปในรถยนต์

<application ...>
    ...
    <meta-data
        android:name="androidx.car.app.minCarApiLevel"
        android:value="7"/>
    ...
</application>

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

ในไฟล์ automotive_app_desc.xml ที่คุณใช้เพื่อ ประกาศการรองรับ Android Auto ให้ตรวจสอบว่าได้ประกาศทั้งความสามารถ notification และ template แล้ว

<automotiveApp>
    <uses name="notification" />
    <uses name="template" />
</automotiveApp>

หากแอปสามารถตั้งค่าเป็น ตัวจัดการ SMS เริ่มต้นได้, ให้ใส่องค์ประกอบ <uses> ต่อไปนี้ หากไม่ใส่ ระบบจะใช้ตัวจัดการเริ่มต้นที่สร้างไว้ใน Android Auto เพื่อจัดการข้อความ SMS/MMS ขาเข้า ซึ่งอาจทำให้เกิดการแจ้งเตือนซ้ำ

<automotiveApp>
    ...
    <uses name="sms" />
</automotiveApp>

แสดงการสนทนา

หากต้องการแสดงภาพรวมของการสนทนาของผู้ใช้ คุณสามารถแสดงรายการออบเจ็กต์ ConversationItem ใน ListTemplate หรือ SectionedItemTemplate

เราขอแนะนำให้แสดงการสนทนาล่าสุดหรือสำคัญที่สุดไม่เกิน 5-10 รายการ และแสดงข้อความล่าสุดไม่เกิน 5 รายการสำหรับการสนทนาแต่ละรายการ เพื่อให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่ดี ซึ่งจะช่วยปรับปรุงประสิทธิภาพการโหลด ช่วยให้ผู้ใช้เห็นเนื้อหาที่เกี่ยวข้องมากที่สุด และลดเวลาในการโต้ตอบ

class MyMessagingScreen() : Screen() {

    override fun onGetTemplate(): Template {
        val itemListBuilder = ItemList.Builder()
        val conversations: List<MyConversation> = // Retrieve conversations

        for (conversation: MyConversation in conversations) {
            val carMessages: List<CarMessage> = conversation.getMessages()
                .map { message ->
                    // CarMessage supports additional fields such as MIME type and URI,
                    // which you should set if available
                    CarMessage.Builder()
                        .setSender(message.sender)
                        .setBody(message.body)
                        .setReceivedTimeEpochMillis(message.receivedTimeEpochMillis)
                        .setRead(message.isRead)
                        .build()
                }

            itemListBuilder.addItem(
                ConversationItem.Builder()
                    .setConversationCallback { /* Implement your conversation callback logic here */ }
                    .setId(/* Set conversation ID */)
                    .setTitle(/* Set conversation title */)
                    .setIcon(/* Set conversation icon if available */)
                    .setMessages(carMessages)
                    /* When the sender of a CarMessage is equal to this Person,
                    message readout is adjusted to "you said" instead of "<person>
                    said" */
                    .setSelf(/* Set self-sender */)
                    .setGroupConversation(/* Set if the message contains more than 2 participants */)
                    .build()
            )
        }

        return ListTemplate.Builder()
            .setTitle("Conversations")
            .setHeaderAction(Action.APP_ICON)
            .setSingleList(itemListBuilder.build())
            .build()
    }
}

ConversationItem แต่ละรายการจะแสดงการดำเนินการสำหรับการเล่นข้อความและการทำเครื่องหมายว่าอ่านแล้ว รวมถึงการตอบกลับโดยอัตโนมัติ การดำเนินการเหล่านั้นจะได้รับการจัดการโดย ConversationCallbackDelegate ที่คุณระบุเมื่อ สร้าง ConversationItem

หากแอปมีทางลัดการสนทนา ให้ตรวจสอบ ว่ารหัสที่ระบุเมื่อสร้าง ConversationItem ตรงกับ รหัสของทางลัดการสนทนานั้น

อัปเดตการสนทนา

เมื่อผู้ใช้ส่งและรับข้อความ คุณควรเรียกใช้ invalidate() เพื่อรีเฟรชหน้าจอของแอปให้แสดงข้อความใหม่ ดูรีเฟรช เนื้อหาของเทมเพลต

เราขอแนะนำให้ใช้เวลาในการรีเฟรชไม่เกิน 500 มิลลิวินาทีเพื่อให้ผู้ใช้ได้รับประสบการณ์การใช้งานที่ดีที่สุด หากการรีเฟรชบ่อยๆ ใช้เวลานานขึ้น คุณสามารถแสดงสถานะการโหลดขณะที่โหลดข้อความขาเข้า

ตั้งค่าความสำคัญของการแจ้งเตือนอย่างเหมาะสม

แอปควรกำหนดความสำคัญของการแจ้งเตือนขาเข้าให้ต่ำลงเมื่อผู้ใช้กำลังใช้หรือดูการสนทนาที่เกี่ยวข้อง เพื่อไม่ให้การแจ้งเตือนปรากฏเป็นการแจ้งเตือนแบบป๊อปอัป (HUN)

คุณสามารถติดตามว่าการสนทนาปรากฏอยู่หรือไม่โดยสังเกตวงจรการทำงานของ Screen ที่แสดงการสนทนานั้น ดูวงจรการทำงานของหน้าจอ

หากต้องการไม่ให้การแจ้งเตือนปรากฏเป็น HUN ให้ตั้งค่าลำดับความสำคัญเป็น IMPORTANCE_DEFAULT หรือต่ำกว่า

เผยแพร่แอปรับส่งข้อความแบบเทมเพลต

เนื่องจากแอปที่รองรับประสบการณ์การรับส่งข้อความแบบเทมเพลตจะเผยแพร่ได้เฉพาะในแทร็กการทดสอบภายในและการทดสอบแบบปิดใน Google Play คุณจึงไม่ควรโปรโมตบิลด์ที่มีการรองรับแทร็กการทดสอบแบบเปิดหรือแทร็กเวอร์ชันที่ใช้งานจริง เนื่องจากระบบจะปฏิเสธการส่งที่ประกอบด้วยบิลด์ในแทร็กเหล่านั้น