[Android] Storage Access Framework で画像を保存する

写真などの画像が保存されている共有メモリに保存するためにSAF(Storage Access Framework)を利用します。ファイル保存に使うのは ACTION_CREATE_DOCUMENT アクションです。取り出したい場合は ACTION_OPEN_DOCUMENT を使います。

Android Studio 3.4.2
API 29
AndroidX

SAF, Storage Access Framework

　
API 19よりSAFを使うことによりコンテンツを容易に参照できるようになりました。

ドキュメントストレージプロバイダ全体から簡単にドキュメント、画像、その他のファイルを参照して開くことができる
標準の Picker UI により、アプリやプロバイダを通じて一貫性のある方法でファイルにアクセスできる

図 2. ストレージアクセスフレームワークのフロー
Ref:ストレージアクセスフレームワーク

目次
1.Intent ACTION_CREATE
2.サンプルコード
3.サンプル動画

Intent ACTION_CREATE

　
画像をSAFを使って保存します。

IntentはACTION_CREATE_DOCUMENT
setTypeでMIMEの設定
EXTRA_TITLEでは名前を設定する時に候補としてデフォルトで入ります。
　

Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT);

intent.setType("*/*");

intent.putExtra(Intent.EXTRA_TITLE, "sample_image.jpg");

startActivityForResult(intent, REQUEST_SAVE_IMAGE);

Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT);

intent.setType("*/*");

intent.putExtra(Intent.EXTRA_TITLE, "sample_image.jpg");

startActivityForResult(intent, REQUEST_SAVE_IMAGE);

　
onActivityResultでUriが返ってきます。そのUriにOutputStream()を使って画像を出力していきます。

サンプルコード

　
drawableに画像を入れてそれを保存してみます。

MainActivity.java

//AndroidX
import androidx.appcompat.app.AppCompatActivity;
//import android.support.v7.app.AppCompatActivity;

import android.app.Activity;
import android.content.Intent;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.net.Uri;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.ImageView;
import android.widget.TextView;

import java.io.OutputStream;
import java.util.Locale;

public class MainActivity extends AppCompatActivity {

    private static final int REQUEST_SAVE_IMAGE = 1002;
    private TextView textView;
    private  Bitmap bmp;

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

        textView = findViewById(R.id.text_view);

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

        Button button = findViewById(R.id.button);
        button.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View v) {

                Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT);
                intent.setType("image/*");
                intent.putExtra(Intent.EXTRA_TITLE, "sample_image.jpg");

                startActivityForResult(intent, REQUEST_SAVE_IMAGE);
            }
        });
    }

    @Override
    public void onActivityResult(int requestCode, int resultCode, Intent resultData) {

        if (requestCode == REQUEST_SAVE_IMAGE && resultCode == Activity.RESULT_OK) {
            if(resultData.getData() != null){

                Uri uri = resultData.getData();

                // Uriを表示
                textView.setText(
                        String.format(Locale.US, "Uri:　%s",uri.toString()));

                try(OutputStream outputStream =
                            getContentResolver().openOutputStream(uri);) {
                    bmp.compress(Bitmap.CompressFormat.PNG, 100, outputStream);
                } catch(Exception e){
                    e.printStackTrace();
                }
            }
        }
    }
}

//AndroidX

import androidx.appcompat.app.AppCompatActivity;

//import android.support.v7.app.AppCompatActivity;

import android.app.Activity;

import android.content.Intent;

import android.graphics.Bitmap;

import android.graphics.BitmapFactory;

import android.net.Uri;

import android.os.Bundle;

import android.view.View;

import android.widget.Button;

import android.widget.ImageView;

import android.widget.TextView;

import java.io.OutputStream;

import java.util.Locale;

public class MainActivity extends AppCompatActivity {

private static final int REQUEST_SAVE_IMAGE = 1002;

private TextView textView;

private Bitmap bmp;

@Override

protected void onCreate(Bundle savedInstanceState) {

super.onCreate(savedInstanceState);

setContentView(R.layout.activity_main);

textView = findViewById(R.id.text_view);

ImageView imageView = findViewById(R.id.image_view);

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

imageView.setImageBitmap(bmp);

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

button.setOnClickListener(new View.OnClickListener() {

@Override

public void onClick(View v) {

Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT);

intent.setType("image/*");

intent.putExtra(Intent.EXTRA_TITLE, "sample_image.jpg");

startActivityForResult(intent, REQUEST_SAVE_IMAGE);

}

});

}

@Override

public void onActivityResult(int requestCode, int resultCode, Intent resultData) {

if (requestCode == REQUEST_SAVE_IMAGE && resultCode == Activity.RESULT_OK) {

if(resultData.getData() != null){

Uri uri = resultData.getData();

// Uriを表示

textView.setText(

String.format(Locale.US, "Uri:　%s",uri.toString()));

try(OutputStream outputStream =

getContentResolver().openOutputStream(uri);) {

bmp.compress(Bitmap.CompressFormat.PNG, 100, outputStream);

} catch(Exception e){

e.printStackTrace();

}

　
activity_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">TestCreateDocument</string>
    <string name="button">Save Image</string>
    <string name="description">a picture</string>
</resources>