Cocos2d-x数据篇01:UserDefault数据存储

【前言】

一个游戏怎么能没有游戏存档呢?在Cocos2d-x中也提供了一个数据存储类CCUserDefault,可以作为一个轻量级的数据库来使用。它支持五种数据bool、int、float、double、string的存储。


【Demo下载】

UserDefault数据存储

【Cocos2d-x 3.x】

(1)去掉 “CC”

(2)获取单例:sharedUserDefault() 改为 getInstance()

(3)增加数据值:Data

1
2
3
4
//
void setDataForKey( const char *pKey, const Data&value);
DatagetDataForKey( Data&defaultValue=Data::Null);
//

(4)其他变化不大。

【CCUserDefault】

CCUserDefault类和之前讲的CCDirector、SimpleAudioEngine一样,都是采用单例模式。

可以通过sharedUserDefault()函数来获取其唯一的实例对象。

CCUserDefault采用XML存储技术,就是一般的键值对,这个类似C++中的map的映射(键——值)。一个关键字对应一个值。其实现的接口也比较简单实用,通过传统的set()、get()方法访问和修改值。

它支持五种数据:bool、int、float、double、string。

1、原理

(1)类似map的映射(键——值)。一个关键字对应一个值,并利用set()/get()进行访问。

(2)数据直接存储在一个XML文件中,并且文件名为程序项目的名字,如“MyTest.xml”。

(3)首次使用时,XML不存在,CCUserDefault会自动创建相应的XML文件。

2、设置数据值set

通过(键——值)的方式进行设置。

4
5
6
7
setBoolForKey( bool value); //设置一个bool值
setIntegerForKey( int //设置一个int值
setFloatForKey( float //设置一个float值
setDoubleForKey( double //设置一个double值
setStringForKey( std::string&value); //设置一个string值
3、获取数据值get

通过关键字,来从XML文件中获取数据值。

若关键字不存在,会自动设置(键——值)映射,并设置对应的默认值defaultValue。

7
//
getBoolForKey( defaultValue= false ); //读取一个bool值
getIntegerForKey( defaultValue=0); //读取一个int值
getFloatForKey( defaultValue=0.0); //读取一个float值
getDoubleForKey( //读取一个double值
std::stringgetStringForKey( std::string&defaultValue= "" //读取一个string值
4、保存flush

当set完后,数据不会马上保存到XML文件中。

所以一定要记得用flush()来保存数据,否则会丢失!

3
//
CCUserDefault::sharedUserDefault()->flush();
5、其他操作

获取单例对象、释放单例对象、获取XML文件路径、判断XML文件是否已经存在。

6
static CCUserDefault*sharedUserDefault(); //获取单例对象
static purgeSharedUserDefault(); //释放单例对象
const std::string&getXMLFilePath(); //获取XML路径
static isXMLFileExist(); //XML文件是否已创建
6、使用技巧

(1)每次操作都要打长长的CCUserDefault::sharedUserDefault(),来获得单例对象。是不是很麻烦呢?可以通过宏定义来缩短长度。

//
#defineUserDefaultCCUserDefault::sharedUserDefault()
(2)在使用的时候,要特别注意:区别 const char* 和 const std::string 是不一样的!

(3)当set完后,一定要记得用flush()来保存数据,否则会丢失!

【代码实战】

代码来源于TestCpp项目中。

1、需要引用以下的头文件和命名空间

因为要用到C++的string类型。

4
#include<string>
using namespace std;
2、宏定义获取单例对象的函数

3、编写数据存储相关操作,并在控制台输出数据值

7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
//设置set
UserDefault->setBoolForKey( "bool" ,153)!important">true );
UserDefault->setIntegerForKey( "integer" UserDefault->setFloatForKey( "float" UserDefault->setDoubleForKey( "double" UserDefault->setStringForKey( "string" "1111111" );
//获取get,并输出到控制台
//通过关键字,获取数据
b=UserDefault->getBoolForKey( );
i=UserDefault->getIntegerForKey( );
f=UserDefault->getFloatForKey( );
d=UserDefault->getDoubleForKey( );
stringret=UserDefault->getStringForKey( );
//输出到控制台
CCLOG((b== )? "boolistrue" : "boolisfalse" );
CCLOG( "integeris%d" "floatis%f" "doubleis%f" "stringis%s"
//输出XML文件路径
if (UserDefault->isXMLFileExist()) //是否存在
{
stringpath=UserDefault->getXMLFilePath();
"XMLfileisexist!" );
"XMLfilepath:%s" }
else
{
"XMLfileisnotexist!" );
}
//保存数据
UserDefault->flush();
4、运行结果

5、分析与总结

(1)不知道大家是否发现输出的结果有问题?float我设置的是33.33,为何输出的是33.330002。不是应该输出33.330000才对吗?

这个就要讲讲C++浮点数的精度问题了,float是单精度浮点数,而double是双精度浮点数。float的有效精度在6~7位,超过7位就可能会失真,就像上面的那个例子一样。而double的有效精度在15~16位,超过16位才会失真。具体的原理,自行百度吧!

(2)getXMLFilePath()获取的XML文件路径为绝对路径。另外XML文件保存的路径为项目的Debug.win32中,说明XML文件是保存在应用程序所在目录下的。

相关文章

    本文实践自 RayWenderlich、Ali Hafizji 的文章《...
Cocos-code-ide使用入门学习地点:杭州滨江邮箱:appdevzw@1...
第一次開始用手游引擎挺激动!!!进入正题。下载资源1:从C...
    Cocos2d-x是一款强大的基于OpenGLES的跨平台游戏开发...
1.  来源 QuickV3sample项目中的2048样例游戏,以及最近《...
   Cocos2d-x3.x已经支持使用CMake来进行构建了,这里尝试...