Androidアプリからプログラムで壁紙画像を設定する方法を解説

この記事では、Androidアプリ内からプログラムで端末の壁紙（ウォールペーパー）画像を設定する方法を、サンプルコードとともに段階的に解説します。

全体の流れ

壁紙の設定には WallpaperManager クラスを使用します。ボタンをタップすると、リソースとして用意した画像をビットマップに変換し、それを壁紙に適用するというシンプルな構成です。また、壁紙の変更には SET_WALLPAPER パーミッションが必要になるため、マニフェストへの記述も忘れずに行いましょう。

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

Android Studioを起動し、「File」→「New Project」を選択して新しいプロジェクトを作成します。必要な項目をすべて入力してプロジェクトの雛形を生成してください。

ステップ2：レイアウトファイルの作成

res/layout/activity_main.xml に以下のコードを追加します。画面中央付近に「Set Wallpaper」というボタンを配置しています。

<LinearLayout xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:tools="https://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".MainActivity">
    <Button
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:id="@+id/button"
        android:text="Set Wallpaper"
        android:layout_gravity="center_vertical"
        android:layout_centerInParent="true"
        android:layout_marginLeft="135dp"/>
</LinearLayout>

ステップ3：MainActivityの実装

src/MainActivity.java に以下のコードを追加します。ボタンがクリックされると setWallpaper() メソッドが呼び出され、drawable リソースの画像をビットマップとして読み込み、WallpaperManager.setBitmap() で壁紙に設定します。成功・失敗に応じてToastで結果を通知します。

import android.app.WallpaperManager;
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.View;
import android.widget.Button;
import android.widget.Toast;
import java.io.IOException;

public class MainActivity extends AppCompatActivity {

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

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

    private void setWallpaper() {
        Bitmap bitmap = BitmapFactory.decodeResource(getResources(), R.drawable.wallpaper);
        WallpaperManager manager = WallpaperManager.getInstance(getApplicationContext());
        try {
            manager.setBitmap(bitmap);
            Toast.makeText(this, "Wallpaper set!", Toast.LENGTH_SHORT).show();
        } catch (IOException e) {
            Toast.makeText(this, "Error!", Toast.LENGTH_SHORT).show();
        }
    }
}

ステップ4：パーミッションの設定

androidManifest.xml に以下のコードを追加します。ポイントは <uses-permission android:name="android.permission.SET_WALLPAPER"/> の記述です。これにより、アプリに壁紙を変更する権限が付与されます。

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="app.com.sample">
    <uses-permission android:name="android.permission.SET_WALLPAPER"/>
    <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」アイコンをクリックします。デバイス選択画面で接続したスマートフォンを選択すると、アプリが起動します。

アプリが起動したら「Set Wallpaper」ボタンをタップしてください。「Wallpaper set!」というメッセージが表示され、ホーム画面の壁紙が指定した画像に変更されます。実際の動作イメージは以下のスクリーンショットの通りです。

補足：開発時の注意点

• 画像リソースの用意： サンプルでは R.drawable.wallpaper を参照しているため、res/drawable フォルダに wallpaper という名前の画像ファイルを配置しておく必要があります。
• 例外処理： setBitmap() は IOException をスローする可能性があるため、必ず try-catch で囲みましょう。
• 新しいAPIでの開発： 本記事のコードは support library を使用していますが、新規プロジェクトでは AndroidX への移行が推奨されています。その場合は import 文を androidx.appcompat.app.AppCompatActivity に置き換えてください。
• ロック画面への設定： Android 7.0（API 24）以降では setBitmap(bitmap, null, true, WallpaperManager.FLAG_LOCK) を使うことで、ロック画面のみに壁紙を設定することも可能です。

以上の手順で、Androidアプリからプログラム的に壁紙画像を設定することができます。壁紙ギャラリーアプリやカスタマイズ系アプリの開発などにぜひ活用してみてください。