[Android] ACTION_CREATE_DOCUMENT で画像を保存する

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

Android Studio 3.0.1
Android 8.1.0

SAF, Storage Access Framework

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

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

storage dataflow - [Android] ACTION_CREATE_DOCUMENT で画像を保存する

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

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

ACTION_CREATE_DOCUMENT

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

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

Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT);

intent.setType("*/*");

intent.putExtra(Intent.EXTRA_TITLE, "img.png");

startActivityForResult(intent, REQUEST_SAVE_IMAGE);

Intent intent = new Intent(Intent.ACTION_CREATE_DOCUMENT);

intent.setType("*/*");

intent.putExtra(Intent.EXTRA_TITLE, "img.png");

startActivityForResult(intent, REQUEST_SAVE_IMAGE);

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

サンプルコード

　
drawableにある画像を保存してみます。

MainActivity.java

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.support.v7.app.AppCompatActivity;
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.img);
        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, "img.png");

                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();
                }
            }
        }
    }
}

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.support.v7.app.AppCompatActivity;

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.img);

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, "img.png");

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="40dp"
        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="center"
        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="40dp"

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="center"

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>

<string name="app_name">TestCreateDocument</string>

<string name="button">Save Image</string>

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

</resources>

　
Downloadsに保存されました。Photosのアプリで確認すると画像として登録されているのがわかります。

サンプル動画

　
　
関連ページ：
スマホ内の画像を検索してpathを表示させます。
MediaStore スマホの画像を検索
　
References:
Storage Access Framework
インテント
 ACTION_OPEN_DOCUMENT
ACTION_GET_CONTENT