商户4G执法记录仪OSS云存储
本系统为视频记录仪客户端,负责视频的录制、本地存储与上传至对象存储(OSS)。本文档说明记录仪的 7 项功能设计要求,作为开发与验收依据。
功能清单:
· OSS 上传凭证与桶名配置
· 商户 ID 绑定
· 上传目录格式:checkVideoData/{商户ID}/{年-月-日}/
· 文件命名:年-月-日-时-分-秒
· 自定义视频命名标记
· 中文 / 英语 / 阿拉伯语 三语切换
· 视频断点续传
二、功能设计
2.1 OSS 上传凭证与桶名配置
系统提供“存储设置”页,用于填写并保存上传所需的 OSS 参数。
· 可配置项:Endpoint、Region、Bucket(桶名)、AccessKeyId、AccessKeySecret、STS 临时令牌(可选)。
· 保存前提供“测试连接”按钮,校验参数是否可用。
· AccessKeySecret 与 STS 令牌加密存储,界面以掩码显示,不提供明文回显。
· 配置不完整时禁止上传,并提示用户前往设置页补全。
· 桶名固定用于上传,不随视频变化;更换桶不影响已上传的历史文件。
2.2 商户 ID 绑定
系统必须提供商户 ID 的录入与绑定入口,绑定结果持久化保存。
· 商户 ID 是上传的必要条件:未绑定商户 ID 时不允许上传视频,界面给出明确提示。
· 商户 ID 参与上传目录的构造,即目录中的“商户id”段(见 2.3)。
· 格式要求:1–64 位,仅允许字母、数字、下划线、连字符;不允许包含 / 、\ 与 .. 及空格。
· 支持解绑与更换;存在进行中的上传任务时,应先完成或取消任务再更换。
2.3 上传目录格式
视频必须按以下目录格式上传:
checkVideoData/商户id/年-月-日/
· checkVideoData 为固定根目录,不可修改、不可省略。
· 第二级为绑定的商户 ID(见 2.2)。
· 第三级为视频开始录制当天,格式 yyyy-MM-dd。
示例:
checkVideoData/M10086/2026-10-30/
2.4 文件命名规则
上传的文件名必须使用视频开始录制的时间,格式为“年-月-日-时-分-秒”:
年-月-日-时-分-秒 → yyyy-MM-dd-HH-mm-ss
· 时间以视频开始录制的时间为准,不使用录制结束时间,也不使用上传时间。
· 各时间段固定两位、不足补零,采用 24 小时制。
· 扩展名沿用视频格式(mp4 / mov / avi),统一小写。
示例:
2026-10-30-15-10-51.mp4
2.5 自定义视频命名标记
用户在上传时可自行填写一个命名标记,系统将该标记追加在时间之后:
年-月-日-时-分-秒-自己添加的命名标记.视频格式
· 标记为可选;不填写时文件名不保留多余的连字符,即回退为 2.4 的格式。
· 标记长度建议不超过 32 个字符。
· 标记不允许包含路径或非法字符:/ \ : * ? " < > |
示例:
2026-10-30-15-10-51-GateA.mp4
2.6 三语切换
系统界面支持简体中文、英语、阿拉伯语三种语言。
· 设置页提供语言切换,切换后立即生效,无需重启,并记住用户的选择。
· 阿拉伯语界面整体采用从右到左(RTL)布局,图标与文字方向同步镜像。
· 界面文案统一以语言资源文件维护,按“键 – 译文”对应;缺失译文时回退英语。
· 文件名与上传目录中的时间格式不受语言影响,始终为数字格式。
语言资源示例:
|
文案键 |
中文 |
English |
العربية |
|
app.name |
记录仪 |
Video Recorder |
مسجل الفيديو |
|
config.oss.title |
OSS 存储配置 |
OSS Storage Configuration |
إعدادات تخزين OSS |
|
config.oss.bucket |
存储桶名称 |
Bucket Name |
اسم الحاوية |
|
merchant.id |
商户 ID |
Merchant ID |
معرف التاجر |
|
merchant.unboundTip |
请先绑定商户 ID |
Please bind a Merchant ID |
يرجى ربط معرف التاجر |
|
upload.tag |
视频标记 |
Video Tag |
علامة الفيديو |
|
upload.resume |
继续 |
Resume |
متابعة |
|
upload.resuming |
正在恢复上传 |
Resuming upload |
جارٍ استئناف الرفع |
|
upload.success |
上传成功 |
Upload succeeded |
تم الرفع بنجاح |
|
error.network |
网络异常 |
Network error |
خطأ في الشبكة |
2.7 断点续传
视频采用分片方式上传,上传过程中记录进度;中断后可从已完成的进度继续上传。
· 分片上传:默认分片大小 5MB,按片上传并逐片记录结果。
· 进度保存:已成功的分片及文件标识(ETag)实时记录到本地。
· 断点恢复:重新开始上传时,先向服务端查询已上传的分片,仅续传未完成的部分,已传分片不重复上传。
· 适用场景:网络中断、Wi-Fi 与移动网络切换、退出应用、进程被关闭、设备断电。
· 完整性校验:上传完成后校验文件大小与校验值(CRC64),不一致则重传异常分片。
· 失败处理:网络恢复后自动重试;连续失败则暂停任务,等待用户手动继续。
三、配置项一览
|
配置项 |
说明 |
默认值 / 示例 |
|
OSS Endpoint |
对象存储接入点 |
oss-cn-chengdu.aliyuncs.com |
|
OSS 桶名 Bucket |
上传目标桶 |
测试:car-det-check-dev |
|
AccessKeyId |
访问密钥 ID |
— |
|
AccessKeySecret |
访问密钥,加密存储 |
— |
|
STS 临时令牌 |
使用临时凭证时填写,可选 |
— |
|
目录根前缀 |
固定值,不可修改 |
checkVideoData |
|
商户 ID |
必填,未绑定不可上传 |
2111065489922592769 |
|
标记长度上限 |
自定义命名标记最大长度 |
32 字符 |
|
分片大小 |
断点续传分片大小 |
5 MB |
|
并发分片数 |
同时上传的分片数量 |
3 |
|
最大重试次数 |
单分片失败重试上限 |
5 |
|
当前语言 |
界面语言 |
zh-CN |
四、上传路径与命名示例
完整上传路径由以下几段拼成:
checkVideoData/{商户ID}/{yyyy-MM-dd}/{yyyy-MM-dd-HH-mm-ss}[-{标记}].{扩展名}
示例:
|
场景 |
开始录制时间 |
生成的视频文件名 |
完整上传路径 |
|
常规(无标记) |
2026-10-30 15:10:51 |
2026-10-30-15-10-51.mp4 |
checkVideoData/2111065489922592769/2026-10-30/2026-10-30-15-10-51.mp4 |
|
带自定义标记 |
2026-10-30 15:10:51 |
2026-10-30-15-10-51-GateA.mp4 |
checkVideoData/2111065489922592769/2026-10-30/2026-10-30-15-10-51-GateA.mp4 |
|
跨零点录制 |
2026-10-30 23:59:58 |
2026-10-30-23-59-58.mp4 |
checkVideoData/2111065489922592769/2026-10-30/2026-10-30-23-59-58.mp4 |
|
其他商户 |
2026-10-30 09:00:00 |
2026-10-30-09-00-00-front_door.mp4 |
checkVideoData/2111065489922592770/2026-10-30/2026-10-30-09-00-00-front_door.mp4 |
五、上传流程
|
1. 录制结束 |
封装视频写入本地,记录开始录制时间。 |
|
2. 上传前校验 |
检查 OSS 配置是否完整、商户 ID 是否已绑定。 |
|
3. 读取标记 |
获取用户填写的自定义标记,可为空。 |
|
4. 生成路径与文件名 |
按二、2.3–2.5 生成对象路径与文件名。 |
|
5. 分片上传 |
开始上传并持续记录进度;中断后可续传。 |
|
6. 完整性校验 |
校验文件大小与 CRC64,异常则重传异常分片。 |
|
7. 完成 |
标记上传成功,本地文件按保留策略清理。 |
