基础使用

推送的注册和注销

• 通过调用XPush.register()，即可完成推送的注册。

• 通过调用XPush.unRegister()，即可完成推送的注销。

• 通过调用XPush.getPushToken()，即可获取消息推送的Token(令牌)。

• 通过调用XPush.getPlatformCode()，即可获取当前使用推送平台的码。

推送的标签（tag）处理

• 通过调用XPush.addTags()，即可添加标签（支持传入多个）。

• 通过调用XPush.deleteTags()，即可删除标签（支持传入多个）。

• 通过调用XPush.getTags()，即可获取当前设备所有的标签。

需要注意的是，友盟推送目前暂不支持标签的获取，华为推送不支持标签的所有操作，小米推送每次只支持一个标签的操作。

推送的别名（alias）处理

• 通过调用XPush.bindAlias()，即可绑定别名。

• 通过调用XPush.unBindAlias()，即可解绑别名。

• 通过调用XPush.getAlias()，即可获取当前设备所绑定的别名。

需要注意的是，友盟推送目前暂不支持别名的获取，华为推送不支持别名的所有操作。

推送消息的接收

• 通过调用XPushManager.get().register()方法，注册消息订阅MessageSubscriber，即可在任意地方接收到推送的消息。

• 通过调用XPushManager.get().unregister()方法，即可取消消息的订阅。

这里需要注意的是，消息订阅的回调并不一定是在主线程，因此在回调中如果进行了UI的操作，一定要确保切换至主线程。下面演示代码中使用了我的另一个开源库XAOP,只通过@MainThread注解就能自动切换至主线程,可供参考。

/**
 * 初始化监听
 */
@Override
protected void initListeners() {
    XPushManager.get().register(mMessageSubscriber);
}

private MessageSubscriber mMessageSubscriber = new MessageSubscriber() {
    @Override
    public void onMessageReceived(CustomMessage message) {
        showMessage(String.format("收到自定义消息:%s", message));
    }

    @Override
    public void onNotification(Notification notification) {
        showMessage(String.format("收到通知:%s", notification));
    }
};

@MainThread
private void showMessage(String msg) {
    tvContent.setText(msg);
}


@Override
public void onDestroyView() {
    XPushManager.get().unregister(mMessageSubscriber);
    super.onDestroyView();
}

推送消息的过滤处理

• 通过调用XPushManager.get().addFilter()方法，可增加对订阅推送消息的过滤处理。对于一些我们不想处理的消息，可以通过消息过滤器将它们筛选出来。

• 通过调用XPushManager.get().removeFilter()方法，即可去除消息过滤器。

/**
 * 初始化监听
 */
@Override
protected void initListeners() {
    XPushManager.get().addFilter(mMessageFilter);
}

private IMessageFilter mMessageFilter = new IMessageFilter() {
    @Override
    public boolean filter(Notification notification) {
        if (notification.getContent().contains("XPush")) {
            showMessage("通知被拦截");
            return true;
        }
        return false;
    }

    @Override
    public boolean filter(CustomMessage message) {
        if (message.getMsg().contains("XPush")) {
            showMessage("自定义消息被拦截");
            return true;
        }
        return false;
    }
};

@Override
public void onDestroyView() {
    XPushManager.get().removeFilter(mMessageFilter);
    super.onDestroyView();
}

推送通知的点击处理

对于通知的点击事件，我们可以处理得更优雅，自定义其点击后的动作，打开我们想让用户看到的页面。

我们可以在全局消息推送的接收器IPushReceiver中的onNotificationClick回调中，增加打开指定页面的操作。

@Override
public void onNotificationClick(Context context, XPushMsg msg) {
    super.onNotificationClick(context, msg);
    //打开自定义的Activity
    Intent intent = IntentUtils.getIntent(context, TestActivity.class, null, true);
    intent.putExtra(KEY_PARAM_STRING, msg.getContent());
    intent.putExtra(KEY_PARAM_INT, msg.getId());
    intent.addFlags(Intent.FLAG_ACTIVITY_CLEAR_TOP);
    ActivityUtils.startActivity(intent);
}

需要注意的是，这需要你在消息推送平台推送的通知使用的是自定义动作或者打开指定页面类型，并且传入的Intent uri 内容满足如下格式:

• title：通知的标题

• content：通知的内容

• extraMsg：通知附带的拓展字段，可存放json或其他内容

• keyValue：通知附带的键值对

xpush://com.xuexiang.xpush/notification?title=这是一个通知&content=这是通知的内容&extraMsg=xxxxxxxxx&keyValue={"param1": "1111", "param2": "2222"}

当然你也可以自定义传入的Intent uri 格式，具体可参考项目中的XPushNotificationClickActivity和AndroidManifest.xml