HarmonyOS 端云协同实战:OBS 云相册的签名直传、队列重试与备份记录设计
一、背景:为什么选择端云协同的相册备份
手机相册是最典型的"重资产"数据:单个用户动辄几十 GB,且以图片、短视频这类非结构化文件为主。如果应用采用"先上传到业务服务器、再由服务器转发到对象存储"的中转方案,带宽和存储成本会翻倍,业务服务器也很容易成为瓶颈。
在鸿蒙端云协同实践中,更合理的路径是:端侧直传对象存储(OBS),云侧只负责签名与元数据。本文结合笔者的实践,梳理这套方案在 HarmonyOS 上的关键实现点,包括预签名直传、上传队列、断点重试和备份记录设计。文中不包含任何真实密钥,示例代码仅用于说明思路。
二、整体架构
方案分为三层:
- 端侧 ArkTS 应用:负责读取相册、生成上传任务、管理本地备份记录。
- 鸿蒙提供了
@ohos.file.photoAccessHelper用于访问媒体库。申请ohos.permission.READ_IMAGEVIDEO后,可以按时间倒序拉取图片:
import { photoAccessHelper } from '@kit.MediaLibraryKit';
const helper = photoAccessHelper.getPhotoAccessHelper(context);
const fetchOpt: photoAccessHelper.FetchOptions = {
fetchColumns: [photoAccessHelper.PhotoKeys.URI, photoAccessHelper.PhotoKeys.DISPLAY_NAME, photoAccessHelper.PhotoKeys.SIZE],
predicates: new photoAccessHelper.DataSharePredicates(),
};
const result = await helper.getAssets(fetchOpt);
拿到 uri 后,用 @ohos.file.fs 打开文件并读成 ArrayBuffer,作为 PUT 的请求体。这里要注意:不要在主线程一次性读入超大视频,建议设置单文件大小阈值(例如 20 MB 以上走分片或交给系统上传任务),避免内存抖动。
四、预签名直传:端侧只做一件事
签名服务对每个对象键计算签名,返回类似下面的结构:
interface UploadTicket {
objectKey: string;
putUrl: string; // 带签名参数的 PUT 地址
getUrl: string; // 用于预览的 GET 地址
expiresAt: number; // 毫秒时间戳
}
端侧用 @ohos.net.http 发起 PUT:
import { http } from '@kit.NetworkKit';
const req = http.createHttp();
const res = await req.request(ticket.putUrl, {
method: http.RequestMethod.PUT,
header: { 'Content-Type': 'image/jpeg' },
extraData: buffer,
expectDataType: http.HttpDataType.STRING,
});
if (res.responseCode !== 200) {
// 进入失败重试队列
}
req.destroy();
几个容易踩的坑:
- Content-Type 必须与签名时一致。签名串里如果带了这个头,端侧改了就会 403。
-
localUri:本地资源标识;-
-
objectKey:云端对象键; -
import { preferences } from '@kit.ArkData'; const store = await preferences.getPreferences(context, 'backup_records'); await store.put(task.objectKey, JSON.stringify(task)); await store.flush();注意
flush()是落盘操作,不要每上传一个分片就调用一次。笔者的策略是:内存中维护状态,每完成一个文件或每 5 秒聚合落盘一次。记录数量很大时(例如数万条),Preferences 的全量序列化会变慢,此时应换成关系型数据库@ohos.data.relationalStore,按state建索引。七、云端预览与缓存
预览时向签名服务申请 GET URL,直接交给
Image组件加载。为了避免每次滑动都重新签名,可以在内存中缓存objectKey -> {url, expiresAt},过期前 60 秒再刷新。端侧再配合@ohos.file.fs的缓存目录做一层磁盘缓存,弱网体验会好很多。八、安全与成本的两点提醒
-
- 点赞
- 收藏
- 关注作者
评论(0)