Android桌面小部件AppWidget：音乐播放器桌面控制部件Widget（3）

最新推荐文章于 2024-07-16 13:59:25 发布

zhangphil

最新推荐文章于 2024-07-16 13:59:25 发布

阅读量8.3k

点赞数 2

分类专栏： Android 文章标签： android

本文链接：https://blog.csdn.net/zhangphil/article/details/50466844

版权

Android 专栏收录该内容

726 篇文章 31 订阅

订阅专栏

Android桌面小部件AppWidget：音乐播放器桌面控制部件Widget（3）

Android桌面小部件AppWidget比较常用的场景就是音乐播放器，音乐播放器虽然通常在后台播放，但需要在桌面提供一个可以控制播放状态的APP widget，为用户提供播放、暂停、停止音乐播放器的功能。
在附录文章1、2的基础上，本文以一个简单的例子加以说明，如何通过桌面小部件实现音乐播放器的播放、停止。简单期间，本例只提供对音乐播放器的两种控制功能：播放和停止。播放，进入后台service播放给定的音乐mp3文件；停止，则直接stopService关闭播放服务即可。
为此，需要在桌面的小部件布局中增加两个按钮，这两个按钮暂时就以Android系统默认的播放（@android:drawable/ic_media_play）和暂停（@android:drawable/ic_media_pause）图片作为按钮使用。当按了播放按钮后，就开始启动后台服务播放mp3音乐文件（暂时以我放置在SDCard根目录下名为zhangphil.mp3的音乐文件为音频源文件）；当按了停止按钮后，就stopService，即停止播放。
和附录文章1,2相比，本例不需要更新桌面小部件的表现形式，仅需要处理由桌面小部件传导过来的点击事件，这些响应点击事件，均放置在onReceive里面处理。

（1）

在Androidmanifest.xml里面定义的widget：

 <receiver android:name="zhangphil.widget.AppWidget" >
           
            <intent-filter>
                <action android:name="action_play" />
            </intent-filter>
            
            <intent-filter>
                <action android:name="action_stop" />
            </intent-filter>
            
            <intent-filter>
                <action android:name="android.appwidget.action.APPWIDGET_UPDATE" />
            </intent-filter>

            <meta-data
                android:name="android.appwidget.provider"
                android:resource="@xml/appwidget" />
            
        </receiver>

涉及到res/xml目录下的appwidget.xml代码文件：

<?xml version="1.0" encoding="utf-8"?>
<appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
    android:initialLayout="@layout/appwidget_layout"
    android:minHeight="20dip"
    android:minWidth="300dip"
    android:previewImage="@drawable/ic_launcher"
    android:resizeMode="horizontal|vertical"
    android:updatePeriodMillis="0"
    android:widgetCategory="home_screen" >

</appwidget-provider>

（2）service播放音乐。也在Androidmanifest.xml里面定义：

<service android:name="zhangphil.widget.MyService" >
        </service>

（3）核心关键的AppWidget.java代码文件：

package zhangphil.widget;


import android.app.PendingIntent;
import android.appwidget.AppWidgetManager;
import android.appwidget.AppWidgetProvider;
import android.content.Context;
import android.content.Intent;
import android.util.Log;
import android.widget.RemoteViews;

public class AppWidget extends AppWidgetProvider {

	@Override
	public void onReceive(Context context, Intent intent) {
		super.onReceive(context, intent);
		// Log.d(this.getClass().getName(), "onReceive");

		if (intent == null)
			return;

		String action = intent.getAction();

		// 停止播放
		if (action.equals(Constants.ACTION_STOP)) {
			Intent serviceIntent = new Intent(context, MyService.class);
			context.stopService(serviceIntent);
		}

		// 点击了按钮，启动一个后台服务播放
		if (action.equals(Constants.ACTION_PLAY)) {
			Intent serviceIntent = new Intent(context, MyService.class);
			context.startService(serviceIntent);
		}
	}

	@Override
	public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
		Log.d(this.getClass().getName(), "onUpdate");

		RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.appwidget_layout);

		// 播放图片作为按钮，绑定播放事件
		Intent intentPlay = new Intent(Constants.ACTION_PLAY);
		PendingIntent pendingIntentPlay = PendingIntent.getBroadcast(context, Constants.REQUEST_CODE_PLAY, intentPlay,
				PendingIntent.FLAG_UPDATE_CURRENT);
		remoteViews.setOnClickPendingIntent(R.id.play, pendingIntentPlay);

		// 停止图片作为按钮，绑定停止事件
		Intent intentStop = new Intent(Constants.ACTION_STOP);
		PendingIntent pendingIntentStop = PendingIntent.getBroadcast(context, Constants.REQUEST_CODE_STOP, intentStop,
				PendingIntent.FLAG_UPDATE_CURRENT);
		remoteViews.setOnClickPendingIntent(R.id.stop, pendingIntentStop);

		// 更新AppWidget
		appWidgetManager.updateAppWidget(appWidgetIds, remoteViews);
	}

	/**
	 * 删除AppWidget
	 */
	@Override
	public void onDeleted(Context context, int[] appWidgetIds) {
		super.onDeleted(context, appWidgetIds);
		Log.d(this.getClass().getName(), "onDeleted");
	}

	@Override
	public void onDisabled(Context context) {
		super.onDisabled(context);
		Log.d(this.getClass().getName(), "onDisabled");
	}

	/**
	 * AppWidget首次创建调用
	 */
	@Override
	public void onEnabled(Context context) {
		super.onEnabled(context);
		Log.d(this.getClass().getName(), "onEnabled");
	}
}

AppWidget.java里面RemoteViews用到的布局文件appwidget_layout.xml:

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="#33000000"
    android:orientation="horizontal" >

    <ImageView
        android:id="@+id/play"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:src="@android:drawable/ic_media_play" >
    </ImageView>

    <ImageView
        android:id="@+id/stop"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:src="@android:drawable/ic_media_pause" >
    </ImageView>

</LinearLayout>

（4）service后台服务MyService.java，该部分代码将负责在后台播放或者停止音播放：

package zhangphil.widget;

import java.io.File;

import android.app.Service;
import android.content.Intent;
import android.media.MediaPlayer;
import android.os.Environment;
import android.os.IBinder;

public class MyService extends Service {

	// 播放器
	private MediaPlayer mMediaPlayer;

	// 音频文件
	private File audioFile;

	@Override
	public void onCreate() {
		super.onCreate();

		mMediaPlayer = new MediaPlayer();

		// 根目录
		File sdcard = Environment.getExternalStorageDirectory();
		audioFile = new File(sdcard, "zhangphil.mp3");
	}

	@Override
	public int onStartCommand(Intent intent, int flags, int startId) {
		// 重置
		mMediaPlayer.reset();

		// 设置播放器的声音源
		try {
			mMediaPlayer.setDataSource(audioFile.getAbsolutePath());
		} catch (Exception e) {
			e.printStackTrace();
		}

		// 也可以从一个静态资源文件中加载音频数据源
		// mMediaPlayer.create(this, R.raw.xxx);

		if (!mMediaPlayer.isPlaying()) {
			try {
				mMediaPlayer.prepare();
			} catch (Exception e) {
				e.printStackTrace();
			}
			
			mMediaPlayer.start();

			// 如果设置循环true，那么将循环播放
			// mMediaPlayer.setLooping(true);
		}
		
		return super.onStartCommand(intent, flags, startId);
	}

	@Override
	public void onDestroy() {
		super.onDestroy();

		mMediaPlayer.stop();
		mMediaPlayer.release();
		mMediaPlayer = null;
	}

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

（5）定义的公共静态变量Constants.java：

package zhangphil.widget;

public class Constants {
	public static final String ACTION_PLAY = "action_play";
	public static final String ACTION_STOP = "action_stop";
	public static final int REQUEST_CODE_PLAY = 0xd05;
	public static final int REQUEST_CODE_STOP = 0xd06;
}

代码运行结果如图所示：