[Android] スマホで撮ったフォトの画像を取得する

昔はギャラリー今はフォト等と言われていますが、写真を撮った画像が保存されているところから画像を取得したい場合にはSAF(Storage Access Framework)を使います。
ファイルをその場で開いて編集したい場合などは、ACTION_OPEN_DOCUMENT を、また保存したい場合はACTION_CREATE_DOCUMENTアクションを使います。
 

Android Studio 3.0
Android 8.0

 



SAF, Storage Access Framework

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

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

アプリ

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

 

ACTION_OPEN_DOCUMENT

 
画像ファイルを取り出してみましょう。

  • ACTION_OPEN_DOCUMENT
    • ピッカーを使用してファイルを選択するためのIntent
  • Intent.CATEGORY_OPENABLE:
    • openFileDescriptor() によるファイル ストリームとして利用可能な「開くことができる」ファイルのカテゴリーを選択
  • setType:
    • MIME タイプを指定、取得するファイルの形式をフィルターする 

 
ピッカーから画像を選択すると、onActivityResult() が呼び出され、選択した画像を指す URI が resultData パラメータに含まれ返ってきます。それを getData() を使って抽出です。
 

このケースでは、パーミッションなど必要ありません(これがありがたいですね)
 
まとめるとこうなります。
MainActivity.java

 
activity_main.xml

 
リソースです
strings.xml

 
このケースでは、本来はAsyncTaskを使って非同期で画像を取り込む事が望ましいとされています。(この例では簡略化させていただきました…)
 


 

ACTION_CREATE_DOCUMENT

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

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

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

drawableにあるアイコン画像を保存してみます。

MainActivity.java

 
activity_main.xml

 
strings.xml

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

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