【Android開発】プログラムからスクリーンショットを撮影する方法をステップ解説

この記事では、Androidアプリ内からプログラム的にスクリーンショットを撮影する方法を、実際のコード例とともに段階的に解説します。Viewの描画キャッシュ機能を利用することで、特別な権限なしに画面のBitmap画像を取得できます。

全体の流れ

実装は以下の5つのステップで行います。

1. Android Studioで新規プロジェクトを作成する
2. レイアウトファイル（activity_main.xml）を編集する
3. スクリーンショット取得用のJavaクラスを作成する
4. MainActivity.javaにボタンの処理を実装する
5. AndroidManifest.xmlを確認する

ステップ1：新規プロジェクトの作成

まず、Android Studioを起動し、メニューから「File」→「New Project」を選択して新しいプロジェクトを作成します。必要な項目（プロジェクト名、パッケージ名、保存先など）を入力してプロジェクトをセットアップしましょう。

ステップ2：レイアウトファイル（activity_main.xml）の編集

次に、「res/layout/activity_main.xml」に以下のコードを追加します。スクリーンショットを撮影するためのButtonと、撮影した画像を表示するImageViewを配置しています。

<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="https://schemas.android.com/apk/res/android"
    style="?attr/actionButtonStyle"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:id="@+id/main">
    <Button
        android:id="@+id/button"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="30dp"
        android:text="Take screenshot"/>
    <ImageView
        android:id="@+id/imageView"
        android:layout_below="@id/button"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_centerHorizontal="true"
        android:layout_marginTop="30dp"
        android:scaleType="fitCenter"/>
</RelativeLayout>

ステップ3：Screenshotクラスの作成

続いて、新しいJavaクラス「Screenshot.java」を作成し、以下のコードを記述します。このクラスでは、ViewのDrawing Cache（描画キャッシュ）を有効化してBitmapを生成する仕組みを使っています。

import android.graphics.Bitmap;
import android.view.View;
public class Screenshot{
    public static Bitmap takescreenshot(View v) {
        v.setDrawingCacheEnabled(true);
        v.buildDrawingCache(true);
        Bitmap b = Bitmap.createBitmap(v.getDrawingCache());
        v.setDrawingCacheEnabled(false);
        return b;
    }
    public static Bitmap takescreenshotOfRootView(View v) {
        return takescreenshot(v.getRootView());
    }
}

ポイントは以下の2つのメソッドです。

• takescreenshot(View v)：指定したViewの描画キャッシュからBitmapを作成して返します。
• takescreenshotOfRootView(View v)：ルートビュー（画面全体）を対象にスクリーンショットを取得します。

ステップ4：MainActivity.javaの編集

次に、「src/MainActivity.java」に以下のコードを追加します。ボタンがタップされると、ルートビューのスクリーンショットを取得し、その結果をImageViewに表示したうえで、背景色をグレー（#999999）に変更します。

import android.graphics.Bitmap;
import android.graphics.Color;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.ImageView;
public class MainActivity extends AppCompatActivity {
    private View main;
    private ImageView imageView;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        main = findViewById(R.id.main);
        imageView = (ImageView) findViewById(R.id.imageView);
        Button btn = (Button) findViewById(R.id.button);
        btn.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                Bitmap b = Screenshot.takescreenshotOfRootView(imageView);
                imageView.setImageBitmap(b);
                main.setBackgroundColor(Color.parseColor("#999999"));
            }
        });
    }
}

ステップ5：AndroidManifest.xmlの確認

最後に、「androidManifest.xml」が以下のようになっていることを確認してください。このサンプルでは特別な権限は不要ですが、マニフェストにアクティビティが正しく登録されている必要があります。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.sample">
    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true"
        android:theme="@style/AppTheme">
        <activity android:name=".MainActivity">
            <intent-filter>
                <action android:name="android.intent.action.MAIN" />
                <category android:name="android.intent.category.LAUNCHER" />
            </intent-filter>
        </activity>
    </application>
</manifest>

アプリの実行と動作確認

それでは、実際にアプリを実行してみましょう。ここでは、実機のAndroidスマートフォンがPCに接続されているものとして説明します。

Android Studioでプロジェクト内の任意のアクティビティファイルを開き、ツールバーの「Run」アイコンをクリックします。デバイス選択画面で接続中のモバイル端末を選択すると、端末側にアプリの初期画面が表示されます。

画面上の「Take screenshot」ボタンをタップすると、現在の画面がキャプチャされ、ImageViewに表示されます。同時に背景色がグレーに変わり、スクリーンショットが正しく取得できたことが視覚的に確認できます。

まとめ

Androidでプログラムからスクリーンショットを撮るには、Viewの描画キャッシュ（Drawing Cache）を利用してBitmapを生成するのが基本的な手法です。今回のようにルートビューを指定すれば画面全体をキャプチャでき、特定のViewだけを指定すれば部分的なキャプチャも可能です。なお、より高度な用途（他アプリの画面キャプチャなど）にはMediaProjection APIが必要になる点も覚えておくとよいでしょう。