r1.6.0 开始支持。
集成了 JPush SDK 的应用程序在第一次成功注册到 JPush 服务器时,JPush 服务器会给客户端返回一个唯一的该设备的标识 - RegistrationID。JPush SDK 会以广播的形式发送 RegistrationID 到应用程序。
应用程序可以把此 RegistrationID 保存以自己的应用服务器上,然后就可以根据 RegistrationID 来向设备推送消息或者通知。
调用此 API 来取得应用程序对应的 RegistrationID。 只有当应用程序成功注册到 JPush 的服务器时才返回对应的值,否则返回空字符串。
开始支持的版本:1.6.0。
//SDK 初次注册成功后,开发者通过在自定义的 Receiver 里监听 Action - cn.jpush.android.intent.REGISTRATION 来获取对应的 RegistrationID。注册成功后,也可以通过此函数获取 public static String getRegistrationID(Context context)
可以通过 RegistrationID 来推送消息和通知, 参考文档 Push API v2, 当 receiver_type = 5 并且设置 receiver_value 为 RegistrationID 时候即可根据 RegistrationID 推送。
注:要使用此功能,客户端 App 一定要集成有 r1.6.0 及以上版本的 JPush Android SDK。
随着开发者对 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 需要把映射关系保存到开发者业务服务器上。
这个本质的不同,决定了其特点:
或者说,使用 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 绑定。