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

末蓝、 2024-02-17 16:46 29阅读 0赞

**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：

涉及到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里面定义：

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

代码运行结果如图所示：

![Center][]

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

[Center]: https://image.dandelioncloud.cn/pgy_files/images/2024/01/30/8fd88520e02e4a12b459e1a252bcab55.png
[http_blog.csdn.net_zhangphil_article_details_50457355]: http://blog.csdn.net/zhangphil/article/details/50457355
[http_blog.csdn.net_zhangphil_article_details_50461944]: http://blog.csdn.net/zhangphil/article/details/50461944