会议档案 SDK 函数与数据参考
会后回放是独立于入会的能力。业务后端先用 POST /api/v2/rtc/rooms/{roomId}/recordings/access 为当前用户申请短时档案票据；view 查目录/事件，play 读媒体，download 下载文件、附件和 ZIP。票据绑定会议、签发账号/会话或 API Token，服务端每次使用仍会复核。会中的 RTC Token 不能替代它。
import { AkRtcArchiveClient, rtcArchiveSpeakers } from '@akstream/rtc-web-sdk'
const archive = new AkRtcArchiveClient({
baseUrl: serviceOrigin,
accessProvider: (roomId, action) => businessBackend.issueArchiveAccess(roomId, action)
})
const page = await archive.queryRecordings(roomId, { page: 1, pageSize: 20 })
const run = page.items[0]
if (run) {
const manifest = await archive.getManifest(roomId, run.recordingId, { afterSequence: 0, maxEvents: 1000 })
console.log(rtcArchiveSpeakers(manifest.events, 20000))
}
serviceOrigin 为 HTTPS 服务根地址；businessBackend.issueArchiveAccess 是宿主自己的服务端授权调用，返回 {token,roomId,actions,expiresAtUtc}。不要把长期 ak_pat_ Token 下发到 App，也不要永久保存媒体 URL。
Web/H5 的 AkRtcArchiveClient
| 函数 | 入参 | 返回 | 权限与特殊情况 |
|---|---|---|---|
new AkRtcArchiveClient({baseUrl,accessProvider,fetchImpl?}) |
服务地址、按 roomId+action 取票函数、可选 fetch |
档案客户端 | 可在离会后单独创建；取票函数应能在票据到期时重新申请。 |
queryRecordings(roomId, filters?) |
search、participantId、deviceSessionId、state、fromUtc/toUtc、page/pageSize |
{total,page,pageSize,items} |
view；时间过滤针对录制开始时间，授权过滤在计数和分页之前。 |
getManifest(roomId, recordingId, {afterSequence?,maxEvents?}) |
会议、一次录制、事件游标和页上限 | RtcArchiveManifest |
view；音视频轨与事件共用原点。按 hasMoreEvents/nextSequence 读完事件，别只取第一页。 |
listFullExports(roomId, recordingId) |
会议与录制 ID | 整场导出任务列表 | view；Pending/Running 尚无可播放文件。 |
getMediaResource(roomId, recordingId, fileId) |
归属本次录制的媒体文件 ID | {url,expiresAtUtc} |
play；URL 可用于支持 HTTP Range 的播放器，过期后重新取票和地址。 |
getDownloadResource(roomId, recordingId, fileId) |
同上 | 授权下载 URL 和到期时间 | download；不能把播放 URL 当下载授权。 |
getAttachmentResource(roomId, recordingId, attachmentId, download?) |
附件 ID；download=true 取下载动作 |
预览或下载 URL | 查看需 view，下载需 download；仅本次公开聊天/白板实际引用的附件可读。 |
getWhiteboardImageResource(roomId, recordingId, attachmentId) |
本次白板图片 ID | 预览 URL | view；私聊或其他会议的图片不会因知道 ID 而开放。 |
getPackageResource(roomId, recordingId) |
会议与录制 ID | 本次归档 ZIP URL | download；ZIP 含获准公开附件，不含私聊。 |
getFullExportResource(roomId, recordingId, exportId, download?) |
整场导出 ID、播放或下载开关 | MP4 URL 和到期时间 | 播放需 play，下载需 download；任务完成后才可取。 |
rtcArchiveDeviceKey(participantId, deviceSessionId?) 返回设备级稳定视图键；rtcArchiveSpeakers(events, positionMilliseconds) 返回该时间点正在发言的 {participantId,deviceSessionId} 列表。大量事件应先按 nextSequence 补齐。RtcArchiveSpeakerTimeline(events).at(positionMilliseconds) 可供拖动、倍速和逐帧更新复用；这些函数只还原事件，不进行语音识别。
返回模型怎么读
| 字段 | 含义 | 容易误用的地方 |
|---|---|---|
recordingId、roomId |
一次录制与所属会议 | 同一会议可有多次录制，不能只用 roomId 当文件编号。 |
originAtUtc、durationMilliseconds |
时间线 UTC 原点与总时长 | 事件/文件的 offsetMilliseconds 从此原点计算，不是页面加载时间。 |
tracks[] |
每个成员设备的原始媒体轨 | 用 participantId + deviceSessionId + mediaKind 区分；同一人换机可出现多轨。 |
tracks[].files[] |
分片 fileId、时间偏移、时长、媒体与下载地址 |
视频断流/静音区间可以没有文件；不要冻结旧画面伪装连续。 |
composites[] |
会后生成的成员/屏幕兼容副本 | Pending/Failed 不代表原轨消失；副本只在会后生成。 |
events[]、hasMoreEvents、nextSequence |
聊天、白板、控制和发言事件分页 | hasMoreEvents=true 时继续查询；私发可见性由服务端裁剪。 |
speakerActivityVersion |
发言事件格式版本 | 旧录制无事件时显示“未知”，不要推断谁在说话。 |
Android、iOS 与 UniApp 对应方法
| 平台 | 初始化与换票 | 查询方法 | 资源方法与结果 |
|---|---|---|---|
| Android | AkRtcArchiveClient(baseUrl, accessJson, okHttpClient)；过期后 setAccess(JSONObject) |
queryRecordings(roomId, filters, Callback)、getManifest(roomId, recordingId, afterSequence, maxEvents, Callback)、listFullExports(..., Callback) |
getMediaResource/getDownloadResource/getAttachmentResource/getWhiteboardImageResource/getPackageResource/getFullExportResource 返回含 URL/到期时间的 JSONObject；网络查询用回调，失败带 HTTP 状态。 |
| iOS | try AkRtcArchiveClient(baseURL:access:session:)；setAccess(_:) |
queryRecordings(roomId:filters:)、getManifest(roomId:recordingId:afterSequence:maxEvents:)、listFullExports(roomId:recordingId:) 均为 async throws |
同名资源方法返回 RtcArchiveResource {url,expiresAtUtc}；RtcArchiveError.status 保留 HTTP 状态。 |
| UniApp | createUniArchiveClient({baseUrl,accessProvider}) |
复用 Web 档案客户端的查询与清单 | 原生 UTS requestRtcArchive(serverUrl,accessJson,action,payloadJson,callback) 用 query/manifest/fullExports/media/download/package/fullExportMedia/fullExportDownload/whiteboardImage/attachmentPreview/attachmentDownload 动作。 |
Android/iOS 的 setAccess 只替换手中短票据，不替业务后端决定谁有权看哪场会议；票据失效时宿主重新获取。原生资源方法返回地址，不创建播放器、下载管理或 UI。
错误与回放边界
| 情况 | 处理 |
|---|---|
| 401 | 档案票据过期、签发会话/API Token 被撤销或登录失效；向业务后端重新申请，不能复用入会票据。 |
| 403 | 缺 view/play/download 动作或当前用户无该会议权限；停止重试并提示申请权限。 |
| 404 | recordingId/fileId/attachmentId 不属于同一会议或未进入本次可见区间；重新查清单。 |
| 415 | 附件格式不支持站内预览；在拥有 download 权限时使用下载入口。 |
Stopping、Pending、Running |
录制/合成/导出仍在收尾；保留状态，稍后查询，不生成假文件链接。 |
完整 HTTP 路径和业务后端签票规则见RTC 档案 API。