引言

技术背景

1. Cocos2d-x 网络与数据层

• 跨平台网络：cocos2d::network::HttpClient支持 HTTP/HTTPS，适用于 RESTful 排行榜 API。
• 数据序列化：ValueMap/ValueVector或 JSON 字符串在客户端与服务端传递结构化数据。
• 多线程：网络请求在子线程执行，避免阻塞渲染。

2. 服务端常见架构

• 存储：Redis（实时排行 ZSET）+ MySQL（玩家成就存档）。
• 接口：RESTful API（GET 查榜，POST 上报分数/进度）。
• 安全：请求签名、频率限制、数据校验防刷榜。

应用场景

核心代码实现

1. 数据模型定义

// LeaderboardDef.h
#ifndef __LEADERBOARD_DEF_H__
#define __LEADERBOARD_DEF_H__

#include "cocos2d.h"
#include <string>
#include <vector>

USING_NS_CC;

// 成就定义
struct Achievement {
    std::string achId;      // 成就ID
    std::string title;      // 标题
    std::string desc;       // 描述
    int targetValue;        // 目标值（如通关数、得分）
    std::string reward;     // 奖励描述
    bool unlocked;          // 是否解锁
};

// 排行榜条目
struct RankItem {
    std::string playerId;
    std::string nickname;
    int score;
    int rank;
    std::string avatarUrl;
};

// 上报分数请求
struct SubmitScoreReq {
    std::string playerId;
    std::string sessionToken;
    std::string leaderboardId; // 如 "weekly_pvp"
    int score;
    long long timestamp;
    std::string sign; // 签名防篡改
};

// 查询排行榜请求
struct GetLeaderboardReq {
    std::string playerId;
    std::string sessionToken;
    std::string leaderboardId;
    int page; // 分页
    int pageSize;
    long long timestamp;
    std::string sign;
};

#endif // __LEADERBOARD_DEF_H__

2. 网络通信封装

// HttpManager.h
#ifndef __HTTP_MANAGER_H__
#define __HTTP_MANAGER_H__

#include "LeaderboardDef.h"
#include "network/HttpClient.h"
#include "network/HttpResponse.h"

class HttpManager {
public:
    static HttpManager* getInstance();
    void submitScore(const SubmitScoreReq& req, 
        const std::function<void(bool success, const std::string& msg)>& callback);
    void getLeaderboard(const GetLeaderboardReq& req,
        const std::function<void(bool success, const std::vector<RankItem>& ranks)>& callback);
    void getAchievements(const std::string& playerId, const std::string& token,
        const std::function<void(bool success, const std::vector<Achievement>& achievements)>& callback);

private:
    void onSubmitScoreCompleted(network::HttpClient* client, network::HttpResponse* response);
    void onGetLeaderboardCompleted(network::HttpClient* client, network::HttpResponse* response);
    void onGetAchievementsCompleted(network::HttpClient* client, network::HttpResponse* response);
};

#endif // __HTTP_MANAGER_H__

// HttpManager.cpp
#include "HttpManager.h"
#include "CryptoUtil.h" // 复用之前的签名工具
#include <json/document.h> // rapidjson 或类似库

USING_NS_CC;
using namespace network;

HttpManager* HttpManager::_instance = nullptr;

HttpManager* HttpManager::getInstance() {
    if (!_instance) _instance = new HttpManager();
    return _instance;
}

void HttpManager::submitScore(const SubmitScoreReq& req, 
    const std::function<void(bool, const std::string&)>& callback) {
    
    // 客户端预签名
    std::string data = StringUtils::format("%s|%s|%d|%lld", 
        req.playerId.c_str(), req.leaderboardId.c_str(), req.score, req.timestamp);
    SubmitScoreReq signedReq = req;
    signedReq.sign = CryptoUtil::generateSign(data, "http_secret");
    
    // 序列化 JSON
    rapidjson::Document doc;
    doc.SetObject();
    doc.AddMember("playerId", rapidjson::StringRef(signedReq.playerId.c_str()), doc.GetAllocator());
    doc.AddMember("leaderboardId", rapidjson::StringRef(signedReq.leaderboardId.c_str()), doc.GetAllocator());
    doc.AddMember("score", signedReq.score, doc.GetAllocator());
    doc.AddMember("timestamp", signedReq.timestamp, doc.GetAllocator());
    doc.AddMember("sign", rapidjson::StringRef(signedReq.sign.c_str()), doc.GetAllocator());
    
    rapidjson::StringBuffer buffer;
    rapidjson::Writer<rapidjson::StringBuffer> writer(buffer);
    doc.Accept(writer);
    
    HttpRequest* request = new HttpRequest();
    request->setUrl("https://api.game.com/leaderboard/submit");
    request->setRequestType(HttpRequest::Type::POST);
    request->setRequestData(buffer.GetString(), buffer.GetSize());
    request->setResponseCallback(CC_CALLBACK_2(HttpManager::onSubmitScoreCompleted, this));
    request->setUserData(&callback);
    HttpClient::getInstance()->send(request);
    request->release();
}

void HttpManager::onSubmitScoreCompleted(HttpClient* client, HttpResponse* response) {
    auto callback = static_cast<std::function<void(bool, const std::string&)>*>(response->getHttpRequest()->getUserData());
    if (!response->isSucceed() || !response->getResponseData()) {
        (*callback)(false, "Network error");
        delete callback;
        return;
    }
    std::string resStr((const char*)response->getResponseData()->data(), response->getResponseData()->size());
    // 解析 JSON 判断 success
    bool success = (resStr.find("\"success\":true") != std::string::npos); // 简化解析
    (*callback)(success, success ? "OK" : "Server reject");
    delete callback;
}

3. 成就系统管理

// AchievementManager.h
#ifndef __ACHIEVEMENT_MANAGER_H__
#define __ACHIEVEMENT_MANAGER_H__

#include "LeaderboardDef.h"

class AchievementManager {
public:
    static AchievementManager* getInstance();
    void loadLocalAchievements(); // 从本地缓存加载
    void syncWithServer(const std::string& playerId, const std::string& token);
    void updateProgress(const std::string& achId, int value);
    bool isUnlocked(const std::string& achId) const;
    const std::vector<Achievement>& getAchievements() const { return _achievements; }

private:
    std::vector<Achievement> _achievements;
    std::unordered_map<std::string, int> _progress; // achId -> 当前值
};

#endif // __ACHIEVEMENT_MANAGER_H__

// AchievementManager.cpp
#include "AchievementManager.h"
#include "LocalStorage.h" // 假设的本地存储工具

AchievementManager* AchievementManager::_instance = nullptr;

AchievementManager* AchievementManager::getInstance() {
    if (!_instance) _instance = new AchievementManager();
    return _instance;
}

void AchievementManager::loadLocalAchievements() {
    // 从文件/SQLite 加载
    _achievements = {
        {"ach_001", "初出茅庐", "完成第一关", 1, "金币+100", false},
        {"ach_002", "百发百中", "累计命中100次", 100, "钻石+10", false},
        {"ach_003", "速通大师", "180秒内通关", 1, "限定皮肤", false}
    };
    // 加载进度...
}

void AchievementManager::updateProgress(const std::string& achId, int value) {
    for (auto& ach : _achievements) {
        if (ach.achId == achId) {
            _progress[achId] += value;
            if (!ach.unlocked && _progress[achId] >= ach.targetValue) {
                ach.unlocked = true;
                // 弹窗提示
            }
            break;
        }
    }
}

4. UI 展示（排行榜场景）

// LeaderboardScene.cpp
#include "HttpManager.h"
#include "AchievementManager.h"

bool LeaderboardScene::init() {
    // ... 创建列表、刷新按钮等
    auto btnRefresh = Button::create("refresh.png");
    btnRefresh->addClickEventListener([this](Ref*) {
        GetLeaderboardReq req;
        req.playerId = _playerId;
        req.sessionToken = _token;
        req.leaderboardId = "weekly_pvp";
        req.page = 1;
        req.pageSize = 10;
        req.timestamp = std::time(nullptr);
        req.sign = CryptoUtil::generateSign(
            StringUtils::format("%s|%s|%d|%d|%lld", req.playerId.c_str(), req.leaderboardId.c_str(), req.page, req.pageSize, req.timestamp),
            "http_secret");
        
        HttpManager::getInstance()->getLeaderboard(req, [this](bool success, const std::vector<RankItem>& ranks) {
            if (success) {
                _rankList->removeAllItems();
                for (const auto& item : ranks) {
                    auto label = Label::createWithTTF(
                        StringUtils::format("%d. %s - %d", item.rank, item.nickname.c_str(), item.score),
                        "arial.ttf", 24);
                    _rankList->pushBackCustomItem(label);
                }
            }
        });
    });
    return true;
}

原理解释

1. 数据上报：客户端收集分数/进度 → 本地校验 → 签名 → HTTP POST 到服务端。
2. 服务端处理：校验签名与会话 → 写入 Redis ZSET（排行）或 MySQL（成就） → 返回结果。
3. 查询榜单：客户端 GET 带签名请求 → 服务端读取 Redis 前 N 名 → 返回 JSON → 客户端渲染列表。
4. 成就判定：客户端上报进度 → 服务端按规则（如时间≤180秒）判断是否解锁 → 下发给客户端。

核心特性

原理流程图

客户端操作 → 更新数据 → 本地校验+签名 → HTTP上报 → 服务端验证签名 → 更新存储(Redis/MySQL) → 返回结果
客户端查询 → 签名请求 → 服务端读取排行 → 返回JSON → 客户端渲染列表

环境准备

• Cocos2d-x 3.8+
• 网络库：cocos2d::network
• JSON 解析：rapidjson 或 cocos 自带
• 服务端：Node.js/Go/Java + Redis + MySQL

运行结果

• 提交分数成功：服务端返回 "success":true，排行榜实时刷新。
• 成就解锁：进度达标后 unlocked=true，客户端弹窗奖励。
• 离线同步：无网时本地记录，联网后批量上报并合并。

测试步骤

1. 刷榜测试：短时间内大量提交高分，服务端频率限制应拒绝后续请求。
2. 篡改测试：修改本地分数为极大值，服务端合理性校验应拒绝。
3. 离线同步：断网更新进度，联网后服务端应正确合并并判断是否解锁成就。

部署场景

• 手游：集成到 Cocos2d-x 项目，服务端用云函数或独立服务器。
• PC 网游：C++ 服务端模块，与游戏逻辑同进程。
• H5 游戏：Cocos Creator 导出，JS 版 HTTP 管理器。

疑难解答

• 签名失败：检查密钥、数据拼接顺序、编码（UTF-8）。
• 跨域问题（H5）：服务端配置 CORS。
• 数据不同步：客户端增加版本号，服务端冲突时以服务端为准。

未来展望

• 实时推送：WebSocket 推送排名变化，无需轮询。
• AI 推荐成就：根据玩家行为动态生成个性化成就。
• 区块链存证：排行榜哈希上链，防篡改与透明审计。

技术趋势与挑战

• 趋势：从静态成就到动态任务流，从中心化排行到区块链+IPFS 分布式排行。
• 挑战：海量并发下的实时排序性能，外挂刷榜与检测的平衡。

总结