Estendi la tua app multimediale ad Android per le auto

Porta la tua app sui veicoli con Android Auto o Android Automotive OS. Utilizza un'architettura dell'app che funzioni per entrambi i casi, in modo che ogni utente possa utilizzare la tua app.

Che cos'è Android for Cars?

Un'app multimediale per auto può offrire agli utenti un modo per collegare la propria vita digitale alle proprie auto. Se estendi le stesse app per smartphone in modo che siano disponibili per le auto, crei un'esperienza utente migliore. Puoi farlo integrandoti con Android Auto o Android Automotive OS.

Le app per Android per auto devono evitare la distrazione del conducente. Puoi minimizzare le distrazioni seguendo le best practice, ad esempio l'utilizzo dei comandi vocali e un design visivo molto pratico. In questo modo, l'app multimediale può mostrare al conducente informazioni tempestive solo quando sono pertinenti e utilizzare pattern prevedibili per le attività comuni.

Android Auto

Android Auto offre un'esperienza con le app ottimizzata per il conducente per gli utenti che hanno uno smartphone Android con l'app Android Auto e un impianto stereo aftermarket o dell'auto compatibile. Possono usare la tua app direttamente sul display dell'auto collegando il telefono. Consenti ad Android Auto di connettersi all'app del telefono creando servizi che Android Auto utilizza per mostrare al conducente un'interfaccia ottimizzata per il conducente.

Nota: Android Auto è compatibile solo con gli smartphone con Android 9 (livello API 28) o versioni successive.

Sistema operativo Android Automotive

Il sistema operativo Android Automotive è un sistema di infotainment basato su Android integrato nei veicoli. Il sistema dell'auto è un dispositivo autonomo basato su Android ottimizzato per la guida. Con il sistema operativo Android Automotive, gli utenti installano la tua app direttamente nell'auto anziché sui loro telefoni.

Categorie di app supportate

Importante: le app multimediali e video sono considerate categorie separate per le auto, come spiegato più dettagliatamente nella tabella delle categorie di app. Per informazioni dettagliate sulle app che riproducono video, consulta la categoria Video.

Le app multimediali consentono agli utenti di sfogliare e riprodurre musica, radio, audiolibri e altri contenuti audio in auto. Per ulteriori informazioni, consulta Creare app di riproduzione audio per le auto. Puoi trovare ulteriori informazioni anche nella pagina Creare app multimediali per le auto.

Le app multimediali vengono create utilizzando MediaLibraryService e MediaSession. Sul sistema operativo Android Automotive, puoi anche creare schermate di accesso e impostazioni (da utilizzare quando il veicolo è parcheggiato) utilizzando Visualizzazioni o Scrittura.

Le app video consentono agli utenti di guardare video in streaming mentre l'auto è parcheggiata. Lo scopo principale di queste app è la visualizzazione di video in streaming. Queste app sono create utilizzando Visualizzazioni o Scrittura. Per ulteriori informazioni, consulta Creare app di riproduzione video per il sistema operativo Android Automotive. Ulteriori informazioni sono disponibili nella pagina Creare app video per il sistema operativo Android Automotive.

Creare app di riproduzione audio per le auto

Questa guida presuppone che tu abbia già un'app di riproduzione multimediale di base. In caso contrario, per iniziare, consulta Creare un'app di media player di base.

Questa guida fornisce informazioni su cosa devi fare, inclusi link a ulteriori risorse con indicazioni specifiche.

Componenti di riproduzione

Media3 offre diversi componenti chiave per i casi d'uso di riproduzione. Le classi che compongono questi componenti ti sono familiari se hai lavorato con le librerie multimediali Android precedenti.

Il seguente diagramma mostra come questi componenti vengono combinati in un'app tipica.

Figura 1: componenti dell'app multimediale

Importante: una delle caratteristiche principali che distingue Media3 dalle API multimediali precedenti è che non è più necessario utilizzare connettori tra i componenti. La nuova classe MediaSession accetta qualsiasi classe che implementa l'interfaccia Player, così come l'interfaccia utente. Sia ExoPlayer che MediaController sono classi che implementano questa interfaccia. In questo modo, l'interazione tra i componenti è molto più agevole.

Per ulteriori informazioni, consulta Componenti di riproduzione.

Implementare un MediaLibraryService e un MediaLibrarySession

Un MediaLibraryService fornisce un'API standardizzata per pubblicare e consentire l'accesso alla tua raccolta multimediale. Questo è necessario quando aggiungi il supporto di Android Auto o Android Automotive OS alla tua app multimediale, poiché queste piattaforme forniscono la propria UI sicura per il conducente per la tua raccolta multimediale. Per ulteriori informazioni sull'implementazione e sull'utilizzo di un MediaLibraryService, consulta Pubblicare contenuti con MediaLibraryService.

Per i controlli di riproduzione, utilizza una sessione multimediale. L'API MediaSession fornisce un modo universale per interagire con un player audio o video. La libreria Media3 di Jetpack include MediaLibrarySession, che estende MediaSession per aggiungere API di navigazione dei contenuti.

La connessione di una sessione multimediale a un player consente a un'app di pubblicizzare la riproduzione di contenuti multimediali all'esterno e di ricevere comandi di riproduzione da origini esterne come Android Auto, Android Automotive OS o l'Assistente Google. Per ulteriori informazioni, consulta Controllare e pubblicizzare la riproduzione utilizzando una MediaSession e Utilizzare una MediaLibrarySession.

Come minimo, la sessione multimediale deve dichiarare il supporto per i seguenti comandi del media player:

• COMMAND_PLAY_PAUSE

• COMMAND_STOP

• COMMAND_SET_MEDIA_ITEM

• COMMAND_PREPARE

La guida Attivare i controlli di riproduzione descrive i modi in cui puoi personalizzare i controlli di riproduzione nelle auto.

Quando Android Auto o il sistema operativo Android Automotive si connettono alla tua app, richiedono di visualizzare una raccolta di contenuti, che attiva il metodo di callback onGetLibraryRoot(). Puoi restituire rapidamente un elemento multimediale principale per consentire l'accesso alla tua biblioteca. Il metodo di callback onGetChildren() viene chiamato quando Android Auto o Android Automotive OS tentano di sfogliare livelli più profondi della raccolta di contenuti.

Queste piattaforme applicano limiti aggiuntivi alla struttura della raccolta dei tuoi contenuti. Per informazioni dettagliate sulla personalizzazione della visualizzazione della raccolta di contenuti, consulta la guida Creare il servizio di browser multimediale.

Dichiarare il supporto di Android Auto

Utilizza la seguente voce manifest per dichiarare che la tua app per smartphone supporta Android Auto:

<application>
    ...
    <meta-data android:name="com.google.android.gms.car.application"
        android:resource="@xml/automotive_app_desc"/>
    ...
</application>

Questa voce del file manifest fa riferimento a un file XML che dichiara le funzionalità per auto e motori supportate dalla tua app. Per indicare che hai un'app multimediale, aggiungi un file XML denominato automotive_app_desc.xml alla directory res/xml/ nel tuo progetto. Questo file deve includere i seguenti contenuti:

<automotiveApp>
    <uses name="media"/>
</automotiveApp>

Dichiarare il supporto per Android Automotive OS

Devi creare un modulo per auto e motori perché non tutta la logica della tua app può essere condivisa con un'app per auto e motori. Alcuni componenti del sistema operativo Android Automotive, come il manifest, hanno requisiti specifici della piattaforma. Crea un modulo che possa mantenere il codice di questi componenti separato dall'altro codice del progetto, ad esempio il codice utilizzato per l'app mobile.

Per aggiungere un modulo per auto e motori al progetto:

1. In Android Studio, fai clic su File > Nuovo > Nuovo modulo.
2. Seleziona Modulo Automotive e poi fai clic su Avanti.
3. Inserisci un nome dell'applicazione/della raccolta. Questo è il nome che gli utenti vedono per la tua app sul sistema operativo Android Automotive.
4. Inserisci un nome del modulo.
5. Modifica il nome del pacchetto in modo che corrisponda a quello della tua app.

6. Seleziona API 28: Android 9.0 (Pie) per l'SDK minimo e poi fai clic su Avanti.

   Tutte le auto che supportano il sistema operativo Android Automotive funzionano su Android 9 (livello API 28) o versioni successive, pertanto la selezione di questo valore ha come target tutte le auto compatibili.

7. Seleziona Nessuna attività e poi fai clic su Fine.

Dopo aver creato il modulo in Android Studio, apri AndroidManifest.xml nel nuovo modulo per auto e motori:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.media">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme" />

    <uses-feature
        android:name="android.hardware.type.automotive"
        android:required="true" />

</manifest>

L'elemento application contiene alcune informazioni standard sull'app, nonché un elemento uses-feature che dichiara il supporto per il sistema operativo Android Automotive. Tieni presente che nel file manifest non sono dichiarate attività.

Se implementi attività di impostazioni o accesso, aggiungile qui. Queste attività vengono attivate dal sistema utilizzando intent espliciti e sono le uniche attività dichiarate nel file manifest per la tua app per il sistema operativo Android Automotive.

Dopo aver aggiunto eventuali impostazioni o attività di accesso, completa il file manifest impostando l'attributo android:appCategory="audio" nell'elemento application e aggiungendo i seguenti elementi uses-feature:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.media">

    <application
        android:allowBackup="true"
        android:appCategory="audio"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme" />

    <uses-feature
        android:name="android.hardware.type.automotive"
        android:required="true" />

    <uses-feature
        android:name="android.hardware.wifi"
        android:required="false" />
    <uses-feature
        android:name="android.hardware.screen.portrait"
        android:required="false" />
    <uses-feature
        android:name="android.hardware.screen.landscape"
        android:required="false" />

</manifest>

L'impostazione esplicita di queste funzionalità su required="false" garantisce che la tua app non entri in conflitto con le funzionalità hardware disponibili nei dispositivi con Automotive OS.

Utilizza la seguente voce manifest per dichiarare che la tua app supporta Android Automotive OS:

<application>
    ...
    <meta-data android:name="com.android.automotive"
        android:resource="@xml/automotive_app_desc"/>
    ...
</application>

Questa voce del file manifest fa riferimento a un file XML che dichiara le funzionalità per auto e motori supportate dalla tua app.

Per indicare che hai un'app multimediale, aggiungi un file XML denominato automotive_app_desc.xml alla directory res/xml/ del progetto. Includi i seguenti contenuti in questo file:

<automotiveApp>
    <uses name="media"/>
</automotiveApp>

Nota: non includere riferimenti all'attributocom.google.android.gms.car.application obbligatorio per Android Auto nell'app Android Automotive OS.

Filtri per intent

Il sistema operativo Android Automotive utilizza intent espliciti per attivare le attività nell'app multimediale. Non includere attività con filtri per intent CATEGORY_LAUNCHER o ACTION_MAIN nel file manifest.

Attività come quella nell'esempio seguente di solito hanno come target uno smartphone o un altro dispositivo mobile. Dichiara queste attività nel modulo che compila l'app per smartphone, non nel modulo che compila l'app per Android Automotive OS.

<activity android:name=".MyActivity">
<intent-filter>
<!-- You can't use either of these intents for Android Automotive OS -->
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
<!--
In their place, you can include other intent filters for any activities
that your app needs for Android Automotive OS, such as settings or
sign-in activities.
-->
</intent-filter>
</activity>

Passaggi successivi

Ora che hai un'app per Android Auto e Android Automotive OS, potresti intraprendere ulteriori passaggi per ottimizzarla in modo che possa essere utilizzata più in sicurezza mentre guidi. Per altri consigli per garantire un'esperienza utente sicura e pratica, consulta le guide tecniche per le azioni vocali, le protezioni per le distrazioni e la gestione degli errori.

Creare app di riproduzione video per il sistema operativo Android Automotive

Poiché le app video sono classificate separatamente dalle app multimediali nelle auto, devi essere consapevole di alcuni requisiti specifici per le app video, come descritto in Creare app per auto in sosta per il sistema operativo Android Automotive e Creare app video per il sistema operativo Android Automotive. Devi utilizzare le seguenti istruzioni.

Linee guida per il design: consulta la pagina Adattare le app video per indicazioni sull'esperienza utente specifiche per le app video.

Importante: Google prende molto sul serio la distrazione al volante. L'app deve soddisfare criteri specifici prima di poter essere elencata su Google Play per il sistema operativo Android Automotive. Se rispetti questi requisiti, puoi ottimizzare la creazione e il test della tua app. Per saperne di più, consulta la sezione Qualità delle app per Android per le auto.

Contrassegnare l'app come app video

Per indicare che la tua app supporta i video, aggiungi un file XML denominatoautomotive_app_desc.xml alla directory res/xml/ del progetto. In questo file, includi i seguenti contenuti:

<automotiveApp>
    <uses name="video"/>
</automotiveApp>

Nota: in Android Studio potresti visualizzare un errore di lint che indica "Si prevede uno di media, notification, sms o template per l'attributo name nel tag uses". Questo elemento può essere ignorato aggiungendo tools:ignore="InvalidUsesTagAttribute" all'elemento uses.

Poi, all'interno dell'elemento application del manifest, aggiungi il seguente elemento meta-data che fa riferimento al file XML:

<meta-data android:name="com.android.automotive"
    android:resource="@xml/automotive_app_desc"/>