萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 快速取得 SD 卡圖片/影片縮略圖:MediaStore Thumbnails API 完整用法

核心 API

  • 圖片縮略圖:MediaStore.Images.Thumbnails
  • 影片縮略圖:MediaStore.Video.Thumbnails
  • 幂別:MICRO_KIND (96x96)、MINI_KIND (512x384)

查詢流程

  1. 取得 ContentResolver。
  2. 查詢 MediaStore.Images.Media.EXTERNAL_CONTENT_URI (或 Video) 取得游標。
  3. 遍歷游標,取得 _ID (即 MediaStore.Images.Media._ID)。
  4. 呼叫 Thumbnails.getThumbnail(cr, id, kind, null) 直接取得 Bitmap。

完整代碼範例

public Bitmap getImageThumbnail(ContentResolver cr, long mediaId) {
    return MediaStore.Images.Thumbnails.getThumbnail(cr, mediaId,
            MediaStore.Images.Thumbnails.MICRO_KIND, null);
}

public Bitmap getVideoThumbnail(ContentResolver cr, long mediaId) {
    return MediaStore.Video.Thumbnails.getThumbnail(cr, mediaId,
            MediaStore.Video.Thumbnails.MICRO_KIND, null);
}

// 遍歷所有圖片取得縮略圖
public void loadAllThumbnails() {
    Uri uri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI;
    String[] proj = { MediaStore.Images.Media._ID };
    try (Cursor cursor = getContentResolver().query(uri, proj, null, null, null)) {
        if (cursor != null) {
            while (cursor.moveToNext()) {
                long id = cursor.getLong(0);
                Bitmap thumb = getImageThumbnail(getContentResolver(), id);
                // 使用 thumb (如載入 ImageView、快取)...
            }
        }
    }
}

效能優化建議

  • 縮略圖由系統媒體掃描器自動生成,無需自行解碼原圖,極大提升列表滑動流暢度。
  • 配合 Glide/Picasso 等圖片庫,可直接用 MediaStore.Images.Media.EXTERNAL_CONTENT_URI 載入,庫內部自動走縮略圖路徑。
  • 大量載入時建議使用 CursorLoader (LoaderManager) 非同步查詢,避免阻塞主執行緒。

常見問題

  • 縮略圖為 null:媒體掃描未完成、檔案損毀、或裝置不支援該格式生成縮圖。
  • Android 10+ (Q):需適配 Scoped Storage,改用 MediaStore 查詢而非直接檔案路徑。
copyright © 萬盛學電腦網 all rights reserved