Skip to Content

集成开发

网易云信 IM 私有云版本为企业提供了完全自主可控的即时通讯解决方案。私有云部署在客户自己的服务器环境中,确保数据安全性和业务独立性。本文主要描述私有云与公有云的差异点。完整的集成开发流程、API 使用方法、SDK 接入步骤等,请参考 网易云信 IM 公有云集成开发文档,文档内容同样适用于私有云版本。

部署环境差异

私有云版本部署在您的私有环境中,具有以下特点:

  • 数据完全存储在客户自有服务器
  • 网络访问完全由客户控制
  • 可根据客户需求进行定制化配置
  • 需要客户自行维护服务器环境

功能支持差异

私有云标准版在功能支持上与公有云存在一定差异,具体如下:

功能私有云标准版是否支持额外依赖项备注
文本翻译❌ 不支持网易有道需要额外集成有道翻译服务
语音转文字❌ 不支持网易有道需要额外集成有道翻译服务
超大群❌ 不支持HBase需要 HBase 数据库支持
单向删除❌ 不支持HBase需要 HBase 数据库支持
更新消息❌ 不支持HBase需要 HBase 数据库支持
定向消息❌ 不支持HBase需要 HBase 数据库支持
圈组❌ 不支持-功能未私有化
历史消息按类型查询❌ 不支持HBase需要 HBase 数据库支持
聊天室历史消息❌ 不支持HBase需要 HBase 数据库支持
聊天室定时关闭❌ 不支持-功能未私有化
登入登出历史❌ 不支持HBase需要 HBase 数据库支持
服务端反垃圾❌ 不支持网易易盾需要集成网易易盾服务
服务端会话列表(V1 版本)❌ 不支持HBase需要 HBase 数据库支持

认证配置差异

私有云版本需要使用客户专属的认证配置:

  • App Key:由网易云信为私有云客户单独分配
  • App Secret:对应私有云环境的密钥
  • 认证服务器:指向客户私有云环境

集成开发指南

客户端开发

私有云版本的基础集成开发方式与公有云基本一致,包括:

服务端开发

当前私有云版本的服务端开发与 公有云 10.10.0 版本一致。

功能增强方案

如需使用私有云标准版不支持的功能,可考虑以下方案:

数据库扩展方案

对于需要 HBase 支持的功能,可通过以下方式实现:

  • 部署 HBase 集群:在私有环境中部署 HBase 数据库。
  • 升级私有云版本:联系网易云信升级至支持 HBase 的版本。
  • 自定义实现:基于现有 API 自行实现相关功能。

第三方服务集成

对于依赖第三方服务的功能:

  • 文本翻译:集成有道翻译 API 或其他翻译服务。
  • 反垃圾功能:集成网易易盾或其他内容安全服务。

常见问题

Q: 私有云版本的 API 接口是否与公有云完全一致?

A: 基础 API 接口保持一致,但服务地址需要指向您的私有云环境。部分高级功能可能不可用。

Q: 如何获取私有云的 App Key 和 App Secret?

A: 请联系网易云信商务或技术支持获取私有云专属的认证信息。

最后更新于