[cocos2dx 3.0 (五)] 使用游戏控制台Console + 添加用户自定义控制台命令

cocos2dx 3.0又出了新版本rc0，在beta2版本中使用Console在vs2012上存在bug，在rc0中已经都修复了，而且加了不少的新的控制台命令。游戏控制台是通过TCP来连接控制的，使用可以让游戏的调试更加方便。

1.使用控制台

先来看一下Console类的一些定义

/** 控制台通过TCP连接可以让开发者更好的控制游戏。它会创建一个新线程去侦听指定的TCP端口。它拥有一个指令分析器，每个指令与一个 std::function<void(int)>相关联。如果这个std::function<>需要使用cocos2d的API，它必须是以下面的形式调用： ``` scheduler->performFunctionInCocosThread( ... ); //使用cocos2d API的部分必须用performFunctionInCocosThread调用 ```  */class CC_DLL Console{public://命令结构：名称、帮助和回调函数    struct Command {        const char *name;        const char *help;        std::function<void(int, const std::string&)> callback;    };    /** Constructor */    Console();    /** Destructor */    virtual ~Console();    /** 开始侦听指定端口 */    bool listenOnTCP(int port);    /** 从指定描述符开始侦听 */    bool listenOnFileDescriptor(int fd);    /** 停止控制台 */    void stop();    /** 添加用户控制台命令 */    void addCommand(const Command& cmd);    /** log something in the console */    void log(const char *buf);protected:......} 

所以使用控制台只需加入一句代码就可以了：

Director::getInstance()->getConsole()->listenOnTCP(5678);

端口号可以随意。

然后就可以使用telnet工具来连接使用控制台了。工具在windows系统中也是自带的，但是经过测试后发现，使用这些telnet工具在控制台获取数据时因为格式问题会输出显示的特别乱，所以就自己写了个控制台的客户端，其实很简单：

#include <stdio.h>#include <thread>#include <winsock2.h> #pragma comment(lib, "ws2_32.lib") #define  MAXLEN 256void wRevc(SOCKET s){char recData[MAXLEN];int len;while(true){len=recv(s, recData, MAXLEN-1, 0);if(len==-1)break;else if(len==0){return ;}else{recData[len] = 0x00;printf(recData);}}printf("已退出连接！\n");}int main(){printf("Cocos2dx Console Client\n请输入控制台端口号:");short port;scanf("%d",&port);WORD sockVersion = MAKEWORD(2,2);WSADATA data; if(WSAStartup(sockVersion, &data) != 0){return 0;}SOCKET sclient = socket(AF_INET, SOCK_STREAM, IPPROTO_TCP);if(sclient == INVALID_SOCKET){printf("invalid socket! ");system("pause");return 0;}sockaddr_in serAddr;serAddr.sin_family = AF_INET;serAddr.sin_port = htons(port);serAddr.sin_addr.S_un.S_addr = inet_addr("127.0.0.1"); if (connect(sclient, (sockaddr *)&serAddr, sizeof(serAddr)) == SOCKET_ERROR){printf("连接console失败!\n");closesocket(sclient);system("pause");return 0;}printf("连接console成功!\n");printf("输入\"help\"获取控制台帮助!\n");std::thread t(&wRevc,sclient);t.detach();char sendData[MAXLEN];getchar();while(true){//printf("Enter CocosConsole Command:\n");gets(sendData);if(strcmp(sendData,"consoleExit")==0){printf("退出ConsoleClient！\n");break;}if(strcmp(sendData,"consoleClear")==0)//clear屏幕{system("cls");printf("> ");continue;}strcat(sendData, "\n");send(sclient, sendData, strlen(sendData),NULL);//if(!wRevc(sclient))//break;}closesocket(sclient);WSACleanup();system("pause");return 0;}

上两张测试的图片：

1.查看控制台帮助：

2.查看FileUtils中的数据：

cocos2dx已经定义了很多命令，具体可以看help。

2.添加控制台命令

其实是使用游戏控制台最重要的是定义自己的控制台命令，比如 设置主角的属性，无敌状态，制造物品，查看各种细节数据等等；  这些在调试复杂游戏的时候都是必须的，首先就是要先定义自己的控制台命令。

添加新命令当然也很简单：

 #include "cocos2d.h" ...  Director::getInstance()->getConsole()->listenOnTCP(5678); ... Console::Command commands={"hello",//命令名称"This is just a user generated command", //说明/*回调函数的第一个参数其实就是socket的句柄，使用send向client发送数据，第2个参数是命令所带的参数字符串。*/[](int fd, const std::string& args) {    const char msg[] = "how are you?\nArguments passed: ";    send(fd, msg, sizeof(msg),0);    send(fd, args.c_str(), args.length(),0);send(fd, "\n",1,0);/*如果回调函数中需要使用cocos2d的api就必须在performFunctionInCocosThread函数中调用。...Director::getInstance()->getScheduler()->performFunctionInCocosThread([]{...});...*/}};Director::getInstance()->getConsole()->addCommand(commands);...

测试结果：

cocos2dx的console就学习到这里了！