美文网首页
5.1 RemoteViews的应用

5.1 RemoteViews的应用

作者: 武安长空 | 来源:发表于2016-06-28 16:40 被阅读163次

    1. RemoteViews简介

    远程View?远程服务更好理解。远程服务是跨进程的服务,那么远程View当然是跨进程的View。
    RemoteViews可以跨进程显示,并且可以跨进程更新页面。
    其使用场景有两种通知栏和桌面小部件。

    2. RemoteViews应用概述

    通知栏和桌面小部件的开发过程都会用到RemoteViews,他们在更新界面时无法像在Activity里面那样去直接更新View,这是因为二者的界面都运行在其他进程中,确切来说是系统的SystemServer进程。为了跨进程更新界面,RemoteViews提供了一系列set方法,并且这些方法只是View全部方法的子集,另外RemoteViews中所支持的View类型也是有限的。

    3. RemoteViews在通知栏上的应用(默认样式)

    notificationManager = (NotificationManager) getSystemService(NOTIFICATION_SERVICE);
    
    NotificationCompat.Builder builder = new NotificationCompat.Builder(RemoteActivity.this);
    Notification notification = builder
            .setContentTitle("contentTitle") // title
            .setContentText("contentText")   // content
            .setWhen(System.currentTimeMillis()) // time
            .setSmallIcon(R.mipmap.ic_launcher)  // 5.0开始只有alpha图层
            .setLargeIcon(BitmapFactory.decodeResource(getResources(), R.mipmap.ic_launcher)) // 
            .build();
    notificationManager.notify(1, notification);
    

    其他功能

    // 点击跳到RemoteActivity页面
    Intent intent = new Intent(RemoteActivity.this, RemoteActivity.class);
    PendingIntent pendingIntent = PendingIntent.getActivity(RemoteActivity.this, 0, intent, 0);
    builder.setContentIntent(pendingIntent);
    
    //通知被点击后,自动消失
    notification.flags |= Notification.FLAG_AUTO_CANCEL;
    //点击'Clear'时,不清楚该通知(QQ的通知无法清除,就是用的这个)
    notification.flags |= Notification.FLAG_NO_CLEAR;
    
    //通知的默认参数 DEFAULT_SOUND, DEFAULT_VIBRATE, DEFAULT_LIGHTS.
    //如果要全部采用默认值, 用 DEFAULT_ALL.
    //此处采用默认声音
    notification.defaults |= Notification.DEFAULT_SOUND;
    notification.defaults |= Notification.DEFAULT_VIBRATE;
    notification.defaults |= Notification.DEFAULT_LIGHTS;
    

    这里使用的是Notification的v7兼容包,因为Android各个版本的Notification有差别。

    4. RemoteViews在通知栏上的应用(自定义样式)

    NotificationCompat.Builder builder = new NotificationCompat.Builder(RemoteActivity.this);
    // smallIcon是必须的,没有会报错,其他可以没有
    builder.setSmallIcon(R.mipmap.ic_launcher);
    
    RemoteViews remoteViews = new RemoteViews("qingfengmy.developmentofart", R.layout.remote_views);
    remoteViews.setImageViewResource(R.id.icon, R.mipmap.ic_launcher);
    remoteViews.setTextViewText(R.id.title, "remote views title");
    
    // icon单独处理点击事件(setOnClickPendingIntent)
    Intent intent = new Intent(this, MainActivity.class);
    PendingIntent iconPendingIntent = PendingIntent.getActivity(this, 0, intent, 0);
    remoteViews.setOnClickPendingIntent(R.id.icon, iconPendingIntent);
    builder.setContent(remoteViews);
    
    // 点击跳到RemoteActivity页面
    Intent intent2 = new Intent(RemoteActivity.this, RemoteActivity.class);
    PendingIntent pendingIntent = PendingIntent.getActivity(RemoteActivity.this, 0, intent2, 0);
    builder.setContentIntent(pendingIntent);
    
    Notification notification = builder.build();
    notificationManager.notify(2, notification);
    
    <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="horizontal">
    
        <ImageView
            android:id="@+id/icon"
            android:layout_width="120dp"
            android:layout_height="120dp" />
    
        <TextView
            android:id="@+id/title"
            android:textColor="#456789"
            android:layout_gravity="center_vertical"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content" />
    </LinearLayout>
    

    5. 扩展样式通知(InboxStyle)

    自定义通知布局的可用高度取决于通知视图。普通视图布局限制为 64 dp,扩展视图布局限制为 256 dp。

    NotificationCompat.Builder builder = new NotificationCompat.Builder(this);
    
    builder.setSmallIcon(R.mipmap.ic_launcher)
            .setContentTitle("My notification")
            .setContentText("Hello World!");
    
    NotificationCompat.InboxStyle inboxStyle = new NotificationCompat.InboxStyle();
    inboxStyle.setBigContentTitle("邮件标题:");
    for (int i=0; i < 5; i++) {
        inboxStyle.addLine("邮件内容" + i);
    }
    builder.setStyle(inboxStyle);
    
    Notification notification = builder.build();
    notificationManager.notify(3, notification);
    

    6. 扩展样式通知(BigPictureStyle)

    NotificationCompat.Builder builder = new NotificationCompat.Builder(this);
    
    builder.setSmallIcon(R.mipmap.ic_launcher)
            .setContentTitle("My notification")
            .setContentText("Hello World!");
    
    //get the bitmap to show in notification bar
    Bitmap bitmap_image = BitmapFactory.decodeResource(this.getResources(), R.mipmap.ic_launcher);
    NotificationCompat.BigPictureStyle s = new NotificationCompat.BigPictureStyle().bigPicture(bitmap_image);
    s.setSummaryText("Summary text appears on expanding the notification");
    builder.setStyle(s);
    
    Notification notification = builder.build();
    notificationManager.notify(3, notification);
    

    7. 默认样式的进度条处理

    final NotificationCompat.Builder mBuilder = new NotificationCompat.Builder(this);
    mBuilder.setContentTitle("Picture Download")
            .setContentText("Download in progress")
            .setSmallIcon(R.mipmap.ic_launcher);
    new Thread(
            new Runnable() {
                @Override
                public void run() {
                    int incr;
                    for (incr = 0; incr <= 100; incr += 5) {
                        mBuilder.setProgress(100, incr, false);
                        notificationManager.notify(0, mBuilder.build());
                        try {
                            Thread.sleep(5 * 1000);
                        } catch (InterruptedException e) {
                        }
                    }
                    // When the loop is finished, updates the notification
                    mBuilder.setContentText("Download complete")
                            .setProgress(0, 0, false);
                    notificationManager.notify(4, mBuilder.build());
                }
            }
    ).start();
    

    默认Notification的完全体:


    Paste_Image.png

    参考文章
    android官网Notification介绍
    android notification 的总结分析

    8. RemoteViews在桌面小部件应用简介

    AppWidgetProvider是Android中提供的用于实现桌面小部件的类,其本质是一个广播即BroadcastingReceiver。

    9. 桌面小部件开发步骤

      1. 定义小部件界面
    <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">
    
        <ImageView
            android:id="@+id/launcher"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:src="@mipmap/ic_launcher" />
    </LinearLayout>
    
      1. 定义小部件配置信息
        配置信息放在 xml/appwidget_provider_info.xml
    <appwidget-provider xmlns:android="http://schemas.android.com/apk/res/android"
        android:initialLayout="@layout/widget"
        android:minHeight="84dp"
        android:minWidth="84dp"
        android:updatePeriodMillis="100000">
    
    </appwidget-provider>
    

    updatePeriodMillis:定义了 Widget 的刷新频率,也就是 App Widget Framework 多久请求一次 AppWidgetProvider 的 onUpdate() 回调函数。该时间间隔并不保证精确,出于节约用户电量的考虑,Android 系统默认最小更新周期是 30 分钟,也就是说:如果您的程序需要实时更新数据,设置这个更新周期是 2 秒,那么您的程序是不会每隔 2 秒就收到更新通知的,而是要等到 30 分钟以上才可以,要想实时的更新 Widget,一般可以采用 Service 和 AlarmManager 对 Widget 进行更新。

      1. 定义小部件的实现类
    public class MyAppWidgetProvider extends AppWidgetProvider {
        public static final String click_action = "QINGFENGMY.DEVELOPMENTOFART.APPWIDGET.ACTION";
    
        // 接受广播
        @Override
        public void onReceive(final Context context, Intent intent) {
            super.onReceive(context, intent);
           // 自己的小部件被单击了,执行相应逻辑
        }
    
        // 每次桌面小部件更新时都调用一次该方法,第一次放到桌面也执行
        @Override
        public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
            super.onUpdate(context, appWidgetManager, appWidgetIds);
            // 通过RemoteView添加点击事件,发送广播
        }
    
    }
    
    
    • onUpdate实现
    @Override
    public void onUpdate(Context context, AppWidgetManager appWidgetManager, int[] appWidgetIds) {
        super.onUpdate(context, appWidgetManager, appWidgetIds);
        Log.e("aaa", "onUpdate");
        int counter = appWidgetIds.length;
        // 可以在桌面添加多个这样的小部件
        for (int i = 0; i < counter; i++) {
            int appWidgetId = appWidgetIds[i];
            Log.e("aaa", "-----------" + appWidgetId);
            onWidgetUpdate(context, appWidgetManager, appWidgetId);
        }
    }
    
    private void onWidgetUpdate(Context context, AppWidgetManager appWidgetManager, int appWidgetId) {
        RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.widget);
    
        // 桌面小部件 单击事件发送的Intent广播
        Intent intentClick = new Intent();
        intentClick.setAction(click_action);
        PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intentClick, 0);
        remoteViews.setOnClickPendingIntent(R.id.launcher, pendingIntent);
        appWidgetManager.updateAppWidget(appWidgetId, remoteViews);
    }
    
    • onReceiver实现
    @Override
    public void onReceive(final Context context, Intent intent) {
        super.onReceive(context, intent);
        Log.e("aaa", "onReceive action=" + intent.getAction());
        if (click_action.equals(intent.getAction())) {
            new Thread(new Runnable() {
                @Override
                public void run() {
                    Bitmap bitmap = BitmapFactory.decodeResource(context.getResources(), R.mipmap.ic_launcher);
                    AppWidgetManager appWidgetManager = AppWidgetManager.getInstance(context);
                    for (int i = 0; i < 37; i++) {
                        float degree = (i * 10) % 360;
                        RemoteViews remoteViews = new RemoteViews(context.getPackageName(), R.layout.widget);
                        remoteViews.setImageViewBitmap(R.id.launcher, rotateBitmap(context, bitmap, degree));
    
                        Intent intentClick = new Intent(click_action);
                        PendingIntent pendingIntent = PendingIntent.getBroadcast(context, 0, intentClick, 0);
                        remoteViews.setOnClickPendingIntent(R.id.launcher, pendingIntent);
                        appWidgetManager.updateAppWidget(new ComponentName(context, MyAppWidgetProvider.class),remoteViews);
                        SystemClock.sleep(30);
                    }
                }
            }).start();
        }
    }
    
    private Bitmap rotateBitmap(Context context, Bitmap srcBitmap, float degree) {
        Matrix matrix = new Matrix();
        matrix.reset();
        matrix.setRotate(degree);
        Bitmap bitmap = Bitmap.createBitmap(srcBitmap, 0, 0, srcBitmap.getWidth(), srcBitmap.getHeight(), matrix, true);
        return bitmap;
    }
    
      1. manifest中定义receiver
    <receiver android:name="._5remoteviews.MyAppWidgetProvider">
        <meta-data
            android:name="android.appwidget.provider"
            android:resource="@xml/appwidget_provider_info">
        </meta-data>
        
        <intent-filter>
            <action android:name="QINGFENGMY.DEVELOPMENTOFART.APPWIDGET.ACTION"/>
            <action android:name="android.appwidget.action.APPWIDGET_UPDATE"/>
        </intent-filter>
    </receiver>
    

    上面的代码中有两个Action,其中第一个Action用于识别小部件的单击行为,而第二个Action则作为小部件的标识而必须存在,这是系统规范,如果不加,那么这个receiver就不是一个桌面小部件,也无法出现在手机的小部件列表里。

    10. AppWidgetProvider的其他几个方法

    AppWidgetProvider除了最常用的onUpdate方法,还有其他几个方法:onEnabled、onDisabled、onDelete以及onReceive。这些方法会自动地被onReceiver方法在合适的事件调用。确切的说,当广播到来以后,AppWidgetProvider会自动根据广播的Action通过onReceiver方法来自动分发广播。

    • onEnable:当该窗口小部件第一次添加到桌面时调用该方法,可添加多次但只在第一次调用。
    • onUpdate:小部件被添加时或者每次小部件更新时都会调用一次该方法,小部件的更新时机有updatePeriodMillis来指定。
    • onDelete:每删除一次桌面小部件就调用一次。
    • onDisabled:当最后一个该类型的桌面小部件被删除时调用该方法,注意是最后一个。
    • onReceiver:这是广播的内置方法,用于分发具体的事件给其他方法。

    AppWidgetProvider的onReceiver方法源码:

    public void onReceive(Context context, Intent intent) {
        
        String action = intent.getAction();
        if (AppWidgetManager.ACTION_APPWIDGET_UPDATE.equals(action)) {
            Bundle extras = intent.getExtras();
            this.onUpdate(context, AppWidgetManager.getInstance(context), appWidgetIds);
        } else if (AppWidgetManager.ACTION_APPWIDGET_DELETED.equals(action)) {
            Bundle extras = intent.getExtras();
            this.onDeleted(context, new int[] { appWidgetId });
        } else if (AppWidgetManager.ACTION_APPWIDGET_OPTIONS_CHANGED.equals(action)) {
            Bundle extras = intent.getExtras();
            this.onAppWidgetOptionsChanged(context, AppWidgetManager.getInstance(context),
                        appWidgetId, widgetExtras);
        } else if (AppWidgetManager.ACTION_APPWIDGET_ENABLED.equals(action)) {
            this.onEnabled(context);
        } else if (AppWidgetManager.ACTION_APPWIDGET_DISABLED.equals(action)) {
            this.onDisabled(context);
        } else if (AppWidgetManager.ACTION_APPWIDGET_RESTORED.equals(action)) {
            Bundle extras = intent.getExtras();
            this.onUpdate(context, AppWidgetManager.getInstance(context), newIds);
        }
    }
    

    11. PendingIntent概述

    PendingIntent表示一种处于pending状态的意图,而pending状态表示的是一种待定,等待,即将发生的意思,就是说接下来有一个Intent将在某个带点的时刻发生。
    PendingIntent典型的使用场景是给RemoteViews添加点击事件,因为RemoteViews运行在远程进程中,因此RemoteViews不同于普通的View,无法直接像View那样通过setOnClickListener方法来设置单击事件。要想给RemoteViews设置单击事件,就必须使用PendingIntent,PendingIntent通过send和cancle方法来发送和取消特定的Intent。
    PendingIntent支持三种待定意图:启动Activity,启动Service和发送广播。

    public static PendingIntent getActivity(Context context, int requestCode,
        Intent intent, int flags);
    

    启动Service和发送广播也是这四个参数。第一个参数和第三个参数好理解,这里主要说下第二个参数requestCode和第四个参数flags.
    requestCode表示PendingIntent发送方的请求码,多数情况设为0即可,另外requestCode也会影响flags的效果。flags常见的类型有:FLAG_ONE_SHOT,FLAG_NO_CREATE,FLAG_CANCEL_CURRENT,FLAG_UPDATE_CURRENT。
    PendingIntent的匹配规则: 如果两个PendingIntent他们内部的Intent相同并且requestCode也相同,那么这两个PendingIntent就是相同的。
    Intent的匹配规则是: 如果两个Intent的ComponentName和intent-filter都相同,那么这两个Intent就是相同的,注意Extras不参与匹配规则。

    12. 举例说明flags

    notificationManager.notify(1, notification);
    
    • 如果notify的第一个参数id是常量,那么多次调用notify只能弹出一个通知,后续的通知会把前面的通知完全替代掉,其中的PendingIntent当然也会被直接替换。
    • 如果notify每次id都不同,那么当pendingIntent不匹配时,这种情况不管采用什么标记位(flags),他们之间不会相互影响。
    • 如果notify每次id不同,pendingIntent匹配,且标记位是FLAG_ONE_SHOT。那么后续通知中的PendingIntent会和第一条通知保持完全一致,包括其中的Extras,单击任何一条通知后,剩余的通知均无法再打开。
    • 如果notify每次id不同,pendingIntent匹配,且标记位是FLAG_CANCEL_CURRENT。那么只有最新的通知可以打开,之前的通知均无法打开。
    • 如果notify每次id不同,pendingIntent匹配,且标记位是FLAG_UPDATE_CURRENT。那么之前的通知中的PendingIntent会被更新,最终他们和最新的一条保持完全一致,包括其中的Extras,并且这些通知都是可以打开的。

    相关文章

      网友评论

          本文标题:5.1 RemoteViews的应用

          本文链接:https://www.haomeiwen.com/subject/gbutjttx.html