Định cấu hình tệp kê khai

Định cấu hình tệp kê khai của ứng dụng để tích hợp với Android Auto và Android Automotive OS (AAOS). Để cho phép các nền tảng này khám phá và kết nối, hãy khai báo dịch vụ trình duyệt nội dung đa phương tiện trong tệp kê khai. Chỉ định các biểu tượng ứng dụng bắt buộc, bao gồm cả biểu tượng trình chạy cho biểu tượng phân bổ để các thành phần giao diện người dùng hệ thống sử dụng, chẳng hạn như các chế độ điều khiển nội dung nghe nhìn.

Để tìm hiểu thêm về tệp kê khai, hãy xem bài viết Tổng quan về tệp kê khai ứng dụng.

Khai báo dịch vụ trình duyệt nội dung đa phương tiện

Android Auto và AAOS kết nối với ứng dụng của bạn thông qua dịch vụ trình duyệt nội dung đa phương tiện để duyệt qua các mục nội dung đa phương tiện. Khai báo dịch vụ trình duyệt nội dung đa phương tiện trong tệp kê khai để cho phép Android Auto và AAOS khám phá dịch vụ này cũng như kết nối với ứng dụng của bạn.

Đoạn mã này cho biết cách khai báo dịch vụ trình duyệt nội dung đa phương tiện trong tệp kê khai của bạn. Phần tiếp theo của hướng dẫn này, Tạo dịch vụ trình duyệt nội dung nghe nhìn, trình bày chi tiết quy trình triển khai dịch vụ.

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

Chỉ định biểu tượng ứng dụng

Để biểu thị ứng dụng của bạn trong giao diện người dùng hệ thống, hãy chỉ định biểu tượng ứng dụng mà Android Auto và AAOS nên dùng. Bạn phải có 2 biểu tượng sau:

Xác định biểu tượng trình chạy

Biểu tượng trình chạy đại diện cho ứng dụng của bạn trong giao diện người dùng hệ thống, chẳng hạn như trên trình chạy và khay biểu tượng.

Theo mặc định, thuộc tính android:icon của phần tử <application> trong ứng dụng của bạn được dùng làm biểu tượng trình chạy:

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

Để sử dụng một biểu tượng khác, hãy đặt thuộc tính android:icon của phần tử <service> trong dịch vụ trình duyệt nội dung đa phương tiện:

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

Xác định biểu tượng phân bổ

Biểu tượng phân bổ được dùng ở những vị trí mà nội dung đa phương tiện được ưu tiên, chẳng hạn như trên thẻ nội dung đa phương tiện. Hãy cân nhắc việc sử dụng lại biểu tượng nhỏ đối với các thông báo. Biểu tượng này phải là đơn sắc.

Biểu tượng phân bổ trên thẻ nội dung nghe nhìn

Hình 1. Biểu tượng phân bổ trên thẻ nội dung đa phương tiện.

Bạn có thể chỉ định một biểu tượng dùng để biểu thị ứng dụng của mình bằng cách sử dụng nội dung khai báo tệp kê khai sau:

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

Chỉ định nhãn của ứng dụng

Theo mặc định, giá trị của thuộc tính android:label trong phần tử <application> của ứng dụng sẽ được dùng làm tên hiển thị cho ứng dụng trên màn hình ô tô.

Để sử dụng một tên hiển thị khác (hoặc nếu ứng dụng của bạn có nhiều dịch vụ trình duyệt nội dung đa phương tiện), hãy đặt thuộc tính android:label của phần tử <service> trong dịch vụ trình duyệt nội dung đa phương tiện.

Chỉ định màu nhấn của ứng dụng

Android Auto và AAOS dùng màu nhấn của ứng dụng để tạo kiểu cho các nút điều khiển phát và các phần tử khác trên giao diện người dùng.

Theo mặc định, màu nhấn được lấy từ mục colorAccent của tài nguyên kiểu android:theme trong phần tử <application> của ứng dụng.

Để sử dụng một màu nhấn khác cho trải nghiệm trên ô tô, hãy thêm một phần tử <meta-data> cho một tài nguyên kiểu khác có chứa một mục colorAccent:

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

Cấu hình dành riêng cho nền tảng

Ngoài cấu hình được trình bày chi tiết trên trang này, hãy xem các phần sau để biết các yêu cầu cụ thể theo nền tảng: