Kể từ ngày 27 tháng 3 năm 2025, bạn nên sử dụng android-latest-release thay vì aosp-main để xây dựng và đóng góp cho AOSP. Để biết thêm thông tin, hãy xem phần Thay đổi đối với AOSP.

Trang này được dịch bởi Cloud Translation API.

Tích hợp Dashcam

Ứng dụng Dashcam được thiết kế để tích hợp với AAOS, cung cấp cho người lái xe khả năng quay video để tăng cường sự an toàn và bảo mật. Hướng dẫn này trình bày các yêu cầu kỹ thuật, các bước tích hợp và các phương pháp hay nhất để đảm bảo việc triển khai thành công.

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

Trước khi tiếp tục, hãy đảm bảo bạn đáp ứng các điều kiện tiên quyết sau:

SDK:

Yêu cầu SDK 31 trở lên.

Phần cứng:

Camera EVS hoặc Camera2 có sẵn cho AAOS.
Bạn phải có đủ bộ nhớ trong hoặc hỗ trợ bộ nhớ ngoài có thể tháo rời
để quay video.

Yêu cầu về phần mềm:

Hỗ trợ riêng lẻ. Để tìm hiểu thêm, hãy xem bài viết Ứng dụng không đi kèm.
Quyền. Dashcam cần có quyền truy cập vào hệ thống.

Lấy mã nguồn

Dashcam là một phần của các ứng dụng độc lập trên AAOS. Để kiểm tra mã chưa được kết hợp, hãy xem phần Kiểm tra mã.

Duyệt mã nguồn bằng Android Code Search (Công cụ tìm kiếm mã Android).

Mã nguồn được cung cấp trong 3 mô-đun sau:

Dịch vụ Dashcam. Logic phát trực tuyến, ghi hình và kích hoạt.
Dashcam Manager. Kết nối với Dịch vụ camera hành trình và cung cấp một API ổn định cho các ứng dụng
Ứng dụng Dashcam.Ứng dụng Dashcam tham chiếu bằng API Trình quản lý Dashcam

Sơ đồ kiến trúc

Tạo Dashcam

Dùng Soong hoặc Gradle để tạo Dashcam.

Soong

On Soong:

mma DashcamService DashcamManager-lib DashcamApp

Các APK nằm trong out/target/product/[lunch-target]/system/priv-app/

Gradle

Trên Gradle:

./gradlew :dashcam-app:assemble
./gradlew :dashcam-manager:assemble
./gradlew :dashcam-service:assemble

Các APK nằm trong out/aaos-apps-gradle-build/

Hướng dẫn chi tiết về cách tạo Dashcam bằng Gradle có trong tệp README.

Quyền

Dịch vụ Dashcam và Ứng dụng Dashcam cần có một số quyền hệ thống.

Cách đơn giản nhất để cấp các quyền này là đưa chúng vào một chế độ thiết lập dựng sẵn bằng cách sử dụng Blueprint hoặc Make.

Trong Blueprint:

Android.bp
android_app_import {
    name: "DashcamApp-prebuilt",
    apk: "DashcamApp.apk",
    privileged: true,
    certificate: "platform",
    required: ["allowed_privapp_com.android.car.dashcam"],
}

prebuilt_etc {
    name: "allowed_privapp_com.android.car.dashcam",
    sub_dir: "default-permissions",
    src: "allowed_privapp_com.android.car.dashcam.xml",
    filename_from_src: true,
}

Trong thẻ Tạo:

dashcam.mk
PRODUCT_PACKAGES += \
    DashcamApp
PRODUCT_COPY_FILES :=\
vendor/[path-to-vendor-prebuilts]/apps/Dashcam/allowed_privapp_com.android.car.dashcam:$(TARGET_COPY_OUT_PRODUCT)/etc/permissions/com.android.car.dashcam.xml \

Tạo một tệp quyền có tên allowed_privapp_com.android.car.dashcam.xml:

<permissions>
  <privapp-permissions package="com.android.car.dashcam.service">
      <permission name="" />
  </privapp-permissions>
  <privapp-permissions package="com.android.car.dashcam.app">
      <permission name="" />
  </privapp-permissions>
</permissions>

Thêm các quyền từ tệp kê khai vào tệp quyền.

Trước khi sử dụng Dashcam, hãy cấp trước quyền Camera2 cho Dịch vụ Dashcam như minh hoạ trong Camera AAOS.

Thêm tệp quyền được cấp trước vào tệp Blueprint hoặc Make theo cách tương tự như tệp quyền.

Trong pre-grant-permissions-com.android.car.dashcam.xml:

<exceptions>
    <exception package="com.android.car.dashcam.service">
        <permission name="android.permission.CAMERA" fixed="false" />
        <permission name="android.permission.SYSTEM_CAMERA" fixed="false" />
        <permission name="android.permission.CAMERA_HEADLESS_SYSTEM_USER" fixed="false" />
    </exception>
</exceptions>

Trong Android.bp:

...
required["pre-grant-permissions-com.android.car.dashcaml"]
...

prebuilt_etc {
    name: "pre-grant-permissions-com.android.car.dashcaml",
    sub_dir: "default-permissions",
    src: "pre-grant-permissions-com.android.car.dashcam.xml",
    filename_from_src: true,
}

Để tìm hiểu thêm, hãy xem phần Tích hợp một bản dựng sẵn vào hình ảnh hệ thống và Thêm danh sách cho phép.

Tải từ nguồn ngoài

Bạn cũng có thể tải tệp quyền lên thiết bị theo cách thủ công. Sử dụng phương thức này khi bạn chưa định cấu hình Camera hành trình được tạo sẵn.

Dùng tệp quyền đã tạo trong phần dựng sẵn trước đó, hãy chạy:

adb root
adb remount
adb push allowed_privapp_com.android.car.dashcam.xml /etc/permissions/allowed_privapp_com.android.car.dashcam.xml
adb shell chmod 644 /etc/permissions/allowed_privapp_com.android.car.dashcam.xml

Thêm tệp quyền trước khi cấp theo cách tương tự như etc/default-permissions/.

Định cấu hình lớp phủ

Dịch vụ camera hành trình có các cấu hình có thể phủ lên.

Cấu hình dịch vụ

dashcam-service/res/values/config.xml

Tệp này chứa cấu hình cho dịch vụ:

config_file Tên của tệp cấu hình điều kiện kích hoạt trong /assets
allow_internal_storage Cho phép lưu bản ghi âm vào bộ nhớ trong
boot_startup_enabled Dịch vụ Dashcam bắt đầu khi thiết bị khởi động
notifications_on Hiện thông báo khi bắt đầu ghi
default_app_component Ứng dụng camera hành trình mặc định, có quyền truy cập vào bản ghi hình và quyền truy cập vào sự kiện kích hoạt trên toàn cầu
recording_module ComponentName của quá trình triển khai IRecordingModule
streaming_module ComponentName của quá trình triển khai IStreamingModule
trigger_module ComponentName của quá trình triển khai ITriggerModule

Cấu hình điều kiện kích hoạt

Để định cấu hình trình kích hoạt ghi hình, hãy tạo bản sao của:

dashcam-service/src/assets/config.xml

và thêm tệp này vào thư mục thành phần. Trỏ đến tệp này trong phần tử config_file trong tệp cấu hình dịch vụ.

Cấu hình trình kích hoạt bao gồm các phần lưu trữ, camera và trình kích hoạt:

Dung lượng lưu trữ

Cấu hình bộ nhớ có các phần tử sau:

maxStorageUsagePercent Tỷ lệ phần trăm tối đa của bộ nhớ có sẵn mà camera hành trình sử dụng trước khi cắt bớt các bản ghi.
maxStorageUsageMegabytes Dung lượng bộ nhớ tối đa mà camera hành trình sử dụng trước khi cắt bớt các bản ghi.
maxAgeHoursBeforePrune Số giờ tối đa trước khi bản ghi bị cắt bớt. Bản ghi có thể bị cắt bớt sớm hơn nếu đạt đến giới hạn bộ nhớ.

Camera

Cấu hình camera có các phần tử sau:

Mã nhận dạng camera. Mã nhận dạng của camera có tiền tố camera.
prerollLengthMs Độ dài của quảng cáo trước video được lưu trữ với mỗi sự kiện.
width Chiều rộng không bắt buộc của vùng đệm do camera trả về.
height Chiều cao không bắt buộc của vùng đệm do camera trả về.

<CameraConfig>
  <Camera
      ID="EVS:1"
      prerollLengthMs="10000"
      width="1920"
      height="1080" />
  <Camera
      ID="Camera2:1"
      prerollLengthMs="10000" />
</CameraConfig>

Ví dụ này cho thấy camera có mã nhận dạng EVS:1 với một quảng cáo trước video dài 10 giây ở độ phân giải 1080p và camera có mã nhận dạng Camera2:1 với một quảng cáo trước video dài 10 giây cùng chiều rộng và chiều cao mặc định.

Trigger

Cấu hình điều kiện kích hoạt bao gồm một danh sách các điều kiện kích hoạt được xác định theo những yếu tố sau:

name Tên duy nhất của điều kiện kích hoạt.
cameras mã nhận dạng của camera.
sensorPropertyID Mã nhận dạng của cảm biến có tiền tố là nhóm cảm biến. Các lựa chọn về tiền tố là VHAL hoặc SENSOR_MANAGER.
description Nội dung mô tả về điều kiện kích hoạt xuất hiện trong giao diện người dùng.
recordingLengthMs Thời lượng sau sự kiện cần ghi lại tính bằng mili giây.
sensorValueType Loại dữ liệu do cảm biến tạo ra. Các lựa chọn là INT, INT_ARRAY, FLOAT, FLOAT_ARRAY và BOOLEAN, STRING.
thresholdType Cách đánh giá giá trị cảm biến dựa trên thresholdValue. Các lựa chọn là AVERAGE, BOOLEAN, EQUALS, LEAP, LEAP_AVERAGE, LEAP_OVER, PEAK và PEAK_HOLD.
thresholdValue Giá trị được so sánh với giá trị của cảm biến.
thresholdExtra Cần có giá trị bổ sung cho một số loại ngưỡng, chẳng hạn như phạm vi cho AVERAGE.
triggerCooldown Thời gian chờ tính bằng mili giây trước khi kích hoạt một sự kiện khác thuộc loại này.

<EventTriggers>
  <EventTrigger
      name="AEB"
      cameras="EVS:1, EVS:2"
      sensorPropertyID="VHAL:289411073"
      description="Automatic Emergency Braking"
      recordingLengthMs="20000"
      sensorValueType="INT"
      thresholdType="EQUALS"
      thresholdValue="2"
      triggerCooldown="5000"/>
</EventTriggers>

Ví dụ này cho thấy một điều kiện kích hoạt trong đó TriggerModule giám sát một cảm biến VHAL tạo ra các giá trị số nguyên. TriggerModule so sánh sự bằng nhau với giá trị ngưỡng. Khi điều kiện về sự bằng nhau được đáp ứng, một sự kiện kích hoạt sẽ ghi lại trên camera EVS 1 và 2.

<EventTrigger
            name="SPEED"
            cameras="Camera2:0, Camera2:1,  Camera2:2,  Camera2:3"
            sensorPropertyID="VHAL:291504648"
            description="Over speed"
            recordingLengthMs="10000"
            sensorValueType="FLOAT"
            thresholdType="AVERAGE"
            thresholdValue="20.0"
            thresholdExtra="10"
            triggerCooldown="2000"/>

Ví dụ này cho thấy một điều kiện kích hoạt trong đó TriggerModule giám sát một cảm biến VHAL tạo ra các giá trị số thực. TriggerModule so sánh mức trung bình của cảm biến trong một phạm vi gồm 10 mẫu với giá trị ngưỡng 20.0. Phạm vi mẫu được đặt trong thresholdExtra. Bạn chỉ có thể kích hoạt một sự kiện mới sau mỗi 2000 mili giây như đã đặt trong triggerCooldown.

Mô-đun

Dashcam Service bao gồm 3 mô-đun:

Stream chứa logic để xử lý các luồng từ camera.
Recording (Ghi hình) chứa logic để xử lý bản ghi.
Trigger chứa logic để kích hoạt quá trình ghi từ dữ liệu cảm biến. Các API mô-đun được xác định trong các giao diện tương ứng, IStreamModule, IRecorderModule và ITriggerModule, đồng thời được hiển thị cho DashcamManager thông qua DashcamServiceAPI.

Mô-đun lớp phủ

Dashcam Service sử dụng dashcam-service/res/values/config.xml để xác định vị trí tìm các hoạt động triển khai mô-đun. Phương thức triển khai mặc định được cung cấp cho từng mô-đun. Tuy nhiên, bạn có thể phủ từng mô-đun bằng cách đặt thành phần của mô-đun đó trong giá trị cấu hình tương ứng.

Đặt tên thành phần triển khai OEM của:

IRecorderModule đến recording_module
IStreamModule đến streaming_module
ITriggerModule đến trigger_module

Trong thời gian chạy, dịch vụ Camera hành trình sẽ tạo thực thể cho tên thành phần được đặt trong config.xml cho từng mô-đun.

Hướng dẫn dành cho nhà phát triển ứng dụng

Dashcam là một giải pháp camera hành trình có thể tuỳ chỉnh và sẵn sàng phát hành công khai. Camera hành trình sử dụng Dashcam Manager API để giao tiếp với Dashcam service. Bạn có thể tìm thấy DashcamManager API tại IDashcamManager. Mọi ứng dụng có các quyền cần thiết đều có thể sử dụng Dashcam Manager.

OverlayUI

Bạn có thể tuỳ chỉnh ứng dụng bằng Lớp phủ tài nguyên thời gian chạy. Để tìm hiểu thêm, hãy xem phần Lớp phủ tài nguyên trong thời gian chạy. Để xem danh sách các phần tử có thể phủ lên, hãy xem overlayable.xml.

Mở rộng các điều kiện kích hoạt

Bạn có thể mở rộng điều kiện kích hoạt cho phiên hiện tại bằng lệnh gọi đến DashcamManager#addTrigger(). Các điều kiện kích hoạt đã thêm chỉ tồn tại trong phiên hiện tại.

Tự động bắt đầu

Không hỗ trợ tính năng tự động bắt đầu ghi. Tuy nhiên, bạn có thể bắt đầu một trình kích hoạt thủ công onBoot bằng cách gọi DashcamManager.startRecording()

Các phương pháp hay nhất

Bộ nhớ. Bạn nên sử dụng bộ nhớ ngoài có thể tháo rời.
Trải nghiệm người dùng. Thiết kế giao diện người dùng của ứng dụng Dashcam sao cho trực quan và thân thiện với người dùng, đồng thời tuân thủ các nguyên tắc thiết kế của AAOS.
Tối ưu hoá hiệu suất. Tối ưu hoá hiệu suất của ứng dụng để giảm thiểu mức sử dụng tài nguyên và đảm bảo hoạt động trơn tru trong AAOS.

Khắc phục sự cố

Vấn đề về kết nối camera. EVS hoặc Camera2 phải được hỗ trợ và có trong IVI của AAOS.
Lỗi bộ nhớ. Xác minh dung lượng lưu trữ còn trống và quản lý bản ghi. Bạn nên sử dụng bộ nhớ ngoài vì việc sử dụng bộ nhớ trong có thể khiến bộ nhớ bị hao mòn sớm.

Tích hợp Dashcam 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.