cocos2d HTTP请求（GET/POST）与JSON数据交互【玩转华为云】

1. 引言

• 从服务器拉取关卡配置（GET）
• 提交玩家分数或存档（POST）
• 解析服务器返回的 JSON 数据并更新游戏逻辑

2. 技术背景

2.1 Cocos2d-x 网络模块

• network::HttpClient：封装了 libcurl，支持同步/异步 HTTP 请求。
• HttpRequest / HttpResponse：分别表示请求与响应对象。
• 回调机制：通过 std::function或自定义监听器处理响应。

2.2 JSON 解析库

• rapidjson（Cocos2d-x 自带）：轻量、高性能 C++ JSON 解析器。
• cJSON：另一个流行的 C 语言 JSON 库。
  本文示例使用 rapidjson，因为 Cocos2d-x 项目通常已集成。

3. 应用使用场景

4. 不同场景下详细代码实现

4.1 GET 请求示例（获取配置）

// GetConfigScene.cpp
#include "network/HttpClient.h"
#include "network/HttpResponse.h"
#include "json/document.h"  // rapidjson
#include "cocos2d.h"

using namespace cocos2d::network;
using namespace rapidjson;

void GetConfigScene::onEnter() {
    Layer::onEnter();

    auto request = new HttpRequest();
    request->setUrl("https://example.com/api/gameconfig.php?version=1.0");
    request->setRequestType(HttpRequest::Type::GET);

    request->setResponseCallback([this](HttpClient* sender, HttpResponse* response) {
        if (!response->isSucceed()) {
            CCLOG("GET request failed: %s", response->getErrorBuffer());
            return;
        }

        std::vector<char>* buffer = response->getResponseData();
        std::string jsonStr(buffer->begin(), buffer->end());

        Document doc;
        doc.Parse(jsonStr.c_str());
        if (doc.HasParseError()) {
            CCLOG("JSON parse error");
            return;
        }

        // 解析示例：{"max_level": 50, "difficulty": "hard"}
        if (doc.HasMember("max_level") && doc["max_level"].IsInt()) {
            int maxLevel = doc["max_level"].GetInt();
            CCLOG("Max level: %d", maxLevel);
        }
        if (doc.HasMember("difficulty") && doc["difficulty"].IsString()) {
            std::string difficulty = doc["difficulty"].GetString();
            CCLOG("Difficulty: %s", difficulty.c_str());
        }
    });

    HttpClient::getInstance()->send(request);
    request->release();
}

4.2 POST 请求示例（提交分数）

// PostScoreScene.cpp
#include "network/HttpClient.h"
#include "network/HttpResponse.h"
#include "json/document.h"
#include "json/writer.h"
#include "json/stringbuffer.h"
#include "cocos2d.h"

using namespace cocos2d::network;
using namespace rapidjson;

void PostScoreScene::submitScore(int score, const std::string& playerName) {
    auto request = new HttpRequest();
    request->setUrl("https://example.com/api/submitscore.php");
    request->setRequestType(HttpRequest::Type::POST);

    // 构造 JSON 请求体
    StringBuffer s;
    Writer<StringBuffer> writer(s);
    writer.StartObject();
    writer.Key("player");
    writer.String(playerName.c_str());
    writer.Key("score");
    writer.Int(score);
    writer.EndObject();
    std::string body = s.GetString();

    request->setRequestData(body.c_str(), body.length());
    std::vector<std::string> headers;
    headers.push_back("Content-Type: application/json; charset=utf-8");
    request->setHeaders(headers);

    request->setResponseCallback([this](HttpClient* sender, HttpResponse* response) {
        if (!response->isSucceed()) {
            CCLOG("POST request failed: %s", response->getErrorBuffer());
            return;
        }

        std::vector<char>* buffer = response->getResponseData();
        std::string jsonStr(buffer->begin(), buffer->end());
        Document doc;
        doc.Parse(jsonStr.c_str());
        if (doc.HasParseError()) {
            CCLOG("JSON parse error");
            return;
        }

        // 示例返回 {"status":"ok","rank":5}
        if (doc.HasMember("status") && doc["status"].IsString()) {
            std::string status = doc["status"].GetString();
            CCLOG("Submit status: %s", status.c_str());
        }
        if (doc.HasMember("rank") && doc["rank"].IsInt()) {
            int rank = doc["rank"].GetInt();
            CCLOG("Player rank: %d", rank);
        }
    });

    HttpClient::getInstance()->send(request);
    request->release();
}

5. 原理解释

1. HTTP 请求创建：通过 new HttpRequest()设置 URL、方法、数据与头。
2. 发送请求：HttpClient::getInstance()->send(request)异步执行。
3. 回调处理：在 Lambda 中解析 HttpResponse，获取数据并转为字符串。
4. JSON 解析：使用 rapidjson 的 Document解析字符串并检查成员与类型。
5. 内存管理：请求对象使用后必须 release()。

6. 核心特性

7. 原理流程图

graph TD
    A[创建 HttpRequest] --> B[设置 URL/Method/Data/Header]
    B --> C[HttpClient::send()]
    C --> D[异步网络线程发送请求]
    D --> E[服务器返回 Response]
    E --> F[回调函数中获取 Data]
    F --> G[转为 std::string]
    G --> H[rapidjson 解析 JSON]
    H --> I[业务逻辑处理]

8. 环境准备

• Cocos2d-x v3.x/v4.x（含 network 模块）
• 链接库：libnetwork, libcurl（Windows/Mac/Linux/iOS/Android 需对应编译）
• 引入头文件：

#include "network/HttpClient.h"
#include "network/HttpResponse.h"
#include "json/document.h"
#include "json/writer.h"
#include "json/stringbuffer.h"

• Android 需在 AndroidManifest.xml添加网络权限：

<uses-permission android:name="android.permission.INTERNET"/>

9. 实际详细应用代码示例实现

综合示例：登录验证（POST + JSON）

// LoginScene.cpp
#include "network/HttpClient.h"
#include "network/HttpResponse.h"
#include "json/document.h"
#include "json/writer.h"
#include "json/stringbuffer.h"
#include "cocos2d.h"

using namespace cocos2d::network;
using namespace rapidjson;

void LoginScene::attemptLogin(const std::string& user, const std::string& pass) {
    auto request = new HttpRequest();
    request->setUrl("https://example.com/api/login.php");
    request->setRequestType(HttpRequest::Type::POST);

    // JSON 请求体
    StringBuffer s;
    Writer<StringBuffer> writer(s);
    writer.StartObject();
    writer.Key("username");
    writer.String(user.c_str());
    writer.Key("password");
    writer.String(pass.c_str());
    writer.EndObject();
    std::string body = s.GetString();

    request->setRequestData(body.c_str(), body.length());
    std::vector<std::string> headers;
    headers.push_back("Content-Type: application/json; charset=utf-8");
    request->setHeaders(headers);

    request->setResponseCallback([this](HttpClient* sender, HttpResponse* response) {
        if (!response->isSucceed()) {
            CCLOG("Login failed: %s", response->getErrorBuffer());
            return;
        }

        std::vector<char>* buffer = response->getResponseData();
        std::string jsonStr(buffer->begin(), buffer->end());
        Document doc;
        doc.Parse(jsonStr.c_str());
        if (doc.HasParseError()) {
            CCLOG("JSON parse error");
            return;
        }

        if (doc.HasMember("success") && doc["success"].IsBool() && doc["success"].GetBool()) {
            CCLOG("Login success!");
            if (doc.HasMember("token") && doc["token"].IsString()) {
                std::string token = doc["token"].GetString();
                CCLOG("Token: %s", token.c_str());
                // 保存 token 供后续请求使用
            }
        } else {
            CCLOG("Login failed by server");
        }
    });

    HttpClient::getInstance()->send(request);
    request->release();
}

10. 运行结果

• GET 请求成功打印配置信息。
• POST 提交分数返回排名。
• 登录成功获取 Token。
  控制台输出示例：

Max level: 50
Difficulty: hard
Submit status: ok
Player rank: 5
Login success!
Token: abcdef123456

11. 测试步骤以及详细代码

1. 确保服务器接口可访问（本地可用 Node.js/PHP 模拟）。
2. 在 Cocos2d-x 项目中加入上述代码文件。
3. 在场景 onEnter()或按钮事件中调用对应函数。
4. 运行并查看日志输出。

12. 部署场景

• 移动端游戏：iOS/Android 打包需开启网络权限。
• PC/Web：确保防火墙允许出站 HTTP。
• 模拟器：注意 localhost 与真机 IP 区别。

13. 疑难解答

14. 未来展望

• 使用 WebSocket​ 替代轮询实现实时通信。
• 结合 RESTful API​ 架构统一管理资源。
• 加密传输（HTTPS + Token 鉴权）。

15. 技术趋势与挑战

• 趋势：HTTP/2、QUIC 提升速度与连接复用；JSON 向 MessagePack 等二进制格式过渡以提升性能。
• 挑战：弱网环境下超时与重试机制；跨平台证书管理。

16. 总结