SDK-云储存

更新时间:2026-06-06 12:00:00OSDK

cloud

如未使用 OSDK Login API,则不能使用此 API,因为会依赖登录态

cloud是sdk的云存储对象,可提供数据的存储和读取。云存储 sdk 已实现自动跟用户登录态 openid 绑定

init

使用cloud.init方法初始化cloud环境

sdk.cloud.init({
    env: 'test' // test || prod,小游戏正式版请使用 prod 环境
});

使用getKv,setKv方法读取或存储数据

sdk.cloud.setKv('mykey', 55666).then((value) => {
  console.log(value); // 55666
});
sdk.cloud.getKv('mykey').then(value => {
  console.log('mykey: ', value) // mykey: 55666
});

setKv

setKv(key: string, value: any): Promise<any>

云端存储游戏数据,传入一个键名和值,将会把键名添加到给定的云端对象中,如果键名已存在,则更新其对应的值。value支持number/string/boolean/array/object。

语法:

sdk.cloud.setKv(key, value).then(value => console.log(value));

getKv

getKv(key: string): Promise<any>

读取云端游戏数据,传入一个键名,将通过Promise返回该键的值。当给定的 Storage 对象中不存在该键,则返回 null。

语法:

sdk.cloud.getKv(key).then(value => console.log(value));

相关文档