RealtimeKit Android Core 3.3.0
增强功能
- SDK 现在会执行文档中所述的 SDK 速率限制。
RtkStore和广播消息在共享数据时现在会保留非基本类型的 JSON 类型。- 将对象转换为 JSON 进行持久化时,日期会编码为 ISO 8601 UTC 字符串。数字时间戳仍保持为数字。
- 新增
RtkStoreManager.refresh(storeName),用于按名称刷新存储。
修复
- 修复了导致 SDK 拒绝空会议标题的 API 不匹配问题。该问题影响了省略
--title时的cf realtime kit meetings create。 - 会议中处于活动状态的插件现在会为稍后加入的移动端参与者自动启用。
RealtimeKit Android Core 3.2.0
增强功能
- 连接和媒体可靠性 — 改进了从连接中断和屏幕共享关闭中恢复的能力。
- 分组讨论室 — 管理员现在可以加入子会议室,并在会议室之间重新分配参与者。参与者分配和状态处理也得到了改进。
- 投票 — 改进了投票确认,以及对含义不明确选项的验证。
- API 错误 — 改进了经过身份验证的 API 失败时的错误报告。
RealtimeKit Android Core 3.1.0
增强功能
- 在正常网络条件下,加入会议室的速度最多提升 25%
- 改进了从移动端参与者接收的视频的初始质量
修复
- 修复了在分组讨论室之间切换时发生崩溃的问题
- 取消音频或视频静音时,如果相应的
RtkMeetingInfo.enableAudio或RtkMeetingInfo.enableVideo字段为false,SDK 现在会请求权限。UI Kit 组件不再被静默禁用。
RealtimeKit Android Core 3.0.0
破坏性变更
- 插件不再由服务器提供。现在必须在客户端预先声明插件,方法是向
RtkMeetingInfo传递plugins列表。任何在初始化时未声明的插件都将无法在会议中使用。val meetingInfo = RtkMeetingInfo( authToken = authToken, plugins = listOf( RtkClientPluginConfig( id = "whiteboard", // Must match the plugin ID used on Web for sync to work name = "Whiteboard", icon = "https://example.com/logo.png", url = "https://example.com", permissions = RtkClientPluginPermissions(canActivate = true, canDeactivate = true), ) ), ) - 已从
RtkPlugin中移除多个内部属性:baseURL、config、description、isPrivate和staggered。请改用新的icon和permissions属性。 - 已移除
RtkStore上的双参数subscribe(key, (key, value) → Unit)和unsubscribe(key, (key, value) → Unit)重载。请使用 2.1.0 中引入的单参数回调版本。
新功能
- AI 转录 — 新的
RtkAi类(以client.ai形式公开)提供对实时转录内容的访问。实现RtkAiEventListener并通过addAiEventListener()注册,即可接收onTranscript(data: RtkTranscriptionData)回调。MiscellaneousPermissions中提供了transcriptionEnabled权限。 - 关联会议(分组讨论室) — 新的
RtkConnectedMeetings类(以client.connectedMeetings形式公开)支持分组讨论室工作流。注册RtkConnectedMeetingsEventListener以处理会议室切换和状态更新。完整指南请参阅分组讨论室文档。 - 聊天:编辑和删除 — 现在可以编辑和删除消息。
RtkChat新增方法:editTextMessage()、editImageMessage()、editFileMessage()和deleteMessage()。RtkChatEventListener新增onMessageEdited()和onMessageDeleted()回调。ChatMessage现在包含isEdited标志。 - 聊天:获取和分页 —
RtkChat新增方法fetchPublicMessages()、fetchPrivateMessages()、fetchPinnedMessages()和getMessages(),可通过FetchMessagesResult(messages, hasMore)使用基于游标的分页获取历史消息。 - 客户端声明的插件 — 插件现在完全通过
RtkClientPluginConfig和RtkClientPluginPermissions在客户端配置。RtkPlugin相应地公开了新的icon和permissions属性。 - 定向广播消息 —
RtkParticipants.broadcastMessage()现在接受可选的targetParticipantIds: List<String>参数,用于向特定的参与者子集发送消息。 - 可为空的存储值 —
RtkStore.set()现在接受可为空的value: Any?,可以通过将键设置为null来清除该键。 - 日志控制 —
RealtimeKitClient新增enableLogging(enabled: Boolean)和enableLogging(enabled: Boolean, minSeverity: LogSeverity),用于在运行时控制 SDK 日志输出。 - Result<S, F> 工具类型 — 新的
sealed class Result<S, F>包含Success和Failure两种变体,在新的异步 API 中统一使用。
修复
- 改进了重连处理,确保媒体在更多场景下能够平稳恢复
- 改进了 simulcast 层级,使较高层级能够以更广泛的质量范围进行广播
- 修复了媒体处理中的一些竞态条件,这些竞态条件偶尔会导致静音/取消静音操作引发崩溃
- 优化了加入会议室流程中的 API 调用,以缩短首次加入所需的时间
- 修复了聊天中的文件和图片上传在某些情况下失败的问题
RealtimeKit Android Core 2.1.0
破坏性变更
RtkParticipants.activeSpeaker→RtkParticipants.lastActiveSpeaker。旧的activeSpeaker属性已弃用,并将在未来的版本中移除。RtkSelfParticipant.enableScreenShare()→enableScreenShare(onResult:)。旧的无回调版本已弃用,并将在未来的版本中移除。RtkSelfParticipant.disableScreenShare()→disableScreenShare(onResult:)。旧的无回调版本已弃用,并将在未来的版本中移除。RtkStore.subscribe(key, (key, value) → Unit)→subscribe(key, (value) → Unit)。旧的双参数回调签名已弃用,但通过向后兼容的适配层仍可正常使用。RtkStore.unsubscribe(key, (key, value) → Unit)→unsubscribe(key, (value) → Unit)。旧的双参数回调签名已弃用,但通过向后兼容的适配层仍可正常使用。
新功能
- 新增
RtkChat.pin()和RtkChat.unpin()方法,用于置顶和取消置顶聊天消息 - 新增
RtkChat.getMessagesByUser()(按发送者筛选消息)和RtkChat.getMessagesByType()(按类型筛选消息) - 新增
SelfPermissions.canPinMessage(),用于检查本地参与者是否有权置顶消息
修复
- 修复了因
SurfaceViewRenderer实例未被释放而导致的视频渲染内存泄漏 - 修复了停止由其他参与者发起的录制时,录制状态卡在“recording”的问题
- 修复了用户处于设置界面但尚未加入 socket 会议室时,网格中出现“幽灵”参与者的问题
- 修复了网络研讨会主持人较晚加入时其他参与者看不到主持人的问题
- 修复了录制机器人和其他隐藏参与者错误地出现在参与者网格中的问题
- 修复了等候名单中的参与者在被允许加入会议之前就出现在参与者列表中的问题
RealtimeKit Android Core 2.0.0
破坏性变更
- 移除了对 Hive SFU 的支持。今后仅支持 Cloudflare SFU。
- 默认的基础 URI 现在是
realtime.cloudflare.com。使用dyte.io基础域调用init()现在会立即以MeetingError.InvalidBaseUrl失败
修复
- 新增对新的后端插件 API 字段命名的兼容
- 修复了在调用
init()之前访问 socket 控制器时可能发生的崩溃 - 修复了身份验证令牌未发送到 callstats 收集器端点的问题
- 移除了仅在之前的基础设施中才需要的自定义 ping-pong 保活逻辑
RealtimeKit Android Core 1.6.0
修复
- 通过分批激活消费者改进了网格切换,以获得更好的性能
- 将消费者切换请求移出主线程,以防止 UI 阻塞
- 通过更好的生命周期管理提高了视频渲染的稳定性
- 通过在初始化期间取消重连尝试来防止竞态条件
RealtimeKit Android Core 1.5.6
修复
- 修复了网络研讨会加入流程和屏幕共享启用流程中的死锁
- 修复了进入设置界面再返回后摄像头无法工作的问题
- 修复了语音活动检测中偶尔发生的崩溃
RealtimeKit Android Core 1.5.3
修复
- 修复了一个回归问题:在禁用摄像头的情况下加入会议时,自己的视频无法渲染
RealtimeKit Android Core 1.5.2
修复
- 通过改进刷新逻辑修复了网格行为不稳定的问题
RealtimeKit Android Core 1.5.0
新功能
- 新增
RtkSelfEventListener#onAudioDeviceChanged方法,在当前音频路由更新时调用
RealtimeKit Android Core 1.4.1
修复
- 现在默认音频输出优先使用扬声器而非听筒
RealtimeKit Android Core 1.4.0
破坏性变更
- 更新了
RtkSelfEventListener#onAudioDevicesUpdated方法,以提供可用设备列表
修复
- 修复了无法将音频路由到蓝牙设备的问题
RealtimeKit Android Core 1.3.4
修复
- 修复了在网络状况较差的情况下加入会议时偶尔发生的崩溃
RealtimeKit Android Core 1.3.3
修复
- 修复了被踢出的置顶对等方未从舞台移除的问题
- 媒体消费者现在会并行创建,从而显著加快了用户加入会议后开始看到/听到他人音视频的速度
- 原生库现在采用 16KB 对齐,以符合 Google Play 要求
- 修复了长时间运行的会议中有时会出现的“幽灵”/无效对等方
- 修复了网络研讨会中 SDK 在被移出舞台一次后无法再产生媒体的问题
RealtimeKit Android Core 1.3.2
增强功能
- 修复了在网络研讨会中加入舞台时麦克风无法工作的问题
RealtimeKit Android Core 1.3.1
增强功能
- 修复了在网络状况较差的情况下可能发生的崩溃
RealtimeKit Android Core 1.3.0
新功能
- 新增
RtkSelfParticipant#canJoinStage和RtkSelfParticipant#canRequestToJoinStageAPI
修复
- 修复了直播中观众无法加入舞台的问题
- 修复了用户加入会议后看不到已有置顶参与者的问题
RealtimeKit Android Core 1.2.0
破坏性变更
- 将
RtkLivestreamData.roomName重命名为RtkLivestreamData.meetingId,以符合现有的 API 约定 - 移除了过时的
WaitingRoomPermissions抽象——所有相关功能均可通过HostPermissions使用 - VideoDevice 新增了
cameraType: CameraType参数 VideoDeviceType#displayName现已弃用,建议改为调用VideoDevice#toString来获取各个VideoDevice实例面向用户的名称- 移除了与中间件相关的现有 API,并替换为 WebRTC 中的等效功能:
RtkSelfParticipant#addVideoMiddleware、RtkSelfParticipant#getVideoMiddlewares和RtkSelfParticipant#removeVideoMiddleware已替换为RealtimeKitMeetingBuilder#setVideoProcessor - 移除了
RtkVideoFrame,改用 WebRTC 自身的VideoFrame类,可通过realtimekit.org.webrtc.VideoFrame使用
新功能
- 使用 WebRTC 原生基元重新实现了中间件,以解决间歇性崩溃和其他问题。要了解更多信息,请查看新的视频处理文档部分
VideoDevice现在会根据摄像头特性(例如广角和长焦)正确标记多个摄像头
修复
- 修复了屏幕共享无法停止的问题
- 屏蔽了 callstats 库产生的大量日志
RealtimeKit Android Core 1.1.0
增强功能
- 会议初始化(
meeting.init())速度现在提升约 60% - 切换到更新后的、使用 RTK 命名空间的 WebRTC
- 借助更新后的 WebRTC 改进了活跃发言人检测
RealtimeKit Android Core 1.0.1
破坏性变更
- 将 RtkMessageType 重命名为 ChatMessageType
修复
- 屏蔽了音频活动报告器产生的大量日志
- 提高了加入通话的速度
- 身份验证令牌现在会自动去除无效的空格和换行符
RealtimeKit Android Core 1.0.0
破坏性变更
- 从
TextMessage中移除了已弃用的channelId字段 - 将监听器类型移至各自的功能包
- 将公共监听器移至各自的功能包
- 重命名了 RtkPluginsEventListener 的插件添加/移除监听器方法
- 将聊天扩展移至
chat包 - 将
RtkParticipant移至根包 - 将
RtkMeetingParticipant移至根包 - 将
RtkPluginFile移至 plugins 包 - 将中间件移至其独立的包
- 将
VideoScaleType移至顶层media包 - 去掉了音频和视频设备类型的
Rtk前缀 - 将设备类型移至顶层
media包 - 去掉了投票类型的
Rtk前缀 - 将所有 LiveStream 引用替换为 Livestream
- 将
RtkMeetingParticipant移至根包 - 去掉了
RtkRecordingState的Rtk前缀 - 去掉了聊天消息类型的
Rtk前缀 - 移除了已弃用的 RtkLivestream#roomName 字段
- 将
RtkMediaPermission移至 media 包并重命名为MediaPermission - 重新分配了
feat包的成员 - 将
StageStatus类移至 stage 包 - 将所有事件监听器重命名为单数的
*EventListener形式
RealtimeKit Android Core 0.2.1
修复
- 对发布管道进行了内部修复
RealtimeKit Android Core 0.2.0
修复
- 新增音频活动检测,用于发出活跃发言人信号