41 lines
4.3 KiB
Markdown
41 lines
4.3 KiB
Markdown
|
# 火山云录音接入（2026-09-27）
|
|||
|
|
|
|||
|
|
已发布：`0.99.13-rc.cloud-recordings1`，基于线上 `0.99.12-rc.portal-records1` 的小范围覆盖。
|
|||
|
|
|
|||
|
|
## 当前可用功能
|
|||
|
|
|
|||
|
|
- 聊天记录 → 选择通话 → 聊天录音，分别列出长者和助手的 MP4 文件、时长和大小。
|
|||
|
|
- 使用私有 TOS 桶 `memory927`，地域 `cn-beijing`；复用服务器已有的火山凭据文件，没有把密钥写入网页或仓库。
|
|||
|
|
- `calls/recordings` 只查询对象元数据，`calls/recording-access` 返回最长 300 秒的签名地址。音频由客户浏览器直接访问 TOS；服务端没有音频 GET、缓存、转发或落盘代码。
|
|||
|
|
- 使用现有家庭成员、长者、敏感信息权限、原音频保存同意及独立 PLAY/DOWNLOAD 授权。撤销授权后不能申请新地址；已经发出的地址在原有效期内仍可能访问，最长 5 分钟，且不超过授权或同意到期时间。
|
|||
|
|
- 家庭所有者可以主动点击为本账号授予 24 小时播放/下载授权；部署没有替任何账号自动授予权限。
|
|||
|
|
|
|||
|
|
## 关联依据
|
|||
|
|
|
|||
|
|
通过会话专属签名校验后的字幕回调保留 `bot_<17位时间戳>` RTC 用户标识，在 `call_session.budget_snapshot.rtc_agent_user_id` 中保存。结合通话记录中的设备名，构造硬件网关的精确房间和录音前缀；列表和签名操作都先核对会话所属长者与租户，再严格匹配完整文件名。客户端不能提交任意对象 Key。
|
|||
|
|
|
|||
|
|
现有通话 `562a391e-e7a0-409f-804e-0eb0d5e576dd` 通过已有字幕的 UID/轮次/序号 SHA-256 标识交叉验证后补充关联：长者 58 秒（1,045,859 字节），助手 103 秒（1,845,555 字节）。没有按时间接近程度匹配历史记录。没有确切 UID 的历史通话显示关联信息暂缺；回调缺失的新通话也不会错误关联录音。
|
|||
|
|
|
|||
|
|
当前火山配置是单流自动录制，不是双方混音。文件生成需要等待通话结束及火山处理，页面提供刷新。
|
|||
|
|
|
|||
|
|
## 在线播放的剩余配置
|
|||
|
|
|
|||
|
|
实测使用默认域名签名 HEAD 返回 HTTP 200，但即使指定 inline，响应仍为 `Content-Disposition: attachment`。火山对 2024-01-03 后新建桶的默认域名禁止预签名直接预览：https://www.volcengine.com/docs/6349/1175779。
|
|||
|
|
|
|||
|
|
因此线上现在提供查询和下载，不显示不可用的播放按钮。绑定带 HTTPS 的 TOS 自定义域名后，配置 `TOS_RECORDING_PLAYBACK_ENDPOINT=https://<已绑定域名>` 可启用播放器；下载继续使用默认 TOS 域名。不能把 CDN 域名直接当作此配置，必须使用支持 TOS 私有签名的已绑定域名，并验证证书和签名响应。未配置自定义域名时 PLAY 请求被服务端拒绝。
|
|||
|
|
|
|||
|
|
## 验证
|
|||
|
|
|
|||
|
|
- 使用临时独立 PostgreSQL 容器执行 7 项数据库/直聊/录音测试：授权、下载权限独立、跨长者通话、错误文件 ID、撤回同意、链接有效期、回调身份保存及冲突。测试容器已经移除；没有在业务数据库创建测试账号或授权。
|
|||
|
|
- 候选版本网页构建通过；浏览器测试 7 项通过，包含直连地址、切换通话时取消旧请求、拒绝访问后清除旧链接、移动布局、未配置域名时保留下载并隐藏播放。
|
|||
|
|
- `go vet ./internal/callmemory` 通过。最初 `internal/app` 的集成测试因本地 PostgreSQL/Redis 未启动而失败；随后相关数据库行为在上述独立环境验证。
|
|||
|
|
- 生产 TOS 只使用 LIST/HEAD 检查元数据和下载响应，未下载真实音频。
|
|||
|
|
- 线上新接口匿名请求均返回 401，api/callbacks/web 健康；生产配置下的服务元数据查询准确返回上述两份录音。
|
|||
|
|
- 网页构建文件逐个校验 SHA-256；worker/gateway/Postgres/Redis/MinIO 容器未更换。
|
|||
|
|
|
|||
|
|
发布清单位于服务器 `/opt/data-terminal-cloud/current/cloud-recordings-release.json`。部署脚本及本地证据位于 `.tmp-tos-recordings/`。测试入口为 `test/e2e/cloud-recordings.mjs`（候选构建目录）以及 `internal/callmemory/recordings_test.go`。
|
|||
|
|
|
|||
|
|
## 边界
|
|||
|
|
|
|||
|
|
本次只管理录音查询和短期访问地址。火山的自动录制开关、对象保留期和 TOS 删除策略仍由火山配置决定；平台隐私删除请求会阻止录音访问，但本次未增加远端 TOS 音频删除任务。TOS 存储、云录制和外网下载产生的火山费用仍按账号计费。
|