Thêm tính năng hỗ trợ Android Auto vào ứng dụng dùng khi đỗ xe

Trên các thiết bị chạy Android 15 trở lên, Android Auto hỗ trợ chạy các ứng dụng trong danh mục ứng dụng đỗ xe được hỗ trợ ngay trên đầu phát trung tâm. Hãy xem bài viết Ứng dụng đỗ xe để biết thêm thông tin về trải nghiệm người dùng ứng dụng đỗ xe trên Android Auto.

Khai báo chức năng hỗ trợ Android Auto

Để khai báo rằng ứng dụng của bạn hỗ trợ Android Auto, bạn phải đưa phần tử <category> sau đây vào bộ lọc ý định của một hoạt động trong tệp kê khai của ứng dụng:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        ...
        <category android:name="android.intent.category.CAR_LAUNCHER" />
    </intent-filter>
</activity>

Nhìn chung, bạn có thể đặt phần tử danh mục android.intent.category.CAR_LAUNCHER trong cùng một bộ lọc ý định với phần tử android.intent.category.LAUNCHER, nhưng bạn cũng có thể đặt phần tử này trong một bộ lọc khác nếu muốn.

Mục nhập tệp kê khai theo danh mục

Ngoài yêu cầu nêu trên, trò chơi còn có một yêu cầu bổ sung. Xem phần Đánh dấu ứng dụng của bạn là trò chơi.

Hỗ trợ các kích thước màn hình Android Auto phổ biến

Để mang lại trải nghiệm tốt nhất cho người dùng, bạn nên thiết kế ứng dụng thích ứng hoàn toàn với nhiều kích thước màn hình. Ít nhất, để đảm bảo trải nghiệm chất lượng cao trên nhiều loại ô tô hỗ trợ Android Auto, ứng dụng không được có khung hình dạng trụ cột đáng kể trên màn hình ngang, như được ghi nhận trong nguyên tắc về chất lượng ứng dụng dành cho ô tô DO-2.

Ví dụ: nếu một ứng dụng chạy ở tỷ lệ khung hình dọc với hiệu ứng hòm trụ trên màn hình ngang, thì ứng dụng đó sẽ bị từ chối trong quá trình đánh giá trên Cửa hàng Play. Bạn có thể chấp nhận một ứng dụng chạy ở tỷ lệ khung hình ngang với hiệu ứng hòm thư tối thiểu trên màn hình ngang, cũng như một ứng dụng chạy ở tỷ lệ khung hình ngang với hiệu ứng hòm thư trên màn hình dọc.

Kiểm thử theo kích thước màn hình chuẩn

Khi tạo và kiểm thử ứng dụng cho Android Auto, bạn có thể sử dụng các cấu hình Đầu phát trung tâm trên máy tính (DHU) sau đây để xác minh rằng ứng dụng của bạn đáp ứng các yêu cầu trước đó:

Phong cảnh nhỏ

[general]
resolution = 800x480
dpi = 160
...

Ngang rộng

[general]
resolution = 1920x1080
dpi = 160
marginheight = 596
normalizedpi = true
cropmargins = true
...

Chân dung

[general]
resolution = 1920x1080
dpi = 160
marginwidth = 878
normalizedpi = true
cropmargins = true
...

Phát hiện hoạt động sử dụng trên Android Auto

Nếu muốn phát hiện thời điểm ứng dụng của bạn đang được sử dụng thông qua Android Auto (chẳng hạn như cho mục đích phân tích), bạn có thể xem xét hai tín hiệu:

  • Trạng thái kết nối do API CarConnection báo cáo. Khi Android Auto được kết nối, giá trị này sẽ là CONNECTION_TYPE_PROJECTION.
  • Mã màn hình của màn hình đang hoạt động. Khi ứng dụng của bạn đang chạy trên một màn hình khác với màn hình tích hợp, chẳng hạn như khi được sử dụng thông qua Android Auto, thì đây là một giá trị khác với DEFAULT_DISPLAY.

Đoạn mã sau đây cho biết cách kết hợp các tín hiệu này để phát hiện mức sử dụng thông qua Android Auto:

val connectionType = ...
val displayId = context.display.displayId
isRunningOnAndroidAuto = connectionType == CONNECTION_TYPE_PROJECTION and displayId != DEFAULT_DISPLAY