iOS / macOS SDK 接入

确认运行环境

iOS arm64 真机：iOS 13.0 及以上。
Apple Silicon iOS Simulator：iOS 14.0 及以上。
macOS：macOS 11.5 及以上，支持 arm64 和 x86_64。

添加 SDK 依赖

同一个 TiRTC Pod 包含 iOS 和 macOS framework。在对应的 iOS 或 macOS App target 中添加依赖：

ruby

target 'YourApp' do
  pod 'TiRTC'
end

bash

cd /path/to/your-project && pod install

初始化并查询录像

appId 来自申请开通。appAccessToken 由自己的业务服务端签发，见云端签发 Token。查询时间使用 UTC Unix 毫秒。

swift

import TiRTC

guard TiCloudStorage.initialize(appId: appId)
        == TiCloudStorageErrorCode.ok else { return }

let cloudStorage = TiCloudStorage(token: appAccessToken)
let result = await cloudStorage.listRecordings(
    startTimeMs: startTimeMs,
    endTimeMs: endTimeMs
)
guard result.code == TiCloudStorageErrorCode.ok else { return }
let recordings = result.recordings

View 操作在主线程执行。页面退出时先停止 Replay，再 detach 视频 View 与两个 Output。最后 dispose Output、Replay 和 TiCloudStorage 实例。

应用不再使用 Ti 云存且所有相关实例和任务均已释放后，调用 TiCloudStorage.shutdown() 释放进程级资源。

配置回放速度

Replay 支持 .x0_125、.x0_25、.x0_5、.x1、.x2、.x4、.x8 七档速度，分别对应 1/8、1/4、1/2、1、2、4、8 倍速。三档慢速采用持帧显示；非 1 倍速时 Audio Output 自动静音。

swift

replay.setSpeed(.x0_5)

确认可以查询录像

查询成功且 recordings 非空，说明初始化和 Token 鉴权均已通过，查询范围内也存在录像。列表为空时，确认查询范围覆盖设备已经完成上传的 UTC 时间。

接入客户端诊断能力（推荐）

初始化成功后，建议在开发阶段为 App 预留隐藏的日志上传入口。这样在需要平台协助诊断时，可以直接上传同一次复现的日志；入口设计、上传结果处理和可选的原始音视频诊断采集见接入客户端诊断能力。

iOS / macOS SDK 接入 ​

确认运行环境 ​

添加 SDK 依赖 ​

初始化并查询录像 ​

配置回放速度 ​

确认可以查询录像 ​