# CloudSaveManager.getArchiveCover
以 Promise 风格调用:支持
# 功能描述
获取云存档封面文件,从云存储下载对应封面文件的内容保存到小游戏本地存储空间。
# 参数
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| archiveUUID | string | 是 | 云存档的UUID | |
| archiveFileId | string | 是 | 文件ID | |
| targetFilePath | string | 否 | 目标文件路径: • 不为空时,将云存档文件下载下来存入targetFilePath并回调; • 传空或者不传时会创建一个临时文件,并在callback中返回该文件的路径 | |
| success | function | 否 | 成功的回调 | |
| fail | function | 否 | 失败的回调 | |
| complete | function | 否 | 完成的回调 |
success回调返回数据:
Object res:
| 属性名 | 数据类型 | 说明 |
|---|---|---|
| filePath | string | 获取云存档封面文件,并将其内容保存到小游戏存储空间的文件路径 |
# 错误
| 错误码 | 说明 |
|---|---|
| 400002 | 指定的存档不存在 |
| 400007 | 不允许并发调用 |
| 400008 | 找不到可用的OSS供应商 |
| 400100 | 云存档sdk初始化失败 |
| 400201 | archiveUUID 为空 |
| 400202 | archiveFileId 为空 |
# 示例代码
tapCloudSave.getArchiveCover({
archiveUUID: "your_archive_uuid",
archiveFileId: "your_archive_file_id",
targetFilePath: `${tap.env.USER_DATA_PATH}/archiveFileCover.png`,
success: (res) => {
console.log(" getArchiveCover success: file cover is ", res.filePath);
},
fail: ({errMsg, errno}) => {
console.error(`getArchiveCover failed: errMsg=${errMsg}, errno=${errno}`);
},
complete: ({errMsg, errno}) => {
console.log(`getArchiveCover complete: errMsg=${errMsg}, errno=${errno}`);
}
})
