Hiển thị hình minh hoạ nội dung đa phương tiện

Hình minh hoạ cho các mục nội dung đa phương tiện phải được chuyển ở dạng URI cục bộ bằng ContentResolver.SCHEME_CONTENT hoặc ContentResolver.SCHEME_ANDROID_RESOURCE. URI cục bộ này phải phân giải thành tệp bitmap hoặc vectơ vẽ được.

• Đối với đối tượng MediaDescriptionCompat biểu thị các mục trong hệ thống phân cấp nội dung, hãy truyền URI thông qua setIconUri.

• Đối với các đối tượng MediaMetadataCompat biểu thị mục đang phát, hãy dùng một trong các khoá này để chuyển URI qua putString:

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

Cung cấp hình minh hoạ từ tài nguyên của ứng dụng

Để cung cấp các đối tượng có thể vẽ từ tài nguyên của ứng dụng, hãy truyền một URI theo định dạng sau:

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

Đoạn mã này minh hoạ cách tạo một URI có định dạng này từ mã nhận dạng tài nguyên:

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

Cung cấp ảnh bìa bằng trình cung cấp nội dung

Các bước này mô tả cách tải hình minh hoạ xuống từ một URI web và hiển thị hình minh hoạ đó thông qua một URI cục bộ bằng cách sử dụng trình cung cấp nội dung. Để biết ví dụ hoàn chỉnh, hãy xem cách triển khai openFile và các phương thức xung quanh trong ứng dụng mẫu Universal Android Music Player.

1. Tạo một URI content:// tương ứng với URI web. Dịch vụ trình duyệt nội dung đa phương tiện và phiên phát nội dung đa phương tiện sẽ chuyển URI nội dung này sang Android Auto và 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. Trong quá trình triển khai ContentProvider.openFile, hãy kiểm tra xem một tệp có tồn tại cho URI tương ứng hay không. Nếu không có, hãy tải xuống và lưu tệp hình ảnh vào bộ nhớ đệm. Đoạn mã này sử dụng 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);
     }