Porta la tua app sui veicoli che eseguono Android Auto o Android Automotive OS. Utilizza un'architettura dell'app che funzioni in entrambi i casi, in modo che ogni utente possa usufruire della tua app.
Che cos'è Android for Cars?
Un'app multimediale per le auto può consentire agli utenti di connettere senza problemi la propria vita digitale alle loro auto. Se estendi le stesse app per smartphone in modo che siano disponibili per le automobili, crei una migliore esperienza utente. Puoi farlo integrando Android Auto o Android Automotive OS.
Le app Android per le auto devono evitare soprattutto di distrarre il conducente. Puoi ridurre al minimo le distrazioni seguendo le best practice, ad esempio utilizzando i comandi vocali e un design visivo molto pratico. In questo modo, la tua app multimediale può mostrare informazioni tempestive al conducente solo quando sono pertinenti e utilizzare pattern prevedibili per le attività comuni.
Android Auto
Android Auto offre un'esperienza app ottimizzata per il conducente agli utenti che hanno uno smartphone Android con l'app Android Auto e un'auto o un sistema stereo aftermarket compatibile. Possono utilizzare la tua app direttamente sul display dell'auto collegando lo smartphone. Per consentire ad Android Auto di connettersi all'app per smartphone, devi creare servizi che Android Auto utilizza per mostrare al conducente un'interfaccia ottimizzata.
Android Automotive OS
Android Automotive OS è 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 Android Automotive OS, gli utenti installano la tua app direttamente sull'auto anziché sui loro smartphone.
Categorie di app supportate
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. Ulteriori informazioni sono disponibili anche in Creare app multimediali per le auto.
Le app multimediali vengono create utilizzando MediaLibraryService
e MediaSession.
Su Android Automotive OS, puoi anche creare schermate di accesso e impostazioni (da utilizzare durante la sosta) utilizzando Views o Compose.
Le app video consentono agli utenti di guardare video in streaming mentre l'auto è parcheggiata. Lo scopo principale di queste app è visualizzare video in streaming. Queste app vengono create utilizzando Views o Compose. Per ulteriori informazioni, consulta Creare app di riproduzione video per Android Automotive OS. Ulteriori informazioni sono disponibili in Creare app video per Android Automotive OS.
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, vai a Creare un'app di base per la riproduzione multimediale.
Questa guida fornisce informazioni su cosa devi fare, inclusi link ad altre risorse con indicazioni specifiche.
Componenti di riproduzione
Media3 offre diversi componenti chiave per i casi d'uso di riproduzione. Se hai lavorato con le precedenti librerie multimediali Android, le classi che compongono questi componenti ti saranno familiari.
Il seguente diagramma mostra come questi componenti si combinano in un'app tipica.
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 libreria multimediale.
Questa operazione è necessaria 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 libreria 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 Jetpack Media3 include MediaLibrarySession, che estende MediaSession per aggiungere API di navigazione dei contenuti.
Il collegamento di una sessione multimediale a un player consente a un'app di pubblicizzare la riproduzione multimediale esternamente e di ricevere comandi di riproduzione da fonti esterne come Android Auto, Android Automotive OS o l'Assistente Google. Per ulteriori informazioni, consulta Controllare e pubblicizzare la riproduzione utilizzando un MediaSession e Utilizzare un MediaLibrarySession.
Come minimo, la sessione multimediale deve dichiarare il supporto dei seguenti comandi del player:
La guida Attivare i controlli di riproduzione descrive i modi in cui puoi personalizzare i controlli di riproduzione nelle auto.
Quando Android Auto o Android Automotive OS si connettono alla tua app, richiedono una libreria di contenuti da visualizzare, il che attiva il metodo di callback onGetLibraryRoot(). Puoi restituire rapidamente un elemento multimediale principale per consentire l'accesso alla tua libreria. Il metodo di callback onGetChildren() viene chiamato quando Android Auto o Android Automotive OS tentano di sfogliare i livelli più profondi della tua libreria di contenuti.
Queste piattaforme applicano limiti aggiuntivi alla struttura della libreria di contenuti. Per informazioni dettagliate sulla personalizzazione della visualizzazione della libreria di contenuti, consulta la guida Creare il servizio di navigazione multimediale.
Dichiarare il supporto di Android Auto
Utilizza la seguente voce del file 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 le auto 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 tuo progetto. Questo file deve includere i seguenti contenuti:
<automotiveApp>
<uses name="media"/>
</automotiveApp>
Dichiarare il supporto di Android Automotive OS
Devi creare un modulo per le auto perché non tutta la logica della tua app può essere condivisa con un'app per le auto. Alcuni componenti di Android Automotive OS, come il file manifest, hanno requisiti specifici della piattaforma. Crea un modulo che possa mantenere il codice di questi componenti separato da altro codice nel tuo progetto, ad esempio il codice utilizzato per la tua app per dispositivi mobili.
Per aggiungere un modulo per le auto al tuo progetto:
- In Android Studio, fai clic su File > Nuovo > Nuovo modulo.
- Seleziona Modulo per le auto, quindi fai clic su Avanti.
- Inserisci un nome dell'applicazione/della libreria. Questo è il nome che gli utenti vedono per la tua app su Android Automotive OS.
- Inserisci un nome del modulo.
- Modifica il nome del pacchetto in modo che corrisponda alla tua app.
Seleziona API 28: Android 9.0 (Pie) per l'SDK minimo, quindi fai clic Avanti.
Tutte le auto che supportano Android Automotive OS eseguono Android 9 (livello API 28) o versioni successive, quindi la selezione di questo valore ha come target tutte le auto compatibili.
Seleziona Nessuna attività, quindi fai clic su Fine.
Dopo aver creato il modulo in Android Studio, apri AndroidManifest.xml nel nuovo modulo per le auto:
<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'application
elemento contiene alcune informazioni standard sull'app, nonché un
uses-feature
elemento che dichiara il supporto di Android Automotive OS. Tieni presente che nel file manifest non sono dichiarate attività.
Se implementi attività di impostazioni o di accesso, aggiungile qui. Queste attività vengono attivate dal sistema utilizzando intent espliciti e sono le uniche attività che dichiari nel file manifest per la tua app Android Automotive OS.
Dopo aver aggiunto eventuali attività di impostazioni o 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>
Se imposti esplicitamente queste funzionalità su required="false", ti assicuri che
la tua app non sia in conflitto con le funzionalità hardware disponibili nei dispositivi Automotive OS.
Utilizza la seguente voce del file 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 le auto 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 tuo progetto. Includi i seguenti contenuti in questo file:
<automotiveApp>
<uses name="media"/>
</automotiveApp>
Filtri per intent
Android Automotive OS utilizza intent espliciti per attivare le attività nella tua app multimediale. Non includere attività con filtri per intent
CATEGORY_LAUNCHER
o ACTION_MAIN
nel file manifest.
Le attività come quella nell'esempio seguente di solito hanno come target uno smartphone o un altro dispositivo mobile. Dichiara queste attività nel modulo che crea l'app per smartphone, non nel modulo che crea la tua app 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 voler eseguire passaggi aggiuntivi per ottimizzare l'app in modo che possa essere utilizzata in modo più sicuro durante la guida. Per ulteriori consigli per garantire un'esperienza utente sicura e pratica, consulta le guide tecniche per le azioni vocali, le misure di sicurezza contro le distrazioni, e la gestione degli errori.
Creare app di riproduzione video per Android Automotive OS
Poiché le app video sono classificate separatamente dalle app multimediali nelle auto, devi essere a conoscenza di alcuni requisiti specifici per le app video, come descritto in Creare app per auto parcheggiate e Creare app video per Android Automotive OS. Devi seguire le istruzioni riportate di seguito.
Contrassegnare l'app come app video
Per indicare che la tua app supporta i video, aggiungi un file XML denominato automotive_app_desc.xml alla directory res/xml/ del tuo progetto. In questo file, includi i seguenti contenuti:
<automotiveApp>
<uses name="video"/>
</automotiveApp>
uses
Poi, all'interno dell'elemento application del file 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"/>