Media StoreでcreateDeleteRequestを使ったファイルの削除

既存のメディアファイルへ、アクセスする許可を取得するためのリクエストが、Media Store APIに準備されています。

このリクエストで許可を得たアプリは、ファイルの所有者に関係なく、アクセスが可能になります。

このリクエストの中の、createDeleteRequestについて、まとめます。

削除する許可を取得するリクエストです。

※環境：Android Studio Narwhal Feature Drop | 2025.1.2 Patch 1

1 Media Storeのリクエスト
2 許可の取得手順
3 削除の例
4 対象をグループで指定

Media Storeのリクエスト

Media Storeに、表のようなリクエストが準備されています。

リクエスト（MediaStore.***）	概要	許可後の動作
createWriteRequest	書き込み許可を要求	URIへ書き込み（更新）可能
createDeleteRequest	削除する許可を要求	即時に削除
createTrashRequest	廃棄する許可を要求	ゴミ箱へ廃棄したと見なされる（is_trashedカラムを設定）一定時間経過後にシステムが削除
createFavoriteRequest	お気に入り登録する許可を要求	お気に入り登録したと見なされる（is_favoriteカラムを設定）
※許可はアプリに対して与えられる

いずれも、アプリが既存ファイル（自アプリ・他アプリが所有するファイル）へアクセスする許可を取得するためのリクエストです。

このリクエストを使うと、ダイアログが表示されて、ユーザーに許可・拒否の判定を求めます。

許可されたら、アクセスが実行されます。

許可の取得手順

許可の取得は、次のような手順で行います。

URIのアクセス許可の取得

手順1

削除対象のURIを準備。Clientアプリを起動します。

手順2

Clientアプリはダイアログを表示して、削除する許可・拒否の判定を求めます。

手順3

ダイアログによる判定の結果をコールバックで返します。

手順1～3はアプリケーションコンポーネント（Activity）の連携と同じ動作です。
※詳細は「App component：Activity」を参照

削除の例

削除の具体的な例です。※Activity Result APIで記述しています。

コールバックの定義と登録

registerForActivityResultはコールバックの定義と登録を行います。

ラムダ式がコールバックです。「許可・拒否」はresultCodeで判断できます。

そして、このコールバックを利用するコンポーネントのランチャー（_MediaDeleteDialog : ActivityResultLauncher）を返します。

        val _MediaDeleteDialog = registerForActivityResult(
            ActivityResultContracts.StartIntentSenderForResult()
        ) { result ->
            if(result.resultCode == RESULT_OK) {    // アクセス許可
                /* ここが実行される時点で、すでに削除済み */
            }
            else { }                                // アクセス拒否
        }

registerForActivityResultは、LifecycleOwnerのcurrentStateが「STARTED」より前のタイミングで実行して下さい。Activityのライフサイクルと密接に関係しています。
※LifecycleOwnerについては「ライフサイクル対応コンポーネント作成」を参照

許可チェックとダイアログ起動

削除対象のURIを準備します。その後、Clientアプリを起動（launch）し、ダイアログを表示させます。

launchの引数は取得したい許可のリクエスト（MediaDeleteReq : IntentSenderRequest）です。削除を行いたいのでMediaStore.createDeleteRequestを使って、リクエストを構築しています。

        @RequiresApi(Build.VERSION_CODES.R)
        fun onDelete(uri: Uri, id: Long) {
            val _uri = ContentUris.withAppendedId(uri, id)  // URIを準備
            _MediaDeleteDialog.launch(MediaDeleteReq(contentResolver, _uri))
        }

@RequiresApi(Build.VERSION_CODES.R)
fun MediaDeleteReq(resolver: ContentResolver, uri: Uri): IntentSenderRequest {
    val _pendingIntent = MediaStore.createDeleteRequest(resolver, listOf(uri))
    val _intentSenderRequest = IntentSenderRequest.Builder(
        _pendingIntent.intentSender
    ).build()
    return _intentSenderRequest
}

MediaStore.createDeleteRequestはAPI≧30から利用が可能です。

削除の実行

削除の実行（onDelete）を行うと、ダイアログが表示されて、ユーザに「許可・拒否」の判定を求めます。

val _uri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI
val _id = 1000000033

// val _uri = MediaStore.Video.Media.EXTERNAL_CONTENT_URI
// val _id = 1000000034

// val _uri = MediaStore.Audio.Media.EXTERNAL_CONTENT_URI
// val _id = 1000000035

onDelete(_uri, _id)

メディアテーブルの状態

# pwd
/data/data/com.google.android.providers.media.module/databases
# sqlite3 ./external.db
sqlite> .headers on
sqlite> .mode column
sqlite> select _id,_display_name,_data from images;
_id         _display_name  _data
----------  -------------  -------------------------------------
1000000033  leaf.jpg       /storage/emulated/0/Pictures/leaf.jpg
sqlite> select _id,_display_name,_data from video;
_id         _display_name  _data
----------  -------------  --------------------------------------
1000000034  myroom.mpeg    /storage/emulated/0/Movies/myroom.mpeg
sqlite> select _id,_display_name,_data from audio;
_id         _display_name  _data
----------  -------------  --------------------------------------
1000000035  akatonbo.mp3   /storage/emulated/0/Music/akatonbo.mp3

※エミュレータ（API 33）で確認

メディアデータの状態

# pwd
/storage/emulated/0
# ls -l Pictures/* Movies/* Music/* */.thumbnails/*
-rw-rw---- 1 u0_a170 media_rw   5349 2025-08-22 12:09 Movies/.thumbnails/1000000034.jpg
-rwxrwx--- 1 u0_a170 media_rw 195759 2025-08-22 12:09 Movies/myroom.mpeg
-rw-rw---- 1 u0_a170 media_rw  11472 2025-08-22 12:11 Music/.thumbnails/1000000035.jpg
-rwxrwx--- 1 u0_a170 media_rw  45366 2025-08-22 12:09 Music/akatonbo.mp3
-rw-rw---- 1 u0_a170 media_rw  34088 2025-08-22 12:08 Pictures/.thumbnails/1000000033.jpg
-rwxrwx--- 1 u0_a170 media_rw  47891 2025-08-22 12:08 Pictures/leaf.jpg

※エミュレータ（API 33）で確認

なお、ダイアログに表示される画像はサムネイル（.thumbnail/メディア情報のID.jpg）です。

imagesvideoaudio

「許可」となったURIは、このアプリにより削除が可能です。

そして、システムにより、このURIに関係する全てのデータ（データベースのレコード、ファイル、サムネイル）が即時に削除されます。ユーザ側で削除処理をする必要はありません。

判定の結果をコールバックで返す時点で、すでに削除済みです。注意して下さい。

対象をグループで指定

URIをリストで指定すると、複数のURIをグループとして、一括で削除できます。

        @RequiresApi(Build.VERSION_CODES.R)
        fun onDelete(uri: Uri, ids: Array<Long>) {
            val _uris = ids.map { ContentUris.withAppendedId(uri, it) } // URIを準備
            _MediaDeleteDialog.launch(MediaDeleteReq(contentResolver, _uris))
        }

@RequiresApi(Build.VERSION_CODES.R)
fun MediaDeleteReq(resolver: ContentResolver, uris: List<Uri>): IntentSenderRequest {
    val _pendingIntent = MediaStore.createDeleteRequest(resolver, uris)
    val _intentSenderRequest = IntentSenderRequest.Builder(
        _pendingIntent.intentSender
    ).build()
    return _intentSenderRequest
}

val _uri = MediaStore.Images.Media.EXTERNAL_CONTENT_URI
val _ids = arrayOf(1000000033, 1000000034, 1000000035, 1000000036)

onDelete(_uri, _ids)

メディアテーブルの状態

# pwd
/data/data/com.google.android.providers.media.module/databases
# sqlite3 ./external.db
sqlite> .headers on
sqlite> .mode column
sqlite> select _id,_display_name,_data from images;
_id         _display_name  _data
----------  -------------  -------------------------------------
1000000033  leaf.jpg       /storage/emulated/0/Pictures/leaf.jpg
1000000034  donguri.jpg    /storage/emulated/0/Pictures/donguri.
1000000035  bike.jpg       /storage/emulated/0/Pictures/bike.jpg
1000000036  fall.jpg       /storage/emulated/0/Pictures/fall.jpg

※エミュレータ（API 33）で確認

メディアデータの状態

# pwd
/storage/emulated/0
# ls -l Pictures/* */.thumbnails/*
-rw-rw---- 1 u0_a163 media_rw  34088 2025-08-23 00:50 Pictures/.thumbnails/1000000033.jpg
-rw-rw---- 1 u0_a163 media_rw  16914 2025-08-23 00:51 Pictures/.thumbnails/1000000034.jpg
-rw-rw---- 1 u0_a163 media_rw  22749 2025-08-23 00:51 Pictures/.thumbnails/1000000035.jpg
-rw-rw---- 1 u0_a163 media_rw  32504 2025-08-23 00:52 Pictures/.thumbnails/1000000036.jpg
-rwxrwx--- 1 u0_a163 media_rw 126143 2025-08-23 00:51 Pictures/bike.jpg
-rwxrwx--- 1 u0_a163 media_rw  54206 2025-08-23 00:51 Pictures/donguri.jpg
-rwxrwx--- 1 u0_a163 media_rw  82076 2025-08-23 00:52 Pictures/fall.jpg
-rwxrwx--- 1 u0_a163 media_rw  47891 2025-08-23 00:50 Pictures/leaf.jpg

※エミュレータ（API 33）で確認

ダイアログに表示されるサムネイルは、表示範囲から溢れたものが、重ねられて表示されます。つまり、省略されてしまいます。

「許可・拒否」という重大な判断をユーザーに求めているのに、判断材料になる情報を省略してもよいのか？！、疑問です。ですので、私としてはグループ指定をお勧めしません。

許可・拒否ダイアログ（group）

「許可」となった（グループ指定された）URIは、このアプリにより削除が可能です。

そして、システムにより一括で消去されます。

ページのトップへ

ストレージのリソース

Adoptable Storage SDカード Storage デザイン内部メモリー外部メモリー拡張ストレージ追加ストレージ

ストレージのリソースは、内部メモリー、外部メモリー、クラウドの3つがあります。外部メモリーは、主にSDカードです。このSDカードはAndroid端末の世代が進むにつれて、扱いを変えてきました。リソースとSDカードを主眼に置いたストレージの変遷について、まとめます。 ※環境：Android Studio Narwhal | 2025.1.1 Patch 1 ...