商户4G执法记录仪OSS云存储

发布时间: 2026-11-06 17:58:57

本系统为视频记录仪客户端,负责视频的录制、本地存储与上传至对象存储(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. 完成

标记上传成功,本地文件按保留策略清理。