Tạo ứng dụng đa phương tiện theo mẫu

Ứng dụng đa phương tiện theo mẫu đang trong giai đoạn thử nghiệm
Hiện tại, bất kỳ ai cũng có thể phát hành ứng dụng đa phương tiện theo mẫu lên các kênh thử nghiệm nội bộ và thử nghiệm khép kín trên Cửa hàng Google Play. Bạn sẽ được phép xuất bản lên kênh công khai và kênh phát hành công khai vào một ngày sau đó.

Ứ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.

Trải nghiệm đỗ xe để lái xe hiện đang ở giai đoạn thử nghiệm beta
Ứng dụng đa phương tiện dựa trên mẫu hiện đủ điều kiện để thêm trải nghiệm chuyển từ trạng thái đỗ xe sang lái xe trên Android Automotive OS. Nhờ đó, ứng dụng của bạn có thể thêm các hoạt động gốc thích ứng khi xe đang đỗ và chuyển đổi liền mạch sang trải nghiệm phát nội dung đa phương tiện theo mẫu khi xe đang di chuyển.

Đị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.

Một trình phát nhạc cho thấy bài hát Sounds of Spring của Summer Fielding, kèm theo ảnh chân dung hình vuông của một người phụ nữ đang chơi đàn guitar.

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.

Giao diện của một ứng dụng nhạc hiển thị các bài hát và đĩa nhạc đã phát gần đây,
     bao gồm hai hàng dọc và ba ảnh bìa đĩa nhạc theo chiều ngang.

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ữ.

Giao diện của một ứng dụng nhạc hiển thị các bài hát và đĩa nhạc đã phát gần đây,
     bao gồm hai hàng dọc và ba ảnh bìa đĩa nhạc theo chiều ngang.

Hình 3: SectionedItemTemplate chứa Chips, Condensed Items, Interactive Header, Grid Items và Minimized Control Panel

Giao diện của một ứng dụng nhạc hiển thị các bài hát và đĩa nhạc đã phát gần đây,
     bao gồm hai hàng dọc và ba ảnh bìa đĩa nhạc theo chiều ngang.

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.

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();
    }
}