🚀Quick Start

发出第一条推送消息

创建新的 PushService

要使用个推推送,必须提供个推开发者平台创建的 App 的 AppId, AppKey 和 MasterSecret.

我们使用一个AppSecret来封装它们:

AppSecret appSecret = new AppSecret(
    $appId,
    $appKey,
    $masterSecret
);

使用appSecret创建一个新的PushService实例并初始化:

PushService ps = new PushService(appSecret);
ps.init();

目前init()的作用只是读取 Token 缓存,并在缓存失效的情况下向个推请求新的 Token. 之后可能会加入一个入参来进行内置 HttpServer 的配置。

构造推送消息

现在我们创建一条新的推送消息。其消息内容为 Android 系统支持的Notification类。

Notification notification = new NotificationBuilder()
                // 必须,规定了此类消息的基本信息:标题,内容和交互类型(click_type)
                .init("Title", "Message Body", "url")
                // 当交互类型为 url 时需提供具体的 url
                .setAction("www.buymeeuk.com")
                // 可选,会将推送内容设置为长文类型
                .setBigText("这是一段长文字")
                .build();

将消息内容填入消息体中:

PushMessage msg = new PushMessageBuilder()
                .notification(notification)
                // 可选,设置推送消息的展示时间窗口
                .setDuration(1590547347000L, 1590633747000L)
                .build();

发出推送

有了推送消息之后,就可以调用PushService中提供的方法,选择不同的消息受众并将其发出。

例如,要推送给 App 的全部用户:

String res = ps.pushAll(msg);

或者,仅推送给特定 cid 的用户:

String res = ps.pushSingleCid(cid, msg);

处理返回

下一步

最后更新于