核心 API
- 圖片縮略圖:
MediaStore.Images.Thumbnails
- 影片縮略圖:
MediaStore.Video.Thumbnails
- 幂別:
MICRO_KIND (96x96)、MINI_KIND (512x384)
查詢流程
- 取得
ContentResolver。
- 查詢
MediaStore.Images.Media.EXTERNAL_CONTENT_URI (或 Video) 取得游標。
- 遍歷游標,取得
_ID (即 MediaStore.Images.Media._ID)。
- 呼叫
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 查詢而非直接檔案路徑。