API
Cocos项目实现淘宝小游戏云存档
更新时间：2025/12/16
访问次数：1651
一、前置说明：
注意：该方案是基于老版本云存档权限包实现的，申请的新版本权限包请使用云存档（新游戏）。
二、设备信息
机型 |
手淘版本 |
IDE版本 |
iPhone7 |
10.38.10 |
3.0.9 |
三、Demo
Cocos Creator v3.8.3 |
Cocos Creator v2.4.13 |
四、实现云存档的代码
注意：Cocos2x跟Cocos3x的初始化方式不一样。
Cocos3x版本
新建Cocos组件代码：
import { _decorator, Component, Node } from 'cc';
const { ccclass, property } = _decorator;
import cloud from '@tbmp/mp-cloud-sdk'
@ccclass('NewComponent')
export class NewComponent extends Component {
onLoad() {
let cloudObj = new cloud.Cloud();
console.log("cloud",cloudObj)
try {
cloudObj.init({
env:'online'
});
}
catch (e) {
console.error("cloud初始化错误:" + e)
}
const userCloudStore = cloudObj.userCloudStore;
// 备份路径，可不填，如果不填，采用默认路径"default"
userCloudStore.definePath = 'iOSCocos3';
userCloudStore.getUserCloudStorage({
keyList: ['a', 'b'],
success(data) { console.log('[cc getUserCloudStorage', data) },
})
userCloudStore.getUserCloudStorageKeys({
success(data) { console.log('[cc getUserCloudStorageKeys', data) },
})
userCloudStore.removeUserCloudStorage({
keyList: ['b'],
success(data) { console.log('[cc removeUserCloudStorage', data) },
})
userCloudStore.setUserCloudStorage({
success(data) { console.log('[cccc', data) },
fail() { },
KVDataList: [{
key: 'a',
value: 20250218
},
{
key: 'b',
value: 20250218
},
{
key: 'c',
value: '20250218'
},
]
})
}
update(deltaTime: number) {
}
}
Cocos2x版本
新建Cocos组件代码：
// Learn TypeScript:
// - https://docs.cocos.com/creator/2.4/manual/en/scripting/typescript.html
// Learn Attribute:
// - https://docs.cocos.com/creator/2.4/manual/en/scripting/reference/attributes.html
// Learn life-cycle callbacks:
// - https://docs.cocos.com/creator/2.4/manual/en/scripting/life-cycle-callbacks.html
import cloud from '@tbmp/mp-cloud-sdk'
const {ccclass, property} = cc._decorator;
@ccclass
export default class NewClass extends cc.Component {
@property(cc.Label)
label: cc.Label = null;
@property
text: string = 'hello';
// LIFE-CYCLE CALLBACKS:
onLoad () {
cloud.init({
env: 'online',
options: {}
})
const userCloudStore = cloud.userCloudStore;
// 备份路径，可不填，如果不填，采用默认路径"default"
userCloudStore.definePath = 'iOSCocos2';
userCloudStore.getUserCloudStorage({
keyList: ['a', 'b'],
success(data) { console.log('[cc getUserCloudStorage', data) },
})
userCloudStore.getUserCloudStorageKeys({
success(data) { console.log('[cc getUserCloudStorageKeys', data) },
})
userCloudStore.removeUserCloudStorage({
keyList: ['b'],
success(data) { console.log('[cc removeUserCloudStorage', data) },
})
userCloudStore.setUserCloudStorage({
success(data) { console.log('[cccc', data) },
fail() { },
KVDataList: [{
key: 'a',
value: 20250218
},
{
key: 'b',
value: 20250218
},
{
key: 'c',
value: '20250218'
},
]
})
}
start () {
}
// update (dt) {}
}
五、真机调试输出日志
若无报错代表执行成功。
日志 |
? |
六、淘宝开放后台云存档界面
后台云存档界面 |
? |
