名词:
1. 别名alias:标识应用程序用户,一个用户一个别名,一个别名却可以指定多个用户。
2. 标签tag: 方便把用户分类,一个标签可以有多个用户,一个用户也可以被打上不同的标签。就像选课,一门课可以有多个学生,一个学生也可以上多门课,当某一门课开课的时候,可以给上这门课的学生发送消息。
3.RegistrationID:应用程序在第一次成功注册到 JPush 服务器时,JPush 服务器会给客户端返回一个唯一的该设备的标识 - RegistrationID。JPush SDK 会以广播的形式发送 RegistrationID 到应用程序。反之,应用程序也可以把此 RegistrationID 保存以自己的应用服务器上,然后就可以根据 RegistrationID 来向设备推送消息或者通知。
4. Badge: badge是iOS用来标记应用程序状态的一个数字,出现在程序图标右上角。
相关重要方法说明:
+ (
void
)setTags:(NSSet *)tags alias:(NSString *)alias callbackSelector:(SEL)cbSelector object:(id)theTarget;
参数说明
|
- alias
- nil 此次调用不设置此值。
- 空字符串 (@"")表示取消之前的设置。
- 每次调用设置有效的别名,覆盖之前的设置。
- 有效的别名组成:字母(区分大小写)、数字、下划线、汉字。
- 限制:alias 命名长度限制为 40 字节。(判断长度需采用UTF-8编码)
- tags
- nil 此次调用不设置此值。
- 空集合([NSSet set])表示取消之前的设置。
- 每次调用至少设置一个 tag,覆盖之前的设置,不是新增。
- 有效的标签组成:字母(区分大小写)、数字、下划线、汉字。
- 限制:每个 tag 命名长度限制为 40 字节,最多支持设置 100 个 tag,但总长度不得超过1K字节。(判断长度需采用UTF-8编码)
- 单个设备最多支持设置 100 个 tag。App 全局 tag 数量无限制。
- callbackSelector
- nil 此次调用不需要 Callback。
- 用于回掉返回对应的参数 alias, tags。并返回对应的状态码:0为成功,其他返回码请参考错误码定义。
- 回调函数请参考SDK 实现。
-
theTarget
- 参数值为实现了callbackSelector的实例对象。
- nil 此次调用不需要 Callback。
+ (
void
)setAlias:(NSString *)alias callbackSelector:(SEL)cbSelector object:(id)theTarget;
|
设置 tags 时,如果其中一个 tag 无效,则整个设置过程失败。
如果 App 的 tags 会在运行过程中动态设置,并且存在对 JPush SDK tag 规定的无效字符,则有可能一个 tag 无效导致这次调用里所有的 tags 更新失败。
这时你可以调用本方法 filterValidTags 来过滤掉无效的 tags,得到有效的 tags,再调用 JPush SDK 的 set tags / alias 方法。
+ (NSSet*)filterValidTags:(NSSet*)tags;
5. setBadge----设置JPush服务器中存储的badge值