HarmonyOS 云相册案例实践笔记:OBS Header 签名备份与云端预览

举报
yd_224048907 发表于 2026/11/10 01:56:36 2026/11/10
【摘要】 案例概览今天阅读了鸿蒙开发实践中心的「用 OBS 打造个人云相册 App」案例(HarmonyOS-APP-OBSCloudAlbum)。这是一个基于 HarmonyOS 与华为云 OBS 的个人云相册应用:读取用户授权的本地照片和视频,逐文件上传到自己的 OBS 桶,并提供备份记录、云端对象列表与图片视频预览。工程面向 API 26,适合愿意使用 AI 编程工具、并愿意核对构建和设备结果...

案例概览

今天阅读了鸿蒙开发实践中心的「用 OBS 打造个人云相册 App」案例(HarmonyOS-APP-OBSCloudAlbum)。这是一个基于 HarmonyOS 与华为云 OBS 的个人云相册应用:读取用户授权的本地照片和视频,逐文件上传到自己的 OBS 桶,并提供备份记录、云端对象列表与图片视频预览。工程面向 API 26,适合愿意使用 AI 编程工具、并愿意核对构建和设备结果的开发者。

核心功能

  1. 在本地图库筛选照片或视频,选择文件或一键备份全部待备份项目,观察逐文件进度与结果。
  2. 在备份记录中查看结果;取消后可再次发起备份,已完成的文件依据目标隔离的本地记录、MD5 和云端 ETag 核验跳过,取消的当前文件需整文件重新上传。
  3. 在云端刷新对象列表,查看详情或切换列表/网格视图;照片和视频以缩略图展示,支持打开图片及视频预览。

对象键与去重

对象键使用 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 桶和最小权限凭据准备好,再动手实践,遇到问题按实际日志和响应定位,效率会高很多。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。