แอปสื่อที่ใช้เทมเพลต Car App Library สามารถปรับแต่งประสบการณ์การเลือกดูและการเล่นสื่อได้ พร้อมทั้งมั่นใจได้ว่าประสบการณ์ดังกล่าวได้รับการเพิ่มประสิทธิภาพสำหรับหน้าจอรถยนต์และลดการรบกวนสมาธิขณะขับรถ
คู่มือนี้ถือว่าคุณมีแอปสื่อที่เล่นเสียงในโทรศัพท์อยู่แล้ว และแอปสื่อของคุณเป็นไปตามสถาปัตยกรรมแอปสื่อของ Android ไลบรารีแอปสำหรับรถยนต์ช่วยให้คุณแทนที่ประสบการณ์การใช้งานในแอปด้วยเทมเพลตแทนประสบการณ์ที่สร้างขึ้นโดยใช้โครงสร้างข้อมูลสร้างแอปสื่อสำหรับรถยนต์
MediaBrowser คุณยังคงต้องระบุ MediaSession
สำหรับตัวควบคุมการเล่น และ MediaBrowserService หรือ MediaLibraryService
ซึ่งใช้สำหรับวิดีโอแนะนำและประสบการณ์การใช้งานอัจฉริยะอื่นๆ
กำหนดค่าไฟล์ Manifest ของแอป
นอกเหนือจากขั้นตอนที่อธิบายไว้ในการใช้ไลบรารีแอป Android สำหรับรถยนต์แล้ว แอปสื่อที่ใช้เทมเพลตยังต้องมีสิ่งต่อไปนี้ด้วย
ประกาศการรองรับหมวดหมู่ในไฟล์ Manifest
แอปของคุณต้องประกาศandroidx.car.app.category.MEDIA
หมวดหมู่แอปสำหรับรถยนต์ในตัวกรอง
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.MEDIA"/>
</intent-filter>
</service>
...
<application>
หากต้องการเข้าถึง MediaPlaybackTemplate แอปของคุณยังต้องประกาศสิทธิ์ androidx.car.app.MEDIA_TEMPLATES ในไฟล์ Manifest ด้วย ดังนี้
<manifest ...>
...
<uses-permission android:name="androidx.car.app.MEDIA_TEMPLATES"/>
...
</manifest>
ตั้งค่าระดับ API ขั้นต่ำของแอปสำหรับรถยนต์
แอปสื่อที่ใช้ MediaPlaybackTemplate จะรองรับเฉพาะใน CAL API 8 ขึ้นไปเท่านั้น โปรดตรวจสอบว่าได้ตั้งค่า Car App API level ขั้นต่ำเป็น 8
<application ...>
...
<meta-data
android:name="androidx.car.app.minCarApiLevel"
android:value="8"/>
...
</application>
ระบุไอคอนการระบุแหล่งที่มา
อย่าลืมเพิ่มไอคอนการแสดงที่มาสำหรับแอปสื่อที่สร้างโดยใช้คลังแอปสำหรับรถยนต์
ประกาศการรองรับ Android Auto
ตรวจสอบว่าไฟล์ Manifest ของแอปมีข้อมูลต่อไปนี้
<application>
...
<meta-data android:name="com.google.android.gms.car.application"
android:resource="@xml/automotive_app_desc"/>
...
</application>
จากนั้นเพิ่มการประกาศ template ลงใน automotive_app_desc.xml ในทรัพยากร XML โดยควรมีลักษณะดังนี้
<automotiveApp xmlns:android="http://schemas.android.com/apk/res/android">
<uses name="media"/>
<uses name="template"/>
</automotiveApp>
ประกาศการรองรับ Android Automotive OS
คุณเผยแพร่แอปสื่อที่เปิดใช้ Car App Library ใน Android Automotive OS ได้ 2 วิธี ได้แก่ เป็น APK เดียวหรือเป็น APK 2 รายการแยกกัน หากคุณเผยแพร่ APK เดียว APK นั้นจะรองรับยานพาหนะที่เปิดใช้ Android Automotive OS ด้วยโฮสต์ไลบรารีแอปสำหรับรถยนต์ และจะเปลี่ยนกลับไปใช้แอปพลิเคชัน MediaBrowserService หรือ MediaLibraryService หากไม่รองรับ แม้จะเป็น Android เวอร์ชันเก่า (Android 10 - Android 13) ก็ตาม หากเลือกเผยแพร่ APK 2 รายการแยกกัน คุณจะอัปเดตส่วนที่เพิ่มใหม่เป็นเวอร์ชัน Car App Library ได้โดยไม่ต้องกังวลว่าจะส่งผลกระทบต่อแอปเวอร์ชัน MediaBrowserService หรือ MediaLibraryService
การเผยแพร่ APK เดียว
เมื่อเผยแพร่ APK เดียวสำหรับคลังแอปสำหรับรถยนต์และแอปเวอร์ชัน MediaBrowserService หรือ MediaLibraryService คุณต้องตั้งค่า android.software.car.templates_host.media เป็น android:required="false"
<uses-feature android:name="android.software.car.templates_host.media" android:required="false"/>
จากนั้นทำตามหลักเกณฑ์ของ Car App Library สำหรับ AAOS และแนะนำ CarAppActivity ที่เปิดใช้งานได้ (หรือกิจกรรมแทรมโพลีน) คุณต้องตั้งค่ากิจกรรมเป็น android:enabled="false" ในไฟล์ Manifest จากนั้นเพิ่มแท็กข้อมูลเมตาลงในการประกาศ MediaBrowserService ที่ระบุคอมโพเนนต์ CarAppActivity เป็นรายการทดแทน ดูไฟล์ Manifest ตัวอย่างต่อไปนี้
<service android:name=".media.MyMediaService"
android:exported="true"
android:label="@string/app_name">
<intent-filter>
<action android:name="androidx.media3.session.MediaLibraryService"/>
</intent-filter>
<!-- Link to Car App Library Activity -->
<meta-data
android:name="androidx.car.app.media.CalMediaActivityComponent"
android:value="com.example.mediaapp.LaunchableTrampoline"/>
</service>
<activity
android:name=".LaunchableTrampoline"
android:exported="true"
android:theme="@android:style/Theme.DeviceDefault.NoActionBar"
android:launchMode="singleTask"
android:label="@string/app_name_cal"
android:enabled="false"> <!-- Set to false -->
<meta-data android:name="distractionOptimized" android:value="true" />
<intent-filter>
<action android:name="android.intent.action.MAIN"/>
<action android:name="androidx.car.app.media.action.SHOW_MEDIA_PLAYBACK"/>
<category android:name="android.intent.category.LAUNCHER"/>
</intent-filter>
</activity>
การเผยแพร่ใน Play
APK ที่มีไลบรารีแอปสำหรับรถยนต์และ MediaBrowserService หรือ MediaLibraryService ควรเปิดใช้ด้วยรหัสเวอร์ชันที่สูงกว่าและ minSdk ที่กำหนดเป้าหมายเป็น Android 14 (34)
การเผยแพร่ด้วย APK 2 รายการ
หากต้องการเผยแพร่ APK 2 รายการแยกกัน โดยรายการหนึ่งใช้ไลบรารีแอปสำหรับรถยนต์และอีกรายการใช้ MediaBrowserService หรือ MediaLibraryService ให้ทำตามขั้นตอนต่อไปนี้เพื่อให้แน่ใจว่ามีการกำหนดเป้าหมายความสามารถของรถยนต์อย่างถูกต้อง
เมื่อสร้าง APK แยกต่างหากสำหรับแอปเวอร์ชันคลังแอปสำหรับรถยนต์ คุณต้องตั้งค่า android.software.car.templates_host.media เป็น android:required=true วิธีนี้ช่วยให้มั่นใจว่าแอปจะเผยแพร่ในบิลด์ Android Automotive OS ที่ได้รับการรับรองพร้อมการรองรับโฮสต์ไลบรารีแอปสำหรับรถยนต์เท่านั้น
<uses-feature android:name="android.software.car.templates_host.media" android:required="true"/>
นอกจากการใช้ android.software.car.templates_host.media และตั้งค่าเป็น android:required=true แล้ว ให้ทำตามขั้นตอนต่อไปนี้เพื่อเปิดใช้ Android Automotive OS สำหรับกิจกรรม Car App Library ที่เปิดใช้งานได้
Play Distribution
APK ที่ใช้ไลบรารีแอปสำหรับรถยนต์ควรเผยแพร่ในแทร็กเฉพาะของ Automotive OS
รองรับการสั่งงานด้วยเสียง
เปิดใช้เสียงในแอปเพื่อให้ผู้ใช้ดำเนินการทั่วไปได้แบบแฮนด์ฟรี
ดูวิธีการติดตั้งใช้งานโดยละเอียดเพิ่มเติมได้ที่รองรับการสั่งงานด้วยเสียงสำหรับสื่อ เมื่อใช้แอปสื่อที่ใช้เทมเพลต หากได้รับคำสั่งเสียง คุณไม่จำเป็นต้องอัปเดต MediaBrowserService หรือ MediaLibraryService ด้วยผลการค้นหา แต่ให้พิจารณาเพิ่มการดำเนินการในเทมเพลตการเล่นสื่อเพื่ออนุญาตให้ผู้ใช้ค้นหาเนื้อหาเพิ่มเติมตามการเล่นหรือคำค้นหานั้นแทน คุณต้องรองรับคำสั่งเสียงเพื่อให้เป็นไปตามหลักเกณฑ์ด้านคุณภาพของ VC-1
สร้างเทมเพลตการเล่น
MediaPlaybackTemplate แสดงข้อมูลการเล่นสื่อในแอปสื่อของ Car App Library เทมเพลตนี้ช่วยให้คุณตั้งค่าส่วนหัวที่มีชื่อและการทำงานที่ปรับแต่งได้ ขณะที่โฮสต์จะป้อนข้อมูลสื่อและตัวควบคุมการเล่นตามสถานะของ MediaSession ของแอป
รูปที่ 1:
MediaPlaybackTemplate พร้อมการดำเนินการส่วนหัวเพื่อเปิดคิวที่ด้านบน
ตัวอย่างโค้ดนี้แสดงวิธีสร้างเทมเพลตการเล่นตัวอย่างที่ตั้งค่าการดำเนินการส่วนหัวซึ่งช่วยให้ผู้ใช้ไปยังหน้าจอที่มีคิวเพลงได้
val playbackTemplate = MediaPlaybackTemplate.Builder()
.setHeader(
Header.Builder()
.setStartHeaderAction(Action.BACK)
.addEndHeaderAction(
Action.Builder()
.setTitle(model.context.getString(R.string.queue_button_title))
.setIcon(
CarIcon.Builder(
IconCompat.createWithResource(
model.context,
R.drawable.gs_queue_music_vd_theme_24,
))
.build())
.setOnClickListener(showQueueScreen())
.build())
.setTitle(model.context.getString(R.string.media_playback_view_title))
.build())
.build()
เมื่อใช้ MediaPlaybackTemplate ให้ลงทะเบียนโทเค็น MediaSession โดยใช้ MediaPlaybackManager ใน CarAppService หากไม่ดำเนินการดังกล่าว ระบบจะแสดงข้อผิดพลาดเมื่อส่ง MediaPlaybackTemplate ไปยังโฮสต์
import androidx.car.app.media.MediaPlaybackManager
…
override fun onCreateSession(sessionInfo: SessionInfo): Session {
return object : Session() {
…
init {
lifecycle.addObserver(
LifecycleEventObserver { _, event ->
if (event == ON_CREATE) {
val token = ... // MediaSessionCompat.Token
(carContext.getCarService(CarContext.MEDIA_PLAYBACK_SERVICE) as MediaPlaybackManager)
.registerMediaPlaybackToken(token)
}
...
}
)
}
}
}
.registerMediaPlaybackToken จำเป็นสำหรับการแสดงข้อมูลและการควบคุมการเล่นสื่อใน Android Auto นอกจากนี้ยังเป็นสิ่งสำคัญสำหรับโฮสต์ในการสร้างการแจ้งเตือนเฉพาะสื่อด้วย
สำหรับแอปที่ใช้ไลบรารี Media3 ซึ่งใช้ PlatformToken แทน MediaSessionCompat.Token มาตรฐาน คุณจะต้องติดตั้งใช้งาน SessionCommand ที่กำหนดเองใน MediaLibrarySession.Callback ซึ่งจะแสดงผลโทเค็นแพลตฟอร์มที่สำคัญของเซสชัน: session.platformToken ใน CarAppService ให้ส่งคำสั่งที่กำหนดเองนี้ไปยังเซสชัน เมื่อได้รับโทเค็นแพลตฟอร์มแล้ว ให้แปลงโทเค็นโดยใช้ MediaSessionCompat.Token.fromToken(platformToken) และส่งโทเค็นความเข้ากันได้นี้ไปยังคลังแอปสำหรับรถยนต์ใน .registerMediaPlaybackToken()
จัดระเบียบสื่อโดยใช้เทมเพลต
หากต้องการจัดระเบียบสื่อสำหรับการเลือกดู เช่น เพลงหรืออัลบั้ม เราขอแนะนำให้ใช้ SectionedItemTemplate ซึ่งช่วยให้คุณใช้ GridSection และ RowSection ร่วมกันเพื่อสร้างเลย์เอาต์ที่ผสมผสานรายการรูปภาพและรายการข้อความได้
รูปที่ 2: SectionedItemTemplate ที่มี RowSection ตามด้วย GridSection
การใช้ SectionedItemTemplate ภายใน TabTemplate
วิธีหนึ่งที่สะดวกในการจัดหมวดหมู่สื่อภายในแอปคือการใช้ SectionedItemTemplate ภายใน TabTemplate
val template =
SectionedItemTemplate.Builder()...build();
val tabTemplate =
TabTemplate.Builder(tabCallback)
.setTabContents(TabContents.Builder(template).build)
.setHeaderAction(Action.APP_ICON)
…
.build();
คอมโพเนนต์และฟีเจอร์ของคลังแอปสำหรับรถยนต์ 1.9
Car App Library API เวอร์ชัน 1.9 เปิดตัวคอมโพเนนต์ที่ปรับแต่งได้สำหรับความสามารถในการเรียกดูที่ไม่เหมือนใคร เช่น ชิป, แถบความคืบหน้า, รายการแบบย่อ, ส่วนหัวแบบอินเทอร์แอกทีฟและแบบขยาย, ส่วนสปอตไลท์ และแบนเนอร์
รูปที่ 3: SectionedItemTemplate ที่มี Chips, Condensed Items, Interactive Header, Grid Items และ Minimized Control Panel
รูปที่ 4: หน้าจอการเลือกดูสื่อ 2 หน้าจอที่มี Expanded Header, Spotlight Sections และ Progress Bars
ดูรายละเอียดเพิ่มเติมเกี่ยวกับวิธีออกแบบอินเทอร์เฟซผู้ใช้ของแอปสื่อโดยใช้เทมเพลตเหล่านี้ได้ที่แอปสื่อ
การไปยังตัวควบคุมการเล่น
เมื่อเรียกดูสื่อ สิ่งสำคัญคือผู้ใช้ต้องสามารถไปยังMediaPlaybackTemplateได้อย่างรวดเร็วโดยมีสิ่งรบกวนน้อยที่สุด เพื่อให้เป็นไปตามข้อกำหนดด้านคุณภาพของ MFT-1 แอปของคุณต้องมีวิธีเข้าถึงMediaPlaybackTemplateจากหน้าจอการเรียกดูสื่อทั้งหมด
หากใช้ SectionedItemTemplate คุณสามารถทำได้โดยเพิ่มปุ่มดำเนินการที่นำทางคุณไปยังหน้าจอการเล่นสื่อ ใช้การดำเนินการ Action.MEDIA_PLAYBACK ของ Car App Library มาตรฐาน แอปสื่อจะแสดงการดำเนินการนี้เป็นแผงควบคุมที่ย่อขนาด ซึ่งจำเป็นต้องเป็นไปตามข้อกำหนดด้านคุณภาพของ MFT-1 หากคุณใช้ Car App Library API 1.9 ขึ้นไป สำหรับเทมเพลตอื่นๆ การดำเนินการส่วนหัวเป็นอีกวิธีหนึ่งในการดำเนินการนี้
จัดการ Intent การเล่นสื่อของระบบ
คุณต้องนำผู้ใช้ไปยัง MediaPlaybackTemplate เมื่อเปิดแอปพลิเคชันจากแพลตฟอร์มการเล่นสื่อของระบบ เช่น การ์ดสื่อ เรากำหนดให้แอปพลิเคชันสื่อจัดการ Intent Action นี้เพื่อมอบประสบการณ์การใช้งานที่ราบรื่นให้แก่ผู้ใช้
เพิ่มการดำเนินการ androidx.car.app.media.action.SHOW_MEDIA_PLAYBACK ลงในตัวกรอง Intent ของคอมโพเนนต์คลังแอปสำหรับรถยนต์ (CarAppActivity หรือแทรมโพลีน Activity)
ตรวจสอบว่ากิจกรรมของคุณใช้ launchMode เป็น singleTask หรือ singleTop เพื่อให้มีการเรียกใช้ onNewIntent()
<activity
android:name=".LaunchableTrampoline"
android:exported="true"
android:theme="@android:style/Theme.DeviceDefault.NoActionBar"
android:launchMode="singleTask"
android:label="@string/app_name_cal"
android:enabled="false">
<meta-data android:name="distractionOptimized" android:value="true" />
<intent-filter>
<action android:name="android.intent.action.MAIN"/>
<action android:name="androidx.car.app.media.action.SHOW_MEDIA_PLAYBACK"/>
<category android:name="android.intent.category.LAUNCHER"/>
</intent-filter>
</activity>
ในคลาส Session ให้ลบล้าง onNewIntent() เพื่อแยกวิเคราะห์ Intent ขาเข้า
หากการดำเนินการตาม Intent ขาเข้าตรงกับ SHOW_MEDIA_PLAYBACK ให้ไปยังหน้าจอ "กำลังเล่น" ของผู้ใช้
@Override
public void onNewIntent(@NonNull Intent intent) {
super.onNewIntent(intent);
if (SHOW_MEDIA_PLAYBACK.equals(intent.getAction())) {
ScreenManager screenManager = getCarContext().getCarService(ScreenManager.class);
// Avoid redundant navigation if already on the playing screen
if (screenManager.getTop() instanceof MyMediaPlayScreen) {
return;
}
screenManager.push(MyMediaPlayScreen.createScreenFromPlaying(
getCarContext(), mMediaSessionController));
}
}
หากคุณใช้กิจกรรมแทรมโพลีน ให้ตรวจสอบการดำเนินการ Intent ภายใน onCreate() ส่งการดำเนินการนี้ไปยัง Intent การสร้าง CarAppActivity ก่อนเรียกใช้ finish()
public class LaunchableTrampoline extends AppCompatActivity {
private static final String SHOW_MEDIA_PLAYBACK = "androidx.car.app.media.action.SHOW_MEDIA_PLAYBACK";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
Intent receivedIntent = getIntent();
String action;
if (SHOW_MEDIA_PLAYBACK.equals(receivedIntent.getAction())) {
action = SHOW_MEDIA_PLAYBACK;
} else {
action = Intent.ACTION_MAIN;
}
Intent intent = new Intent(action);
intent.setClassName(getPackageName(), "androidx.car.app.activity.CarAppActivity");
startActivity(intent);
finish();
}
}