HarmonyOS 云相册案例实践笔记:OBS Header 签名备份与云端预览
案例概览
今天阅读了鸿蒙开发实践中心的「用 OBS 打造个人云相册 App」案例(HarmonyOS-APP-OBSCloudAlbum)。这是一个基于 HarmonyOS 与华为云 OBS 的个人云相册应用:读取用户授权的本地照片和视频,逐文件上传到自己的 OBS 桶,并提供备份记录、云端对象列表与图片视频预览。工程面向 API 26,适合愿意使用 AI 编程工具、并愿意核对构建和设备结果的开发者。
核心功能
- 在本地图库筛选照片或视频,选择文件或一键备份全部待备份项目,观察逐文件进度与结果。
- 在备份记录中查看结果;取消后可再次发起备份,已完成的文件依据目标隔离的本地记录、MD5 和云端 ETag 核验跳过,取消的当前文件需整文件重新上传。
- 在云端刷新对象列表,查看详情或切换列表/网格视图;照片和视频以缩略图展示,支持打开图片及视频预览。
对象键与去重
对象键使用 photo_backup/v2/ 前缀,由本地 URI、大小、修改时间与 MD5 等信息生成。记录按 Endpoint 和桶隔离。当前不支持后台定时备份或字节级断点续传,单文件上传和预览上限为 64 MiB,云预览磁盘缓存上限 128 MiB,缩略图最多 64 张。
OBS Header 签名要点
案例使用 OBS Header 认证:按官方规范构造规范化资源及 x-obs 请求头,使用 SK 计算 HMAC-SHA1 并 Base64 编码,Authorization 为 OBS AK:签名 的形式。出现签名不匹配或 403 时,应先核对 Endpoint、桶名、AK/SK、设备时间、权限与规范化资源,再根据实际响应定位问题。
配置与费用提醒
- 桶使用私有权限;建议使用已开启「编程访问」的专用 IAM 用户,只授予该桶的
obs:bucket:ListBucket和桶内对象的obs:object:PutObject、obs:object:GetObject权限。 - AK/SK 在应用设置页以密码态输入,但仍以明文保存在应用沙箱 preferences 中,仅用于教学调试,不要提交或分享凭据。
- 存储包只按适用条件抵扣存储费;公网下载流量、读写请求及超出额度或有效期的用量仍可能产生费用。资源包、桶的区域与单/多 AZ 策略、对象的存储类别必须匹配,才可抵扣相应费用。
- 桶名、区域及单/多 AZ 策略创建后不能直接修改,提交前要核对。
实践路径与清理
案例提供两条路径:快速体验是导入现有工程、让 AI 编译打包、创建云手机并安装体验;完整实践是从空项目开始,按确认的方案创建工程、实现 OBS 认证和备份、再运行验证云端预览,期间不要复制案例业务代码。测试完成后,应保存需要的工程及数据,停止不再使用的云工作区和设备,核对后删除测试对象及不再需要的桶,并撤销或轮换测试密钥。
小结
这个案例把端侧媒体能力、OBS 对象存储和 AI 辅助开发串在了一起:端侧负责授权读取与界面,云侧负责存储与预览,签名与去重规则是保证备份正确性的关键。按文档先把 OBS 桶和最小权限凭据准备好,再动手实践,遇到问题按实际日志和响应定位,效率会高很多。
- 点赞
- 收藏
- 关注作者
评论(0)