Wyświetlanie elementów graficznych

Grafika elementów multimedialnych musi być przekazywana jako lokalny identyfikator URI za pomocą elementu ContentResolver.SCHEME_CONTENT lub ContentResolver.SCHEME_ANDROID_RESOURCE. Ten lokalny identyfikator URI musi prowadzić do bitmapy lub rysunku wektorowego.

• W przypadku obiektów MediaDescriptionCompat reprezentujących elementy w hierarchii treści przekaż identyfikator URI za pomocą parametru setIconUri.

  Ostrzeżenie: nie przesyłaj elementów graficznych za pomocą setIconBitmap. Ta metoda jest obsługiwana w Androidzie Auto, ale nie w Androidzie Automotive OS (AAOS). Dodatkowo umieszczenie w wyniku wielu map bitowych może spowodować przekroczenie limitu rozmiaru 1 MB, co może sprawić, że aplikacja przestanie odpowiadać.

• W przypadku obiektów MediaMetadataCompat reprezentujących odtwarzany element użyj dowolnego z tych kluczy, aby przekazać identyfikator URI przez putString:

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

Prześlij grafikę z zasobów aplikacji

Aby udostępnić elementy rysowalne z zasobów aplikacji, przekaż identyfikator URI w tym formacie:

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

Ten fragment kodu pokazuje, jak utworzyć identyfikator URI w tym formacie na podstawie identyfikatora zasobu:

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()

Przesyłanie grafiki za pomocą dostawcy treści

Poniższe czynności opisują, jak pobrać grafikę z identyfikatora URI w internecie i udostępnić ją za pomocą lokalnego identyfikatora URI przy użyciu dostawcy treści. Pełny przykład znajdziesz w implementacji openFile i powiązanych metod w przykładowej aplikacji Universal Android Music Player.

1. Utwórz content:// identyfikator URI odpowiadający identyfikatorowi URI w internecie. Przeglądarka multimediów i sesja multimediów przekazują ten identyfikator URI treści do Androida Auto i 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. W implementacji ContentProvider.openFile sprawdź, czy istnieje plik odpowiadający danemu identyfikatorowi URI. Jeśli nie, pobierz plik obrazu i zapisz go w pamięci podręcznej. Ten fragment kodu korzysta z biblioteki 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);
     }
   

Uwaga: identyfikator URI treści powinien być szybko tworzony i wysyłany do Androida Auto i AAOS, jak pokazano w poprzednim przykładzie. Dzieje się tak nawet wtedy, gdy plik nie zostanie pobrany. Android Auto i AAOS wyświetlają interfejs ładowania obrazów, gdy czekają na odpowiedź dostawcy treści. Zoptymalizuj aplikację, aby szybko pobierała obrazy i minimalizowała czas potrzebny na wczytanie interfejsu. Rozważ wstępne wczytywanie i zapisywanie obrazów w pamięci podręcznej.