HarmonyOS 云相册实践:用 OBS Header 签名实现照片逐文件备份
背景
把手机里的照片和视频备份到自己的云端,是一个很典型的端云一体场景。本文以 HarmonyOS 个人云相册为例,记录如何用华为云 OBS 的 Header 签名方式,把本地图库的照片视频逐文件备份到自己的桶,并在云端查看缩略图和预览。
整体链路很简单:本地图库选择文件 → OBS Header 签名 → 逐文件 PUT 上传 → 备份记录落盘 → 云端列表与预览。
一、OBS Header 签名:HMAC-SHA1
OBS 的 Header 签名方式不依赖 SDK,适合在端侧直接构造请求。签名串按“请求方法、内容头、规范化 OBS 请求头和资源”构造,再用 SK 计算 HMAC-SHA1 并 Base64 编码,放到 Authorization 请求头:
Authorization: OBS AK:Signature
实践中有三点容易踩坑:第一,设备时间必须准确,签名包含时间信息,偏差过大服务端会返回 403(SignatureDoesNotMatch);第二,规范化资源要包含桶名和对象名;第三,SK 只用于本地计算签名,绝不要写进代码、日志或截图里。
二、逐文件备份与去重
备份按“目标对象 + 内容 MD5”识别重复文件,同一文件重复备份时直接跳过上传。上传过程显示进度、支持取消;备份结果写入本地记录,刷新后仍可查看。单文件上传上限为 64 MiB,超过 64 MiB 的视频需要走分段上传。
另外要注意:桶的区域和单/多 AZ 策略创建后不能直接修改;存储包只抵扣存储费用,公网下载流量和读写请求仍会按需计费,选购前先核对地域是否匹配。
三、云端查看与预览
上传完成后,在云端列表可以按对象浏览,列表和网格两种视图可切换,点进对象详情可以查看元数据。通过认证 GET 请求可以预览图片和视频。需要注意两个上限:单个预览不超过 64 MiB,磁盘缓存上限 128 MiB,缩略图最多 64 张。
四、权限与安全:最小权限
建议使用开启了“编程访问”的专用 IAM 用户,只授予目标桶的 ListBucket、PutObject 和 GetObject 权限。AK/SK 只在 App 的设置页填写,测试使用非敏感媒体;用完后及时删除测试对象和不再使用的桶,并轮换测试密钥。
五、常见问题
- SignatureDoesNotMatch:核对区域、桶名、密钥、签名串和设备时间。
- 图库为空:确认设备里有测试媒体,且已授予照片和视频读取权限。
- 云端预览失败:检查对象读取权限、网络、文件大小和格式。
小结
这个案例的核心并不复杂:签名解决“能不能访问”,逐文件上传加去重解决“传什么、怎么传”,云端列表和预览解决“传完怎么看”。把这三段跑通,再扩展分段上传、时间轴和文档归档,就是一个完整的个人云相册。
- 点赞
- 收藏
- 关注作者
评论(0)