JPush推送 之 RegistrationID 精确对点推送

JPush推送 之 RegistrationID 精确对点推送


获取 RegistrationID API

支持的版本

r1.6.0 开始支持。

功能说明

RegistrationID 定义

集成了 JPush SDK 的应用程序在第一次成功注册到 JPush 服务器时,JPush 服务器会给客户端返回一个唯一的该设备的标识 - RegistrationID。JPush SDK 会以广播的形式发送 RegistrationID 到应用程序。

应用程序可以把此 RegistrationID 保存以自己的应用服务器上,然后就可以根据 RegistrationID 来向设备推送消息或者通知。

API - getRegistrationID

调用此 API 来取得应用程序对应的 RegistrationID。 只有当应用程序成功注册到 JPush 的服务器时才返回对应的值,否则返回空字符串。

支持的版本

开始支持的版本:1.6.0。

接口定义
//SDK 初次注册成功后,开发者通过在自定义的 Receiver 里监听 Action - cn.jpush.android.intent.REGISTRATION 来获取对应的 RegistrationID。注册成功后,也可以通过此函数获取
public static String getRegistrationID(Context context)

附加说明

通过 RegistrationID 进行点对点推送

可以通过 RegistrationID 来推送消息和通知, 参考文档 Push API v2, 当 receiver_type = 5 并且设置 receiver_value 为 RegistrationID 时候即可根据 RegistrationID 推送。

注:要使用此功能,客户端 App 一定要集成有 r1.6.0 及以上版本的 JPush Android SDK。

Android客户端快速集成:http://docs.jpush.cn/pages/viewpage.action?pageId=3309574

详情见JPush推送Android客户端API:http://docs.jpush.io/client/android_api/#android-api


随着开发者对 JPush 的使用越来越深入,不少开发者越来越想要非常精确地定位到每一个设备安装(应用)。为此,JPush 开放了基于 RegistrationID 推送的功能。

JPush Android SDK r1.6.0 更新,主要增加了对 RegistrationID 的支持;并且服务器端 Push API 也新增此支持。另外,也改进了统计分析相关功能,以便 JPush 可以基于更完善的统计来改进推送效果。

JPush RegistrationID 是这个版本 SDK 引入的一个新概念,它唯一地标识当前这个应用安装在这个设备上。或者说,相当于是 JPush SDK 内部的用户ID。

开发者可通过 App 新安装后 JPush SDK 内部注册成功时发出的 Broadcast 来得到到这个 ID,也可以通过调用 JPushInterface.getRegistrationID() 方法来得到这个 ID。使用上,开发者取得 RegistrationID 后,上传到自己的服务器端。之后就可以在自己的服务器调基于这个 RegistrationID 来进行推送。如下图:


在调用了JPushInterface.init(getApplicationContext());方法后,会监听到 cn.jpush.android.intent.REGISTRATION 广播。可将该id上传到服务器,服务器处理业务逻辑并给该ID推送信息。测试确认不同设备打印出的 Registration ID 不同。

JPush 之前一直支持基于 Alias (别名)的点对点推送方式,那为什么还要开放 RegistrationID 的点对点推送方式呢?

与 Alias 相比,RegistrationID 的有什么不同,或者说优势、劣势呢?

本质上 RegistrationID 与 Alias 类似,其目的都是唯一地定位到应用安装在一个特定的设备上。而本质的不同在于,Alias 是把映射关系保存到 JPush 的服务器上,而 RegistrationID 需要把映射关系保存到开发者业务服务器上。

这个本质的不同,决定了其特点:

  1. Alias 有个 SDK 端设置绑定关系的问题。这个设置,有可能会失败,App 需要有处理这个暂时失败的逻辑。另外,Alias 是不限制绑定到多个设备的,这样要精确地定位到一个设备就不好控制。总而言之,这个绑定关系是没有那么精确一点的。
  2. RegistrationID 一旦生成,意味着这个设备的安装一定存在。App 把这个 RegistrationID 保存到自己的业务服务器上,可以非常精确地定位到这台设备(安装这个应用)。这样开发者的内部业务可以做比较复杂的用户关联关系。

或者说,使用 Alias 开发者更简单、方便。但使用 RegistrationID 更方便于精确地定位用户。

JPush iOS SDK 将于稍后发布的 SDK 版本支持 RegistrationID 推送。

Android SDK 具体的更新说明,请参考最新更新页面

RegistrationID 相关的文档有:获取 RegistrationID API接收推送消息 Receiver 里关于从广播接受 RegistrationID 部分;

Push API v2 里关于 RegistrationID 推送参数的部分。

统计分析功能相关的文档有:统计分析 API (Android SDK)。


 相关疑问:

请问如果用户卸载了应用,业务服务器怎么知道相关RegistrationID已经失效了呢?

用户直接卸载了应用,服务器端 RegistrationID 不会失效。 也就是说,你推送可以保存离线消息,短时间内重新安装了还可以收到消息。用户过了一定的时间比如一个月后还没有 online 过,会被 JPush 认为是无效用户。

一个RegistrationID对应一个终端吗?当这个终端由另一个用户登录时,其RegistrationID是否一样?

是的,RegistrationID 是设备级别的概念,不受你应用层的影响。你的用户使用不同用户登录时,需要重新与这个 registrationID 绑定。


  • 11
    点赞
  • 3
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
springboot可以通过集成极光推送实现消息的广播和单点推送。首先,在系统中每个用户对应一个唯一的极光ID(regId)。然后,可以使用广播推送来向所有拥有该appKey下载的安装程序的用户发送消息。此外,还可以通过单点推送,使用设备的regId来向特定的设备发送消息。还可以通过别名推送registrationId推送来实现消息的推送。具体的代码实现可以参考以下示例代码: 1. 广播推送: ```java @Autowired private JiGuangPushService service; @PostMapping("/pushAll") public Result pushAll(@RequestParam String title, @RequestParam String content){ PushBean pushBean = new PushBean(); pushBean.setTitle(title); pushBean.setAlert(content); boolean flag = jiGuangPushService.pushAndroid(pushBean); return ResultUtil.success(flag); } ``` 2. 单点推送: ```java @PostMapping("/push") public Result push(@RequestParam String title,@RequestParam String regId,@RequestParam String content){ PushBean pushBean = new PushBean(); pushBean.setTitle(title); pushBean.setAlert(content); boolean flag = jiGuangPushService.pushAndroid(pushBean, regId); return ResultUtil.success(flag); } ``` 3. 通过别名推送: ```java @PostMapping("/pushMsgByAlias") public Result pushMsgByAlias(@NotBlank String alias, @NotBlank String msg){ PushResult pushResult = PushUtils.pushMsgByAlias(Arrays.asList(alias.split(",")), msg); return Result.success(pushResult); } ``` 4. 通过registrationId推送: ```java @PostMapping("/pushMsgByIds") public Result pushMsgByIds(@NotBlank String ids, @NotBlank String msg){ PushResult pushResult = PushUtils.pushMsg(Platform.all(), Audience.registrationId(ids.split(",")), msg); return Result.success(pushResult); } ```

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值