本節の導入:

本節では、WallpaperManager(壁紙マネージャー)を紹介します。その名の通り、スマートフォンの壁紙に関するAPIです。本節では、WallpaperManagerの基本用法、システム内蔵の壁紙選択機能の呼び出し、Activityの背景を壁紙の背景に設定する方法、そして定期的に壁紙を変更する例を説明します。さて、余計な話はせずに、本節の内容を始めましょう。

公式APIドキュメント:WallpaperManager


1.WallpaperManagerの基本用法

関連メソッド

壁紙を設定する関連メソッド:

  • setBitmap(Bitmap bitmap):壁紙をbitmapが表すビットマップに設定します
  • setResource(int resid):壁紙をresidリソースが表す画像に設定します
  • setStream(InputStream data):壁紙をdataデータが表す画像に設定します

その他のメソッド:

  • clear():壁紙をクリアし、システムデフォルトの壁紙に戻します
  • getDesiredMinimumHeight():最小壁紙の高さ
  • getDesiredMinimumWidth():最小壁紙の幅
  • getDrawable():現在のシステム壁紙を取得します。壁紙が設定されていない場合は、システムデフォルトの壁紙を返します
  • getWallpaperInfo():現在の壁紙がライブ壁紙の場合、ライブ壁紙の情報を返します
  • peekDrawable():現在のシステム壁紙を取得します。壁紙が設定されていない場合はnullを返します

WallpaperManagerオブジェクトを取得

WallpaperManager wpManager =WallpaperManager.getInstance(this);

壁紙の設定に必要な権限

<uses-permission android:name="android.permission.SET_WALLPAPER"/> 

2.システム内蔵の壁紙選択機能を呼び出す

Button btn_set = (Button) findViewById(R.id.btn_set);
    btn_set.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            Intent chooseIntent = new Intent(Intent.ACTION_SET_WALLPAPER);
            startActivity(Intent.createChooser(chooseIntent, "选择壁纸"));
        }
    });

実行画面:


3.Activityの背景を壁紙の背景に設定する

方法は2つあります。1つはActivity内でコードで設定する方法、もう1つはAndroidManifest.xmlでActivityのテーマを変更する方法です。

方法一:Activity内で設定:

@Override
protected void onCreate(Bundle savedInstanceState) {
    setTheme(android.R.style.Theme_Wallpaper_NoTitleBar_Fullscreen);
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
}

方法二:AndroidManifest.xmlでthemeを変更:

<activity android:name=".MainActivity"
android:theme="@android:style/Theme.Wallpaper.NoTitleBar"/>

4.定期的に壁紙を変更するデモ

ここでは前に学んだAlarmManager(アラームサービス)を使用します。もしそれについてよく知らない場合は、次を参照してください:10.5 AlarmManager(アラームサービス)を参照して学習してください。それではデモを作成してみましょう。

実行画面:

コード実装:

まず、定期的に壁紙を変更するServiceを作成しましょう:WallPaperService.java

/**
 * Created by Jay on 2015/11/13 0013.
 */
public class WallPaperService extends Service {

    private int current = 0;  //当前壁纸下标
    private int[] papers = new int[]{R.mipmap.gui_1,R.mipmap.gui_2,R.mipmap.gui_3,R.mipmap.gui_4};
    private WallpaperManager wManager = null;   //定义WallpaperManager服务

    @Override
    public void onCreate() {
        super.onCreate();
        wManager = WallpaperManager.getInstance(this);
    }

    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {
        if(current >= 4)current = 0;
        try{
            wManager.setResource(papers[current++]);
        }catch(Exception e){e.printStackTrace();}
        return START_STICKY;
    }

    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }
}

次に、簡単なレイアウトと3つのButtonを作成します:activity_main.xml:

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">
    
    <Button
        android:id="@+id/btn_on"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="开启自动换壁纸" />

    <Button
        android:id="@+id/btn_off"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="关闭自动换壁纸" />

    <Button
        android:id="@+id/btn_clean"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="清除壁纸" />

</LinearLayout>

次にActivityです。ここでaManagerをインスタンス化し、定期イベントを設定します:MainActivity.java:

public class MainActivity extends AppCompatActivity implements View.OnClickListener {

    private Button btn_on;
    private Button btn_off;
    private Button btn_clean;
    private AlarmManager aManager;
    private PendingIntent pi;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        //①获得AlarmManager对象:
        aManager = (AlarmManager) getSystemService(ALARM_SERVICE);
        //②指定要启动的Service,并指明动作是Servce:
        Intent intent = new Intent(MainActivity.this, WallPaperService.class);
        pi = PendingIntent.getService(MainActivity.this, 0, intent, 0);
        bindViews();
    }

    private void bindViews() {
        btn_on = (Button) findViewById(R.id.btn_on);
        btn_off = (Button) findViewById(R.id.btn_off);
        btn_clean = (Button) findViewById(R.id.btn_clean);
        btn_on.setOnClickListener(this);
        btn_off.setOnClickListener(this);
        btn_clean.setOnClickListener(this);
    }

    @Override
    public void onClick(View v) {
        switch (v.getId()) {
            case R.id.btn_on:
                aManager.setRepeating(AlarmManager.RTC_WAKEUP, 0, 3000, pi);
                btn_on.setEnabled(false);
                btn_off.setEnabled(true);
                Toast.makeText(MainActivity.this, "自动更换壁纸设置成功", Toast.LENGTH_SHORT).show();
                break;
            case R.id.btn_off:
                btn_on.setEnabled(true);
                btn_off.setEnabled(false);
                aManager.cancel(pi);
                break;
            case R.id.btn_clean:
                try {
                    WallpaperManager.getInstance(getApplicationContext()).clear();
                    Toast.makeText(MainActivity.this, "清除壁纸成功~", Toast.LENGTH_SHORT).show();
                } catch (IOException e) {
                    e.printStackTrace();
                }
                break;
        }
    }
}

最後に、壁紙を設定する権限を追加し、Serviceを登録することを忘れないでください:AndroidManifest.xml:

<uses-permission android:name="android.permission.SET_WALLPAPER" />
<service android:name=".WallPaperService"/>

はい、とても簡単です。


5.本節のサンプルコードのダウンロード

WallpaperManagerDemo.zip


本節のまとめ:

本節では、WallpaperManagerの基本的な使い方を紹介しました。さらに詳しいことは、皆さん自身で探求してみてください。ありがとうございます!