跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

iOS Core SDK

最后更新 查看 MarkdownAgent 设置

Subscribe to RSS

2026-10-22

RealtimeKit iOS Core 3.3.0

增强功能

  • SDK 现在会执行文档中所述的 SDK 速率限制。
  • RtkStore 和广播消息在共享数据时现在会保留非基本类型的 JSON 类型。
  • 将对象转换为 JSON 进行持久化时,日期会编码为 ISO 8601 UTC 字符串。数字时间戳仍保持为数字。
  • 新增 RtkStoreManager.refresh(storeName),用于按名称刷新存储。

修复

  • 修复了导致 SDK 拒绝空会议标题的 API 不匹配问题。该问题影响了省略 --title 时的 cf realtime kit meetings create。
  • 会议中处于活动状态的插件现在会为稍后加入的移动端参与者自动启用。

2026-09-16

RealtimeKit iOS Core 3.2.0

增强功能

  • 连接和媒体可靠性 — 改进了从连接中断和屏幕共享关闭中恢复的能力。
  • 分组讨论室 — 管理员现在可以加入子会议室,并在会议室之间重新分配参与者。参与者分配和状态处理也得到了改进。
  • 投票 — 改进了投票确认,以及对含义不明确选项的验证。
  • API 错误 — 改进了经过身份验证的 API 失败时的错误报告。

2026-07-17

RealtimeKit iOS Core 3.1.0

增强功能

  • 在正常网络条件下,加入会议室的速度最多提升 25%
  • 改进了从移动端参与者接收的视频的初始质量

修复

  • 修复了在分组讨论室之间切换时发生崩溃的问题
  • 取消音频或视频静音时,如果相应的 RtkMeetingInfo.enableAudio 或 RtkMeetingInfo.enableVideo 字段为 false,SDK 现在会请求权限。UI Kit 组件不再被静默禁用。

2026-06-24

RealtimeKit iOS Core 3.0.0

破坏性变更

  • 插件不再由服务器提供。现在必须在客户端预先声明插件,方法是向 RtkMeetingInfo 传递 plugins 列表。任何在初始化时未声明的插件都将无法在会议中使用。
    let meetingInfo = RtkMeetingInfo(
      authToken: authToken,
      plugins: [
        RtkClientPluginConfig(
          id: "whiteboard", // Must match the plugin ID used on Web for sync to work
          name: "Whiteboard",
          url: "https://example.com",
          icon: "https://example.com/logo.png",
          permissions: RtkClientPluginPermissions(canActivate: true, canDeactivate: false)
        )
      ]
    )
    
  • 已从 RtkPlugin 中移除多个内部属性:baseURL、config、description、isPrivate 和 staggered。请改用新的 icon 和 permissions 属性。
  • RtkMeetingInfo 中的 baseUrl 现在有默认值,无需再显式传递。
  • 已移除 RtkStore 上将键和值同时传递给回调的双参数 subscribe(key:listener:) 和 unsubscribe(key:listener:) 重载。请使用 2.1.0 中引入的单参数回调版本。

新功能

  • AI 转录 — 新的 RtkAi 类(以 client.ai 形式公开)提供对实时转录内容的访问。实现 RtkAiEventListener 并通过 addAiEventListener(_:) 注册,即可接收 onTranscript(data:) 回调。MiscellaneousPermissions 中提供了 transcriptionEnabled 权限。
  • 关联会议(分组讨论室) — 新的 RtkConnectedMeetings 类(以 client.connectedMeetings 形式公开)支持分组讨论室工作流。注册 RtkConnectedMeetingsEventListener 以处理会议室切换和状态更新。完整指南请参阅分组讨论室文档。
  • 聊天:编辑和删除 — 现在可以编辑和删除消息。RtkChat 新增方法:editTextMessage(messageId:newText:onResult:)、editImageMessage(messageId:newUri:onResult:)、editFileMessage(messageId:newUri:onResult:) 和 deleteMessage(messageId:onResult:)。RtkChatEventListener 新增 onMessageEdited(message:) 和 onMessageDeleted(messageId:) 回调。ChatMessage 现在包含 isEdited 标志。
  • 聊天:获取和分页 — RtkChat 新增方法 fetchPublicMessages(beforeTimestamp:count:onlyPinned:onResult:)、fetchPrivateMessages(userId:beforeTimestamp:count:onlyPinned:onResult:)、fetchPinnedMessages(beforeTimestamp:count:onlyPinned:onResult:) 和 getMessages(timestamp:count:channelId:isPinned:onResult:),可通过 FetchMessagesResult(messages:hasMore:) 使用基于游标的分页获取历史消息。
  • 客户端声明的插件 — 插件现在完全通过 RtkClientPluginConfig 和 RtkClientPluginPermissions 在客户端配置。RtkPlugin 相应地公开了新的 icon 和 permissions 属性。
  • 定向广播消息 — RtkParticipants.broadcastMessage(message:targetParticipantIds:payload:) 用于向特定的参与者子集发送消息。
  • 可为空的存储值 — RtkStore.set(key:value:broadcast:persist:) 现在接受可为空的 value: Any?,可以通过将键设置为 nil 来清除该键。
  • 日志控制 — RealtimeKitClient 新增 enableLogging(_:) 和 enableLogging(_:minSeverity:),用于在运行时控制 SDK 日志输出。
  • Result_ 工具类型 — 新的 Result_<S, F> 类型包含 Success 和 Failure 两种变体,在新的异步 API 中统一使用。之所以命名为 Result_,是为了避免与 Swift 内置的 Result 类型冲突。

修复

  • 改进了重连处理,确保媒体在更多场景下能够平稳恢复
  • 通过将音频路由变更观察器移出主线程分派,修复了可能出现的 UI 卡顿
  • 改进了 simulcast 层级,使较高层级能够以更广泛的质量范围进行广播
  • 修复了媒体处理中的一些竞态条件,这些竞态条件偶尔会导致静音/取消静音操作引发崩溃
  • 优化了加入会议室流程中的 API 调用,以缩短首次加入所需的时间
  • 修复了聊天中的文件和图片上传在某些情况下失败的问题

2026-05-08

RealtimeKit iOS 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(),用于检查本地参与者是否有权置顶消息

修复

  • 修复了停止由其他参与者发起的录制时,录制状态卡在“recording”的问题
  • 修复了用户处于设置界面但尚未加入 socket 会议室时,网格中出现“幽灵”参与者的问题
  • 修复了网络研讨会主持人较晚加入时其他参与者看不到主持人的问题
  • 修复了录制机器人和其他隐藏参与者错误地出现在参与者网格中的问题
  • 修复了等候名单中的参与者在被允许加入会议之前就出现在参与者列表中的问题

2026-04-20

RealtimeKit iOS Core 2.0.0

破坏性变更

  • 移除了对 Hive SFU 的支持。今后仅支持 Cloudflare SFU。
  • 默认的基础 URI 现在是 realtime.cloudflare.com。使用 dyte.io 基础域调用 init() 现在会立即以 MeetingError.InvalidBaseUrl 失败

修复

  • 新增对新的后端插件 API 字段命名的兼容
  • 修复了在调用 init() 之前访问 socket 控制器时可能发生的崩溃
  • 修复了身份验证令牌未发送到 callstats 收集器端点的问题
  • 移除了仅在之前的基础设施中才需要的自定义 ping-pong 保活逻辑

2026-02-06

RealtimeKit iOS Core 1.6.1

修复

  • 修复了连接建立耗时较长时出现的媒体问题

2026-01-14

RealtimeKit iOS Core 1.6.0

修复

  • 解决了上传文件时发生的崩溃
  • 通过分批激活消费者改进了网格切换,以获得更好的性能
  • 将消费者切换请求移出主线程,以防止 UI 阻塞
  • 通过在初始化期间取消重连尝试来防止竞态条件

2025-12-16

RealtimeKit iOS Core 1.5.7

修复

  • 修复了切换音频静音时偶尔发生的崩溃
  • 不在台上的网络研讨会主持人不再显示在网格中

2025-12-12

RealtimeKit iOS Core 1.5.6

修复

  • 修复了网络研讨会加入流程和屏幕共享启用流程中的死锁
  • 修复了进入设置界面再返回后摄像头无法工作的问题
  • 修复了语音活动检测中偶尔发生的崩溃

2025-12-04

RealtimeKit iOS Core 1.5.5

修复

  • 修复了对等方离开会议后参与者图块未被正确移除的问题
  • 解决了参与者启用或切换视频时出现的内存峰值
  • 改进了视频缓冲区管理,以防止内存累积
  • 增强了 iOS 视频渲染,使其行为与 Android 保持一致

2025-11-06

RealtimeKit iOS Core 1.5.4

修复

  • 内部修复,降低遥测数据的详细程度
  • 修复了一个轻微的内存泄漏

2025-10-23

RealtimeKit iOS Core 1.5.3

修复

  • 修复了一个回归问题:在禁用摄像头的情况下加入会议时,自己的视频无法渲染

2025-10-23

RealtimeKit iOS Core 1.5.2

修复

  • 通过改进刷新逻辑修复了网格行为不稳定的问题

2025-10-06

RealtimeKit iOS Core 1.5.1

修复

  • 内部修复,以解决 Flutter 平台上的问题

2025-09-23

RealtimeKit iOS Core 1.5.0

新功能

  • 新增 RtkSelfEventListener#onAudioDeviceChanged 方法,在当前音频路由更新时调用

修复

  • iOS 在首次加入时不再忽略音频设备选择

2025-09-18

RealtimeKit iOS Core 1.4.1

修复

  • 现在默认音频输出优先使用扬声器而非听筒

2025-09-18

RealtimeKit iOS Core 1.4.0

破坏性变更

  • 更新了 RtkSelfEventListener#onAudioDevicesUpdated 方法,以提供可用设备列表

修复

  • 修复了无法将音频路由到蓝牙设备的问题

2025-09-12

RealtimeKit iOS Core 1.3.4

修复

  • 修复了在网络状况较差的情况下加入会议时偶尔发生的崩溃

2025-09-12

RealtimeKit iOS Core 1.3.3

修复

  • 修复了被踢出的置顶对等方未从舞台移除的问题
  • 媒体消费者现在会并行创建,从而显著加快了用户加入会议后开始看到/听到他人音视频的速度
  • 修复了长时间运行的会议中有时会出现的“幽灵”/无效对等方
  • 修复了网络研讨会中 SDK 在被移出舞台一次后无法再产生媒体的问题

2025-08-13

RealtimeKit iOS Core 1.3.2

增强功能

  • 修复了在网络研讨会中加入舞台时麦克风无法工作的问题

2025-08-13

RealtimeKit iOS Core 1.3.1

增强功能

  • 修复了在网络状况较差的情况下可能发生的崩溃

2025-08-12

RealtimeKit iOS Core 1.3.0

新功能

  • 新增 RtkSelfParticipant#canJoinStage 和 RtkSelfParticipant#canRequestToJoinStage API

修复

  • 修复了直播中观众无法加入舞台的问题
  • 修复了用户加入会议后看不到已有置顶参与者的问题

2025-08-05

RealtimeKit iOS 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 已被移除。iOS 上不支持中间件,因此这些 API 原本就不执行任何操作,属于被错误公开的 API。

新功能

  • 使用 WebRTC 原生基元重新实现了中间件,以解决间歇性崩溃和其他问题。
  • VideoDevice 现在会根据摄像头特性(例如广角和长焦)正确标记多个摄像头。

修复

  • 修复了屏幕共享无法启动的问题
  • 屏蔽了 callstats 库产生的大量日志

2025-07-02

RealtimeKit iOS Core 1.1.0

新功能

  • 支持活跃发言人

增强功能

  • 会议初始化(meeting.init())速度现在提升约 60%
  • 切换到更新后的、使用 RTK 命名空间的 WebRTC

2025-06-20

RealtimeKit iOS Core 1.0.1

破坏性变更

  • 将 RtkMessageType 重命名为 ChatMessageType

修复

  • 屏蔽了音频活动报告器产生的大量日志
  • 提高了加入通话的速度
  • 身份验证令牌现在会自动去除无效的空格和换行符

2025-05-26

RealtimeKit iOS 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 形式

2025-05-16

RealtimeKit iOS Core 0.2.1

修复

  • 对发布管道进行了内部修复

2025-05-16

RealtimeKit iOS Core 0.2.0

修复

  • 新增音频活动检测,用于发出活跃发言人信号

2025-05-14

RealtimeKit iOS Core 0.1.0

新 API

  • 首个 alpha 版本

这篇文档对您有帮助吗?