首页 > 代码库 > 极光推送JPush

极光推送JPush

2024-07-17 05:21:42   221人阅读

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

/** * 自定义接收器 *  * 如果不定义这个 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 样式。

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。

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

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

默认5条

public static void setLatestNotifactionNumber(Context context, int maxNum)

7.设置允许推送时间

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.别名与标签

public static void setAliasAndTags(Context context, String alias, Set<String> tags)

调用此 API 来同时设置别名与标签。
需要理解的是，**这个接口是覆盖逻辑，而不是增量逻辑。即新的调用会覆盖之前的设置。**
在之前调用过后，如果需要再次改变别名与标签，只需要重新调用此 API 即可。

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

参数定义
alias
null 此次调用不设置此值。（注：不是指的字符串"null"）
"" （空字符串）表示取消之前的设置。
每次调用设置有效的别名，覆盖之前的设置。
有效的别名组成：字母（区分大小写）、数字、下划线、汉字。
限制：alias 命名长度限制为 40 。

tags
null 此次调用不设置此值。（注：不是指的字符串"null"）
空数组或列表表示取消之前的设置。
每次调用至少设置一个 tag，覆盖之前的设置，不是新增。
有效的标签组成：字母（区分大小写）、数字、下划线、汉字。
限制：每个 tag 命名长度限制为 40，最多支持设置 100 个 tag，但总长度不得超过1K字节。

9.通知与自定义消息

通知
或者说 Push Notification，即指在手机的通知栏（状态栏）上会显示的一条通知信息。这是 Android / iOS 的基本功能。
一条通知，简单的填写纯文本的通知内容即可。
通知主要用于提示用户的目的。应用加上通知功能，有利于提高应用的活跃度。

自定义消息
是极光推送自己的概念。
自定义消息不是通知，所以不会被SDK展示到通知栏上。其内容完全由开发者自己定义。
自定义消息主要用于应用的内部业务逻辑。一条自定义消息推送过来，有可能没有任何界面显示。


联系
我们