发版说明

更新时间

本文提供云端录制服务的更新说明。

云端录制可为声网实时音视频提供录制服务。与声网本地服务端录制相比,声网云端录制无需部署 Linux 服务器,减轻了研发和运维的压力,更轻量便捷。点击云端录制产品概述了解关键特性。

兼容性

声网云端录制与以下声网 SDK 兼容:

SDK兼容版本
声网 RTC Native 及框架 SDKv1.7.0 及以上版本
声网 RTC Web SDKv1.12.0 及以上版本
表格内容超出当前宽度,可横向滚动查看更多列。

升级必看

单流录制 API 已从 v1 升级至 v2。迁移时需要将 start、update、query 和 stop 请求 URL 中的 mode/individual 改为 mode/raw,并按照如下差异更新业务逻辑:

  • 删除 recordingConfig.streamMode。v2 不再支持 standard、default 和 original。
  • HLS 输出改为音视频合并的一个 M3U8 文件。你需要同步调整播放器、文件解析逻辑和下游处理流程。
  • v2 支持输出 MP4 和 MP3。需要在 avFileType 中指定 mp4;音频场景可直接指定 mp3。
  • 删除请求中的 extensionServiceConfig,否则接口会拒绝请求。
  • 如果使用消息通知服务,新单流录制的录制服务、录制模块、上传模块及截图回调的 payload.serviceScene 均为 rtsc/raw-recording。需要将原来按 rtc_record 或 rtc_snapshot 识别回调的逻辑更新为按新值识别。详见回调事件概览。
  • 新单流录制已移除事件 33(uploading_progress),不再按分钟推送上传进度。迁移时需要移除对该事件的依赖,详见上传模块事件。
  • 处理 uploadingStatus 时新增 stranded 状态分支。该状态表示部分录制文件尚未上传至指定的第三方云存储,录制服务会继续自动重试上传,直至上传成功。业务侧应将其视为“上传未完成”,而不是文件丢失或上传完成。详见上传状态说明。

详见实现单流录制和录制文件介绍。