[Android] MediaStore 画像を保存する

パブリックな共有ストレージのMediaStoreに画像を保存する方法について見てみましょう。

Android Studio
2021.1.1

MediaStore

　
ストレージには内部ストレージ(Internal Storage)と外部ストレージ(External Storage)があります。アプリには固有のストレージ領域がありますが、共有のストレージ領域を使うことも可能です。

メディアコレクションは共有可能なストレージで写真、動画やミュージックなどのメディアを保存できる領域です。

MediaStore APIを使ってアクセスし、他のアプリが作成したメディアには読み出しでアクセスできる
読み出しにはREAD_EXTERNAL_STORAGE のPermissionが必要,
保存に WRITE_EXTERNAL_STORAGE は不要（Android 10 以降）
アプリが削除されてもファイルは残っている

● 画像：（写真とスクリーンショットを含む）
DICM/、Picture/ ディレクトリに格納されている
● 動画：
DCIM/、Movies/、Pictures/ ディレクトリに格納
● オーディオ：
オーディオファイルは Alarms/、Audiobooks/、Music/、Notifications/、Podcasts/、Ringtones/ ディレクトリに格納
オーディオプレイリストは Music/ ディレクトリまたは Movies/ ディレクトリに格納

目次
1. プロバイダにデータを挿入
2. サンプルコード

プロバイダにデータを挿入

　
Mediaファイルを保存するには、ContentResolver.insert() を使ってプロバイダにデータを挿入します。プロバイダに新しい行を挿入し、その行のコンテンツ URI を返します。

// Defines a new Uri object that receives the result of the insertion
Uri newUri;

...

// Defines an object to contain the new values to insert
ContentValues newValues = new ContentValues();

// Sets the values of each column and inserts the word. 
// The arguments to the "put" method are "column name" and "value"
newValues.put(UserDictionary.Words.APP_ID, "example.user");
newValues.put(UserDictionary.Words.LOCALE, "en_US");
newValues.put(UserDictionary.Words.WORD, "insert");
newValues.put(UserDictionary.Words.FREQUENCY, "100");

newUri = getContentResolver().insert(
    UserDictionary.Words.CONTENT_URI,   // the user dictionary content URI
    newValues                          // the values to insert
);

// Defines a new Uri object that receives the result of the insertion

Uri newUri;

...

// Defines an object to contain the new values to insert

ContentValues newValues = new ContentValues();

// Sets the values of each column and inserts the word.

// The arguments to the "put" method are "column name" and "value"

newValues.put(UserDictionary.Words.APP_ID, "example.user");

newValues.put(UserDictionary.Words.LOCALE, "en_US");

newValues.put(UserDictionary.Words.WORD, "insert");

newValues.put(UserDictionary.Words.FREQUENCY, "100");

newUri = getContentResolver().insert(

UserDictionary.Words.CONTENT_URI, // the user dictionary content URI

newValues // the values to insert

);

　
ContentValues：ContentResolverにデータを保存するためのクラスで、
ファイル情報を入力し、insert() の引数に使います

insert()からUriオブジェクトが返されるので、そこに保存します。

IS_PENDING を 1 に設定して処理が完了していないので他からのアクセスを無視するようにします。

処理が終わったら IS_PENDING を 0 にして解除してから
update() にて更新をします。

サンプルコード

　
drawableに入れた画像をMediaStoreに保存してみましょう。

MainActivity.java

//package your.package.name;

import androidx.appcompat.app.AppCompatActivity;
import android.content.ContentResolver;
import android.content.ContentValues;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.net.Uri;
import android.os.Bundle;
import android.os.Environment;
import android.provider.MediaStore;
import android.widget.Button;
import android.widget.ImageView;
import android.widget.TextView;

import java.io.IOException;
import java.io.OutputStream;

public class MainActivity extends AppCompatActivity {

    private TextView textView;
    private ImageView imageView;
    private Bitmap bmp;

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

        textView = findViewById(R.id.text_view);
        imageView = findViewById(R.id.image_view);
        bmp = BitmapFactory.decodeResource(getResources(), R.drawable.sample_image);

        Button button = findViewById(R.id.button);
        button.setOnClickListener( v -> {
            if(isExternalStorageWritable()) {

                ContentValues values = new ContentValues();
                // コンテンツ クエリの列名
                // ファイル名
                values.put(MediaStore.Images.Media.DISPLAY_NAME, "TestSampeImage.jpg");
                // マイムの設定
                values.put(MediaStore.Images.Media.MIME_TYPE, "image/jpeg");
                // 書込み時にメディア ファイルに排他的にアクセスする
                values.put(MediaStore.Images.Media.IS_PENDING, 1);

                ContentResolver resolver = getApplicationContext().getContentResolver();
                Uri collection = MediaStore.Images.Media.getContentUri(
                        MediaStore.VOLUME_EXTERNAL_PRIMARY);
                Uri item = resolver.insert(collection, values);

                try (OutputStream outstream = getContentResolver().openOutputStream(item)) {
                    bmp.compress(Bitmap.CompressFormat.JPEG, 70, outstream);
                    textView.setText(R.string.saved);
                    imageView.setImageBitmap(bmp);
                } catch (IOException e) {
                    e.printStackTrace();
                }

                values.clear();
                //　排他的にアクセスの解除
                values.put(MediaStore.Images.Media.IS_PENDING, 0);
                resolver.update(item, values, null, null);
            }
        });
    }
    /* Checks if external storage is available for read and write */
    public boolean isExternalStorageWritable() {
        String state = Environment.getExternalStorageState();
        return (Environment.MEDIA_MOUNTED.equals(state));
    }
}

//package your.package.name;

import androidx.appcompat.app.AppCompatActivity;

import android.content.ContentResolver;

import android.content.ContentValues;

import android.graphics.Bitmap;

import android.graphics.BitmapFactory;

import android.net.Uri;

import android.os.Bundle;

import android.os.Environment;

import android.provider.MediaStore;

import android.widget.Button;

import android.widget.ImageView;

import android.widget.TextView;

import java.io.IOException;

import java.io.OutputStream;

public class MainActivity extends AppCompatActivity {

private TextView textView;

private ImageView imageView;

private Bitmap bmp;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

textView = findViewById(R.id.text_view);

imageView = findViewById(R.id.image_view);

bmp = BitmapFactory.decodeResource(getResources(), R.drawable.sample_image);

Button button = findViewById(R.id.button);

button.setOnClickListener( v -> {

if(isExternalStorageWritable()) {

ContentValues values = new ContentValues();

// コンテンツクエリの列名

// ファイル名

values.put(MediaStore.Images.Media.DISPLAY_NAME, "TestSampeImage.jpg");

// マイムの設定

values.put(MediaStore.Images.Media.MIME_TYPE, "image/jpeg");

// 書込み時にメディアファイルに排他的にアクセスする

values.put(MediaStore.Images.Media.IS_PENDING, 1);

ContentResolver resolver = getApplicationContext().getContentResolver();

Uri collection = MediaStore.Images.Media.getContentUri(

MediaStore.VOLUME_EXTERNAL_PRIMARY);

Uri item = resolver.insert(collection, values);

try (OutputStream outstream = getContentResolver().openOutputStream(item)) {

bmp.compress(Bitmap.CompressFormat.JPEG, 70, outstream);

textView.setText(R.string.saved);

imageView.setImageBitmap(bmp);

} catch (IOException e) {

e.printStackTrace();

}

values.clear();

//　排他的にアクセスの解除

values.put(MediaStore.Images.Media.IS_PENDING, 0);

resolver.update(item, values, null, null);

}

});

}

/* Checks if external storage is available for read and write */

public boolean isExternalStorageWritable() {

String state = Environment.getExternalStorageState();

return (Environment.MEDIA_MOUNTED.equals(state));

}

　
適当な画像をsample_image.jpgとして用意しdrawableに入れます。

その他ファイル

acitivty_main.xml

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout 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:orientation="vertical"
    android:background="#fee"
    android:gravity="center_horizontal"
    tools:context=".MainActivity">

    <TextView
        android:id="@+id/text_view"
        android:textColor="#000"
        android:layout_margin="10dp"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

    <Button
        android:id="@+id/button"
        android:text="@string/button"
        android:layout_margin="10dp"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content" />

    <ImageView
        android:id="@+id/image_view"
        android:scaleType="centerInside"
        android:contentDescription="@string/description"
        android:layout_margin="10dp"
        android:layout_width="match_parent"
        android:layout_height="wrap_content" />

</LinearLayout>

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

<LinearLayout 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:orientation="vertical"

android:background="#fee"

android:gravity="center_horizontal"

tools:context=".MainActivity">

<TextView

android:id="@+id/text_view"

android:textColor="#000"

android:layout_margin="10dp"

android:layout_width="match_parent"

android:layout_height="wrap_content" />

<Button

android:id="@+id/button"

android:text="@string/button"

android:layout_margin="10dp"

android:layout_width="wrap_content"

android:layout_height="wrap_content" />

<ImageView

android:id="@+id/image_view"

android:scaleType="centerInside"

android:contentDescription="@string/description"

android:layout_margin="10dp"

android:layout_width="match_parent"

android:layout_height="wrap_content" />

</LinearLayout>

　
strings.xml

<resources>
    <string name="app_name">Your App Name</string>
    <string name="description">a picture</string>
    <string name="button">Save</string>
    <string name="saved">Saved Image</string>
</resources>

<string name="description">a picture</string>

<string name="saved">Saved Image</string>

</resources>

これで実行すると、

　
スマホの「フォト」アプリから共有ストレージを見ると「Pictures」に保存されているのがわかります。

　
画像の情報を見ると

1x1.trans - [Android] MediaStore 画像を保存する

　
以下に保存されていることが分かります。

/storage/emulated/0/Pictures/TestSampleImage.jpg

1	/storage/emulated/0/Pictures/TestSampleImage.jpg

尚、このパスはあくまで例で実装は端末に依存します。

　
　
関連ページ：
　

asynctask 00b 100x100 - [Android] MediaStore 画像を保存する

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

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

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