基于 HarmonyOS 与华为云 OBS 的个人云相册 App,支持照片视频备份、云端图库与预览,附 AI 辅助开发教程。
Access rate limit exceeded. Please log in to continue.
用OBS打造个人云相册app
案例仓库:HarmonyOS-APP-OBSCloudAlbum。素材下载地址读取仓库默认分支。
使用 AI 辅助实践,将照片和视频备份到华为云 OBS,并查看云端对象与备份记录。

| 项目 | 内容 |
|---|---|
| 适合谁 | 愿意使用 AI 编程工具并核对构建和设备结果的开发者,了解 ArkTS 和 HTTP 更易上手 |
| 难度与耗时 | 进阶;快速体验约 30 分钟,完整实践约 120 分钟,均为估计,不含环境准备 |
| 你将学到 | 相册访问、OBS Header 签名、逐文件备份与云端预览 |
| 你将完成 | 体验已有应用,并从空项目构建自己的相册云备份作品 |
| 实践环境 | 云端工作区与云手机,或本地 DevEco Studio 和模拟器/真机;需要华为云 OBS |
1. 案例概览
应用读取用户授权的本地照片和视频,逐文件上传到自己的 OBS 桶,并提供记录、对象详情与云图库。
核心功能与体验
- 在本地图库筛选照片或视频,选择文件或一键备份全部待备份项目,观察逐文件进度与结果。
- 在备份记录中查看结果;取消后可再次发起备份,已完成的文件依据目标隔离的本地记录、MD5 和云端 ETag 核验跳过;取消的当前文件需整文件重新上传。
- 在云端刷新对象列表,查看详情或切换网格;照片和视频以缩略图展示,打开图片及视频预览。
对象键由本地 URI、大小、修改时间与 MD5 等信息生成,使用 photo_backup/v2/ 前缀。记录按 Endpoint 和桶隔离;当前不支持后台定时备份或字节级断点续传。
| 本地图库 | 备份记录 | 云端网格 |
|---|---|---|
![]() |
![]() |
![]() |
技术方案一览
flowchart LR A[本地相册] --> B[媒体扫描与备份] B --> C[OBS Header 签名与 HTTP] C --> D[华为云 OBS] B --> E[本地备份记录] D --> F[对象列表与认证预览]
| 层级 | 技术 | 作用 |
|---|---|---|
| 端侧 | ArkTS、ArkUI、photoAccessHelper | 媒体选择与交互 |
| 云侧 | 华为云 OBS REST API | 上传、列举及读取对象 |
| 数据 | preferences、应用缓存 | 保存配置与记录,缓存云端预览 |
| 工具 | DevEco Studio、HarmonyOS SDK | 构建和设备运行 |
2. 开始之前
环境与配置
| 项目 | 要求及获取方式 |
|---|---|
| 云端开发 | 鸿蒙开发实践中心作业中心账号、支持 API 26 的在线工具链和云手机;创建前核对实际 SDK、可选 ROM、连接及签名条件,版本未提供时先联系平台准备 |
| 本地开发 | DevEco Studio 及 HarmonyOS SDK;工程 compile、compatible、target 均为 26.0.0。本地可用 DevEco Studio 26.0.0,AI 编程工具按实际安装情况使用 |
| 设备 | 云端使用支持 API 26 的云手机;本地使用相应模拟器或真机,真机需自己的有效调试签名 |
| OBS | 按下方步骤创建私有桶,取得 AK、SK、区域 Endpoint 和桶名;推荐使用最小权限 IAM 用户 |
| 权限 | ohos.permission.READ_IMAGEVIDEO 用于读取授权媒体;ohos.permission.INTERNET 用于访问 OBS;ohos.permission.GET_NETWORK_INFO 在工程中声明,当前未发现代码调用 |
| 配置安全 | 设置页保存 AK、SK、Endpoint 和桶名;AK 和 SK 均为密码态输入,但 AK/SK 仍以明文保存在应用沙箱 preferences 中,仅用于教学调试。不要提交或分享凭据 |
创建 OBS 并获取 App 配置
云端和本地实践使用同一套 OBS 配置。登录华为云,进入控制台,搜索并打开“对象存储服务 OBS”。已有可用桶和密钥时,可直接核对第 3、4 步。
1. 选择资源包(可选)
在 OBS 控制台进入“资源包管理 → 购买资源包”,选择“存储包”。本案例可使用以下活动规格,单 AZ 和多 AZ 二选一,不必都买:
| 资源包类型 | 容量与时长 | 活动参考价 | 创建桶时的冗余策略 |
|---|---|---|---|
| 标准存储多 AZ 包 | 40 GB / 1 年 | 9 元 | 多 AZ 存储 |
| 标准存储单 AZ 包 | 40 GB / 1 年 | 9 元 | 单 AZ 存储 |
先选择使用地域,再核对规格、有效期、账号活动资格、续费选项及订单价格后购买;活动是否可选及最终金额以购买页为准。已有资源包无需重复购买。不购买资源包也可按需使用 OBS,详见资源包购买指引。
40 GB 是存储容量额度,不是下载流量,也不是整年费用封顶。存储包只按适用条件抵扣存储费;公网下载流量、读写请求及超出额度或有效期的用量仍可能产生费用。
2. 创建私有桶
资源包用于抵扣费用,购买后不会自动创建桶。回到“桶列表 → 创建桶”,按下表填写后单击“立即创建”:
| 参数 | 本案例选择 |
|---|---|
| 区域 | 按实际使用选择;已购资源包时选相同地域,例如华北-北京四 |
| 桶名 | 全局唯一的小写字母、数字和连字符组合,例如 album-demo-7m3x9;换成自己的名称,避免使用英文句点 |
| 存储类别 | 标准存储 |
| 数据冗余存储策略 | 单/多 AZ 任选;已购包时必须匹配:多 AZ 包对应多 AZ 桶,单 AZ 包对应单 AZ 桶 |
| 桶策略/访问权限 | 私有;App 使用签名请求访问 |
桶名、区域及单/多 AZ 策略创建后不能直接修改,提交前核对。资源包、桶的区域与 AZ 策略,以及对象的存储类别必须匹配,才可抵扣相应用量;不匹配时会按需计费。详见创建桶与资源包仍扣费的排查说明。
3. 取得 App 的四项信息
已有可用访问密钥可直接使用。没有时,在控制台右上角用户名菜单进入“我的凭证 → 访问密钥 → 新增访问密钥”,按提示验证身份并下载保存密钥文件,操作见访问密钥获取说明。
| App 设置字段 | 去哪里获取 | 填写内容 |
|---|---|---|
| AK | 访问密钥列表或下载的密钥文件 | Access Key ID |
| SK | 新建密钥时下载的密钥文件 | Secret Access Key;之后不能重新查看,遗失时需新建并替换 |
| Endpoint | 桶列表 → 进入桶 → 概览,查看所属区域的 Endpoint | 区域域名,例如 obs.cn-north-4.myhuaweicloud.com;不含桶名、对象路径或端口 |
| 桶名 | 桶列表或桶概览的“桶名称” | 自己刚创建的完整桶名,不是文件夹名 |
Endpoint 示例仅对应华北-北京四;其他地域必须复制对应值,不要照抄 App 默认值,也不要填“桶名.Endpoint”形式的桶访问域名或完整对象 URL。格式说明见OBS 访问规则。
推荐使用已开启“编程访问”的专用 IAM 用户,授予该桶的 obs:bucket:ListBucket 和桶内对象的 obs:object:PutObject、obs:object:GetObject 权限,范围以实际测试桶为限,参见常用 OBS 权限。AK/SK 只在 App 中填写,不发到聊天、源码或截图中。
4. 安装后保存配置并检查连接
完成后续快速体验中的 App 安装后,打开“设置”,依次填入 AK、SK、Endpoint 和桶名后保存;刷新云端列表,再选择一张非敏感测试照片发起备份。若返回 403,先核对四项配置、设备时间及桶访问权限。
准备完成标志: 桶在控制台可见,已取得四项配置;App 安装后按第 4 步检查连接,测试照片备份成功且云端可找到对应对象。
费用与配额
OBS 可能产生存储、请求和流量等费用,云工作区和云手机也可能消耗配额或费用。列表请求、图片缩略图和视频预览使用认证 GET 读取原对象;公网读取可能产生流出流量。按使用区域、存储类别、容量和请求量查看 OBS 计费说明与流量费用,具体价格以购买页为准。
3. 快速体验
完成第 2 章的 OBS 准备后,选择云端或本地路径,在设备相册准备少量测试照片和视频,并准备可访问 OBS 的网络。应用单文件上传和预览上限为 64 MiB;云预览磁盘缓存上限 128 MiB,缩略图最多 64 张。
云端快速体验
第一步:创建项目并导入案例
打开鸿蒙开发实践中心,进入作业中心创建项目,将 https://gitcode.com/harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum.git 填入“案例仓地址”;确认工作区显示工程文件。
完成标志: 工作区可见 build-profile.json5 和 entry 模块。
第二步:让 AI 编译打包
输入:
请检查当前相册云备份工程的 API 26 SDK、依赖和构建工具,编译 entry HAP。保留已有修改,失败时按实际日志定位并修复,告诉我实际产物路径和签名要求。
完成标志: 构建成功且 AI 给出实际 HAP 路径。
第三步:创建并连接云手机
在平台设备管理中核对可选 ROM 与 API,创建并连接支持 API 26 的云手机,按平台要求处理签名与配额;若工作区或云手机尚未提供 API 26,先联系平台准备匹配的工具链和设备,再继续。
完成标志: 云手机运行且工作区能识别所选设备。
第四步:让 AI 安装并打开
输入:
请识别当前工作区连接的云手机,将刚构建的 HAP 安装并打开。多个设备时先让我选择;根据实际错误检查连接、API 和签名,不清除设备数据。告诉我设备及启动结果。
完成标志: 云手机显示应用的本地图库。
第五步:体验主要功能
首次进入图库时按提示授权相册,在设置中填入已取得的 AK、SK、区域 Endpoint 和桶名并保存,选择测试文件或全部待备份项目,开始备份;查看记录,刷新云端列表,切换列表和网格,查看照片视频缩略图并打开图片或视频。

完成标志: 备份结果可见,云端可找到刚上传的对象并打开支持预览的文件。
本地快速体验
第一步:准备开发工具
安装 DevEco Studio 和 API 26 SDK,准备可用 AI 编程工具及华为云 OBS 配置。
完成标志: 开发工具和 API 26 SDK 可用。
第二步:让 AI 获取案例代码
输入:
请将 https://gitcode.com/harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum.git 获取到当前工作区独立目录 HarmonyOS-APP-OBSCloudAlbum;已有工程则保留已有文件和修改。识别 build-profile.json5 与 entry 模块。若仓库尚未发布文件或网络获取失败,请报告实际状态,不要创建占位业务代码。
完成标志: 本地能看到工程配置和 entry 模块。
第三步:让 AI 编译打包
输入:
请检查相册云备份工程的 API 26 SDK、依赖和构建工具,编译 entry HAP。保留已有修改,失败时按实际日志定位并修复,告诉我实际产物路径和签名要求。
完成标志: 构建成功且 AI 给出实际 HAP 路径。
第四步:准备模拟器或真机
启动支持 API 26 的模拟器或连接已授权真机;真机使用自己的有效调试签名,并向设备相册准备测试媒体。
完成标志: 目标设备已连接,具备安装条件且相册有测试文件。
第五步:让 AI 安装并打开
输入:
请识别本机已连接的 HarmonyOS 设备,将刚构建的 HAP 安装并打开。多个设备时先让我选择;根据实际错误检查连接、API 和签名,不清除设备数据。告诉我设备及启动结果。
完成标志: 设备显示应用的本地图库。
第六步:体验主要功能
首次进入图库时按提示授权相册,在设置中填入已取得的 AK、SK、区域 Endpoint 和桶名并保存,选择测试文件或全部待备份项目,开始备份;查看记录,刷新云端列表,切换列表和网格,查看照片视频缩略图并打开图片或视频。

完成标志: 备份结果可见,云端可找到刚上传的对象并打开支持预览的文件。
4. 完整实践
从空项目构建自己的作品。先按第 2 章完成 OBS 准备;云端创建空项目并留空案例仓地址,本地打开空文件夹。不要复制案例业务代码。
统一教学素材
下列图片是统一视觉参考,提供仓内查看路径和单文件下载地址。仅下载图片到 reference/,不获取现成应用代码。单文件下载使用 GitCode 原始文件 API,读取仓库默认分支,供 AI 或下载工具直接获取;正文插图仍采用仓内相对路径。下载后确认文件可解码为图片;请求失败时停止本阶段,不用占位图片替代。
| 素材 | 仓内查看 | 单文件下载 | 用途 |
|---|---|---|---|
| 本地图库 | 图库 | 下载 PNG | 筛选、选择与备份入口 |
| 备份记录 | 记录 | 下载 PNG | 备份结果 |
| 云端详情 | 详情 | 下载 PNG | 对象列表及详情 |
| 云端网格 | 网格 | 下载 PNG | 云图库 |
| 图片预览 | 图片 | 下载 PNG | 图片查看 |
| 视频预览 | 视频 | 下载 PNG | 视频播放 |
| 安全配置 | 设置 | 下载 PNG | 配置入口与密码态 |
1. 检查环境
输入:
请只读检查我的空工作区、HarmonyOS API 26 SDK、构建工具和可连接设备,说明缺项及准备方法;不要下载现成案例代码或覆盖已有文件。
完成标志: 获得环境与设备准备清单。
2. 设计需求和素材
输入:
请只下载下列七张视觉参考图片到当前空工作区 reference/,保存为 URL 中对应的 PNG 文件名,并确认响应确实是可解码图片,不是登录页或 HTML 错误页:
https://api.gitcode.com/api/v5/repos/harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum/raw/cases/images/screenshot-library.png
https://api.gitcode.com/api/v5/repos/harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum/raw/cases/images/screenshot-records.png
https://api.gitcode.com/api/v5/repos/harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum/raw/cases/images/screenshot-cloud-list.png
https://api.gitcode.com/api/v5/repos/harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum/raw/cases/images/screenshot-cloud-grid.png
https://api.gitcode.com/api/v5/repos/harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum/raw/cases/images/screenshot-photo-preview.png
https://api.gitcode.com/api/v5/repos/harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum/raw/cases/images/screenshot-video-preview.png
https://api.gitcode.com/api/v5/repos/harmony-practice-center/HarmonyOS-APP-OBSCloudAlbum/raw/cases/images/screenshot-settings.png
若仓库尚未发布这些文件、返回错误或需要登录,请停止本阶段并报告具体失败地址;不要编造图片,也不要下载或复制案例应用代码。
根据图片设计本地图库、备份记录、云端列表和网格、照片视频缩略图、图片视频预览及设置。支持照片视频筛选、多选、全部待备份、进度和取消;记录与 MD5 按桶和端点隔离。写出状态、异常、验收方法和页面方案供我确认。
完成标志: 图片可打开,需求、界面与验收方案已确认。
3. 创建并编译工程与界面
输入:
请按已确认方案创建 API 26 HarmonyOS Stage 工程,声明相册读取、网络和网络状态权限。实现本地图库、备份记录、云端和设置的页面骨架,以及照片视频筛选与多选。按实际构建日志修复错误,保留用户文件。
完成标志: 工程可构建,主要页面和选择入口可见。
4. 实现 OBS 认证和备份
输入:
请实现华为云 OBS Header 认证:按官方规范构造规范化资源及 x-obs 请求头,使用 SK 计算 HMAC-SHA1 并 Base64 编码,Authorization 为 OBS AK:Signature。使用 HTTPS 完成对象列举和 PUT 上传,计算 Content-MD5,处理签名和网络错误。对象键使用 photo_backup/v2/SHA256(localUri,size,modifiedAt,md5)/safeName,按 Endpoint 和桶隔离本地记录,并结合本地文件信息、MD5 和云端 ETag 校验跳过已备份文件;逐文件显示进度与取消,再次发起时继续处理尚未完成的文件,不宣称分片断点续传。单文件超过 64 MiB 给出提示。设置页以密码态展示 AK 和 SK,并说明 preferences 明文存储的风险。先使用测试桶和最小权限,不输出真实密钥。
完成标志: 测试文件可上传,重复备份可按目标和内容识别,失败及取消状态可见。
5. 运行并验证云端预览
输入:
请实现云端对象列表、网格、详情、照片视频缩略图以及通过认证 GET 获取图片和视频预览;单个预览不超过 64 MiB,磁盘缓存不超过 128 MiB、缩略图最多 64 张。提示读取原对象可能产生请求和流量费用。编译并在我选择的设备运行,检查配置、授权、选择备份、取消后再次备份、记录、列表和预览。根据日志修复可复现问题,不泄露凭据;报告实际结果和未完成项。
完成标志: 设备可完成测试备份,记录和云端对象可核对,支持的图片视频可预览。
5. 功能检查与排障
| 操作或现象 | 检查与处理 |
|---|---|
| 相册为空 | 确认设备中有测试媒体且已授予照片和视频读取权限 |
| 备份后再次备份 | 检查同一目标下的记录和 MD5;清除应用数据会影响本地记录 |
| 签名不匹配或 403 | 核对 Endpoint、桶名、AK/SK、设备时间、权限与规范化资源;根据实际响应定位 |
| 云端预览失败 | 检查对象读取权限、网络、文件大小及格式;GET 读取原对象会产生相应请求和流量 |
| 同名对象保护 | 上传使用 x-obs-forbid-overwrite;版本控制桶的行为须按 OBS 文档和桶配置核对,不能依赖它阻止产生新版本 |
6. 安全与清理
测试使用最小权限凭据和非敏感媒体。密码态只隐藏输入,不加密沙箱中的 AK/SK;生产应用应采用适当的临时授权方案。不要将凭据放入代码、日志、截图或公开问题中。
保存需要的工程及数据,停止不再使用的云工作区和设备;核对后删除测试对象及不再需要的桶,撤销或轮换测试密钥。桶启用版本管理时,删除当前对象不一定删除历史版本,应按控制台实际版本清理并确认费用。
7. 项目导览与进阶
关键目录
| 位置 | 作用 |
|---|---|
entry/src/main/ets/pages/Index.ets |
页面入口 |
entry/src/main/ets/common/ObsClient.ets |
OBS 请求与签名 |
entry/src/main/ets/common/BackupService.ets |
备份流程 |
entry/src/main/ets/common/CloudPreviewStore.ets |
云端预览缓存 |
entry/src/main/module.json5 |
权限声明 |
深入阅读与扩展
OBS Header 签名介绍规范化请求、签名和认证。以下任务均为选做,基于当前工程独立改造;现有应用尚未实现这些扩展。
| 应用场景与目标 | 对应任务 | 适配差异与验收落点 |
|---|---|---|
| 家庭视频备份:备份超过 64 MiB 的家庭视频 | 分段上传大文件 | 保留逐文件去重,检查分段完成及失败处理 |
| 旅行素材整理:按备份时间浏览和筛选旅行素材 | 云相册时间轴 | 按 OBS lastModified 分组,明确时区并保留原视图 |
| 文档资料归档:选择并备份指定类型文档 | 文档选择备份 | 使用系统授权 URI,复用目标隔离、哈希核验和 PUT |
| 跨设备相册恢复:将云端照片或视频保存到另一台设备相册 | 云端下载恢复 | 经用户确认保存到系统相册;预览缓存不是永久恢复 |
任务:分段上传大文件
入口:entry/src/main/ets/common/BackupService.ets、MediaScanner.ets、ObsClient.ets 和 BackupRules.ets。准备测试桶、最小权限凭据和大于 64 MiB 的非敏感视频;当前分段上传尚未实现。
1. 设计分段上传方案
输入:
请检查 BackupService、MediaScanner、ObsClient 和 BackupRules,设计大于 64 MiB 视频的 OBS 分段上传,说明初始化、分段、合并、签名、有限内存读取、去重和完整性校验。失败或取消时中止上传,或明确保留可恢复状态及清理方式;不要把分段 ETag 当整文件 MD5,不要简单移除内存上限。先给方案和验收方法,不修改代码。
完成标志: 已确认分段流程、校验和失败处理方案。
2. 实现分段上传
输入:
请按已确认方案实现分段上传和状态处理,保留小文件上传与逐文件去重;不要简单移除内存上限或把分段 ETag 当整文件 MD5。处理失败、取消和未完成上传,按构建日志修复。
完成标志: 构建成功,分段上传及失败处理入口可见。
3. 验证分段上传
输入:
请在我指定的测试桶和设备上用超过 64 MiB 的视频验证初始化、分段和合并;检查失败、取消后中止或明确保留可恢复状态,回归小文件上传及逐文件去重。报告实际结果和未验证项。
完成标志: 大视频和原有备份的实际验证结果可见。
验收清单:
- 超过 64 MiB 的视频可初始化、分段并合并为可读取对象。
- 失败或取消后上传被中止,或明确保留恢复状态及清理方式。
- 完整性校验不把分段 ETag 当整文件 MD5。
- 小文件备份与逐文件去重仍可用。
任务:云相册时间轴
入口:entry/src/main/ets/pages/Index.ets、entry/src/main/ets/common/ObsClient.ets、entry/src/main/ets/viewmodel/BackupModels.ets。准备不同日期的云对象;lastModified 是 OBS 对象时间,不是 EXIF 拍摄时间。
1. 设计时间轴方案
输入:
请检查云端列表、CloudObject.lastModified 和详情、网格及预览流程,设计按 OBS 备份或上传时间分组的时间轴、日期筛选、时区显示和空态;不要将其标为拍摄时间。先给方案和验收方法,不修改代码。
完成标志: 已确认时间来源、时区、筛选和切换方案。
2. 实现云相册时间轴
输入:
请按已确认方案实现时间轴及日期筛选,标明 OBS 备份或上传时间和时区,处理无匹配结果;保留详情、网格切换与图片视频预览,按构建日志修复问题。
完成标志: 构建成功,时间轴及筛选入口可见。
3. 验证时间轴
输入:
请用不同日期的云对象验证时间分组、时区、日期筛选及空态,回归详情、网格切换和图片视频预览;报告实际结果和未验证项。
完成标志: 时间轴和原有视图的实际验证结果可见。
验收清单:
- 对象按 OBS 备份或上传时间分组,显示时区且不称拍摄时间。
- 日期筛选可改变结果,无匹配时显示空态。
- 原详情、网格切换及图片视频预览仍可用。
任务:文档选择备份
入口:entry/src/main/ets/common/MediaScanner.ets、BackupService.ets、ObsClient.ets、entry/src/main/ets/viewmodel/BackupModels.ets。准备 PDF、TXT 和不支持类型测试文件;使用系统选择器获取授权 URI 及元数据。
1. 设计文档备份方案
输入:
请检查媒体扫描、备份模型和 OBS PUT,设计通过系统文件选择器取得授权 URI、名称、大小和类型并备份 PDF/TXT 的方案;复用目标隔离和哈希核验,保留照片视频,不把文档当媒体 URI 或交给图片解码。说明大小限制、不支持类型及授权失效处理,先给方案和验收方法,不修改代码。
完成标志: 已确认文档来源、类型、授权和备份方案。
2. 实现文档选择备份
输入:
请按已确认方案实现系统选择器文档备份,仅接受 PDF/TXT,使用授权 URI 和元数据,复用目标隔离、哈希核验及 OBS PUT;保留照片视频,处理不支持类型和授权失效,不使用图片解码或媒体 URI 假设。按构建日志修复问题。
完成标志: 构建成功,文档选择及备份入口可见。
3. 验证文档备份
输入:
请用 PDF、TXT 和不支持类型文件验证选择、上传、类型拒绝及授权失效提示,回归照片视频备份和目标隔离;报告实际结果及未验证项。
完成标志: 文档和原有媒体备份的实际验证结果可见。
验收清单:
- 授权选择 PDF、TXT 后可备份并核验对应对象。
- 不支持类型被拒绝,授权失效时显示提示。
- 文档不进入图片解码或依赖媒体 URI 的流程。
- 照片视频备份与目标隔离仍可用。
任务:云端下载恢复
入口:entry/src/main/ets/common/ObsClient.ets、CloudPreviewStore.ets、entry/src/main/ets/pages/Index.ets。准备另一台设备及可读云对象;现有缓存不是永久恢复,当前读取上限为 64 MiB。
1. 设计下载恢复方案
输入:
请检查 ObsClient 认证 GET、CloudPreviewStore 缓存和云端预览页面,设计将照片视频恢复到系统相册:经系统保存或相册创建请求由用户确认,处理读取或保存权限拒绝、重名不覆盖及取消清理半成品。保留现有 64 MiB 限制,不删除云对象;先给方案和验收方法,不修改代码。
完成标志: 已确认用户授权、保存和异常处理方案。
2. 实现云端下载恢复
输入:
请按已确认方案复用认证 GET 实现恢复,经系统保存或相册创建请求由用户确认,将文件真正写入系统相册;不能把私有缓存视为永久恢复。重名不覆盖、取消清理半成品,读写权限被拒绝时提示,保留 64 MiB 限制且不删除云对象。按构建日志修复问题。
完成标志: 构建成功,云端对象恢复入口可见。
3. 验证下载恢复
输入:
请在我指定的另一台设备上验证图片和视频确认保存后可在系统相册查看;验证重名不覆盖、取消无半成品、读写权限拒绝提示和 64 MiB 限制,确认云对象仍存在。报告实际结果和未验证项。
完成标志: 系统相册与异常处理的实际验证结果可见。
验收清单:
- 确认保存后图片和视频可在系统相册查看。
- 重名不覆盖,取消后无半成品。
- 读取或保存权限被拒绝时有提示;64 MiB 限制仍生效。
- 云对象保留,私有缓存不作为永久恢复结果。
8. 参考与维护
官方资料与帮助
- OBS Header 签名
- OBS API 参考
- HarmonyOS photoAccessHelper
- 使用问题可提交至案例仓库 Issues;不要公开凭据。
维护信息
| 项目 | 内容 |
|---|---|
| 维护团队 | 鸿蒙开发实践中心 |
| 当前案例版本 | 文档 v1.1.3;工程 1.1.1 |
| 文档更新日期 | 2026-11-07 |
| 代码获取方式 | 默认分支最新内容 |
| 教学素材版本 | 1.1.1 界面基线,七张参考图从默认分支获取 |
| 实践路径 | 第 3 章体验现有工程,第 4 章从空项目构建,第 7 章选做拓展 |
| 兼容限制 | API 26;单文件上传和预览上限 64 MiB;云端须具备匹配的 SDK 与 ROM |
案例迭代记录
- v1.1.3(2026-11-07):补充 OBS 购买与建桶步骤、客户端配置获取方法及资源包抵扣条件。
- v1.1.2(2026-11-06):统一维护信息表和维护团队,补齐迭代记录及独立许可证小节。
- v1.1.1(2026-11-06):完善图库状态与选择备份、记录缩略图、云端双视图及图片视频预览。
许可证
代码和文档采用 MIT License,原始版权声明及署名保留在许可证文件中。第三方依赖及素材遵循各自许可证。
