如何平滑迁移

开发者已使用了第三方云服务,考虑到融云即时通讯云平台系统稳定、产品线丰富、功能高度可控可订制,希望迁移到融云平台,可详细阅读以下迁移方案。

一、迁移条件

第三方云服务支持并开通服务端消息路由功能(用户 A 给用户 B 发消息的过程中,服务器支持通过 Callback 或者 WebHook 的模式将消息转发给开发者提供的服务器 URL 地址)。

二、消息架构模型

实现即时通讯平台架构迁移的核心逻辑是实现新旧有即时通讯系统消息互通。假设旧 App 端为 A,新 App 端为 B,旧有即时通讯服务为 IM_Old,新即时通讯服务为 IM_New,那么 A 发给 B 的消息要先通过 IM_Old 服务发送给 IM_New,再由 IM_New 服务送达 B,反之亦然。

实际架构上,需要中间开发部署一个消息流转适配器负责 IM_Old 和 IM_New 之间的消息转发和适配。

消息收发流程

迁移过程中,新 App 同旧 App 之间的消息收发流程如下:

架构所需的 4 个接口:

1、旧有即时通讯平台的消息路由接口:用来将旧有系统中的消息发送到消息流转适配器中。

2、旧有即时通讯平台的消息发送接口:用来从消息流转适配器中发送来自融云系统的消息。

3、融云即时通讯平台的消息路由接口:用来将融云系统中的消息发送到消息流转适配器中,查看消息路由服务文档

4、融云即时通讯平台的消息发送接口:用来从消息流转适配器中发送来自旧有系统的消息,查看消息发送服务文档

三、迁移实施过程

1、新版 App 按照正常流程集成融云 SDK,服务端也接入融云的相关服务。

Android 开发指南

iOS 开发指南

Server API 开发指南

2、向旧有即时通讯云服务商申请开启消息路由服务(将消息实时同步到自己应用服务器的功能)。

3、在融云申请开启消息路由服务,详细可参见服务端实时消息路由开通方式

4、开发者实现消息流转适配器服务,期间可以根据业务需要添加消息筛选或者转换逻辑。

5、开发者自己的服务器上部署消息流转适配器服务。

四、注意事项

用户系统

融云的用户系统采用增量激活的方式,所以您不用考虑一次性用户激活的问题,融云有能力承载您的业务上线时带来的用户激活压力。

好友关系

融云不保存客户的好友关系,所以不用考虑好友关系迁移事宜。

群组关系

为了实现群聊,需要向融云同步群组关系,上线前建议一次性调用融云服务端 API 进行一次初始化同步,上线后按照正常逻辑执行即可。详细请查看 Server 同步用户所属群组方法

语音消息模型与编码

不同的即时通讯云服务可能采用不同的消息编码方案,在消息流转适配器中,需要将接收方和发送方的消息内容进行适当的转换。

查看融云的语音消息结构

图片消息模型

不同的即时通讯云服务可能采用不同的消息编码方案,在消息流转适配器中,需要将接收方和发送方的消息内容进行适当的转换。

查看融云的图片消息结构

Push 缺失用户信息的问题

因为融云侧没有旧有即时通讯平台的注册用户信息,所以当 B 用户(融云平台注册的)收到来自 A 用户(旧有即时通讯平台)发来的消息时,Push 信息中无法显示用户名。

应对方法是在消息流转适配器中调用融云发送消息代码时,自行组织 pushContent 字段,在 pushContent 字段中显示出用户信息,如:“小明:发送了一条消息。”,相关文档请参考发送单聊消息方法

五、客户端升级

客户端升级逻辑

安装新版融云客户端后,需要 App 在第一次运行时,将原有第三方 IM 数据(会话+消息)导入到融云 IM SDK 内嵌数据库。

融云的工作

融云提供融云 SDK 内嵌数据库 Schema。

App 的工作

由 App 负责集成融云提供的数据库升级代码。

六、其他问题

可能存在 App 升级时未正常注销导致仍然推送消息不正确的情况(通过消息流转适配器服务记录用户迁移状态可以解决)。

通过消息流转适配器服务记录用户迁移状态,可以实现更节约资源的路由方案(有些用户已经迁移就不用再发消息了)。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,245评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,749评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 160,960评论 0 350
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,575评论 1 288
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,668评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,670评论 1 294
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,664评论 3 415
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,422评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,864评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,178评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,340评论 1 344
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,015评论 5 340
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,646评论 3 323
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,265评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,494评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,261评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,206评论 2 352

推荐阅读更多精彩内容

  • WebSocket-Swift Starscream的使用 WebSocket 是 HTML5 一种新的协议。它实...
    香橙柚子阅读 23,842评论 8 183
  • 你工作了 到几点 也没告诉我
    掉毛的老公阅读 157评论 0 0
  • 有时候, 人太不知足, 得不到的才是最好的。 其实, 最好的时候, 身在一座城, 城里有个人, 莞尔一笑, 颦颦一...
    一笑一见自难忘阅读 216评论 0 0
  • 踏上宝岛是我一直以来的小心愿,对于这片土地有着莫名的好感,因为潮汕话与台语源于闽南语,听起来有亲切感,我对于潮汕文...
    DTttt阅读 264评论 0 0
  • Colonial park 玫瑰开了,免费观赏还不错哦,还为了去采些艾叶,端午节是不是要烧一烧呢,好像又有点怪怪,...
    XinSuting阅读 341评论 0 0