[Android] MediaStore スマホの画像や音楽ファイルを検索する

スマホ内で共有されるMediaStorageにアクセスして画像や音楽ファイルをContentProviderを使って探してみます。

Android Studio
2021.2.1

ContentProvider

ContentProviderは外部アプリに対しテーブルに似たものとしてデータを提供するものです。
　

Ref: コンテンツプロバイダの基本
　

目次
1. コンテンツプロバイダ
2. Permissions
3. サンプルコード

コンテンツプロバイダ

コンテンツプロバイダにアクセスする一般的なパターンは、以下のようになります。

CursorLoader を使用してバックグラウンドで非同期クエリを実行
UI の Activity/Fragment は、クエリに対して CursorLoader を呼び出し
ContentResolver を使用して ContentProvider からデータを取得

Ref: コンテンツプロバイダの基本

ContentResolver.query() を呼び出してデータ情報を取得。

ContentResolver contentResolver = getContentResolver();
Cursor cursor =
    getContentResolver().query(
        Uri,             // Uri of the table
        projection,      // The columns to return for each row
        selection,       // Selection criteria
        selectionArgs,   // Selection criteria
        sortOrder);      // The sort order for the returned rows

ContentResolver contentResolver = getContentResolver();

Cursor cursor =

getContentResolver().query(

Uri, // Uri of the table

projection, // The columns to return for each row

selection, // Selection criteria

selectionArgs, // Selection criteria

sortOrder); // The sort order for the returned rows

Uri： DataBaseでのtable_nameに相当
例えば、画像であれば
MediaStore.Images.Media.EXTERNAL_CONTENT_URI
を渡します。これは
content://media/external/images/media
でありここを検索していくことになります。

projection： DataBaseでのcolumnであり、データの種類
例えば画像では以下のようなcolumnがあります

MediaStore.Images.Media._ID
MediaStore.Images.Media.DATA
MediaStore.Images.Media.DISPLAY_NAME
MediaStore.Images.Media.TITLE
MediaStore.Images.Media.DATE_TAKEN
MediaStore.Images.Media.DATE_ADDED

selection：

DataBaseのWHEREキーワードと同じ

selectionArgs： Selectionと一緒に使用される
selectionの疑問符(？)に入る内容がSelection args、argsの型は String[]

sortOrder： クエリ結果の行が表示される順序を指定
タイムスタンプで昇順・降順に分けるなど

Permissions

ContentProviderを使ってスマホ内のMediaStre内を検索しますのでPermissionが必要になります。

AndroidManifest.xmlに追加

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

1	<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

READ_EXTERNAL_STORAGE は Runtime Permission に該当するため、アプリ起動中に許可を得るように設定します。

サンプルコード

端末内のMediaStorageにある画像を検索してみます。
最初に読み出し許可の処理を行います。

MainActivity.java

//package your.package.name;

import androidx.activity.result.ActivityResultLauncher;
import androidx.activity.result.contract.ActivityResultContracts;
import androidx.appcompat.app.AppCompatActivity;

import android.Manifest;
import android.annotation.SuppressLint;
import android.content.ContentResolver;
import android.content.pm.PackageManager;
import android.database.Cursor;
import android.os.Bundle;
import android.provider.MediaStore;
import android.widget.TextView;
import android.widget.Toast;

public class MainActivity extends AppCompatActivity {

    private final ActivityResultLauncher<String>
            requestPermissionLauncher = registerForActivityResult(
            new ActivityResultContracts.RequestPermission(),
            isGranted -> {
                if (isGranted) {
                    readContent();
                }
                else {
                    // それでも拒否された時の対応
                    Toast toast = Toast.makeText(this,
                            "これ以上なにもできません", Toast.LENGTH_SHORT);
                    toast.show();
                }
            });

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        if (checkSelfPermission(Manifest.permission.READ_EXTERNAL_STORAGE)!=
                PackageManager.PERMISSION_GRANTED) {
            requestPermissionLauncher.launch(
                    Manifest.permission.READ_EXTERNAL_STORAGE);
        }
        else{
            readContent();
        }

    }

    @SuppressLint("Range")
    private void readContent(){
        TextView textView = findViewById(R.id.text_view);

        ContentResolver contentResolver = getContentResolver();
        Cursor cursor = null;
        StringBuilder sb = null;

        // 例外を受け取る
        try {
            cursor = contentResolver.query(
                    MediaStore.Images.Media.EXTERNAL_CONTENT_URI,
                    null,null,null,null);

            if (cursor != null && cursor.moveToFirst()) {
                String str =  String.format(
                        "MediaStore.Images = %s\n\n", cursor.getCount() );

                sb = new StringBuilder(str);

                do {
                    sb.append("ID: ");
                    sb.append(cursor.getString(cursor.getColumnIndex(
                            MediaStore.Images.Media._ID)));
                    sb.append("\n");
                    sb.append("Title: ");
                    sb.append(cursor.getString(cursor.getColumnIndex(
                            MediaStore.Images.Media.TITLE)));
                    sb.append("\n");
                    sb.append("Path: ");
                    sb.append(cursor.getString(cursor.getColumnIndex(
                            MediaStore.Images.Media.DATA)));
                    sb.append("\n\n");

                } while (cursor.moveToNext());

                cursor.close();
            }
        } catch (Exception e) {
            e.printStackTrace();

        } finally{
            if(cursor != null){
                cursor.close();
            }
        }

        textView.setText(sb);
    }
}

//package your.package.name;

import androidx.activity.result.ActivityResultLauncher;

import androidx.activity.result.contract.ActivityResultContracts;

import androidx.appcompat.app.AppCompatActivity;

import android.Manifest;

import android.annotation.SuppressLint;

import android.content.ContentResolver;

import android.content.pm.PackageManager;

import android.database.Cursor;

import android.os.Bundle;

import android.provider.MediaStore;

import android.widget.TextView;

import android.widget.Toast;

public class MainActivity extends AppCompatActivity {

private final ActivityResultLauncher<String>

requestPermissionLauncher = registerForActivityResult(

new ActivityResultContracts.RequestPermission(),

isGranted -> {

if (isGranted) {

readContent();

}

else {

// それでも拒否された時の対応

Toast toast = Toast.makeText(this,

"これ以上なにもできません", Toast.LENGTH_SHORT);

toast.show();

}

});

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

if (checkSelfPermission(Manifest.permission.READ_EXTERNAL_STORAGE)!=

PackageManager.PERMISSION_GRANTED) {

requestPermissionLauncher.launch(

Manifest.permission.READ_EXTERNAL_STORAGE);

}

else{

readContent();

}

@SuppressLint("Range")

private void readContent(){

TextView textView = findViewById(R.id.text_view);

ContentResolver contentResolver = getContentResolver();

Cursor cursor = null;

StringBuilder sb = null;

// 例外を受け取る

try {

cursor = contentResolver.query(

MediaStore.Images.Media.EXTERNAL_CONTENT_URI,

null,null,null,null);

if (cursor != null && cursor.moveToFirst()) {

String str = String.format(

"MediaStore.Images = %s\n\n", cursor.getCount() );

sb = new StringBuilder(str);

do {

sb.append("ID: ");

sb.append(cursor.getString(cursor.getColumnIndex(

MediaStore.Images.Media._ID)));

sb.append("\n");

sb.append("Title: ");

sb.append(cursor.getString(cursor.getColumnIndex(

MediaStore.Images.Media.TITLE)));

sb.append("\n");

sb.append("Path: ");

sb.append(cursor.getString(cursor.getColumnIndex(

MediaStore.Images.Media.DATA)));

sb.append("\n\n");

} while (cursor.moveToNext());

cursor.close();

}

} catch (Exception e) {

e.printStackTrace();

} finally{

if(cursor != null){

cursor.close();

}

textView.setText(sb);

}

その他ファイル

レイアウト
actiity_main.xml

<?xml version="1.0" encoding="utf-8"?>
<ScrollView xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="#dfe"
    android:padding="5dp"
    tools:context=".MainActivity">

    <TextView
        android:id="@+id/text_view"
        android:textColor="#000"
        android:textSize="20sp"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"/>

</ScrollView>

<?xml version="1.0" encoding="utf-8"?>

<ScrollView xmlns:android="http://schemas.android.com/apk/res/android"

xmlns:tools="http://schemas.android.com/tools"

android:layout_width="match_parent"

android:layout_height="match_parent"

android:background="#dfe"

android:padding="5dp"

tools:context=".MainActivity">

<TextView

android:id="@+id/text_view"

android:textColor="#000"

android:textSize="20sp"

android:layout_width="wrap_content"

android:layout_height="wrap_content"/>

</ScrollView>

　
READ_EXTERNAL_STORAGE とReadContentのAcitivtyを追加
AndroidManifest.xml

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    ...

    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

    <application
        ...
    </application>

</manifest>

<?xml version="1.0" encoding="utf-8"?>

<manifest xmlns:android="http://schemas.android.com/apk/res/android"

...

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

<application

...

</application>

</manifest>

　
実行するとリストが表示されます。
　

　
Audio:
音楽ファイルを探すときは、 MediaStore.Images…をMediaStore.Audio.Media.EXTERNAL_CONTENT_URI
に変更すると検索できます。
　
Video:
動画の場合は、同様にテーブルを MediaStore.Video.Media.EXTERNAL_CONTENT_URI に変えると確認できます。
　
実際にemulatorがどうなっているかはDevice File Explorerを使うと確認できます。
　
関連ページ：
　

asynctask 00b 100x100 - [Android] MediaStore スマホの画像や音楽ファイルを検索する

[Android] データ保存、対象範囲別外部ストレージ

データを保存するストレージ領域が目的・用途によって区分されてセキュリティー的に厳しくなりました。対象範囲別外部ストレージ　 S...

　
Reference:
コンテンツプロバイダの基本
共有ストレージからメディアファイルにアクセスする

ContentProvider

コンテンツ プロバイダ

Permissions

サンプルコード

コンテンツプロバイダ