术语表

APNS 角标(badge)

Integer，收到消息后，应用图标的右上角会显示该数值，即角标。

如果不使用该参数，角标不变，0 会使角标清空。

APNS 铃声(sound)

String，用于自定义通知铃声。

值为 app bundle 中的声音文件名，如果声音文件不存在或者值为 default ，将播放默认提示音。声音文件的准备请参考这里

token

在每个 APP 的每类 service 中，每个设备都有一个唯一标识符，即 token ，用于推送时筛选目标设备。 不同的 service ， token 的来源(生成方式)不一：

  • ad，ap：即为 APNS 为设备分发的 token 。
  • tps：推送宝自行生成的24位16进制字符串。

service

推送服务，也可以理解为推送途径(transport)，用来向目标设备推送消息的通道，目前支持如下几种：

  • ad：APNS 开发环境
  • ap：APNS 生产环境
  • tps： Tuisongbao Push Service，推送宝独立提供的推送服务，适用于国内 Android 系统无法使用 GCM 服务的情况。推送宝通过在 SDK 与服务器间建立稳定的长连接来保证消息的即时送达，目前单机支持百万并发，且可无限水平扩展。
  • huaweipush：华为的推送服务，适用于 EMUI 系统。
  • mipush：小米的推送服务，适用于 MIUI 系统。

标签(tag)

用于给设备(用户)分类，以提高推送精度。 同一台设备可以注册多个标签。

别名(alias)

开发者为设备设置的自定义标识，比如使用应用自己系统内的用户 ID，这样就不需要再维护 token 与用户之间的映射关系，发消息的时候直接通过 alias 即可指定接收设备。

  • 与 token 不同： token 是推送宝系统生成的， alias 则由开发者自己决定，它与 token 之间的映射关系由推送宝维护。一个 alias 可以绑定多个 token 。
  • 与 tag 不同： tag 可以对设备或用户进行划分，比如按照地区，爱好。同一个用户可以有多个 tag （例如“上海地区”，“喜欢徒步”），但只能有一个 alias 。

TTL(Time To Live)

消息在服务器保存的时间。例如 TTL 是24小时，从消息发送的时刻起，24小时之后才上线的目标设备将不会收到此消息，如此可以防止长时间离线的用户收到过期的消息。

测试消息

在准备推送消息前,可以先推送给一台或多台测试设备来查看推送效果。

附加信息(extra)

Object，会推送到 APP，但是不会被显示在通知栏中。 用来实现透传消息，具体如何使用请参考相应 SDK 指南。

用户变量(user var)

用于根据用户属性定制推送内容。

透传消息

请参考 附加信息 。

  Back To Top