RoomKit
  • iOS : Objective-C
  • Android
  • macOS
  • Windows
  • Web
  • 小程序
  • Flutter
  • React Native
  • 产品简介
    • 概述
    • 发布日志
  • 开通 RoomKit 服务
  • 下载
  • 体验 App
  • 快速开始
  • 进阶功能
  • 客户端 API
  • 服务端 API
  • 常见错误码
  • 常见问题
  • 文档中心
  • RoomKit
  • 产品简介
  • 发布日志

发布日志

更新时间:2023-05-17 22:41

2.3.0 版本

发布日期:2023-05-17

新增功能

功能项 功能描述 相关接口
支持 CDN Plus 直播拉流 CDN 和超低延迟直播无缝融合,当监测到用户网络较差时,SDK 会自动切换到超低延迟直播拉流(L3);反之,从 CDN 拉流。

CDN Plus 直播拉流功能不是默认开启,使用前请联系 ZEGO 技术支持开通。
-
支持学生端上台后设置麦克风和摄像头权限 学生端上台(和教师端连麦)时,麦克风和摄像头默认开启。若开发者需要上台学生关闭麦克风和摄像头状态,请联系 ZEGO 技术支持进行配置。 -

改进优化

优化项 优化描述 相关接口
更新音视频 SDK 更新音视频 SDK,提高稳定性。 -

问题修复

  1. 修复因云盘列表过长导致拉取列表失败的问题

其他事项

1. 从 2.3.0 版本开始,RoomKit 不再支持 iOS 11.0 以下版本,开发者的 iOS Deployment Target(最低支持版本)需提升到 iOS 11.0

具体说明,请参考 App Store submission requirement starts April 25Xcode 14 Release Notes

2. 从 2.3.0 版本开始,RoomKit iOS SDK 不再支持 32 位 armv7 架构

具体说明,请参考 Xcode 14 Release Notes



2.2.5 版本

发布日期:2022-12-27

改进优化

优化项 优化描述 相关接口
更新音视频 SDK 更新音视频 SDK,提高稳定性。 -
iOS 版本兼容 兼容了 iOS 16 版本。

问题修复

  1. 修复已知问题


2.2.0 版本

发布日期:2022-07-13

改进优化

优化项 优化描述 相关接口
更新音视频 SDK 更新音视频 SDK,提高稳定性。 -


2.1.0 版本

发布日期:2021-11-12

功能优化

优化项 优化描述 相关接口
SDK UI 层拆分 RoomKit SDK 拆分为 RoomKitUI(UI 层) 和 RoomKitCore(数据层) 两个 SDK。
  • RoomKitUI 接入体验与之前一致,参考 含 UI 集成
  • RoomKitCore 接入可实现高度的 UI 定制,参考 无 UI 集成
    -


    2.0.5 版本

    发布日期:2021-09-28

    功能优化

    优化项 优化描述 相关接口
    SDK 内部优化 SDK 内部技术优化,对接口及功能无影响。 -


    2.0.0 版本

    发布日期:2021-09-06

    功能优化

    优化项 优化描述 相关接口
    SDK 内部结构 SDK 内部技术优化,对接口及功能无影响。 -

    问题修复

    该版本修复了如下问题:

    1. 修复了同个账号登录多个同类型房间挤下线提示不正确的问题。
    2. 修复了潜在的警告和风险问题。


    1.21.0 版本

    发布日期:2021-08-12

    新增功能

    功能项 功能描述 相关接口
    支持实现字幕功能 通过新增的原始音频数据监听回调事件获取音频数据,开发者自行转换为字幕后可通过发送自定义消息接口实现字幕功能。 详见接口变更

    接口变更

    • 新增接口
    新增接口 接口描述
    onCapturedAudioData 在 ZegoInRoomServiceDelegate 中新增回调通知,对外返回推流音频数据,判断当前成员麦克风状态,如果麦克风为关闭状态不回调。
    sendCustomMessage 在 ZegoInRoomService 中新增接口 sendCustomMessage ,允许客户通过接口发送自定义消息。

    改进优化

    优化项 优化描述 相关接口
    小班课新增未开始上课设置 小房间场景下未开始上课时,主持显示课程未开始提示和开始上课按钮,成员显示课程开始倒计时,无法看到其他人的音视频画面和共享内容,但可以进行文字聊天。
    消息头像支持本地图片 消息头像支持main bundle、沙盒、url加载图片


    1.20.0 版本

    发布日期:2021-08-02

    新增功能

    功能项 功能描述 相关接口
    新增消息交互事件通知 当发生消息交互事件时 RoomKit 会向外通知 ZegoMessageEvent 类型的事件。 onMessageEventNotify
    新增开启笔锋功能 用户可以在进入房间时配置 ZegoJoinRoomUIConfig 的 enableHandwriting 属性来开启白板笔锋功能。 ZegoJoinRoomUIConfig
    新增大房间服务支持配置直接上台无需弹窗确认 大房间服务支持配置学生被邀请上台后直接上台,无需点击弹窗确认。 -

    改进优化

    优化项 优化描述 相关接口
    消息UI调整 调整了头像和图标位置。
    最小化窗口缺省图优化 最小化窗口缺省图区分出主持人麦克风关闭或主持人未进入房间的两种状态。


    1.19.0 版本

    发布日期:2021-07-15

    新增功能

    功能项 功能描述 相关接口
    大房间场景新增纯视频模式 大房间场景在纯视频模式下将不显示白板课件等共享,创建共享将切换为共享模式,结束所有共享将切换为视频模式。 -
    大房间场景新增支持共享第三方直播 大房间场景支持播放第三方直播的拉流地址,并发起共享推送给其他端。 -

    改进优化

    优化项 优化描述 相关接口
    大房间场景举手提醒优化 大房间场景老师和助教端在学生举手时会有红点提醒,新增举手学生列表展示。


    1.18.5 版本

    发布日期:2021-07-05

    新增功能

    功能项 功能描述 相关接口
    支持设置用户的头像 支持在加入房间时传入成员头像。 setUserParameter
    进退房间消息固定展示 支持配置在固定位置展示进退房消息。 setUIConfig
    支持调整摄像头镜像 支持用户在房间内改变摄像头预览镜像。 -


    1.18.0 版本

    发布日期:2021-06-24

    新增功能

    功能项 功能描述 相关接口
    大房间场景支持主持人、助教设置全员禁言 大房间场景中,主持人、助教可以设置全员禁言,控制房间秩序。 -
    大房间场景支持主持人、助教移除房间成员 大房间场景中,主持人、助教可以设置移除指定房间成员。 -
    成员进退房消息是否显示支持配置 大量的成员进退房消息可能对房间造成干扰,支持隐藏进退房消息。 ZegoJoinRoomUIConfig

    改进优化

    优化项 优化描述 相关接口
    SDK 接口优化 优化 SDK 对外接口,删除不必要的接口,方便开发者快速接入 参考接口变更

    接口变更

    • 新增接口
    新增接口 接口描述
    setAdvancedConfig 设置 SDK 的私有参数,具体的参数请咨询 ZEGO 技术支持。
    ZegoRoomKitRole 加入房间的成员角色,不同角色加入房间权限不同。
    ZegoRoomParameter 新增房间自定义参数类,支持外部自定义房间信息。
    ZegoScreenShareConfig 新增屏幕共享配置类,调用 addShareScreenModule 设置。
    addShareScreenModule 新增添加屏幕共享模块接口,不设置则房间内不显示屏幕共享入口。
    • 删除接口
    删除接口 接口描述
    ZegoAuthenticationService 删除 ZegoAuthenticationService 类,移除登录逻辑。
    ZegoUnloginedUserJoinRoomConfig 删除 ZegoUnloginedUserJoinRoomConfig 类,移除登录相关逻辑。
    ZegoOutRoomService 删除房间外服务接口类,相关功能可直接调用对应 Server API 实现。
    ZegoListRoomCommand 删除房间列表查询命令类,相关功能可直接调用对应 Server API 实现。
    ZegoRoomBaseInfo 删除房间基础信息类,相关功能可直接调用对应 Server API 实现。
    ZegoRoomAdvancedConfig 删除安排房间高级设置类,相关功能可直接调用对应 Server API 实现。
    • 变更接口
    变更接口 接口描述
    ZegoInitConfig 删除其中的非必要属性:appName、dataFolder、logFolder、appGroupID、appExtensionBundleID,仅保留 secretID。
    ZegoJoinRoomConfig 调整字段为:productID、token、roomID、userName、userID、role。
    ZegoRoomDetailInfo 修改房间详细信息类。
    ZegoRoomTypeLargeRoom 修改 ZegoRoomTypeLargeClass 枚举名为 ZegoRoomTypeLargeRoom。
    ZegoJoinRoomUIConfig 删除 customTitle 属性。
    新增 isCompanyFilesHidden 属性,支持设置是否隐藏企业云盘。


    1.16.0 版本

    发布日期:2021-06-04

    新增功能

    功能项 功能描述 相关接口
    大房间场景支持拉辅助摄像头的流 大房间场景中,新增支持拉辅助摄像头的流,满足双摄像头等场景需求。 -
    大房间场景支持显示成员消息被撤回提示 大房间场景中,IM 消息支持显示成员消息被撤回提示。主持人/助理主持撤回成员消息时,成员会收到该消息被撤回提示。 -
    1V1 场景支持助理主持人角色进房 1V1 场景中,支持助理主持人角色进入房间,辅助主持人进行房间管理。 -
    新增支持接收自定义信令功能 用户在发送自定义信令消息之后,同房间中其他用户会收到 receiveCustomMessage 消息,获取透传过来的数据。 receiveCustomMessage

    改进优化

    优化项 优化描述 相关接口
    新增错误码 新增如下错误码:

    • 4020008:房间成员已满。
    • 4020009:房间助理主持人已满。
    ZegoRoomKitError
    修改错误码枚举名 优化了 4020004 错误码的枚举名。 ZegoRoomKitError
    用户自定义上传日志文件名 用户可以在上传日志到 RoomKit SDK 后台时自定义日志文件名。 uploadLog

    接口变更

    • 新增接口
    新增接口 接口描述
    getCurrentRoomVC 通过该接口获取房间容器,允许客户在房间内加自己的视图。


    1.15.0 版本

    发布日期:2021-05-20

    改进优化

    优化项 优化描述 相关接口
    小房间支持横竖屏切换 旧版本小房间进房默认以横屏方式展示,且使用过程中一直保持横屏,无法切换竖屏,移动端用户体验不佳。优化后支持跟随手机方向自动切换横竖屏。


    1.14.0 版本

    发布日期:2021-04-13

    新增功能

    功能项 功能描述 相关接口
    大房间场景新增举手功能 大房间场景中,新增观众举手和上台功能,满足观众和主持人的交互需求。 -
    大房间场景新增助理主持人角色 大房间场景中,新增助理主持角色,辅助主持人进行房间管理。 -

    改进优化

    优化项 优化描述 相关接口
    更新动态库文件

    将 ZegoAppDC.framework 库更换为 RoomkitDC.framework,开发者在集成 SDK 时,需要在工程中修改库的引用关系。

    详情请参考 集成文档

    -
    更新音视频流加密字段 将 ZegoJoinRoomConfig.secretKey 更新为 ZegoJoinRoomConfig.streamEncryptKey,避免引起歧义。 ZegoJoinRoomConfig
    更新错误码枚举 将 ZegoRoomKitErrorSecretKeyError 更新为 ZegoRoomKitErrorEncryptKeyError,避免引起歧义。 ZegoRoomKitError


    1.13.5 版本

    发布日期:2021-04-02

    新增功能

    功能项 功能描述 相关接口
    新增房间窗口最小化功能

    用户在开始进行会议或直播时,可以将视频窗口最小化,退回到之前的页面处理别的事情,会议或直播仍在继续,可随时点击小窗回到会议或直播。

    用户在房间最小化的时候会收到 ZegoRoomEventMinimize 消息,用户收到此消息后可以做一些最小化视频 View 的处理。在房间最小化之后,用户调用 displayRoomViewFromVC 接口可以使房间重新最大化,需要传入一个 VC 来承载房间。

    新增隐藏最小化按钮功能 通过 ZegoJoinRoomUIConfigisMinimizeHidden 属性来控制是否在房间内隐藏最小化按钮。 ZegoJoinRoomUIConfig
    新增获取房间的基本信息功能 在加入房间后,可以通过 getCurrentRoomInfo 接口来获取房间的基本信息。 getCurrentRoomInfo
    新增获取当前的视频 View 功能 在加入房间后,可以获取当前的视频 View,例如在房间最小化后通过此接口获取视频 View 来展示到房间外的某个地方。 getCurrentVideoView

    改进优化

    优化项 优化描述 相关接口
    移除依赖 移除对第三方库 IQKeyboardManager 的依赖。 -


    1.13.0 版本

    发布日期:2021-03-29

    新增功能

    功能项 功能描述 相关接口
    新增白板实时轨迹功能 优化了白板功能,支持实时展示白板操作轨迹。 -

    改进优化

    优化项 优化描述 相关接口
    移除依赖 移除对第三方库 Lottie 的依赖。 -

    问题修复

    该版本修复了KeyWindow引起的 crash 问题。



    1.12.0 版本

    发布日期:2021-03-16

    新增功能

    功能项 功能描述 相关接口
    新增未开始房间倒计时功能 1V1 和大房间场景支持未开始时展示开始倒计时。 -
    支持触发动态 PPT 动画、动态效果 支持用户共享动态 PPT 时展示动画效果,支持播放 PPT 内嵌视频、音频。 -

    改进优化

    优化项 优化描述 相关接口
    优化 UI 展示 优化撤销、重做、清空 UI 展示方式。 -

    问题修复

    该版本修复了 Roomkit 设置语言可能不生效的问题。

    其它说明

    该版本因接入第三方 SDK,暂不支持 Bitcode,故暂时关闭 Roomkit 的 Bitcode 支持。



    1.11.0 版本

    发布日期:2021-03-05

    新增功能

    功能项 功能描述 相关接口
    1V1 场景新增教学工具 1V1 场景下,新增计时器和答题器等插件。 -
    大房间场景新增台上成员共享功能 大房间场景下,观众被主持人邀请上台后,可以使用共享功能。主持人端可以对台上观众的共享功能进行给予/取消设置。 -
    大房间场景新增成员本地搜索功能 大房间场景下,可以搜索群成员,目前只支持前缀匹配(不区分大小写)。 -
    支持 Bitcode

    包括 Roomkit SDK 所依赖的其他动态库:

    • ZegoAppDC
    • ZegoDocsView
    • ZegoExpressEngine
    • ZegoGateway
    • ZegoWhiteboardView
    -

    改进优化

    优化项 优化描述 相关接口
    优化接口 移除 ZegoInitConfig 中的属性 isTestEnv。 ZegoInitConfig


    1.10.0 版本

    发布日期:2021-02-26

    新增功能

    首次发布,包含音视频通话、文件共享、实时消息、成员管理、布局 UI 等模块化功能。

    本篇目录