cc.sys.localStorage存储和读取用户数据

存储和读取用户数据

我们在游戏中通常需要存储用户数据，如音乐开关、显示语言等，如果是单机游戏还需要存储玩家存档。 Cocos Creator 中我们使用cc.sys.localStorage接口来进行用户数据存储和读取的操作。

cc.sys.localStorage接口是按照Web Storage API来实现的，在 Web 平台运行时会直接调用 Web Storage API，在原生平台上会调用 sqlite 的方法来存储数据。一般用户不需要关心内部的实现。

配合本篇文档可以参考数据存储范例。

存储数据

cc.sys.localStorage.setItem(key, value)

上面的方法需要两个参数，用来索引的字符串键值key，和要保存的字符串数据value。

假如我们要保存玩家持有的金钱数，假设键值为gold:

cc.sys.localStorage.setItem('gold', 100);

对于复杂的对象数据，我们可以通过将对象序列化为 JSON 后保存：

userData = {

    name:'Tracer',

    level:1,

    gold:100

};

cc.sys.localStorage.setItem('userData',JSON.stringify(userData));

读取数据

cc.sys.localStorage.getItem(key)

和setItem相对应，getItem方法只要一个键值参数就可以取出我们之前保存的值了。对于上文中储存的用户数据：

var userData =JSON.parse(cc.sys.localStorage.getItem('userData'));

移除键值对

当我们不再需要一个存储条目时，可以通过下面的接口将其移除：

cc.sys.localStorage.removeItem(key)

数据加密

对于单机游戏来说，对玩家存档进行加密可以延缓游戏被破解的时间。要加密存储数据，只要在将数据通过JSON.stringify转化为字符串后调用你选中的加密算法进行处理，再将加密结果传入setItem接口即可。

您可以搜索并选择一个适用的加密算法和第三方库，比如encryptjs， 将下载好的库文件放入你的项目，存储时：

var encrypt=require('encryptjs');

var secretkey='open_sesame';// 加密密钥

var dataString =JSON.stringify(userData);

var encrypted = encrypt.encrypt(dataString,secretkey,256);

cc.sys.localStorage.setItem('userData', encrypted);

读取时：

var cipherText = cc.sys.localStorage.getItem('userData');

var userData=JSON.parse(encrypt.decrypt(cipherText,secretkey,256));

注意数据加密不能保证对用户档案的完全掌控，如果您需要确保游戏存档不被破解，请使用服务器进行数据存取。