差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 | ||
im:other:integrationcases:movedata [2020/09/30 08:51] allenwang |
im:other:integrationcases:movedata [2022/03/01 00:30] amy.hao [迁移准备] |
||
---|---|---|---|
行 4: | 行 4: | ||
环信多年来一直在致力于提供稳定,安全的即时通讯服务,在开发者中积累了良好的口碑。如果您希望接入环信的IM服务,但正在使用自研或友商提供的即时通讯服务,这篇文档正是针对这一场景,介绍了一套迁移方案,这套方案已经成功为多家客户实现了平滑迁移。 | 环信多年来一直在致力于提供稳定,安全的即时通讯服务,在开发者中积累了良好的口碑。如果您希望接入环信的IM服务,但正在使用自研或友商提供的即时通讯服务,这篇文档正是针对这一场景,介绍了一套迁移方案,这套方案已经成功为多家客户实现了平滑迁移。 | ||
+ | |||
+ | 用户也可以通过环信提供的存量迁移工具、平滑迁移Relay-server来完成迁移。这两个工具已经完成了绝大部分迁移工作,用户只需要关注感兴趣部分即可。 | ||
===== 基本概念 ===== | ===== 基本概念 ===== | ||
- | * 应用服务器:客户方自有,服务于客户应用业务功能的服务器。 | + | * 应用服务器:客户方自有,服务于客户应用业务功能的服务器。 |
- | * 环信IM服务器:环信提供的即时通讯服务器。 | + | * 环信IM服务器:环信提供的即时通讯服务器。 |
- | * 原IM服务器:用户原先实现IM功能的服务器,可以是自有服务器或友商提供的云服务 | + | * 原IM服务器:用户原先实现 IM 功能的服务器,可以是自有服务器或友商提供的云服务。 |
- | * 老应用:与原IM服务器链接的老版本app。 | + | * 老应用:与原 IM 服务器连接的老版本 app。 |
- | * 新应用:迁移后与环信信服务器连接的新版本app。 | + | * 新应用:迁移后与环信服务器连接的新版本 app。 |
===== 迁移准备 ===== | ===== 迁移准备 ===== | ||
- | 进行IM平滑迁移,需要提前进行以下准备: | + | 进行 IM 平滑迁移,需要提前进行以下准备: |
- | 注册环信信账号,创建应用并开通IM功能。 | + | 注册环信账号,创建应用并开通IM功能。 |
===== 强制升级迁移 ===== | ===== 强制升级迁移 ===== | ||
行 39: | 行 41: | ||
[[http://docs-im.easemob.com/im/server/basics/group|群组管理]] | [[http://docs-im.easemob.com/im/server/basics/group|群组管理]] | ||
- | ===== 3. 导入用户设备上的历史消息 ===== | + | ==== 3. 存量迁移工具 ==== |
+ | |||
+ | 环信为了用户更好的迁移数据(用户体系、群组),提供了存量迁移工具。用户只需要在此基础上简单二次开发,向工具中集成需要迁移的数据,即可使用。如有需要,请联系销售。 | ||
+ | |||
+ | ==== 4. 导入用户设备上的历史消息 ==== | ||
在新版本App中集成环信IM SDK后,如果需要继续使用用户设备上的旧消息,可以使用导入消息的api,构建环信消息结构,导入环信SDK中的消息数据库。 | 在新版本App中集成环信IM SDK后,如果需要继续使用用户设备上的旧消息,可以使用导入消息的api,构建环信消息结构,导入环信SDK中的消息数据库。 | ||
行 48: | 行 54: | ||
[[http://docs-im.easemob.com/im/ios/basics/message#%E6%8F%92%E5%85%A5%E6%B6%88%E6%81%AF|iOS导入消息至本地数据库]] | [[http://docs-im.easemob.com/im/ios/basics/message#%E6%8F%92%E5%85%A5%E6%B6%88%E6%81%AF|iOS导入消息至本地数据库]] | ||
+ | |||
===== 新老兼容的平滑迁移 ===== | ===== 新老兼容的平滑迁移 ===== | ||
行 82: | 行 89: | ||
[[http://docs-im.easemob.com/im/server/basics/chatrecord#%E8%81%8A%E5%A4%A9%E8%AE%B0%E5%BD%95%E6%95%B0%E6%8D%AE%E7%BB%93%E6%9E%84|消息数据格式]] | [[http://docs-im.easemob.com/im/server/basics/chatrecord#%E8%81%8A%E5%A4%A9%E8%AE%B0%E5%BD%95%E6%95%B0%E6%8D%AE%E7%BB%93%E6%9E%84|消息数据格式]] | ||
+ | |||
+ | 用户也可以参考Relay-server此部分的实现 | ||
=== 语音消息的格式 === | === 语音消息的格式 === | ||
环信的移动端语音消息为amr格式,其中iOS端是录制后转换为amr格式,web端是由服务器端在下载语音消息时转换为mp3格式。如果旧的IM服务器支持的格式不符,需要适当的进行转换。 | 环信的移动端语音消息为amr格式,其中iOS端是录制后转换为amr格式,web端是由服务器端在下载语音消息时转换为mp3格式。如果旧的IM服务器支持的格式不符,需要适当的进行转换。 | ||
+ | |||
+ | 用户也可以参考Relay-server此部分的实现 | ||
+ | |||
+ | ==== 3. 平滑迁移Relay-server ==== | ||
+ | |||
+ | 环信为了更好帮助客户从云信、融云平台迁移到环信,环信开发平滑迁移服务(Relay-server),来完成 “利用消息路由功能完成新旧版本之间的消息互通”。 | ||
+ | Relay-server 提供了大多数的消息转换,如:文字、语音、视频、图片、文件、位置等消息。 | ||
+ | 客户只需要进行简单开发即可高度适配客户特有需求,如客户的自定义消息转换等。 | ||
+ | 如有需要,请联系销售 | ||
==== 其他迁移问题 ==== | ==== 其他迁移问题 ==== |