本地存储(Cocos)

数据持久化在游戏运行所在的那台设备上。适合存偏好、缓存,以及任何丢了也能便宜地重建的内容。

所有方法都挂在 FRVRSDK.instance 单例上,且都返回 Promise。

单条数据

await FRVRSDK.instance.localStorageSetItem('coins', 100);
const coins = await FRVRSDK.instance.localStorageGetItem('coins');   // → 100 | null
await FRVRSDK.instance.localStorageRemoveItem('coins');

值可以是任意可 JSON 序列化的值 —— 封装层帮你处理序列化(底层 Web SDK 只接受字符串)。

批量(性能更好)

批量 API 在多键场景下能省掉多次往返。建议在存档/读档点使用。

await FRVRSDK.instance.localStorageSetItems([
  { key: 'score',        value: 4200 },
  { key: 'level',        value: 5 },
  { key: 'tutorial_done', value: true },
]);

const items = await FRVRSDK.instance.localStorageGetItems(['score', 'level', 'tutorial_done']);
// items 是以传入 key 作为键的对象

await FRVRSDK.instance.localStorageRemoveItems(['legacy_key', 'temp_run']);

何时用本地、何时用云端

用本地存储当…	用**云存储**当…
数据丢了便宜重建	数据丢了会毁掉玩家进度
数据是设备相关的(静音、画质档位)	数据应跟玩家跨设备
不需要玩家登录	玩家有 FRVR 鉴权会话

游戏存档、解锁、内购发放的内容应放在云存储。偏好和缓存放在本地存储。