กำหนดค่าไฟล์ Manifest

กำหนดค่าไฟล์ Manifest ของแอปให้ผสานรวมกับ Android Auto และ Android Automotive OS (AAOS) หากต้องการให้แพลตฟอร์มเหล่านี้ค้นพบและเชื่อมต่อได้ ให้ประกาศบริการเบราว์เซอร์สื่อใน Manifest ระบุไอคอนแอปที่จำเป็น ซึ่งรวมถึงไอคอน Launcher สำหรับไอคอนการระบุแหล่งที่มาที่คอมโพเนนต์ UI ของระบบ เช่น การควบคุมสื่อ จะใช้

ดูข้อมูลเพิ่มเติมเกี่ยวกับไฟล์ Manifest ได้ที่ ภาพรวมของ Manifest ของแอป

ประกาศบริการเบราว์เซอร์สื่อ

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

ข้อมูลโค้ดนี้แสดงวิธีประกาศบริการเบราว์เซอร์สื่อใน Manifest ส่วนถัดไปของคู่มือนี้ ซึ่งก็คือสร้างบริการเบราว์เซอร์สื่อ จะแสดงรายละเอียดขั้นตอนการใช้งานบริการ

<application>
    ...
    <service android:name=".MyMediaBrowserService"
             android:exported="true">
        <intent-filter>
            <action android:name="android.media.browse.MediaBrowserService"/>
        </intent-filter>
    </service>
    ...
</application>

ระบุไอคอนแอป

หากต้องการแสดงแอปใน UI ของระบบ ให้ระบุไอคอนแอปที่ Android Auto และ AAOS ควรใช้ คุณต้องระบุไอคอน 2 รายการต่อไปนี้

• กำหนดไอคอน Launcher
• กำหนดไอคอนการระบุแหล่งที่มา

กำหนดไอคอน Launcher

ไอคอน Launcher จะแสดงแอปของคุณใน UI ของระบบ เช่น ใน Launcher และในถาดไอคอน

โดยค่าเริ่มต้น ระบบจะใช้แอตทริบิวต์ android:icon ขององค์ประกอบ <application> ของแอปเป็นไอคอน Launcher

<application
    ...
    android:icon="@mipmap/ic_launcher"
>

หากต้องการใช้ไอคอนอื่น ให้ตั้งค่าแอตทริบิวต์ android:icon ขององค์ประกอบ <service> ของบริการเบราว์เซอร์สื่อ

<application>
    ...
    <service
        ...
        android:icon="@mipmap/ic_car_launcher"/>
</application>

กำหนดไอคอนการระบุแหล่งที่มา

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

รูปที่ 1 ไอคอนการระบุแหล่งที่มาในการ์ดสื่อ

คุณสามารถระบุไอคอนที่จะใช้แสดงแอปได้โดยใช้การประกาศ Manifest นี้

<application>
    ...
    <meta-data
        android:name="androidx.car.app.TintableAttributionIcon"
        android:resource="@drawable/ic_status_icon" />
    ...
</application>

ระบุป้ายกำกับของแอป

โดยค่าเริ่มต้น ระบบจะใช้ค่าของแอตทริบิวต์ android:label ขององค์ประกอบ <application> ของแอปเป็นชื่อที่แสดงสำหรับแอปในหน้าจอรถ

หากต้องการใช้ชื่อที่แสดงอื่น หรือหากแอปมีบริการเบราว์เซอร์สื่อหลายรายการ ให้ตั้งค่าแอตทริบิวต์ android:label ขององค์ประกอบของบริการเบราว์เซอร์สื่อ <service>

ระบุสีเน้นของแอป

Android Auto และ AAOS จะใช้สีเน้นของแอปเพื่อจัดรูปแบบการควบคุมการเล่นและองค์ประกอบ UI อื่นๆ

โดยค่าเริ่มต้น ระบบจะดึงสีเน้นจากรายการ colorAccent ของแหล่งข้อมูลสไตล์ android:theme ขององค์ประกอบ <application> ของแอป

หากต้องการใช้สีเน้นอื่นสำหรับประสบการณ์การใช้งานในรถ ให้ใส่องค์ประกอบ <meta-data> สำหรับแหล่งข้อมูลสไตล์อื่นที่มีรายการ colorAccent

<application>
    ...
    <meta-data
        android:name="com.google.android.gms.car.application.theme"
        android:resource="@style/THEME_NAME"/>
    ...
</application>

การกำหนดค่าเฉพาะแพลตฟอร์ม

นอกจากการกำหนดค่าที่มีรายละเอียดในหน้านี้แล้ว โปรดดูข้อกำหนดเฉพาะแพลตฟอร์มในส่วนต่อไปนี้

• เพิ่มการรองรับ Android Auto ลงในแอปสื่อ
• เพิ่มการรองรับ Android Automotive OS ลงในแอปสื่อ