文档

基本概念

更新时间:

本术语表按拼音首字母对术语进行排序。

B

BizType

为业务类型,是业务场景的唯⼀标识。数据推送后,客户端数据同步 SDK 需要通过 Biztype 将数据分发给对应的业务模块。

C

持久化

持久化是将程序数据在持久状态和瞬时状态间转换的机制。在数据同步服务中,该机制产生了两种行为:持久化数据和非持久化数据。

  • 持久化数据:当⽤户或设备不在线时,数据将持久化⾄数据库,待⽤户或设备上线后,数据同步 SDK 将触发同步。

  • 非持久化数据:当用户或设备在线时,立即推送数据;不在线则直接抛弃数据,即使用户再次上线也无法再接收到该条数据。

D

单设备推送

指基于用户维度推送时,消息推送至用户最新上线的设备,且只推送一次。在设备上卸载客户端,重新安装并上线或者用户在其他设备上线时,系统将不重复推送该条数据。

多设备同步

指基于用户维度推送时,支持单个用户的多个设备之间的数据同步,即同一个用户在切换设备的情况下仍然会收到在上一个设备上已经收到过的数据。在设备上卸载客户端,重新安装并上线后,数据依然会再次推送。

H

后台

指客户端 APP 当前处于压后台状态(用户手机在 home 界面、在操作其他 App 或处于黑屏状态等)。

M

幂等

根据 SyncOrder 中的 thirdMsgId 字段进行去重(bizTypelinkTokenthirdMsgId 组合唯一即可),只允许成功一次,新的数据会被抛弃不予入库,接口返回成功,结果码为 DUPLICAT ED_BIZ _ID。

MSS 数据

指需要通过数据同步服务端推送的数据。

MSS 推送

指将⼀份数据从服务端主动推送到客户端,若调用业务的客户端在线,则立即触发推送,否则,待客户端上线之后再进行推送。

Q

前台

指客户端 App 当前处于打开的状态。

S

SYNC

指数据同步服务,是指将数据从数据同步服务端同步至客户端 App。

T

推送类型

分为指定推送和全局推送两种类型。

  • 指定推送:指定某⼀个 userId 或 utdId,推送⼀条数据。

  • 全局推送:对所有已上线的用户或设备推送数据,全局推送业务为多设备同步。

Y

业务维度

同步的业务维度分为⽤户维度和设备维度,用户维度指根据 userId 来推送数据,设备维度指根据 utdId 来推送数据。

阈值

为服务端设置允许积压的数据上限。推送数据时,若用户或设备长时间不在线,而 MSS 服务端又一直产生新的数据,则可能导致服务端数据积压,此时,将只保留阈值内的最新数据,超出阈值部分的老数据将被废弃。

Z

在线

指客户端 App 有网络,可保持稳定的 TCP 长连接。

大部分 Android 手机支持 App 在后台时保持在线,苹果手机支持 App 在后台时维持三分钟在线(iOS 操作系统性限制)。