[Android & Kotlin] MediaStore に画像を保存

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

Android Studio
2021.2.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
lateinit var newUri: Uri

...

// Defines an object to contain the new values to insert
val newValues = ContentValues().apply {
    /*
     * Sets the values of each column and inserts the word. The arguments to the "put"
     * method are "column name" and "value"
     */
    put(UserDictionary.Words.APP_ID, "example.user")
    put(UserDictionary.Words.LOCALE, "en_US")
    put(UserDictionary.Words.WORD, "insert")
    put(UserDictionary.Words.FREQUENCY, "100")

}

newUri = contentResolver.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

lateinit var newUri: Uri

...

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

val newValues = ContentValues().apply {

* Sets the values of each column and inserts the word. The arguments to the "put"

* method are "column name" and "value"

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

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

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

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

}

newUri = contentResolver.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.kt

//package your.package.name

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 androidx.appcompat.app.AppCompatActivity
import java.io.IOException

class MainActivity : AppCompatActivity() {
    
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        var newUri: Uri
        val textView = findViewById<TextView>(R.id.text_view)
        val imageView = findViewById<ImageView>(R.id.image_view)
        val bmp: Bitmap = BitmapFactory.decodeResource(resources, R.drawable.sample_image)

        val button = findViewById<Button>(R.id.button)
        button.setOnClickListener {
            if (isExternalStorageWritable()) {
                val newValues = ContentValues().apply{
                    // コンテンツ クエリの列名
                    // ファイル名
                    put(MediaStore.Images.Media.DISPLAY_NAME, "TestSampleImage.jpg")
                    // マイムの設定
                    put(MediaStore.Images.Media.MIME_TYPE, "image/jpeg")
                    // 書込み時にメディア ファイルに排他的にアクセスする
                    put(MediaStore.Images.Media.IS_PENDING, 1)
                }

                val resolver = applicationContext.contentResolver
                val collection: Uri = MediaStore.Images.Media.getContentUri(
                    MediaStore.VOLUME_EXTERNAL_PRIMARY
                )

                newUri = resolver.insert(collection, newValues)!!

                try { contentResolver.openOutputStream(newUri).use { outstream ->
                            bmp.compress(Bitmap.CompressFormat.JPEG, 70, outstream)
                            textView.setText(R.string.saved)
                            imageView.setImageBitmap(bmp) }
                } catch (e: IOException) {
                    e.printStackTrace()
                }

                newValues.clear()
                //　排他的にアクセスの解除
                newValues.put(MediaStore.Images.Media.IS_PENDING, 0)
                resolver.update(newUri, newValues, null, null)
            }
        }

    }

    /* Checks if external storage is available for read and write */
    private fun isExternalStorageWritable(): Boolean {
        val state = Environment.getExternalStorageState()
        return Environment.MEDIA_MOUNTED == state
    }

}

//package your.package.name

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 androidx.appcompat.app.AppCompatActivity

import java.io.IOException

class MainActivity : AppCompatActivity() {

override fun onCreate(savedInstanceState: Bundle?) {

super.onCreate(savedInstanceState)

setContentView(R.layout.activity_main)

var newUri: Uri

val textView = findViewById<TextView>(R.id.text_view)

val imageView = findViewById<ImageView>(R.id.image_view)

val bmp: Bitmap = BitmapFactory.decodeResource(resources, R.drawable.sample_image)

val button = findViewById<Button>(R.id.button)

button.setOnClickListener {

if (isExternalStorageWritable()) {

val newValues = ContentValues().apply{

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

// ファイル名

put(MediaStore.Images.Media.DISPLAY_NAME, "TestSampleImage.jpg")

// マイムの設定

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

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

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

}

val resolver = applicationContext.contentResolver

val collection: Uri = MediaStore.Images.Media.getContentUri(

MediaStore.VOLUME_EXTERNAL_PRIMARY

)

newUri = resolver.insert(collection, newValues)!!

try { contentResolver.openOutputStream(newUri).use { outstream ->

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

textView.setText(R.string.saved)

imageView.setImageBitmap(bmp) }

} catch (e: IOException) {

e.printStackTrace()

}

newValues.clear()

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

newValues.put(MediaStore.Images.Media.IS_PENDING, 0)

resolver.update(newUri, newValues, null, null)

}

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

private fun isExternalStorageWritable(): Boolean {

val state = Environment.getExternalStorageState()

return Environment.MEDIA_MOUNTED == 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 & Kotlin] MediaStore に画像を保存

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

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

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

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

　
　
関連ページ：
　

asynctask 00b 100x100 - [Android & Kotlin] MediaStore に画像を保存

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

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

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