Medien-Apps mit der Car App Library

Entwickler von Media-Apps können die Car App Library (CAL) verwenden, um die Benutzeroberfläche ihrer App zu erstellen. Diese Bibliothek bietet eine Alternative zur herkömmlichen Methode, Daten über MediaBrowserService für die Darstellung durch die CarMediaApp bereitzustellen.

Mit CAL-basierten Media-Apps mit Vorlage können Entwickler die Benutzeroberfläche an ihre Markenidentität anpassen. Im Gegensatz zu CAL-basierten Apps können Entwickler bei herkömmlichen Medien-Apps, die MediaBrowserService und CarMediaApp verwenden, das UI-Styling nicht anpassen. Dieses Styling wird vom OEM gesteuert.

Entwickler können eine Media-App mit Vorlage erstellen, die Android Auto und Android Automotive OS (AAOS) unterstützt.

Einbinden

Die Unterstützung für CAL-basierte Media-Apps mit Vorlage erfordert eine Plattformintegration.

Vorbereitung

Mit der Funktion „Alternative App Controls“ können Apps Hintergrundaudio wiedergeben und gleichzeitig ablenkungsoptimierte Steuerelemente zur Steuerung dieses Audios bereitstellen.

• „Alternative App Controls“ ist in Car-apps-release-14 und höher verfügbar.

  • Ermöglicht Apps, Hintergrundaudio wiederzugeben
  • Ermöglicht, dass Apps, die MediaBrowserService nicht verwenden, weiterhin über eine System-Medienkarte gesteuert werden können.

• Die Plattform muss die Unterstützung für com.android.car.background_audio_while_driving deklarieren.

Plattformänderungen

Die CarMediaApp der Plattform muss folgende Voraussetzungen erfüllen:

• Sie muss die Berechtigung haben, die CAL-Aktivität einer Media-App zu aktivieren. Codebeispiel ansehen.
• Sie muss die CAL-Aktivität anstelle von Media Center auf Geräten starten, die das Feature android.software.car.templates_host.media unterstützen. Codebeispiel ansehen.

Der Car Launcher der Plattform muss folgende Voraussetzungen erfüllen:

• Er muss nur ein App-Symbol im Car Launcher anzeigen, nachdem die CarMediaApp die CAL-Aktivität einer Media-App aktiviert hat.
• Er muss auf die PACKAGE_CHANGED Broadcast-Nachricht warten und die Liste der Apps aktualisieren. Codebeispiel ansehen.

Die Medienkarte oder das Widget der Plattform muss folgende Voraussetzungen erfüllen:

• Sie muss die Audioausgabe in der Medienkarte anzeigen.

Build-Konfiguration

Die Plattform muss die Unterstützung für android.software.car.templates_host.media deklarieren:

<permissions>
    <!-- Declare support for templated applications. -->
    <feature name="android.software.car.templates_host" />

    <!-- This feature indicates that the system supports apps that use the
    Car App Library Media category -->
    <feature name="android.software.car.templates_host.media"/>
</permissions>

Test

Testen Sie die Plattformunterstützung für CAL-basierte Media-Apps mit TestMediaCalApp. TestMediaCalApp ist eine Media-App, die mit der Car App Library erstellt wurde und vom Templates Host auf der Plattform gerendert wird.

1. Installieren Sie TestMediaCalApp.apk.

2. Öffnen Sie die App mit dem Namen Test Media3 CAL App im Launcher:

   

   Abbildung 1 : Test Media3 CAL App im Car Launcher

3. Nach dem Start der App kehren Sie zum Launcher zurück. Der Name der App wurde in Test Media CAL App geändert. Die vorherige App mit dem Namen Test Media3 CAL App sollte nicht mehr sichtbar sein:

   

   Abbildung 2 : Test Media CAL App im Car Launcher

4. Öffnen Sie Test Media CAL App und spielen Sie einen beliebigen Song ab, indem Sie in der Playlist auf einen Song tippen:

   

   Abbildung 3 : Playlist-Ansicht, gerendert vom App Host

5. Die Ansicht „Wird jetzt wiedergegeben“ (MediaPlaybackTemplate) wird geöffnet:

   

   Abbildung 4 : Ansicht „Wird jetzt wiedergegeben“, gerendert vom App Host

6. Die Metadaten der Wiedergabe werden im Medien-Widget auf dem Startbildschirm angezeigt:

   

   Abbildung 5 : Medienkarte