Google cam kết thúc đẩy công bằng chủng tộc cho Cộng đồng người da đen. Xem cách thực hiện.

Cụm công cụ

Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Sử dụng API cụm công cụ (một API Android) để hiển thị các ứng dụng điều hướng, bao gồm cả Google Maps, trên màn hình phụ trong ô tô, chẳng hạn như sau vô lăng trên bảng điều khiển. Trang này mô tả cách tạo một dịch vụ để điều khiển màn hình phụ đó và sau đó tích hợp dịch vụ với CarService để các ứng dụng điều hướng có thể hiển thị giao diện người dùng.

Thuật ngữ

Các thuật ngữ sau được sử dụng trên trang này:

Kỳ hạn Sự mô tả
CarInstrumentClusterManager CarManager cho phép các ứng dụng bên ngoài khởi chạy một hoạt động trên Cụm công cụ và nhận lệnh gọi lại khi Cụm công cụ sẵn sàng hiển thị các hoạt động.
CarManager Lớp cơ sở của tất cả người quản lý được các ứng dụng bên ngoài sử dụng để tương tác với các dịch vụ dành riêng cho ô tô do CarService triển khai.
CarService Dịch vụ Nền tảng Android cung cấp giao tiếp giữa các ứng dụng bên ngoài (bao gồm cả Google Maps) và các tính năng dành riêng cho ô tô, chẳng hạn như quyền truy cập Cụm công cụ.
Điểm đến Điểm đến cuối cùng mà chiếc xe sẽ hướng đến.
ETA Thời gian dự kiến ​​đến điểm đến.
Đầu đơn vị (HU) Đơn vị tính toán chính được nhúng trong ô tô. HU chạy tất cả các mã Android và được kết nối với màn hình trung tâm trong xe hơi.
Cụm công cụ Màn hình phụ nằm sau vô lăng và giữa các thiết bị xe hơi. Đây có thể là một đơn vị tính toán độc lập được kết nối với HU thông qua mạng nội bộ của ô tô (CAN bus) hoặc một màn hình phụ gắn với HU.
InstrumentClusterRenderingService Lớp cơ sở cho dịch vụ được sử dụng để giao diện với màn hình Cụm công cụ. OEM phải cung cấp phần mở rộng của lớp này tương tác với phần cứng dành riêng cho OEM.
Ứng dụng KitchenSink Ứng dụng thử nghiệm đi kèm với Android Automotive.
Tuyến đường Một con đường cụ thể mà một chiếc xe điều hướng để đến một điểm đến.
Dịch vụ Singleton Một dịch vụ Android có thuộc tính android:singleUser . Tại bất kỳ thời điểm nào, nhiều nhất một phiên bản của dịch vụ chạy trên hệ thống Android.

Điều kiện tiên quyết

Để phát triển tích hợp, hãy đảm bảo có các yếu tố sau:

  • Môi trường phát triển Android. Để thiết lập môi trường phát triển Android, hãy xem Yêu cầu bản dựng .
  • Tải xuống mã nguồn Android. Tải phiên bản mới nhất của mã nguồn Android từ chi nhánh pi-car-release (hoặc mới hơn) tại https://android.googlesource.com .
  • Đơn vị trưởng (HU). Thiết bị Android có khả năng chạy Android 9 (trở lên). Thiết bị này phải có màn hình riêng và có khả năng nhấp nháy màn hình với các bản dựng mới của Android.
  • Cụm công cụ là một trong những cụm sau:
    • Màn hình phụ vật lý gắn liền với HU. Nếu phần cứng và nhân của thiết bị hỗ trợ quản lý nhiều màn hình.
    • Đơn vị độc lập. Bất kỳ thiết bị tính toán nào được kết nối với HU qua kết nối mạng, có khả năng nhận và hiển thị luồng video trên màn hình của chính nó.
    • Màn hình giả lập. Trong quá trình phát triển, bạn có thể sử dụng một trong các môi trường giả lập sau:
      • Màn hình phụ mô phỏng. Để bật màn hình phụ mô phỏng trên bất kỳ bản phân phối Android AOSP nào, hãy chuyển đến cài đặt Tùy chọn nhà phát triển trong ứng dụng hệ thống Cài đặt và sau đó chọn Mô phỏng màn hình phụ. Cấu hình này tương đương với việc gắn một màn hình phụ vật lý, với hạn chế là màn hình này được xếp chồng lên màn hình chính.
      • Cụm đồng hồ giả lập. Trình giả lập Android đi kèm với Android Automotive cung cấp một tùy chọn để hiển thị một cụm công cụ với trình mô phỏng Android _qemu-pipe . Sử dụng triển khai cụm công cụ tham chiếu DirectRenderingCluster để kết nối với màn hình bên ngoài được mô phỏng này.

Kiến trúc tích hợp

Các thành phần tích hợp

Bất kỳ tích hợp nào của API cụm công cụ đều bao gồm ba thành phần sau:

  • CarService
  • Ứng dụng điều hướng
  • Dịch vụ cụm công cụ OEM

Các thành phần tích hợp

Dịch vụ cho xe ô tô

CarService làm trung gian giữa các ứng dụng điều hướng và ô tô, đảm bảo rằng chỉ một ứng dụng điều hướng hoạt động tại bất kỳ thời điểm nào và chỉ những ứng dụng có quyền android.car.permission.CAR_INSTRUMENT_CLUSTER_CONTROL mới có thể gửi dữ liệu đến ô tô.

CarService khởi động tất cả các dịch vụ dành riêng cho ô tô và cung cấp quyền truy cập vào các dịch vụ này thông qua một loạt người quản lý. Để tương tác với các dịch vụ, các ứng dụng chạy trên ô tô có thể truy cập các trình quản lý này.

Để triển khai cụm công cụ, OEM ô tô phải tạo một triển khai tùy chỉnh của InstrumentClusterRendererService và cập nhật tệp config.xml để trỏ đến triển khai tùy chỉnh đó.

Khi hiển thị một Cụm công cụ, trong quá trình khởi động, CarService đọc khóa InstrumentClusterRendererService của config.xml để định vị việc triển khai InstrumentClusterService . Trong AOSP, mục nhập này trỏ đến dịch vụ kết xuất cụm mẫu triển khai API Trạng thái Điều hướng:

<string name="instrumentClusterRendererService">
android.car.cluster/.ClusterRenderingService
</string>

Dịch vụ được đề cập trong mục này được khởi tạo và liên kết với CarService . Khi các ứng dụng điều hướng, như Google Maps, yêu cầu CarInstrumentClusterManager , CarService cung cấp một trình quản lý cập nhật trạng thái Cụm công cụ từ InstrumentClusterRenderingService bị ràng buộc. (Trong trường hợp này, ràng buộc đề cập đến Dịch vụ Android .)

Dịch vụ cụm công cụ

OEM phải tạo Gói Android (APK) có chứa lớp con của InstrumentClusterRendererService . Xem ClusterRenderingService để biết mẫu.

Lớp này phục vụ hai mục đích:

  • Cung cấp giao diện Android và thiết bị kết xuất Cụm công cụ (mục đích của trang này).
  • Nhận và hiển thị các cập nhật trạng thái điều hướng, chẳng hạn như hướng dẫn điều hướng từng chặng.

Đối với mục đích đầu tiên, các triển khai OEM của InstrumentClusterRendererService phải khởi tạo màn hình phụ được sử dụng để hiển thị thông tin trên màn hình trong cabin ô tô và truyền thông tin này tới CarService bằng cách gọi đến các phương thức InstrumentClusterRendererService.setClusterActivityOptions()InstrumentClusterRendererService.setClusterActivityState() .

Đối với chức năng thứ hai, dịch vụ Cụm công cụ phải cung cấp triển khai giao diện NavigationRenderer nhận các sự kiện cập nhật trạng thái điều hướng, được mã hóa dưới dạng eventType và dữ liệu sự kiện được mã hóa trong một gói.

Trình tự tích hợp

Sơ đồ sau minh họa việc triển khai trạng thái điều hướng hiển thị các bản cập nhật:

Trình tự tích hợp

Trong hình minh họa này, màu sắc biểu thị những điều sau:

  • Màu vàng. CarServiceCarNavigationStatusManager được cung cấp bởi nền tảng Android.
  • Màu lục lam. InstrumentClusterRendererService do OEM triển khai.
  • Màu đỏ tía. Ứng dụng Điều hướng do Google và các nhà phát triển bên thứ ba triển khai.
  • Màu xanh lá. CarAppFocusManager .

Luồng thông tin Trạng thái Điều hướng tuân theo trình tự sau:

  1. CarService khởi tạo InstrumentClusterRenderingService .
  2. Trong quá trình khởi tạo, InstrumentClusterRenderingService cập nhật CarService với:
    1. Thuộc tính hiển thị của Cụm công cụ, chẳng hạn như ranh giới không được thu thập (xem thêm chi tiết về ranh giới không được thu thập sau).
    2. Các tùy chọn hoạt động cần thiết để khởi chạy các hoạt động bên trong màn hình Cụm công cụ (xem thêm chi tiết tại ActivityOptions .
  3. Một ứng dụng điều hướng (chẳng hạn như Google Maps dành cho Android Ô tô hoặc bất kỳ ứng dụng bản đồ nào có các quyền cần thiết):
    1. Có được CarAppFocusManager bằng cách sử dụng lớp Car từ car-lib.
    2. Trước khi chỉ đường từng chặng bắt đầu, hãy gọi tới CarAppFocusManager.requestFocus() để chuyển CarAppFocusManager.APP_FOCUS_TYPE_NAVIGATION làm thông số appType .
  4. CarAppFocusManager thông báo yêu cầu này tới CarService . Nếu được cấp phép, CarService kiểm tra gói ứng dụng điều hướng và định vị hoạt động được đánh dấu bằng danh mục android.car.cluster.NAVIGATION .
  5. Nếu được tìm thấy, ứng dụng điều hướng sẽ sử dụng ActivityOptions do InstrumentClusterRenderingService báo cáo để khởi chạy hoạt động và bao gồm các thuộc tính hiển thị của Instrument Cluster như phần bổ sung trong ý định.

Tích hợp API

Việc triển khai InstrumentClusterRenderingService phải:

  • Được chỉ định là một dịch vụ singleton bằng cách thêm giá trị sau vào AndroidManifest.xml. Điều này là cần thiết để đảm bảo rằng một bản sao duy nhất của dịch vụ Cụm công cụ sẽ chạy, ngay cả trong quá trình khởi tạo và chuyển đổi người dùng:
    android:singleUser="true"
  • Giữ quyền hệ thống BIND_INSTRUMENT_CLUSTER_RENDERER_SERVICE . Điều này đảm bảo rằng chỉ dịch vụ kết xuất Cụm công cụ được bao gồm như một phần của hình ảnh hệ thống Android từng bị ràng buộc bởi CarService :
    <uses-permission android:name="android.car.permission.BIND_INSTRUMENT_CLUSTER_RENDERER_SERVICE"/>
    

Triển khai InstrumentClusterRenderingService

Để xây dựng dịch vụ:

  1. Viết một lớp mở rộng từ InstrumentClusterRenderingService và sau đó thêm một mục nhập tương ứng vào tệp AndroidManifest.xml của bạn. Lớp này kiểm soát màn hình Cụm công cụ và có thể ( tùy chọn ) hiển thị dữ liệu API Trạng thái Điều hướng.
  2. Trong onCreate() , hãy sử dụng dịch vụ này để khởi tạo giao tiếp với phần cứng kết xuất. Các tùy chọn bao gồm:
    • Xác định màn hình phụ sẽ được sử dụng cho Cụm công cụ.
    • Tạo một màn hình ảo để ứng dụng Cụm công cụ hiển thị và truyền hình ảnh được kết xuất đến thiết bị bên ngoài (sử dụng định dạng phát trực tuyến video, chẳng hạn như H.264).
  3. Khi màn hình hiển thị được chỉ ra ở trên đã sẵn sàng, dịch vụ này phải gọi InstrumentClusterRenderingService#setClusterActivityLaunchOptions() để xác định ActivityOptions chính xác phải được sử dụng để hiển thị Hoạt động trên Cụm công cụ. Sử dụng các thông số sau:
    • thể loại. CarInticmentClusterManager # CATEGORY_NAVIGATION
    • ActivityOptions. Một cá thể ActivityOptions có thể được sử dụng để khởi chạy một Hoạt động trong Cụm công cụ. Ví dụ: từ triển khai Cụm công cụ mẫu trên AOSP:
      getService().setClusterActivityLaunchOptions(
         CATEGORY_NAVIGATION,
         ActivityOptions.makeBasic()
            .setLaunchDisplayId(displayId));
      
  4. Khi Cụm công cụ sẵn sàng hiển thị các hoạt động, dịch vụ này phải gọi InstrumentClusterRenderingService#setClusterActivityState() . Sử dụng các thông số sau:
    • category CarInstrumentClusterManager#CATEGORY_NAVIGATION
    • state Gói được tạo bằng ClusterActivityState . Đảm bảo cung cấp các dữ liệu sau:
      • visible Chỉ định Cụm công cụ là có thể nhìn thấy và sẵn sàng hiển thị nội dung.
      • unobscuredBounds Một hình chữ nhật xác định khu vực bên trong màn hình Cụm công cụ mà ở đó nó an toàn để hiển thị nội dung. Ví dụ, các khu vực được bao phủ bởi mặt số và đồng hồ đo.
  5. Ghi đè phương thức Service#dump() và báo cáo thông tin trạng thái hữu ích cho việc gỡ lỗi (xem kết xuất để biết thêm thông tin).

Triển khai Sample InstrumentClusterRenderingService

Ví dụ sau đây phác thảo một triển khai InstrumentClusterRenderingService , tạo ra một VirtualDisplay để trình bày nội dung của Instrument Cluster trên một màn hình vật lý từ xa.

Ngoài ra, mã này có thể vượt qua displayId của màn hình phụ vật lý được kết nối với HU, nếu được biết là có sẵn.

/**
* Sample {@link InstrumentClusterRenderingService} implementation
*/
public class SampleClusterServiceImpl extends InstrumentClusterRenderingService {
   // Used to retrieve or create displays
   private final DisplayManager mDisplayManager;
   // Unique identifier for the display that will be used for instrument
   // cluster
   private final String mUniqueId = UUID.randomUUID().toString();
   // Format of the instrument cluster display
   private static final int DISPLAY_WIDTH = 1280;
   private static final int DISPLAY_HEIGHT = 720;
   private static final int DISPLAY_DPI = 320;
   // Area not covered by instruments
   private static final int DISPLAY_UNOBSCURED_LEFT = 40;
   private static final int DISPLAY_UNOBSCURED_TOP = 0;
   private static final int DISPLAY_UNOBSCURED_RIGHT = 1200;
   private static final int DISPLAY_UNOBSCURED_BOTTOM = 680;
   @Override
   public void onCreate() {
      super.onCreate();
      // Create a virtual display to render instrument cluster activities on
      mDisplayManager = getSystemService(DisplayManager.class);
      VirtualDisplay display = mDisplayManager.createVirtualDisplay(
          mUniqueId, DISPLAY_WIDTH, DISPLAY_HEIGHT, DISPLAY_DPI, null,
          0 /* flags */, null, null);
      // Do any additional initialization (e.g.: start a video stream
      // based on this virtual display to present activities on a remote
      // display).
      onDisplayReady(display.getDisplay());
}
private void onDisplayReady(Display display) {
    // Report activity options that should be used to launch activities on
    // the instrument cluster.
    String category = CarInstrumentClusterManager.CATEGORY_NAVIGATION;
    ActionOptions options = ActivityOptions.makeBasic()
        .setLaunchDisplayId(display.getDisplayId());
    setClusterActivityOptions(category, options);
    // Report instrument cluster state.
    Rect unobscuredBounds = new Rect(DISPLAY_UNOBSCURED_LEFT,
        DISPLAY_UNOBSCURED_TOP, DISPLAY_UNOBSCURED_RIGHT,
        DISPLAY_UNOBSCURED_BOTTOM);
    boolean visible = true;
    ClusterActivityState state = ClusterActivityState.create(visible,
       unobscuredBounds);
    setClusterActivityState(category, options);
  }
}

Sử dụng CarAppFocusManager

API CarAppFocusManager cung cấp một phương thức có tên getAppTypeOwner() , cho phép dịch vụ cụm do OEM viết để biết ứng dụng điều hướng nào có tiêu điểm điều hướng tại bất kỳ thời điểm nào. OEM có thể sử dụng phương thức CarAppFocusManager#addFocusListener() hiện có, sau đó sử dụng getAppTypeOwner() để tìm hiểu ứng dụng nào có trọng tâm. Với thông tin này, OEM có thể:

  • Chuyển hoạt động được hiển thị trong cụm sang hoạt động trong cụm được cung cấp bởi ứng dụng điều hướng đang giữ tiêu điểm.
  • Có thể phát hiện xem ứng dụng điều hướng tập trung có hoạt động cụm hay không. Nếu ứng dụng điều hướng tập trung không có hoạt động cụm (hoặc nếu hoạt động đó bị vô hiệu hóa), OEM có thể gửi tín hiệu này tới DIM của ô tô để mặt điều hướng của cụm bị bỏ qua hoàn toàn.

Sử dụng CarAppFocusManager để đặt và lắng nghe tiêu điểm ứng dụng hiện tại, chẳng hạn như điều hướng hoạt động hoặc lệnh thoại. Thông thường, chỉ một phiên bản của ứng dụng như vậy đang hoạt động (hoặc tập trung) trong hệ thống.

Sử dụng phương CarAppFocusManager#addFocusListener(..) để lắng nghe các thay đổi về trọng tâm ứng dụng:

import android.car.CarAppFocusManager;

...

Car car = Car.createCar(this);
mAppFocusManager = (CarAppFocusManager)car.getCarManager(Car.APP_FOCUS_SERVICE);
mAppFocusManager.addFocusListener(this, CarAppFocusManager.APP_FOCUS_TYPE_NAVIGATION);

...

public void onAppFocusChanged(int appType, boolean active) {
    // Use the CarAppFocusManager#getAppTypeOwner(appType) method call
    // to retrieve a list of active package names
}

Sử dụng phương CarAppFocusManager#getAppTypeOwner(..) để truy xuất tên gói của chủ sở hữu hiện tại của một loại ứng dụng nhất định được lấy tiêu điểm. Phương thức này có thể trả về nhiều hơn một tên gói nếu chủ sở hữu hiện tại sử dụng tính năng android:sharedUserId .

import android.car.CarAppFocusManager;

...

Car car = Car.createCar(this);
mAppFocusManager = (CarAppFocusManager)car.getCarManager(Car.APP_FOCUS_SERVICE);
List<String> focusOwnerPackageNames = mAppFocusManager.getAppTypeOwner(
              CarAppFocusManager.APP_FOCUS_TYPE_NAVIGATION);

if (focusOwnerPackageNames == null || focusOwnerPackageNames.isEmpty()) {
        // No Navigation application has focus
        // OEM may choose to show their default cluster view
} else {
       // focusOwnerPackageNames
       // Use the PackageManager to retrieve the cluster activity for the package(s)
       // returned in focusOwnerPackageNames
}

...

Phụ lục: Sử dụng ứng dụng mẫu

AOSP cung cấp một ứng dụng mẫu triển khai API Trạng thái Điều hướng.

Để chạy ứng dụng mẫu này:

  1. Xây dựng và cài đặt Android Auto trên HU được hỗ trợ. Sử dụng xây dựng Android và hướng dẫn nhấp nháy dành riêng cho thiết bị của bạn. Để biết hướng dẫn, hãy xem Sử dụng bảng tham chiếu .
  2. Kết nối màn hình phụ vật lý với HU (nếu được hỗ trợ) hoặc bật HU phụ ảo:
    1. Chọn Chế độ nhà phát triển trong ứng dụng Cài đặt.
    2. Đi tới Cài đặt> Hệ thống> Nâng cao> Tùy chọn nhà phát triển> Mô phỏng màn hình phụ .
  3. Khởi động lại HU. Dịch vụ ClusterRenderingService được kết nối với màn hình phụ.
  4. Để khởi chạy ứng dụng KitchenSink:
    1. Mở ngăn kéo.
    2. Đi tới Inst. Cụm .
    3. Nhấp vào BẮT ĐẦU METADATA .

KitchenSink yêu cầu tiêu điểm NAVIGATION, hướng dẫn dịch vụ DirectRenderingCluster hiển thị giao diện người dùng giả lập trên Instrument Cluster.