Integracja wideorejestratora

Aplikacja Dashcam została zaprojektowana z myślą o integracji z AAOS i zapewnia kierowcom możliwość nagrywania filmów w celu zwiększenia bezpieczeństwa. Ten przewodnik zawiera wymagania techniczne, kroki integracji i sprawdzone metody, które pomogą Ci w udanym wdrożeniu.

Wymagania wstępne

Zanim przejdziesz dalej, upewnij się, że są spełnione te warunki wstępne:

Pakiet SDK:

  • Wymagana jest wersja 31 lub nowsza pakietu SDK.

Sprzęt:

  • Aparaty EVS lub Camera2 dostępne w Androida One.
  • Do nagrywania filmów musi być dostępne wystarczające miejsce na urządzeniu z pamięcią wewnętrzną lub zewnętrzną.

Wymagania dotyczące oprogramowania:

Pobieranie kodu źródłowego

Kod źródłowy można znaleźć w wyszukiwarce kodu Androida:

https://cs.android.com/android/platform/superproject/+/ub-automotive-master-20250219:packages/apps/Car/Dashcam/

Kod źródłowy jest dostępny w tych 3 modułach:

  • Usługa wideorejestratora. strumieniowanie, nagrywanie i uruchamianie logiki;
  • Menedżer Dashcam Łączy się z usługą Dashcam i udostępnia klientom stabilne interfejs API.
  • Aplikacja Dashcam. Przykładowa aplikacja Dashcam korzystająca z Dashcam Manager API

Schemat architektury

Tworzenie wideorejestratora

Użyj Soong lub Gradle do skompilowania Dashcam.

Soong

Przed kompilacją za pomocą Soong wyczyść katalogi .cxx.

W Soong:

mma DashcamService DashcamManager-lib DashcamApp

Pliki APK znajdują się w folderze out/target/product/[lunch-target]/system/priv-app/

Gradle

W Gradle:

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

Pliki APK znajdują się w folderze out/aaos-apps-gradle-build/

Szczegółowe instrukcje kompilowania Dashcam za pomocą Gradle znajdziesz w pliku README.

Uprawnienia

Usługa Dashcam i aplikacja Dashcam wymagają kilku uprawnień systemowych.

Najprostszym sposobem przyznania tych uprawnień jest uwzględnienie ich w uprzednio skonfigurowanym ustawieniu za pomocą szablonu lub Make.

W planie:

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

W sekcji Marka:

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

Utwórz plik uprawnień o nazwie 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>

Dodaj uprawnienia z pliku manifestu do pliku uprawnień.

Więcej informacji znajdziesz w artykule o wstępnie utworzonych obrazach systemowych.

Instalowanie z nieoficjalnego źródła

Plik z uprawnieniami można też zainstalować ręcznie. Użyj tej metody, gdy wstępnie skonfigurowana kamera samochodowa nie jest skonfigurowana.

Użyj pliku uprawnień utworzonego wcześniej w sekcji z wstępnie skompilowanymi plikami:

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

Konfigurowanie nakładek

Usługa Dashcam ma konfiguracje, które można nakładać.

Konfiguracja usługi

dashcam-service/res/values/config.xml

Ten plik zawiera konfiguracje usługi:

  • allow_internal_storage Zezwalanie na nagrywanie w pamięci wewnętrznej
  • save_location Nazwa katalogu, w którym mają być zapisywane nagrania. Domyślnie: dashcam
  • max_storage_mb Ile miejsca na dane ma być wykorzystywane przez wideorejestrator
  • max_age_days Jak długo plik ma być przechowywany przed przycięciem
  • boot_startup_enabled Uruchomienie usługi wideorejestratora po uruchomieniu urządzenia
  • notifications_on Pokaż powiadomienia po rozpoczęciu nagrywania
  • native_recorder Używanie interfejsów NDK, domyślnie interfejsy Java
  • native_renderer Używanie interfejsów NDK, domyślnie interfejsy Java
  • default_app_component Domyślna aplikacja rejestratora jazdy, która ma dostęp do wszystkich nagrań i do wszystkich zdarzeń
  • recording_module ComponentName implementacji IRecordingModule
  • streaming_module ComponentName implementacji IRecordingModule
  • trigger_module ComponentName implementacji IRecordingModule

Konfigurowanie reguły

Aby uruchomić konfigurację, uruchom:

dashcam-service/src/assets/config.xml

Ten plik zawiera konfiguracje wyzwalaczy nagrywania. Konfiguracja reguły składa się z 2 części:

  • Identyfikator reklamy przed filmem. Identyfikator aparatu (EVSS lub Camera2) w zależności od tego, co jest obsługiwane.

  • prerollLengthMs Długość wstępu, który ma być przechowywany wraz z każdym zdarzeniem.

<Preroll>
  <Camera
      ID="0"
      prerollLengthMs="10000" />
</Preroll>

Ten przykład pokazuje kamerę o identyfikatorze 0 z 10-sekundowym filmem wstępnym.

  • name Unikalna nazwa reguły

  • camera Identyfikator kamery (EVs lub Camera2 w zależności od tego, co jest obsługiwane)

  • sensorPropertyID Identyfikator czujnika

  • description Opis reguły wyświetlany w interfejsie

  • recordingLengthMs Czas trwania nagrywania po zdarzeniu w milisekundach.

  • sensorType Typ czujnika. Dostępne opcje to VHAL lub SENSOR_MANAGER

  • sensorValueType Typ danych generowanych przez czujnik. Opcje to INT, INT_ARRAY, FLOAT, FLOAT_ARRAY i BOOLEAN, STRING.

  • thresholdType Jak ocenić wartość czujnika. Opcje: AVERAGE, BOOLEAN, EQUALS, LEAP, LEAP_AVERAGE, LEAP_OVER, PEAK i PEAK_HOLD

  • thresholdValue Wartość, z którą porównać wartość czujnika przy danym typie progu

  • thresholdExtra Dodatkowa wartość wymagana w przypadku niektórych typów progów, takich jak zakres w przypadku AVERAGE

  • triggerCooldown Czas oczekiwania przed wywołaniem kolejnego zdarzenia tego typu w milisekundach.

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

Ten przykład pokazuje czujnik VHAL, który zwraca wartości całkowite, gdzie porównujemy równość z wartością progową. Gdy warunek równości jest spełniony, wyzwalacz rejestruje w kamerach 1 i 2.

<EventTrigger
            name="SPEED"
            camera="1 2 3 4"
            sensorPropertyID="291504648"
            description="Over speed"
            recordingLengthMs="10000"
            sensorType="VHAL"
            sensorValueType="FLOAT"
            thresholdType="AVERAGE"
            thresholdValue="20.0"
            thresholdExtra="1000"
            triggerCooldown="2000"/>

Ten przykład pokazuje czujnik VHAL, który zwraca wartości zmiennoprzecinkowe. Średnią z różnych próbek porównuje się z wartością progową. Zakres próbki jest ustawiony w thresholdExtra

Moduły

Usługa Dashcam składa się z 3 modułów:

  • Stream zawiera logikę obsługi strumieni z kamer.

  • Recording zawiera logikę obsługi nagrań.

  • Wyzwalacz zawiera logikę wyzwalania nagrywania na podstawie danych z czujników. Interfejsy API modułów są zdefiniowane w odpowiednich interfejsach IStreamModule, IRecorderModule i ITriggerModule oraz udostępniane interfejsowi DashcamManager za pomocą DashcamServiceAPI.

Moduły nakładek

Usługa Dashcam używa właściwości dashcam-service/res/values/config.xml do określenia, gdzie znajdują się implementacje modułów. Dla każdego modułu udostępniamy domyślne implementacje. Każdy moduł można jednak nałożyć, ustawiając jego komponent w odpowiedniej wartości konfiguracji.

  • Ustaw nazwę komponentu implementacji OEM o nazwie IRecorderModule na recording_module

  • Ustaw nazwę komponentu OEM IStreamModule na nazwę modułu strumieniowego.

  • Ustaw nazwę komponentu implementacji OEM o nazwie ITriggerModule na trigger_module

    Podczas działania usługa Dashcam tworzy instancję nazwy komponentu ustawionej w config.xml dla każdego modułu.

Przewodnik dla deweloperów aplikacji

Dashcam to gotowe do wdrożenia i możliwe do dostosowania rozwiązanie do rejestrowania obrazu z przodu pojazdu. Dashcam do komunikacji z Dashcam service używa interfejsów Dashcam Manager API. Interfejs DashcamManager API znajdziesz na stronie IDashcamManager. Każda aplikacja z wymaganymi uprawnieniami może korzystać z Menedżera wideorejestratora.

Uprawnienia

Obsługiwane są Camera2 i EV.

Gotowe

Najprostszym sposobem przyznania tych uprawnień jest uwzględnienie ich w gotowym szablonie za pomocą Blueprint lub Make.

OverlayUI

Aplikację można dostosować za pomocą nakładek zasobów w czasie działania. Więcej informacji znajdziesz w artykule Nakładki zasobów w czasie wykonywania. Aby zobaczyć listę elementów, które można nakładać, otwórz plik overlayable.xml.

Rozszerzanie reguł

Korzystając z funkcji DashcamManager.addTrigger(), możesz rozszerzyć działanie reguł na bieżącą sesję. Dodane reguły są aktywne tylko w bieżącej sesji.

Automatyczne uruchamianie

Automatyczne uruchamianie nagrywania nie jest obsługiwane. Można jednak uruchomić onBoot za pomocą wywołania DashcamManager.startRecording()

Sprawdzone metody

  • Miejsce na dane Zdecydowanie zalecamy użycie zewnętrznego wymiennego urządzenia pamięci masowej.

  • Interfejs użytkownika. Zaprojektuj interfejs aplikacji Dashcam tak, aby był intuicyjny i przyjazny dla użytkownika, a jednocześnie zgodny ze wskazówkami dotyczącymi AAOS.

  • Optymalizacja skuteczności. Zoptymalizuj wydajność aplikacji, aby zminimalizować wykorzystanie zasobów i zapewnić płynne działanie w AAOS.

Rozwiązywanie problemów

  • Problemy z połączeniem kamery EVS lub Camera2 muszą być obsługiwane i dostępne w AAOS IVI.

  • Błędy miejsca na dane. Sprawdzanie dostępnego miejsca na dane i zarządzanie nagraniami. Zdecydowanie zalecamy korzystanie z pamięci zewnętrznej, ponieważ używanie pamięci wewnętrznej może spowodować przedwczesne zużycie pamięci.