Afficher une illustration de l'élément multimédia

Les illustrations d'éléments multimédias doivent être transmises sous la forme d'un URI local en utilisant ContentResolver.SCHEME_CONTENT ou ContentResolver.SCHEME_ANDROID_RESOURCE. Cet URI local doit correspondre à un bitmap ou un drawable vectoriel.

• Pour les objets MediaDescriptionCompat représentant des éléments de la hiérarchie de contenu, transmettez l'URI via setIconUri.

  Avertissement : Ne fournissez pas de visuels à l'aide de setIconBitmap. Bien que cette méthode soit compatible avec Android Auto, elle ne l'est pas avec Android Automotive OS (AAOS). De plus, l'inclusion de nombreux bitmaps dans un résultat peut entraîner le dépassement de la limite de taille du binder (1 Mo), ce qui rend votre application non réactive.

• Pour les objets MediaMetadataCompat représentant l'élément en cours de lecture, utilisez l'une de ces clés pour transmettre l'URI via putString :

  • MediaMetadataCompat.METADATA_KEY_DISPLAY_ICON_URI
  • MediaMetadataCompat.METADATA_KEY_ART_URI
  • MediaMetadataCompat.METADATA_KEY_ALBUM_ART_URI

Fournir des illustrations à partir des ressources de votre application

Pour fournir des éléments drawables à partir des ressources de votre application, transmettez un URI au format suivant :

android.resource://PACKAGE_NAME/RESOURCE_TYPE/RESOURCE_NAME

// Example URI - note that there is no file extension at the end of the URI
android.resource://com.example.app/drawable/example_drawable

Cet extrait montre comment créer un URI de ce format à partir d'un ID de ressource :

val resources = context.resources
val resourceId: Int = R.drawable.example_drawable

Uri.Builder()
    .scheme(ContentResolver.SCHEME_ANDROID_RESOURCE)
    .authority(resources.getResourcePackageName(resourceId))
    .appendPath(resources.getResourceTypeName(resourceId))
    .appendPath(resources.getResourceEntryName(resourceId))
    .build()

Fournir des illustrations à l'aide d'un fournisseur de contenu

Ces étapes décrivent comment télécharger une illustration à partir d'un URI Web et comment l'exposer via un URI local à l'aide d'un fournisseur de contenu. Pour obtenir un exemple complet, consultez l'implémentation de openFile et des méthodes proches dans l'application exemple Universal Android Music Player.

1. Créez un URI content:// correspondant à l'URI Web. Le service de navigateur multimédia et la session multimédia doivent transmettre cet URI de contenu à Android Auto et à AAOS.

   Kotlin

   fun Uri.asAlbumArtContentURI(): Uri {
         return Uri.Builder()
           .scheme(ContentResolver.SCHEME_CONTENT)
           .authority(CONTENT_PROVIDER_AUTHORITY)
           .appendPath(this.getPath()) // Make sure you trust the URI
           .build()
     }
   

   Java

   public static Uri asAlbumArtContentURI(Uri webUri) {
         return new Uri.Builder()
           .scheme(ContentResolver.SCHEME_CONTENT)
           .authority(CONTENT_PROVIDER_AUTHORITY)
           .appendPath(webUri.getPath()) // Make sure you trust the URI!
           .build();
    }
   

2. Dans votre implémentation de ContentProvider.openFile, vérifiez s'il existe un fichier pour l'URI correspondant. Si ce n'est pas le cas, téléchargez et mettez en cache le fichier image. Cet extrait de code utilise Glide.

   Kotlin

   override fun openFile(uri: Uri, mode: String): ParcelFileDescriptor? {
         val context = this.context ?: return null
         val file = File(context.cacheDir, uri.path)
         if (!file.exists()) {
           val remoteUri = Uri.Builder()
               .scheme("https")
               .authority("my-image-site")
               .appendPath(uri.path)
               .build()
           val cacheFile = Glide.with(context)
               .asFile()
               .load(remoteUri)
               .submit()
               .get(DOWNLOAD_TIMEOUT_SECONDS, TimeUnit.SECONDS)
   
           cacheFile.renameTo(file)
            file = cacheFile
         }
         return ParcelFileDescriptor.open(file, ParcelFileDescriptor.MODE_READ_ONLY)
    }
   

   Java

   @Nullable
     @Override
     public ParcelFileDescriptor openFile(@NonNull Uri uri, @NonNull String mode)
           throws FileNotFoundException {
         Context context = this.getContext();
         File file = new File(context.getCacheDir(), uri.getPath());
         if (!file.exists()) {
           Uri remoteUri = new Uri.Builder()
               .scheme("https")
               .authority("my-image-site")
               .appendPath(uri.getPath())
               .build();
           File cacheFile = Glide.with(context)
               .asFile()
               .load(remoteUri)
               .submit()
               .get(DOWNLOAD_TIMEOUT_SECONDS, TimeUnit.SECONDS);
   
           cacheFile.renameTo(file);
           file = cacheFile;
         }
         return ParcelFileDescriptor.open(file, ParcelFileDescriptor.MODE_READ_ONLY);
     }
   

Remarque : Comme illustré dans l'exemple précédent, l'URI de contenu doit être construit et envoyé rapidement à Android Auto et à AAOS. Cela s'applique même lorsque le fichier n'est pas téléchargé. Android Auto et AAOS affichent une UI de chargement pour les images en attendant que le fournisseur de contenu réponde. Envisagez d'optimiser votre application pour récupérer rapidement les images et réduire le temps nécessaire au chargement de l'UI. Envisagez de précharger les images et de les mettre en cache.