当前位置:首页 » 其他

极光推送JPush

2013-12-15 18:03 本站整理 浏览(11)

记录几点(摘自官方文档):

1.设置

AndroidManifest.xml

libs/jpush-sdk-release 1.x.y.jar

libs/armeabi/libsys 1.x.y.so

2.基础API

init 初始化SDK

setDebugMode 设置调试模式

3.MyReceiver

1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
/**
 * 自定义接收器
 * 
 * 如果不定义这个 Receiver,则:
 * 1) 默认用户会打开主界面
 * 2) 接收不到自定义消息
 */
public class MyReceiver extends BroadcastReceiver {
    private static final String TAG = "MyReceiver";

    @Override
    public void onReceive(Context context, Intent intent) {
        Bundle bundle = intent.getExtras();
        Log.d(TAG, "onReceive - " + intent.getAction() + ", extras: " + printBundle(bundle));

        if (JPushInterface.ACTION_REGISTRATION_ID.equals(intent.getAction())) {
            String regId = bundle.getString(JPushInterface.EXTRA_REGISTRATION_ID);
            Log.d(TAG, "接收Registration Id : " + regId);
            //send the Registration Id to your server...
        }else if (JPushInterface.ACTION_UNREGISTER.equals(intent.getAction())){
            String regId = bundle.getString(JPushInterface.EXTRA_REGISTRATION_ID);
            Log.d(TAG, "接收UnRegistration Id : " + regId);
          //send the UnRegistration Id to your server...
        } else if (JPushInterface.ACTION_MESSAGE_RECEIVED.equals(intent.getAction())) {
            Log.d(TAG, "接收到推送下来的自定义消息: " + bundle.getString(JPushInterface.EXTRA_MESSAGE));

        } else if (JPushInterface.ACTION_NOTIFICATION_RECEIVED.equals(intent.getAction())) {
            Log.d(TAG, "接收到推送下来的通知");
            int notifactionId = bundle.getInt(JPushInterface.EXTRA_NOTIFICATION_ID);
            Log.d(TAG, "接收到推送下来的通知的ID: " + notifactionId);

        } else if (JPushInterface.ACTION_NOTIFICATION_OPENED.equals(intent.getAction())) {
            Log.d(TAG, "用户点击打开了通知");

            //打开自定义的Activity
            Intent i = new Intent(context, TestActivity.class);
            i.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
            context.startActivity(i);

        } else {
            Log.d(TAG, "Unhandled intent - " + intent.getAction());
        }
    }

    // 打印所有的 intent extra 数据
    private static String printBundle(Bundle bundle) {
        StringBuilder sb = new StringBuilder();
        for (String key : bundle.keySet()) {
            if (key.equals(JPushInterface.EXTRA_NOTIFICATION_ID)) {
                sb.append("nkey:" + key + ", value:" + bundle.getInt(key));
            } else {
                sb.append("nkey:" + key + ", value:" + bundle.getString(key));
            }
        }
        return sb.toString();
    }

}

4.自定义通知样式

定制声音、震动、闪灯等 Notification 样式。

1
2
3
4
5
BasicPushNotificationBuilder builder = new BasicPushNotificationBuilder(MainActivity.this);
builder.statusBarDrawable = R.drawable.jpush_notification_icon;
builder.notificationFlags = Notification.FLAG_AUTO_CANCEL;  //设置为自动消失
builder.notificationDefaults = Notification.DEFAULT_SOUND | Notification.DEFAULT_VIBRATE;  // 设置为铃声与震动都要
JPushInterface.setPushNotificationBuilder(1, builder);

5.高级自定义通知样式

基于基础的 PushNotificationBuilder,可进一步地定制 Notification 的 Layout。

1
2
3
4
5
CustomPushNotificationBuilder builder = new CustomPushNotificationBuilder(MainActivity.this,
    R.layout.customer_notitfication_layout, R.id.icon, R.id.title, R.id.text);  // 指定定制的 Notification Layout
builder.statusBarDrawable = R.drawable.your_notification_icon;      // 指定最顶层状态栏小图标
builder.layoutIconDrawable = R.drawable.your_2_notification_icon;   // 指定下拉状态栏时显示的通知图标
JPushInterface.setPushNotificationBuilder(2, builder);

6.设置保留最近通知条数

默认5条

1
public static void setLatestNotifactionNumber(Context context, int maxNum)

7.设置允许推送时间

1
public static void setPushTime(Context context, Set<Integer> weekDays, int startHour, int int endHour)
参数说明

Context context 应用的ApplicationContext

Set days 0表示星期天,1表示星期一,以此类推。 (7天制,Set集合里面的int范围为0到6)

Sdk1.2.9 – 新功能:set的值为null,则任何时间都可以收到消息和通知,set的size为0,则表示任何时间都收不到消息和通知.

int startHour 允许推送的开始时间 (24小时制:startHour的范围为0到23)

int endHour 允许推送的结束时间 (24小时制:endHour的范围为0到23)

8.别名与标签

1
public static void setAliasAndTags(Context context, String alias, Set<String> tags)
调用此 API 来同时设置别名与标签。

需要理解的是,**这个接口是覆盖逻辑,而不是增量逻辑。即新的调用会覆盖之前的设置。**

在之前调用过后,如果需要再次改变别名与标签,只需要重新调用此 API 即可。

Android 在调用此接口时,建议 Set 的实现使用LinkedHashSet,即会保证排序的 Set。这样,当你调用接口 tags 多于 100 个时,保证前 100 个被 JPush 成功地设置。

参数定义

aliasnull 此次调用不设置此值。(注:不是指的字符串"null")

"" (空字符串)表示取消之前的设置。

每次调用设置有效的别名,覆盖之前的设置。

有效的别名组成:字母(区分大小写)、数字、下划线、汉字。

限制:alias 命名长度限制为 40 。

tagsnull 此次调用不设置此值。(注:不是指的字符串"null")

空数组或列表表示取消之前的设置。

每次调用至少设置一个 tag,覆盖之前的设置,不是新增。

有效的标签组成:字母(区分大小写)、数字、下划线、汉字。

限制:每个 tag 命名长度限制为 40,最多支持设置 100 个 tag,但总长度不得超过1K字节。

9.通知与自定义消息

通知

或者说 Push Notification,即指在手机的通知栏(状态栏)上会显示的一条通知信息。这是 Android / iOS 的基本功能。

一条通知,简单的填写纯文本的通知内容即可。

通知主要用于提示用户的目的。应用加上通知功能,有利于提高应用的活跃度。

自定义消息是极光推送自己的概念。

自定义消息不是通知,所以不会被SDK展示到通知栏上。其内容完全由开发者自己定义。

自定义消息主要用于应用的内部业务逻辑。一条自定义消息推送过来,有可能没有任何界面显示。