帮助与文档

> >

1、UMSSDK

无界面代码集中于UMSSDK类中,其中相对主要的方法如下:

方法名称 参数列表 返回值 使用说明
registerSDK 用于初始化SDK
loginWithPhoneNumber String country 国家代码,如:中国对应86
String phone 手机号码
String password 密码
OperationCallback callback 操作回调
以手机号码登录。成功后返回当前账号的User对象
sendVerifyCodeForRegitser String country 国家代码,如:中国对应86
String phone 手机号码
OperationCallback callback 操作回调
请求用于注册的短信验证码
成功后返回true或false,表示是否已经智能验证
sendVerifyCodeForResetPassword String country 国家代码,如:中国对应86
String phone 手机号码
OperationCallback callback 操作回调
请求用于重置密码的短信验证码
成功后返回true或false,表示是否已经智能验证
registerWithPhoneNumber String country 国家代码,如:中国对应86
String phone 手机号码
String vcode 验证码
String password 密码
User user 一同提交注册的用户资料
OperationCallback callback 操作回调
以电话号码执行注册
成功后返回当前账号的User对象
resetPasswordWithPhoneNumber String country 国家代码,如:中国对应86
String phone 手机号码
String vcode 验证码
String password 密码
User user 一同提交注册的用户资料
OperationCallback callback 操作回调
以电话号码执行重置密码
getQuery QueryView view 能用于Query的View的枚举 Query 执行Query操作的对象 返回一个query工具来往服务器查询数据
updateUserInfo HashMap updates 需要修改的字段名称及其值
OperationCallback callback 操作回调
更新用户资料
uploadAvatar String path 头像文件的本地路径
OperationCallback callback 操作回调
上传头像
成功后返回一个包含“id”和“avatar”的HashMap,分别表示“头像id”和“头像url数组”
changePassword String newPassword 新密码
String oldPassword 老密码
OperationCallback callback 操作回调
修改密码
logout OperationCallback callback 操作回调 注销

请注意,在调用任何操作之前,需要初始化SDK:

所以,一般调用代码的方法如下:

2、Query API

UMSSDK不提供直接获取用户数据的办法,而是提供了一套通用的Query API。您可以通过这套工具向服务端查询想要的数据。其主要方法列述如下:

方法名称 参数列表 返回值 使用说明
condition Condition condition
        查询条件,包括:
        大于、小于、等于、不等于、大于等于、小于等于、集合、与、或和非
Query 设置查询的条件
fields String… fields
        指定要查询的字段
Query 设置返回数据每一个元素包含的字段,缺省为全部返回
sort Sort… sorts
        指定优先级的字段排序方式
Query 根据设置的字段,对返回数据进行排序
offset int offset
        返回数据在搜索结果中的偏移值
Query 设置从搜索结果的何处开始返回数据,缺省为从第0条开始
size int size
        返回数据的最大个数
Query 设置返回数据的总量,缺省为最多50条
query String 执行查询,为联网阻塞操作,返回一个json结果

一般执行一次查询的可能步骤如下:

UMSSDK当前提供了两个可供Query的View,分别为:

名称 说明
QueryView.USERS 用于查询用户信息
QueryView.USERS_BIND 用于查询绑定在登录用户账号上的第三方社交平台列表

此外,并不是所有的数据类型都可以用来执行检索,只有下面特定的类型才能使用:

类型 说明
Bool 布尔类型
Number 数值类型
Date 时间类型
Text 字符串类型

这些数据类型都位于“com.mob.jimu.query.data”包下。

3、User字段

User类是UMSSDK的核心数据结构,用于解析和存放用户资料,它包括默认的和自定义两类字段,其中默认字段包括:

字段 类型 说明
id String 用户id。只提供get方法
nickname String 昵称
avatarId String 头像id。内部字段,在上传头像过程中使用
avatar String[] 用户头像,包含多种尺寸
phone String 电话号码
gender Gender 性别,枚举类型
birthday Date 生日
age Integer 年龄
constellation Constellation 星座,枚举类型
zodiac Zodiac 生肖,枚举类型
country Country 国家,枚举类型
province Province 省份,枚举类型
city City 城市,枚举类型
signature String 签名
email String 电子邮箱
address String 地址
zipCode Long 邮政编码
resume String 简介

这些字段除了id,都可以通过get、和set两个方法来获取或者修改其在本地的值。

至于自定义字段,User提供下面的方法来设置和获取:

方法名称 参数列表 返回值 使用说明
setCustomField String key 字段名称
DataType<?> value 字段的取值,只能是上诉4中特定类型
添加一个自定义字段
getCustomField String key 字段名称 DataType<?> 返回一个自定义字段
getCustomFields HashMap<String, DataType<?>> 返回所有的自定义字段及其值

4、特殊异常信息

在一些特殊的情况下,用户可能需要执行“重新登录”的操作,这个时候UMSSDK会对外抛出一个“ShouldReloginException”异常。您需要捕获这个异常,并引导用户回到登录页面。

0 0