PDF《一、概述》

1 天,之后的 app 调用注册 都不会向服务端发送请求.因此只要应用不卸载重装或者清除应用本地数据,PushId 就不会清除.反之,则从服务端重新获取 PushId. 3. PushId 在同一个设备上的同一个应用中是始终保持不变的, 不会因系统、 应用升级卸载 而改变;

4. PushId 在如下几种情况下会失效: ? app 调用了 unRegister 操作;

? 在flyme 系统中,app 卸载时,如果上报成功,则PushId 会失效;

? 设备连续

1 个月没有订阅操作;

? 对应 PushId 消息开关关闭. Android SDK 订阅 PushId 时序图如下: 7.4.

2、标签订阅 标签是针对应用设置的,PushId 可以订阅多个标签,一个标签可以有多个 PushId. 使用场景类似 app 做推送, 根据不同的标签用户推送不同的内容. 对订阅了娱乐标签的用户 推送娱乐新闻,对订阅了美食标签的用户推送美食信息. 注: 1. 同个 PushId 可以订阅多个标签,同个标签可以包含多个 PushId;

2. 同个 app 的标签数不能超过

100 个;

3. 此类型任务推送有次数限制,默认

1000 次/天;

4. 标签下 PushId 在如下几种情况下会失效: ? app 调用了 unRegister 操作;

? 标签对应的 PushId 已失效. Android SDK 订阅标签时序图如下: 7.4.

3、别名绑定 PushId 是一个设备上的一个应用在推送服务中的唯一标识. 考虑到在实际场景中, 对大部分 开发者来说是以应用自有的用户唯一标识为对象来推送,因此提供了设置别名推送的功能: 应用可以将用户在应用内的账号或者其他用户唯一标识设定为用户设备 PushId 的别名,在 推送中可以直接基于别名进行推送.避免因需要保存设备 PushId 与自有账号的对应关系而 给开发者带来额外的开发和存储成本.别名不能超过

20 个字符. 注: 1. 同个 PushId 只有一个别名,PushId 对应的别名以最后一次订阅的为准;

2. 同个别名可以绑定多个 PushId,建议不要超过

10 个,如果过多,请采用标签方式;

3. 别名在如下几种情况下会失效: ? app 调用了 unRegister 操作;

? 别名对应的 PushId 已经失效;

Android SDK 订阅别名时序图如下: 7.4.

4、切换推送消息开关(开启/关闭通知栏/透传消息) 推送开关分为两种,通知栏消息和透传消息开关.订阅 PushId 时,两个开关默认都是打开 状态.此开关为用户操作使用,app 可自由选择是否开启此功能.用户如果关闭通知栏消息 开关,则对应的通知栏消息不会推送,同理,关闭透传消息开关,则透传消息不会推送. 注: 1. PushId 初始订阅,通知栏和透传消息开关都是打开状态;

2. 通知栏和透传消息开关互不影响;

3. 关闭开关不会取消 PushId 订阅,只是对应的消息无法推送;

Android SDK 切换消息开关时序图如下: 7.

5、Server SDK 接入流程 Server SDK 推送分为非任务推送和任务推送两大类: 1. 非任务推送: ? 非任务推送包含 PushId 推送、别名推送两类;

? 此类型是将个性化消息推送给指定的设备, 此方式适合为每个用户订制个性化推送场 景. 2. 任务推送: ? 任务推送包含 PushId 推送、别名推送、标签推送、应用全部推送四类;

? 此类型是先获取推送的 taskId, 将推送消息与 taskId 绑定, 然后通过 taskId 来推送. 此方式适合对大批量用户推送相同的消息内容的场景. 7.5.

1、PushId 推送 PushId 是Flyme 推送为每个设备上的每个 app 注册推送服务时生成的唯一标识. 当开发者需 要给一个或者多个具体的设备推送消息时,可以使用基于 PushId 的推送,将个性化消息推 送给指定的设备.这种方式适合为每个用户订制个性化推送场景. 注: 5. PushId 是在客户端注册 Flyme 推送时,推送平台根据设备标识、appId 生成,保证每个 设备上的每个 app 对应的 PushId 都是不同的. 6. 当app 注册成功后,客户端 SDK 保存 pushId 的时间默认为