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

. keywords_public: Android Auto, Android Automotive OS, AAOS, Manifest, Media Browser Service, App Icons, Car UI, Manifest Configuration, Media App, Car Development

กำหนดค่าไฟล์ 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 แสดงแอปของคุณใน 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> ของแอปเป็นชื่อที่แสดงสำหรับแอปในหน้าจอรถยนต์

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

ระบุสีเฉพาะจุดของแอป

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>

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

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