4G执法记录仪定制开发~火山云上传

发布时间: 2025-10-23 10:26:18

执法记录仪定制化开发

1. 开始录像操作

1.1 功能描述

向执法记录仪发送指令，触发录像功能启动，用于记录执法过程中的关键画面信息。

1.2 请求参数

参数名称	说明	必要性
caseId	案件唯一标识 ID，用于关联具体执法案件	必传
objectId	对象唯一标识 ID，用于区分同一案件下的不同记录对象	必传

1.3 响应要求

无特殊响应格式或内容要求，执法记录仪接收指令后正常启动录像即可，如果失败需要返回失败原因。

1.4 文件存储规则

执法记录仪生成的录像文件，需按照以下固定路径生成objectKey：

固定文件夹/年/月/日/caseId/objectId/文件名

2. 结束录像操作

2.1 功能描述

向执法记录仪发送指令，终止当前录像功能，完成执法过程记录。

2.2 请求参数

参数名称	说明	必要性
caseId	与 “开始录像” 操作对应的案件唯一标识 ID，确保前后操作关联同一案件	必传
objectId	与 “开始录像” 操作对应的对象唯一标识 ID，确保前后操作关联同一记录对象	必传

2.3 响应要求

无特殊响应格式或内容要求，执法记录仪接收指令后正常终止录像即可，如果失败需要返回失败原因。

3. 执法记录仪至火山云上传规则

3.1 上传路径说明

直接通过执法记录仪客户端，将该caseId、objectId本次 “开始录像 - 结束录像” 流程生成的录像文件上传至火山云存储，。

3.2 核心上传要求

1. STS 临时授权机制：上传前需调用理赔系统接口通过 STS（Security Token Service）获取临时访问凭证（包含临时 AccessKeyId、临时 AccessKeySecret、SecurityToken），仅使用临时授权权限完成上传操作，避免长期密钥泄露风险，临时凭证需在有效期内使用。

2. 分片上传策略：针对大体积录像文件），采用分片上传方式，将文件拆分为固定大小的分片，逐一上传分片后，在火山云端完成分片合并，确保大文件上传稳定性。

3. 断点续传功能：支持断点续传，上传过程中若因网络中断、设备异常等原因暂停，恢复后可从已上传完成的分片后续继续上传，无需重新上传完整文件，减少重复流量消耗，提升上传效率。

4. 同一文件去重机制：上传前需对文件进行唯一性校验，通过文件 MD5 值、文件名称 + 大小组合等唯一标识，判断火山云端是否已存在相同文件；若文件已存在，直接跳过上传流程，避免重复存储占用资源，同时记录去重结果用于后续回传信息标注。

4. 录像文件上传回传操作

4.1 功能描述

（1）执法记录仪生成的录像文件上传至火山云存储成功后，需将文件列表信息回传至理赔系统，以便理赔系统获取执法记录文件，支撑后续理赔业务流程。

（2）如果支持转语音和转文字的话，可以将识别后的音频文件、文本文件按照相同的objectKey生成方式上传，若是该过程耗时较长，可以与视频文件分开传。

4.2 请求参数

参数名称	说明	必要性
caseId	关联案件的唯一标识 ID，需与 “开始录像”“结束录像” 操作中的 caseId 保持一致	必传
objectId	关联对象的唯一标识 ID，需与 “开始录像”“结束录像” 操作中的 objectId 保持一致	必传
文件列表	本次 “开始录像 - 结束录像” 流程中生成的所有录像文件信息，需包含文件名称、文件存储路径（火山云路径）、文件大小、文件格式、文件 MD5 值、上传状态（成功 / 去重跳过）等关键信息，确保理赔系统可准确定位并获取文件	必传