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



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;
}

代码运行结果如图所示：



附录文章：
1，《Android桌面小部件AppWidget（1）》链接地址：http://blog.csdn.net/zhangphil/article/details/50457355
2，《Android桌面小部件AppWidget（2）》链接地址：http://blog.csdn.net/zhangphil/article/details/50461944