说明 自 2020 年 6 月 28 日起，mPaaS 停止维护 10.1.32 基线。请使用 10.1.68 或 10.1.60 系列基线。可以参考 mPaaS 10.1.68 升级指南 或 mPaaS 10.1.60 升级指南 进行基线版本升级。 |
在 10.1.32 及以后的基线版本中，mPaaS 中间层的 MPSync 类封装了移动同步组件所有 API。通过 MPSync 对象即可实现移动同步的所有功能。
java.lang.Object
- com.mpaas.mss.adapter.api.MPSync涉及的公共函数列表如下：
返回值 | 说明 |
void |
|
void |
|
void |
|
void |
|
void |
|
boolean |
|
void |
|
void |
|
void |
|
boolean |
|
setup(Application application)
声明
public static void setup(Application application)
说明
用于初始化移动同步服务依赖的基础服务，在 initialize 方法调用前调用。仅限 10.1.60 及以上版本基线。
参数
参数 | 类型 | 说明 |
application | Application | Applicaiton 实例。 |
返回值
无。
appToBackground()
声明
public static void appToBackground()
说明
用于让客户端 SDK 感知到当前 App 已经回到后台，使其断开与服务器的网络连接。每次 App 压后台时调用。
建议在首页的 onStop() 方法内调用。如果压后台不调用此 API， 将会导致长时间网络连接，带来耗电量、流量增加的问题。
参数
无。
返回值
无。
appToForeground()
声明
public static void appToForeground()
说明
用于让客户端 SDK 感知到当前 App 已经启动，使其建立与服务器的网络连接。每次 App 回到前台时调用。
建议在首页的 onResume() 方法内调用。
参数
无。
返回值
无。
clearUserInfo()
声明
public static void clearUserInfo()
说明
用于用户登出。
参数
无。
返回值
无。
initialize(Context context)
声明
public static void initialize(Context ctx)
说明
初始化接口，初始化移动同步服务。如果不调用，将导致当前 App 不能使用本服务。
全局仅需调用一次（App 打开到关闭的生命周期内只需要调用一次）。
参数
参数 | 类型 | 说明 |
ctx | Context | 一个不为空的 |
返回值
无。
isConnected()
声明
public static boolean isConnected()
说明
检查当前移动同步服务是否正常。
参数
无。
返回值
正常返回 true；不正常返回 false。
registerBiz(String bizType, ISyncCallback syncCallback)
声明
public static void registerBiz(String biz, ISyncCallback callback)
说明
用于注册一个接收业务数据的 callback。在获取到同步推送的数据后，客户端 SDK 会回调 syncCallback 实现类。
每个同步配置都需调用一次该 API。
参数
参数 | 类型 | 说明 |
bizType | String | 同步标识 |
syncCallback | ISyncCallback | 回调实现类 |
返回值
无。
reportMsgReceived(SyncMessage syncMessag)
声明
public static void reportMsgReceived(SyncMessage msg)
说明
用于在 syncCallback 中收到同步推送的数据后，调用该接口通知移动同步服务端接收同步数据成功。在没有收到 reportMsgReceived 前，移动同步服务端会重试投递，重试 6 次之后数据就被永久删除。
参数
参数 | 类型 | 说明 |
syncMessag | SyncMessage | 同步消息 |
返回值
无。
unregisterBiz(String bizType)
声明
public static void unregisterBiz(String biz)
说明
反注册指定同步配置。移动同步服务在收到该同步配置的数据后，不会调用 syncCallback。
参数
参数 | 类型 | 说明 |
biz | String | 同步标识 |
返回值
无。
updateUserInfo(String sessionId)
声明
public static boolean updateUserInfo(String sessionId)
说明
方法内部的调用基于 LongLinkSyncService.getInstance().updateUserInfo(String userId, String sessionId)接口，其中 userId 使用的是在 MPLogger 中设置的用户 ID。该接口用于在登录信息 userId/sessionId 有变化时调用，以更新用户登录信息。登录时，两个参数都不能为空，如果 userId 未设置，该方法会返回 false，调用失败。如果 session 过期，或者是客户端在用户登录过一次之后具备了自动免登的功能，那么每次免登成功时也必须要调用本方法。总体调用原则是： userId 与 sessionId 两个参数任意一个发生变化时都必须要调用本方法。
参数
参数 | 类型 | 说明 |
sessionId | String | 会话 ID。 |
返回值
更新用户信息成功则返回 true；如果登录时 userId 未设置返回 false。