Ứng dụng đa phương tiện sử dụng các mẫu Thư viện ứng dụng cho ô tô có thể tuỳ chỉnh trải nghiệm duyệt xem và phát nội dung đa phương tiện, đồng thời đảm bảo trải nghiệm này được tối ưu hoá cho màn hình ô tô và giảm thiểu sự phân tâm khi lái xe.
Hướng dẫn này giả định rằng bạn đã có một ứng dụng đa phương tiện phát âm thanh trên điện thoại và ứng dụng đa phương tiện đó phù hợp với cấu trúc ứng dụng đa phương tiện của Android. Thư viện ứng dụng cho ô tô cho phép bạn thay thế trải nghiệm trong ứng dụng bằng các mẫu thay vì những mẫu được tạo bằng cấu trúc dữ liệu MediaBrowser Tạo ứng dụng đa phương tiện cho ô tô. Bạn vẫn phải cung cấp MediaSession cho bộ điều khiển chế độ phát và MediaBrowserService hoặc MediaLibraryService, được dùng cho các đề xuất và trải nghiệm thông minh khác.
Định cấu hình tệp kê khai của ứng dụng
Ngoài các bước được mô tả trong phần Sử dụng Thư viện ứng dụng Android cho Ô tô, ứng dụng đa phương tiện dựa trên mẫu còn phải đáp ứng các yêu cầu sau:
Khai báo tính năng hỗ trợ danh mục trong tệp kê khai của bạn
Ứng dụng của bạn cần khai báo androidx.car.app.category.MEDIA danh mục ứng dụng cho ô tô trong bộ lọc ý định của 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>
Để có quyền truy cập vào MediaPlaybackTemplate, ứng dụng của bạn cũng cần khai báo quyền androidx.car.app.MEDIA_TEMPLATES trong tệp kê khai:
<manifest ...>
...
<uses-permission android:name="androidx.car.app.MEDIA_TEMPLATES"/>
...
</manifest>
Đặt cấp độ API tối thiểu của ứng dụng dành cho ô tô
Ứng dụng đa phương tiện sử dụng MediaPlaybackTemplate chỉ được hỗ trợ trong CAL API 8 trở lên, hãy đảm bảo bạn đặt Car App API level tối thiểu là 8.
<application ...>
...
<meta-data
android:name="androidx.car.app.minCarApiLevel"
android:value="8"/>
...
</application>
Cung cấp biểu tượng ghi công
Hãy nhớ thêm biểu tượng ghi nhận tác giả cho các ứng dụng đa phương tiện được tạo bằng Thư viện ứng dụng cho ô tô.
Khai báo chức năng hỗ trợ Android Auto
Đảm bảo rằng tệp kê khai của ứng dụng có chứa nội dung sau:
<application>
...
<meta-data android:name="com.google.android.gms.car.application"
android:resource="@xml/automotive_app_desc"/>
...
</application>
Sau đó, hãy thêm nội dung khai báo template vào automotive_app_desc.xml trong tài nguyên XML. Nó sẽ có dạng như sau:
<automotiveApp xmlns:android="http://schemas.android.com/apk/res/android">
<uses name="media"/>
<uses name="template"/>
</automotiveApp>
Khai báo tính năng hỗ trợ Android Automotive OS
Có hai cách để phân phối ứng dụng đa phương tiện có hỗ trợ Thư viện ứng dụng cho ô tô trên Android Automotive OS: dưới dạng một tệp APK hoặc dưới dạng hai tệp APK riêng biệt. Nếu bạn
phân phối một tệp APK duy nhất, thì tệp đó sẽ hỗ trợ các xe được bật Android
Automotive OS bằng máy chủ lưu trữ Thư viện ứng dụng cho ô tô và quay lại
ứng dụng MediaBrowserService hoặc MediaLibraryService nếu không, ngay cả đối với
các phiên bản Android cũ (Android 10 – Android 13). Nếu chọn phân phối
hai APK riêng biệt, bạn có thể cập nhật các nội dung bổ sung mới cho phiên bản
Thư viện ứng dụng cho ô tô mà không lo ảnh hưởng đến phiên bản MediaBrowserService hoặc
MediaLibraryService của ứng dụng.
Phân phối một tệp APK duy nhất
Khi phân phối một tệp APK duy nhất cho Thư viện ứng dụng cho ô tô và các phiên bản MediaBrowserService hoặc MediaLibraryService của ứng dụng, bạn cần đặt android.software.car.templates_host.media thành android:required="false".
<uses-feature android:name="android.software.car.templates_host.media" android:required="false"/>
Tiếp theo, hãy làm theo nguyên tắc của Thư viện ứng dụng cho ô tô dành cho AAOS và giới thiệu một CarAppActivity có thể khởi chạy (hoặc hoạt động trampoline). Bạn phải đặt hoạt động thành android:enabled="false" trong tệp kê khai. Tiếp theo, hãy thêm thẻ siêu dữ liệu vào phần khai báo MediaBrowserService cho biết thành phần CarAppActivity là thành phần thay thế. Hãy xem tệp kê khai mẫu sau:
<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>
Phân phối trên Play
Bạn nên bật tệp APK có Thư viện ứng dụng cho ô tô và MediaBrowserService hoặc MediaLibraryService bằng mã phiên bản cao hơn và minSdk nhắm đến Android 14 (34).
Phân phối bằng hai tệp APK
Để phân phối hai tệp APK riêng biệt, một tệp sử dụng Thư viện ứng dụng cho ô tô và một tệp sử dụng MediaBrowserService hoặc MediaLibraryService, hãy làm theo các bước sau để đảm bảo nhắm mục tiêu chính xác các chức năng của xe.
Khi tạo một tệp APK riêng cho phiên bản Thư viện ứng dụng cho ô tô của ứng dụng,
bạn phải đặt android.software.car.templates_host.media thành
android:required=true. Điều này đảm bảo ứng dụng chỉ được phân phối trên các bản dựng Android Automotive OS được chứng nhận có hỗ trợ máy chủ Thư viện ứng dụng cho ô tô.
<uses-feature android:name="android.software.car.templates_host.media" android:required="true"/>
Ngoài việc sử dụng android.software.car.templates_host.media và đặt thành android:required=true, hãy làm theo các bước sau để bật Android Automotive OS cho hoạt động có thể chạy của Thư viện ứng dụng cho ô tô.
Play Distribution
Bạn nên phân phối APK sử dụng Thư viện ứng dụng cho ô tô trong kênh dành riêng cho Automotive OS.
Hỗ trợ thao tác bằng giọng nói
Bật tính năng điều khiển bằng giọng nói cho ứng dụng để người dùng có thể hoàn tất các thao tác phổ biến mà không cần dùng tay.
Hãy xem phần hỗ trợ thao tác bằng giọng nói cho nội dung nghe nhìn để biết thêm hướng dẫn triển khai chi tiết. Với ứng dụng đa phương tiện theo mẫu, nếu nhận được lệnh thoại, bạn không cần cập nhật MediaBrowserService hoặc MediaLibraryService bằng kết quả tìm kiếm. Thay vào đó, hãy cân nhắc thêm một hành động vào mẫu phát nội dung nghe nhìn để cho phép người dùng tìm thêm nội dung dựa trên lượt phát hoặc cụm từ tìm kiếm đó. Bạn phải hỗ trợ lệnh thoại để đáp ứng nguyên tắc về chất lượng VC-1.
Tạo mẫu phát
MediaPlaybackTemplate hiển thị thông tin phát nội dung nghe nhìn trong ứng dụng đa phương tiện của Thư viện ứng dụng cho ô tô. Mẫu này cho phép đặt dòng tiêu đề với tiêu đề và các thao tác tuỳ chỉnh, trong khi thông tin nghe nhìn và bộ điều khiển chế độ phát được máy chủ điền sẵn dựa trên trạng thái của MediaSession trong ứng dụng.
Hình 1:
MediaPlaybackTemplate có thao tác ở tiêu đề để mở hàng đợi
dọc theo phía trên cùng.
Ví dụ về mã này cho thấy cách tạo một mẫu phát mẫu đặt thao tác tiêu đề cho phép người dùng chuyển đến màn hình có hàng đợi bài hát.
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()
Khi bạn sử dụng MediaPlaybackTemplate, hãy đăng ký mã thông báo MediaSession bằng MediaPlaybackManager trong CarAppService. Nếu không, lỗi sẽ xuất hiện khi MediaPlaybackTemplate được gửi đến máy chủ lưu trữ.
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 là cần thiết để hiển thị thông tin và các nút điều khiển phát nội dung nghe nhìn cho Android Auto. Điều này cũng quan trọng đối với máy chủ lưu trữ để tạo thông báo dành riêng cho nội dung nghe nhìn.
Đối với các ứng dụng dùng thư viện Media3 (sử dụng PlatformToken thay vì MediaSessionCompat.Token tiêu chuẩn), bạn cần triển khai SessionCommand tuỳ chỉnh trong MediaLibrarySession.Callback để trả về mã thông báo nền tảng cơ bản của phiên: session.platformToken. Trong CarAppService, hãy gửi lệnh tuỳ chỉnh này đến phiên. Sau khi nhận được mã thông báo nền tảng, hãy chuyển đổi mã thông báo đó bằng MediaSessionCompat.Token.fromToken(platformToken) rồi truyền mã thông báo tương thích này đến Thư viện ứng dụng cho ô tô trong .registerMediaPlaybackToken().
Sắp xếp nội dung nghe nhìn bằng mẫu
Để sắp xếp nội dung nghe nhìn cho việc duyệt xem, chẳng hạn như bài hát hoặc đĩa nhạc, bạn nên sử dụng SectionedItemTemplate. Thư viện này cho phép bạn sử dụng GridSection và RowSection cùng nhau để tạo bố cục kết hợp danh sách hình ảnh và mục văn bản.
Hình 2: SectionedItemTemplate chứa RowSection, theo sau là GridSection
Sử dụng SectionedItemTemplate bên trong TabTemplate
Một cách thuận tiện để phân loại nội dung nghe nhìn trong ứng dụng là sử dụng SectionedItemTemplate bên trong TabTemplate.
val template =
SectionedItemTemplate.Builder()...build();
val tabTemplate =
TabTemplate.Builder(tabCallback)
.setTabContents(TabContents.Builder(template).build)
.setHeaderAction(Action.APP_ICON)
…
.build();
Các thành phần và tính năng của Thư viện ứng dụng cho ô tô phiên bản 1.9
API Thư viện ứng dụng cho ô tô phiên bản 1.9 ra mắt các thành phần tuỳ chỉnh cho các chức năng duyệt xem độc đáo, chẳng hạn như Khối, Thanh tiến trình, Mục thu gọn, Tiêu đề tương tác và mở rộng, Phần nổi bật và Biểu ngữ.
Hình 3: SectionedItemTemplate chứa Chips, Condensed Items, Interactive Header, Grid Items và Minimized Control Panel
Hình 4: Hai màn hình duyệt nội dung nghe nhìn có Expanded Header, Spotlight Sections và Progress Bars
Để biết thêm thông tin chi tiết về cách thiết kế giao diện người dùng của ứng dụng đa phương tiện bằng các mẫu này, hãy xem phần Ứng dụng đa phương tiện.
Chuyển đến bộ điều khiển chế độ phát
Khi duyệt xem nội dung nghe nhìn, người dùng cần có thể nhanh chóng chuyển đến MediaPlaybackTemplate mà không bị phân tâm.Để đáp ứng yêu cầu về chất lượng của MFT-1, ứng dụng của bạn phải có cách truy cập vào MediaPlaybackTemplate từ tất cả màn hình duyệt xem nội dung nghe nhìn.
Nếu đang sử dụng SectionedItemTemplate, bạn có thể thực hiện việc này bằng cách thêm một nút hành động đưa bạn đến màn hình phát nội dung nghe nhìn. Sử dụng thao tác Action.MEDIA_PLAYBACK tiêu chuẩn của Thư viện ứng dụng cho ô tô. Ứng dụng đa phương tiện sẽ
hiển thị hành động này dưới dạng Bảng điều khiển thu nhỏ.
Đây là yêu cầu bắt buộc để đáp ứng yêu cầu về chất lượng MFT-1 nếu bạn
đang sử dụng API Thư viện ứng dụng cho ô tô phiên bản 1.9 trở lên. Đối với các mẫu khác, thao tác trên tiêu đề là một cách khác để thực hiện việc này.
Xử lý ý định phát nội dung nghe nhìn của hệ thống
Bạn phải chuyển hướng người dùng đến MediaPlaybackTemplate khi một ứng dụng được chạy từ một nền tảng phát nội dung nghe nhìn của hệ thống, chẳng hạn như thẻ nội dung nghe nhìn. Chúng tôi yêu cầu các ứng dụng đa phương tiện phải xử lý Intent Action này để mang lại trải nghiệm liền mạch cho người dùng.
Thêm hành động androidx.car.app.media.action.SHOW_MEDIA_PLAYBACK vào bộ lọc ý định của thành phần Thư viện ứng dụng cho ô tô (CarAppActivity hoặc Activity).
Đảm bảo hoạt động của bạn sử dụng launchMode của singleTask hoặc singleTop để onNewIntent() được gọi.
<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>
Trong lớp Session, hãy ghi đè onNewIntent() để phân tích cú pháp ý định sắp tới.
Nếu hành động theo ý định đến khớp với SHOW_MEDIA_PLAYBACK, hãy chuyển người dùng đến màn hình Phát hiện nhạc.
@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));
}
}
Nếu bạn đang sử dụng hoạt động gián tiếp, hãy kiểm tra hành động theo ý định trong onCreate(). Truyền hành động này đến ý định tạo CarAppActivity trước khi gọi 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();
}
}