即时通信 IM 云端录制（iOS）

注意：版本说明：

注意：云端录制接口（startRecording / stopRecording）自 AtomicXCore 和 RTCRoomEngine 的 4.2.3 版本起支持，请确认你使用的版本满足要求。

一、前提条件

·用户已通过 LoginStore 完成登录鉴权，请参考 接入概览。

·用户已通过 RoomStore 进入标准会议房间，请参考 房间管理。

·已完成云端录制套餐开通及存储配置：

·购买含云录制能力的视频会议 SDK 套餐。

·开通录制文件存储服务：录制文件支持存储至 云点播（VOD） 或 对象存储（COS），请在对应控制台完成开通并记录存储信息。

·提交工单，选择实时音视频产品，申请为你的 SDKAppID 配置云端录制存储信息。

二、录制效果

视频会议 SDK 默认采用合流录制模式，将房间内发布的音视频流混合为一份完整的录制文件。录制布局会随会中状态自动切换，切换过程中不重启录制任务：

三、接口说明

视频会议 SDK 无 UI 集成通过 RoomStore 提供录制控制与状态订阅能力，录制任务由服务端全程托管，客户端仅负责发起与停止。

四、权限要求

仅房主或管理员可调用 startRecording()，其他角色调用将抛出权限错误。同一房间内同时只能存在一个录制任务，重复调用也会返回错误。

五、示例代码

import AtomicXCoreprivate func startRecording() { RoomStore.shared.startRecording { result in switch result { case .success: print("录制成功") case .failure(let error): print("录制失败:code=\\(error.code),desc=\\(error.message)") } }}

六、错误处理

startRecording() 调用失败时会抛出错误，常见错误情况如下：

import AtomicXCoreprivate func startRecording() { RoomStore.shared.startRecording { result in switch result { case .success: print("录制成功") case .failure(let error): switch error.code { case 100001: print("后端系统错误，请稍后重试。") case 100004: print("房间不存在，请确认已进房后再发起录制。") case 100006: print("权限不足，仅房主或管理员可发起录制") case 101072: print("录制配置不存在或未启用，请检查控制台开通配置。") default: print("发起录制失败：\\(error.message)") } } }}

七、前置条件

当前房间内有进行中的录制任务（RecordingStatus.recording）。

八、权限要求

仅房主或管理员可调用 stopRecording()。

九、示例代码

import AtomicXCoreprivate func stopRecording() { RoomStore.shared.stopRecording { result in switch result { case .success: print("停止录制成功") case .failure(let error): print("停止录制失败:code=\\(error.code),desc=\\(error.message)") } }}

十、前置条件

·已进房成功。

·建议在进房前先订阅事件，避免遗漏由其他端（例如移动端房主）发起的录制通知。

十一、示例代码

import AtomicXCoreimport Combineprivate var cancellableSet = Set<AnyCancellable>()private func observeRecordingState() { let roomStore = RoomStore.shared // 主动查询当前录制状态 let currentRoom = roomStore.state.value.currentRoom let isRecording = currentRoom?.recordingInfo.status == .recording // 监听录制事件 roomStore.roomEventPublisher .sink { event in switch event { case .onRecordingStarted(let roomInfo, let operatorUser): print("录制已开始，操作人：\\(operatorUser.userID)") case .onRecordingStopped(let roomInfo, let operatorUser, let reason): switch reason { case .stoppedByUser: print("录制已停止，操作人：\\(operatorUser.userID)") case .recorderLeftRoom: print("录制异常中断，录制机器人已退出房间，请视需要重新发起录制。") @unknown default: break } default: break } } .store(in: &cancellableSet)}

十二、错误情况

onRecordingStopped 事件的 reason 字段标识录制停止原因：