有关libeva的使用说明 - 登录和登出操作

点击打开链接

有关libeva的使用说明 - 登录和登出操作

首先，需要简单说一下腾讯QQ2005beta1的登录过程。

第一步。向服务器索要登录令牌, 对应的libeva的封装类为RequestLoginTokenPacket
第二步。得到登录令牌后， 则尝试登录一个腾讯服务器。 登录包的对应封装为 LoginPacket
第三步。如果服务器返回的是, 登录回应包的封装为 LoginReplyPacket
   3。1 QQ_LOGIN_REPLY_OK(0x00)： 则说明登录成功
   3。2 QQ_LOGIN_REPLY_REDIRECT(0x01)：说明服务器要求你更改新的服务器重新登录
   3。3 QQ_LOGIN_REPLY_PWD_ERROR(0x05)：你的密码错误
   3。4 其他未知码： 意义不大了，其实我们只要上面三种情况就够了

   
现在，给出一个大概的编码逻辑，   这里还是假定网络部分已经实现

这里假定一个方法叫做send(OutPacket *p),是发送数据包的。内容大体如下
[code:1]
void send(OutPacket *p){
    char *data = new char[MAX_PACKET_SIZE];
    int len = MAX_PACKET_SIZE;
    
    p.fill(data, &len);
    
    doSend(data, len); // 这里换成你发送数据的方法
    
    delete []data;
    delete p;  // 注意如果p在之外还要用，就不要删了
}
[/code:1]
在用户输入用户名和密码以后，我们需要首先设置libeva中Packet的QQ号，
和密码密钥(password key，就是对密码做2次md5后的字串， 细节可以参考“libeva使用说明－发送和接收”文档)
假如用户的 QQ号为12345， 密码为11111， 那么密码密钥就是d545c63da029385e7f46806156f8f51d，
我们假设密码密钥在一个char型的数组 md5Pwd中，数组长度为16(注意密码密钥长度总是16)。
[code:1]
Packet::setQQ(12345); // 设置QQ号
Packet::setPasswordKey(md5Pwd); // 设置密码密钥
Packet::setUDP(true); // 这里设置是UDP登录。 参数为false就是TCP登录
[/code:1]

完成了这些准备工作，我们就可以请求登录令牌了
[code:1]
RequestLoginTokenPacket *packet ＝ new RequestLoginTokenPacket();
send(packet);
[/code:1]

这里说明一下，有关接收数据和判断数据的类型，在“libeva使用说明－发送和接收”
中已经说明，就不再重复了。

这里假定分析登录令牌的回复方法如下
[code:1]
void processRequestLoginTokenReply(const InPacket *in)
{
        RequestLoginTokenReplyPacket *packet = new RequestLoginTokenReplyPacket();
        packet->setInPacket(in);
        packet->parse(); // 解析一下就可以了， 这个类会自动设置好loginToken
        delete packet;   // 释放点内存，这是个好习惯
        
        doLogin();  // OK， 有了登录令牌，我们就可以登录了。
}
[/code:1]
[code:1]
void doLogin()
{
    send(new LoginPacket(QQ_LOGIN_MODE_NORMAL));  // 这就足够了， 够简单吧， 要是隐身登录，
                                                  // 参数换成QQ_LOGIN_MODE_INVISIBLE 就OK了
}
[/code:1]

现在我们来看看登录回应包的处理，
[code:1]
void processLoginReply(const InPacket *in)
{
        LoginReplyPacket *packet = new LoginReplyPacket();
        packet->setInPacket(in);
        if(!packet->parse()) {         // 我也不清楚是什么原因，有时候会出现解析失败，也许是网络的原因                               
                printf("parse error\n");  // 但是大家放心， 总会正确的， 多检查一下总是好的，^_^
                return;
        }
        switch(packet->getReplyCode())
        {
        case QQ_LOGIN_REPLY_OK:
                // 到这里的话，那就是登录成功， 恭喜你！
                break;
        case QQ_LOGIN_REPLY_REDIRECT:
                // 如果到这里，说明服务器要求你转到其他服务器登录
                // 登录服务器的IP通过 packet->getRedirectedIP() 来得到,
                //             这个IP是个以本地字节序排列在一个int里(4字节)
                // 服务器的端口通过 packet->getRedirectedPort() 来得到,
                //             这个就是一个short型， 16字节
                break;
        case QQ_LOGIN_REPLY_PWD_ERROR:
                // 如果到这里则，说明你密码错误，而且服务器会返回一个“密码错误”之类
                // 的字符串， 你可以printf出来， 注意所以服务器的字符串编码，如果没有
                // 特殊说明，都是GB编码， GBK， GB18030 都可以
                printf("password error:%s\n",packet->getReplyMessage().c_str());
                break;
        default:
                // 我还没有见过到这里的， 你要是到了这里，还请告诉我, ^_^
                printf("unknown reply code\n");
        }
}
[/code:1]

登录上了不是就完事了， 大概没隔1分钟，还是要向腾讯汇报一下，你还“活着”，否则，
腾讯服务器就不理你了，呵呵
[code:1]
   send(new KeepAlivePacket()); // 这样就可以了， easy？
[/code:1]

对于上面的保持在线的回应包，没有多大用处， 里面就是目前腾讯服务器在线总人数，什么的。
[code:1]
void processKeepAliveReply( const InPacket * in )
{
        KeepAliveReplyPacket *packet = new KeepAliveReplyPacket();
        packet->setInPacket(in);
        packet->parse(); // 以上三步都是固定套路， 也许，我以后把这个写到一个方法里
        numOnlineUsers = packet->numOnlineUsers(); // 通过这个方法就可以得到当前在线总人数了
}
[/code:1]

最后再说一下登出操作， 最简单就是这个了， 登出操作时，腾讯服务器是不会
回复的，只要扔4个一样的登出包给服务器就搞定了
[code:1]
        for(int i=0; i<4; i++)
                send(new LogoutPacket());

        // 现在已经登出腾讯服务器了，我们需要清理整个登录和会话
        // 过程中用到的所有的Key
        Packet::clearAllKeys();
[/code:1]


ok， 总算说差不多了，现在大家，可以自己写一个简单地客户端了吧，呵呵
大家好运。^_^

最后     再补充一下， 大家需要用eva 0.3.0 pre版中的 libeva 才行， 否则，
不灵的，呵呵， 就是登录的时候直接登就可以了，不需要什么登录令牌。

eva 0.3.0 pre 在这里去找把