Flagi AAOS konfiguracji dźwięku

System operacyjny Android Automotive (AAOS) korzysta z flag i konfiguracji, aby włączać różne funkcje, począwszy od dynamicznego kierowania na bardziej ogólne flagi funkcji, takie jak sterowanie głośnością z usługi samochodowej. Tutaj opisano flagi konfiguracji AAOS dotyczące zarządzania dźwiękiem.

Zgłoś Cel
audioUseDynamicRouting Zdefiniowany w pliku konfiguracji usługi samochodowej, aby włączyć routing AAOS. Konfiguracja musi mieć wartość true. Gdy false, routing i duża część CarAudioService są wyłączone, system operacyjny stosuje domyślne zachowanie opisane w sekcji Konfigurowanie zasad dotyczących dźwięku.
audioUseCarVolumeGroupMuting Zdefiniowane w pliku konfiguracji usługi samochodowej, aby umożliwić wyciszenie poszczególnych grup głośności. Gdy ustawisz wartość false (wartość domyślna), wyciszanie poszczególnych grup głośności zostanie wyłączone. Zamiast tego przełącznik wyciszenia powoduje wyciszenie główne. Gdy ustawisz wartość true, wyciszenie grupy głośności samochodu zostanie włączone, a każdą grupę głośności można wyciszyć osobno. Gdy true, wyciszanie grupy głośności musi być zaimplementowane w Audio Control HAL.
audioUseHalDuckingSignals Zdefiniowany w pliku konfiguracji usługi samochodowej, aby umożliwić interfejsowi API IAudioControl#onDevicesToDuckChange informowanie HAL, kiedy należy się zatrzymać. Gdy true (wartość domyślna), interfejs API otrzymuje sygnały wskazujące, które urządzenia wyjściowe należy wyciszyć i jakie zastosowania mają pozostać w fokusie. Gdy false, interfejs API nie jest wywoływany. Interfejs API nie jest wywoływany, chyba że HAL kontroli dźwięku obsługuje wyciszanie.
config_oemCarService Zdefiniowana w pliku konfiguracji usługi samochodowej nazwa komponentu usługi dostosowywania OEM. Producenci OEM mogą wdrożyć tę usługę, aby dostosować działania związane z serwisem samochodu do różnych zasad. Jeśli OEM zdecyduje się zaimplementować ten komponent, musi wdrożyć usługę rozszerzającą OemCarService udostępnianą przez car-lib, a następnie wdrożyć wymagane usługi komponentów. W przypadku usługi audio w samochodzie OEM może zaimplementować dowolną pod usługę audio, aby zarządzać działaniem audio. Więcej informacji znajdziesz w usłudze Car Audio Plugin. Jeśli nazwa komponentu jest nieprawidłowa, CarService nie połączy się z żadną usługą OEM. Nazwa komponentu nie może być pakietem zewnętrznym. Musi być wstępnie zainstalowany.
audioVolumeAdjustmentContextsVersion

Zdefiniowany w pliku konfiguracji usługi samochodowej, aby wybrać wersję listy priorytetów kontekstu regulacji głośności.

Wersja 1 zawiera wszystkie konteksty audio w tej kolejności:

  • NAVIGATION
  • CALL
  • MUSIC
  • ANNOUNCEMENT
  • VOICE_COMMAND
  • CALL_RING
  • SYSTEM_SOUND
  • SAFETY
  • ALARM
  • NOTIFICATION
  • VEHICLE_STATUSEMERGENCY

Wersja 2 jest ograniczona do tych kontekstów (w tej kolejności):

Wersja domyślna to 1.

  • CALL
  • MUSIC
  • ANNOUNCEMENT
  • VOICE_COMMAND
audioPersistMasterMuteState Zdefiniowany w pliku konfiguracji usługi samochodowej, aby zachować globalny stan wyciszenia. Gdy true (wartość domyślna) Android przywraca globalny stan wyciszenia po uruchomieniu. Jeśli audioUseCarVolumeGroupMuting jest ustawione na true, nie ma to wpływu na trwałe zmiany wyciszenia, ponieważ zmiany wyciszenia są oparte na poszczególnych grupach głośności. Wartość domyślna to true i musi zostać zastąpiona, gdy nie chcesz, aby wyciszenie główne było trwałe na urządzeniu.
audioVolumeKeyEventTimeoutMs

Zdefiniowana w pliku konfiguracji usługi samochodowej konfiguracja, która wskazuje czas oczekiwania (w milisekundach), gdy grupa głośności samochodu jest uważana za aktywną w przypadku zmian głośności podczas zdarzeń związanych z klawiszami głośności. Konfiguracja jest używana w ten sposób:

  • Czas oczekiwania służy do określania, czy odtwarzanie (głośność dźwięku związana z odtwarzaniem) może być nadal uwzględniana w automatycznym wyborze głośności po zakończeniu odtwarzania.
  • Czas oczekiwania jest też używany jako czas pauzy wymagany między automatycznymi korektami głośności, aby zmienić to, co użytkownik dostosowuje.

Wartość domyślna to 3000 ms i powinna być dostosowywana przez producentów OEM, aby dostosować wrażenia użytkownika.
audioUseCarVolumeGroupEvent Zdefiniowana w pliku konfiguracji usługi samochodowej konfiguracja umożliwiająca przekazywanie zdarzeń wywołania zwrotnego do grup objętości. Gdy true, klienci otrzymują wywołanie zwrotne ICarVolumeGroupEvent do zdarzeń, które wpływają na grupy objęte objętością. Jeśli jest włączona:
  • Zdecydowanie zalecamy, aby dostawcy również obsługiwali IAudioControl#setModuleChangeCallback i IAudioControl#registerGainCallback w przypadku zdarzeń i zmian w sprzęcie audio.
  • Jeśli zarówno CarVolumeCallback, jak i CarVolumeGroupEventCallback są zarejestrowane przez tę samą aplikację, wywołania zwrotne indeksu grupy głośności i wyciszania grupy głośności będą przekazywane tylko przez CarVolumeGroupEventCallback. Dlatego zdecydowanie zalecamy, aby wszystkie aplikacje zostały przeniesione na nowy interfejs wywołania zwrotnego, co zapewni spójną wydajność.

    • Wartość domyślna to false. Zalecamy ustawienie tej wartości na true, ponieważ interfejsy API obsługujące starsze wywołania zwrotne dotyczące głośności są wycofywane i wkrótce zostaną całkowicie usunięte.
config_useFixedVolume Zdefiniowane w frameworks/base/core/res/res/values/config.xml. Musi być ustawione na true, aby umożliwić usłudze audio w samochodzie zarządzanie regulacją głośności. Jeśli flaga config_useFixedVolume nie jest ustawiona lub jest ustawiona na false (wartość domyślna), aplikacje mogą wywoływać interfejsy API do zarządzania głośnością AudioManager i zmieniać głośność w zależności od typu strumienia w mikserze programowym. Może to być niepożądane ze względu na potencjalny wpływ na inne aplikacje oraz fakt, że tłumienie głośności w mikserze programowym może spowodować, że sygnał będzie zawierał mniej znaczących bitów po otrzymaniu na wzmacniaczu sprzętowym. Nowe urządzenia, które nie zostały skonfigurowane i są ustawione na true, otrzymują zmiany głośności za pomocą interfejsów API do regulowania głośności i wyciszania AudioManager.
config_handleVolumeKeysInWindowManager Zdefiniowany w pliku frameworks/base/core/res/res/values/config.xml, musi mieć wartość true, aby umożliwić usługom audio w samochodzie przechwytywanie zdarzeń związanych z klawiszami głośności. Jeśli ustawisz wartość false (wartość domyślna), zdarzenia związane z kluczem głośności mogą być przekierowywane do aplikacji na pierwszym planie, co może spowodować niekorzystne skutki zarządzania zdarzeniami związanymi z kluczem głośności poza usługą audio samochodu.
audioUseMinMaxActivationVolume Zdefiniowany w pliku konfiguracji usługi samochodowej w celu umożliwienia minimalnej i maksymalnej liczby aktywacji. Gdy true, indeks wzmocnienia głośności można dostosować ze względu na minimalną i maksymalną objętość aktywacji. Jeśli ustawisz wartość false (wartość domyślna), minimalna i maksymalna objętość aktywacji nie będą obowiązywać.
audioUseFadeManagerConfiguration Zdefiniowany w pliku konfiguracji usługi samochodowej w celu włączenia zachowania polegającego na utracie przez system priorytetu dźwięku. Gdy true, framework dźwięku w samochodzie analizuje definicje konfiguracji zanikania dźwięku w samochodzie i zachowuje odpowiednie FadeManagerConfiguration podczas wysyłania wiadomości o utracie fokusu dźwiękowego. Gdy ustawisz wartość false (wartość domyślna), system nie będzie wymuszać zanikania dźwięku, gdy aplikacja straci na nim skupienie.

Konfiguracje usług dźwięku w samochodzie

Przed Androidem 13 konfiguracje usług samochodowych były zastępowane za pomocą nakładki konfiguracji produktu (więcej informacji znajdziesz w artykule Dostosowywanie kompilacji za pomocą nakładek zasobów) w pliku packages/services/Car/service/res/values/config.xml.

PRODUCT_PACKAGE_OVERLAYS := <path_to_overlay>

Lokalizacja pliku konfiguracji z <path_to_overlay> do rzeczywistej lokalizacji powinna obejmować packages/services/Car/service/res/values/.

Serwis samochodowy RROs

Od Androida 13 AAOS obsługuje nakładki zasobów w czasie wykonywania. Użyj RRO, aby zmienić wartość konfiguracji dźwięku w samochodzie. Przykład: RRO dotyczące cuttlefish w dokumentacji device/google/cuttlefish/shared/auto/rro_overlay/. Konfiguracja audioUseDynamicRouting jest zastąpiona w device/google/cuttlefish/shared/auto/rro_overlay/CarServiceOverlay/res/values/config.xml.

<resources>
    <bool name="audioUseDynamicRouting">true</bool>
...

Mapa nakładki zasobów znajduje się w teczkach:device/google/cuttlefish/shared/auto/rro_overlay/CarServiceOverlay/res/xml/overlays.xml:

<overlay>
...
  <item target="bool/audioUseDynamicRouting"
value="@bool/audioUseDynamicRouting" />
...
</overlay>

Plik manifestu nakładki zasobu zdefiniowany w device/google/cuttlefish/shared/auto/rro_overlay/CarServiceOverlay/AndroidManifest.xml zawiera element targetPackage ustawiony jako com.android.car.updatable.

Więcej informacji znajdziesz w tych materiałach:

Interfejs API z włączoną funkcją

Metoda zwraca true, jeśli funkcja jest włączona na urządzeniu, w przeciwnym razie zwraca false. W interfejsie API CarAudioManager#isAudioFeatureEnabled parametr przekazany w ramach wywołania musi być jednym z tych elementów:

  • AUDIO_FEATURE_DYNAMIC_ROUTING
  • AUDIO_FEATURE_VOLUME_GROUP_MUTING
  • AUDIO_FEATURE_OEM_AUDIO_SERVICE
  • AUDIO_FEATURE_VOLUME_GROUP_EVENTS
  • AUDIO_FEATURE_AUDIO_MIRRORING