服务端 SDK 更新日志

更新时间: 2025/08/21 17:27:49

本文介绍网易云信服务端 Java SDK 的更新日志。具体功能请前往 集成 SDK 体验。

1.1.0 (2025-08-19)

新增功能

面向对象 IM 接口封装:新增信令 API 的面向对象封装。

缺陷修复

无。

兼容性

向后兼容,现有基于原始 API 的代码可正常运行。

1.0.1 (2025-08-07)

新增功能

面向对象 IM 接口封装:全新推出面向对象的 IM 服务接口,大幅简化开发体验。开发者无需再处理复杂的原始 API 调用,可通过直观的对象方法完成 IM 相关操作,如用户管理、消息发送、群组管理等。

缺陷修复

修复了当默认域名不可用时 SDK 初始化失败的问题,提升服务可用性。

接口变更

根据 API 服务类命名规范,修改部分代码命名。

变更项目 原值 新值
接口 getSuperTeamV1Service getSuperTeamService
实例 superTeamV1Service superTeamService

兼容性

完全向后兼容,无需修改现有代码。

兼容性

向后兼容,现有基于原始 API 的代码可正常运行。

0.9.0 (2025-06-30)

新增功能

多业务线支持:新增对音视频通话 RTC、短信服务 SMS、直播 LIVE、点播 VOD、房间组件 NEROOM、网易会议组件 MEETING 等业务的支持。您可以通过统一的 SDK 管理多条业务线,简化集成复杂度。

功能优化

  • 监控指标增强PrometheusConverter 新增 biz 字段,用于区分 IM、RTC、NEROOM、SMS、MEETING 等不同业务的监控数据,便于运维团队精细化监控和问题定位。
  • 异常信息优化HttpCodeExceptionYunxinSdkException 的错误信息中新增 bizName 描述,帮助开发者快速识别异常来源的业务模块。

缺陷修复

修复 PrometheusConverter 格式化输出中耗时分位数相关指标字段错误的问题,确保监控数据的准确性。

兼容性

  • ⚠️破坏性更新:为支持多业务线,进行了以下调整。

    变更项目 原值 新值
    包名前缀 com.netease.nim.im.server.sdk com.netease.nim.server.sdk
    Maven artifactId yunxin-im-server-sdk yunxin-server-sdk
  • 升级指南:请更新 Maven 依赖配置,并调整 import 语句中的包名。

0.2.0 (2025-03-21)

新增功能

单次请求超时配置:支持在发起请求前动态设置超时时间,允许为特定请求设置与全局配置不同的超时值。适用于处理耗时不同的业务场景,如文件上传、批量数据处理等对超时要求不同的操作。

功能优化

SDK 初始化安全性增强:同一个网易云信开发者账号的 appkey/appsecret 组合,仅允许初始化 YunxinHttpClient 一次,重复初始化会立即抛出错误。避免因误操作导致的资源浪费和潜在的配置冲突问题。

兼容性

  • 大部分场景向后兼容。
  • 如果现有代码中存在重复初始化 YunxinHttpClient 的情况,需要进行相应调整。

0.1.0 (2024-12-24)

新增功能

  • SDK 核心功能:首个正式版本发布,提供完整的 SDK 核心能力,包括智能多域名切换和调度策略、自动重试机制、全链路监控、分布式链路追踪等企业级特性。适用于对服务可用性和可观测性有高要求的生产环境。

  • 网易云信 V1 IM API 支持:提供网易云信 V1 版本 API 的原始客户端调用能力,同时封装了用户账号创建的面向对象接口。适用于需要使用 V1 版本 API 的存量业务和账号管理场景。

  • 网易云信 V2 IM API 支持:提供网易云信 V2 版本 API 的原始客户端调用能力,并封装了账号创建、更新、查询的完整面向对象接口。适用于新接入的业务和需要更丰富账号管理功能的场景。

兼容性

首个版本,建立基础兼容性规范。

此文档是否对你有帮助?
有帮助
去反馈
  • 1.1.0 (2025-08-19)
  • 1.0.1 (2025-08-07)
  • 0.9.0 (2025-06-30)
  • 0.2.0 (2025-03-21)
  • 0.1.0 (2024-12-24)