使用LumaQQ来开发QQ机器人

自从博客园闪存发布了QQ机器人以后，闪存数量一下子就上升了很多。很多人也一直都在询问QQ机器人是如何开发的，这足以说明QQ在中国不仅仅是普通人使用的IM工具，在程序员圈子里也相当有人缘的，其老大地位不容怀疑啊。我这篇也算是给解答一些朋友的疑惑吧。
　
　　所谓的IM机器人（QQ，MSN），其实就是一个简化版的IM客户端（QQ，MSN）。利用这个简单的客户端连接到IM服务器，接收和发送消息来达到自动回复的目的。可惜，。NET中并没有开源的QQ机器人的开发包（MSN，有DotMSN，详见《使用DotMSN 2.0开发MSN机器人》）。博客园使用的是商业组件，而对大部分人来说更希望是免费的。。NET中没有开源开发包，但是JAVA中却有。在Liunx等其它非Windows 平台下，会有很多的开源QQ，其中的LumaQQ也算是比较有名的开源QQ了，你可以从它的官方主页上了解更多的信息。在网络上也已经有人根据LumaQQ的协议，使用C #来开发机器人了。遗憾的是，没有一个是开源的。没有也罢，那我们就直接使用JAVA版本来的LumaQQ来开发自己的机器人吧。
　
　　其实使用JAVA语法，对于我们来说并不是一件难事。我想大家主要的麻烦就在于如何去使用JAVA的开发工具，引用LumaQQ的包，以及编译，调试，打包和部署。但这些在这里都不是难事，我会提供引用好了点整个的Eclipse解决方案（工作空间）。你下载了，直接在这个空间下开发编辑源代码即可。下面先来说说简单的原理。

原理部分

　　这个机器人，我们直接开发一个一直运行的机器人即可。如果你对JAVA本身并不是很了解的话，那么我建议QQ机器人本身只提供一个QQ客户端收发信息的作用，并不将机器人逻辑写在这个机器人客户端里面，把机器人逻辑写到一个WebService中。一方面你可以用你最擅长的语言来开发 WebService；一方面，如果你需要多种平台的机器人（MSN机器人等）这部分的逻辑是可以公用的，而不需再次去开发测试这部分。

代码部分

　　关于LumaQQ接口开发机器人，网上已经有很多的代码了，我也是从网上直接拷贝的代码下来的。最关键的代码有以下两部分：

C ODE 1：设置参数，登录代码

原理部分

代码部分

　　关于LumaQQ接口开发机器人，网上已经有很多的代码了，我也是从网上直接拷贝的代码下来的。最关键的代码有以下两部分：

C ODE 1：设置参数，登录代码

view plain copy to clipboard print ?

1 : private void connect() 2 : { 3 : try 4 : { 5 : client = new QQClient(); 6 : client.addQQListener( this ); 7 : client.setConnectionPoolFactory( new PortGateFactory()); 8 : user = new QQUser( 739330764 , "qqrobot" ); 9 : user.setStatus(QQ.QQ_LOGIN_MODE_NORMAL); 10 : 11 : client.setUser(user); 12 : //TCP 登录 13: user.setUdp(false); 14: client.setTcpLoginPort(8000); 15: client.setLoginServer("219.133.48.103"); 16: //UDP 登录 17: //user.setUdp(true); 18: //clent.setLoginServer("sz.tencent.com"); 19: 20: //client.setProxyType("Socks5"); 21: // client.setProxy(new InetSocketAddress("AF25",1080)); 22: 23: client.login(); 24: } 25: catch (Exception ex) 26: { 27: ex.printStackTrace(); 28: //client.release(); 29: } 30: }

分代码里面提供了两种方式：TCP和UDP来登录到服务器。大家都知道QQ直接这两种方式的登录，但是需要使用不同的服务器地址。

CDOE 2：事件处理代码

view plain copy to clipboard print ?

1 : public void qqEvent(QQEvent e) 2 : { 3 : switch (e.type) 4 : { 5 : case QQEvent.QQ_LOGIN_SUCCESS: 6 : msg( "QQ_LOGIN_SUCCESS" ); 7 : break ; 8 : case QQEvent.QQ_LOGIN_FAIL: 9 : msg( "QQ_LOGIN_FAIL" ); 10 : msg( "reconnect" ); 11 : connect(); 12 : // client.release(); 13: //System.exit(0); 14: break; 15: case QQEvent.QQ_LOGIN_UNKNOWN_ERROR: 16: msg("QQ_LOGIN_UNKNOWN_ERROR"); 17: msg("reconnect"); 18: connect(); 19: // client.release(); 20: //System.exit(0); 21: break; 22: case QQEvent.QQ_LOGIN_REDIRECT_NULL: 23: msg("QQ_LOGIN_REDIRECT_NULL"); 24: msg("reconnect"); 25: connect(); 26: // client.release(); 27: //System.exit(0); 28: break; 29: case QQEvent.QQ_CONNECTION_LOST: 30: msg("QQ_CONNECTION_LOST"); 31: msg("reconnect"); 32: connect(); 33: // client.release(); 34: //System.exit(0); 35: break; 36: case QQEvent.QQ_NETWORK_ERROR: 37: msg("QQ_NETWORK_ERROR"); 38: msg("reconnect"); 39: connect(); 40: // client.release(); 41: //System.exit(0); 42: break; 43: case QQEvent.QQ_CONNECTION_BROKEN: 44: msg("QQ_CONNECTION_BROKEN"); 45: msg("reconnect"); 46: connect(); 47: // client.release(); 48: //System.exit(0); 49: break; 50: case QQEvent.QQ_RECEIVE_TEMP_SESSION_IM: 51: SimpleDateFormat tempDate = new SimpleDateFormat("MM- dd HH:mm"); 52: impacket = (ReceiveIMPacket) e.getSource();& lt;br> 53: qqnum = impacket.tempSessionIM.sender;<br& gt; 54: immsg = new String(impacket.tempSessionIM.message);& lt;br> 55: msg(" [" 56: + tempDate.format(new Date(impacket.tempSessionIM.time)) 57: + "] " + qqnum + ":" + immsg); 58: addFriend(qqnum); 59: msg(" 临时回复"); 60: client.sendIM(qqnum, Util.getBytes(" 对不起:" + impacket.tempSessionIM.nick + "，GK助手暂时还不支持临时会话，请先将我加为好友，然后在正常聊天窗体与我聊天,这样我才能帮助你。:)")); 61: break; 62: case QQEvent.QQ_RECEIVE_NORMAL_IM:// 收到正常消息 �? 63: SimpleDateFormat sdf = new SimpleDateFormat("MM- dd HH:mm"); 64: impacket = (ReceiveIMPacket) e.getSource();& lt;br> 65: qqnum = impacket.normalHeader.sender;<br& gt; 66: immsg = new String(impacket.normalIM.messageBytes);& lt;br> 67: msg(" [" 68: + sdf.format(new Date(impacket.normalHeader.sendTime)) 69: + "] " + qqnum + ":" + immsg); 70: if (impacket.normalIM.replyType != QQ.QQ_IM_AUTO_REPLY)& lt;br> 71: { 72: msg("好友:" + qqnum +"请求信息:" + immsg ); 73: client.sendIM(qqnum, Util.getBytes(immsg)); 74: } 75: //if (immsg.trim().equalsIgnoreCase("exit")) 76: // { 77: // System.out.println(qqnum + " 命令你�退出"); 78: // client.logout(); 79: // client.release(); 80: // System.exit(0); 81: // } 82: break; 83: case QQEvent.QQ_ADDED_BY_OTHERS: // 事件发生在有人将我加为好友时 84: case QQEvent.QQ_ADDED_BY_OTHERS_EX:// 事件发生在有人将我加为好友时 85: msg("QQ_ADDED_BY_OTHERS_EX"); 86: snpacket = (SystemNotificationPacket) e.getSource();& lt;br> 87: qqnum = snpacket.from;<br& gt; 88: msg(qqnum + "把我加为了好友 �?"); 89: client.sendIM(qqnum, Util.getBytes("hello.")); 90: break; 91: case QQEvent.QQ_REQUEST_ADD_ME:// 事件发生在有人请求加我为好友 �? 92: case QQEvent.QQ_REQUEST_ADD_ME_EX:// 事件发生在有人请求加我为好友 �? 93: msg("QQ_REQUEST_ADD_ME_EX"); 94: snpacket = (SystemNotificationPacket) e.getSource();& lt;br> 95: qqnum = snpacket.from;<br& gt; 96: msg(qqnum + "想加我为好友 �");// 1675103 97: client.approveAddMe(qqnum); 98: addFriend(qqnum); 99: break; 100: case QQEvent.QQ_ADD_FRIEND_NEED_AUTH: 101: AddFriendExReplyPacket packet = (AddFriendExReplyPacket)e.getSource();& lt;br> 102: qqnum = packet.friendQQ;<br& gt; 103: sendAddFriendAuth(qqnum); 104: break; 105: case QQEvent.QQ_REQUEST_ADD_OTHER_APPROVED:// 事件发生在有人请求加我为好友时，我同意并且加他为好友 106: msg("QQ_REQUEST_ADD_OTHER_APPROVED"); 107: break; 108: case QQEvent.QQ_REQUEST_ADD_OTHER_APPROVED_AND_ADD:// 事件发生在有人请求加我为好友时，我同意并且加他为好友 109: msg("QQ_REQUEST_ADD_OTHER_APPROVED_AND_ADD"); 110: break; 111: case QQEvent.QQ_REQUEST_ADD_OTHER_REJECTED:// 事件发生在我请求加一个人，那个人拒绝 �? 112: snpacket = (SystemNotificationPacket) e.getSource();& lt;br> 113: msg(snpacket.from 114: + " 拒绝加我为好友�?理由为：" 115: + ((snpacket.message == null || snpacket.message& lt;br> 116: .equals("")) ? "�?" : snpacket.message)); 117: break; 118: case QQEvent.QQ_KICKED_OUT_BY_SYSTEM: 119: msg("QQ 在别处登录了,重新登录."); 120: connect(); 121: break; 122: default : 123: msg(e.type); 124: break; 125: } 126: }

大家看到了LumaQQ里面的事件处理看起来似乎比较原始了一点。但是没关系，它是确实可用的。LumaQQ里面支持的QQ事件协议都在QQEvent中已经有定义了，同时不同的事件，它的事件参数e.getSource（）都是不同类型的对象。比如接收到正常消息，它的事件枚举是 QQEvent.QQ_RECEIVE_NORMAL_IM，e.getSource（）的类型是ReceiveIMPacket.你把这个对象转换成 ReceiveIMPacket类型后，就可以得知是谁发送的什么样的消息了。这时候你就可以调用client.sendIM方法来回复消息了。至于回复什么，就是你的机器人要做的事件了，它里可以调用WebService，也可以把业务逻辑直接写在这边。

　　还有就是断点重连，LumaQQ已经可以保证长时间在线了。但是我们也要有断线重连的功能，这个在例子中也已经有了。还有其它的事件和接口我就不详细介绍了，因为我个人对JAVA的了解也不够多。下面再来介绍一下Eclipse的打包吧，这也是一个比较麻烦的地方，没有同事的帮忙我也是一时半会儿也搞不定。　

编译，打包部分

　　同事给我的是装有ObjectWeb Lomboz插件的eclipse，我还必须要说明一下，我的eclipse目录是在：D：\Program Files\ecplise ，因为它有可能影响到一些包的引用和编译。它的启动界面是这样的：

图一：

　　大家下载完附件的示例代码后，在文件菜单下点击"Switch Workspace"选择解压后的目录。就可以打开解决方案了（工作空间），里面会有三个工程：LumaQQ是QQ协议工程，LumaQQ.net 是LumaQQ负责网络连接部分的工程代码，robot是QQ机器人工程。如果你要在eclipse里面运行或调试机器人，点击QQRobot.java右键在菜单中选择RunAs或DebugAs Java Applcation就可以运行或调试了：

图二：

　　更多的调试技巧我就不多介绍了。下面来介绍打包吧。eclipse要打包成控制台程序那也不是一件容易的事情。要先将这个解决方案导出成jar包：File --- Export 选择Java 目录下的JAR File：

图三：

把三个工程都选择起来，选择包存放的路径和包的文件名：

图四：

　　一路Next或者直接Finish，可能是弹出警告提示，看不懂也不用管它。转到你刚才包的保存路径，正常情况下，你可以看到你刚才保存的文件名.jar这么一个文件。接下来的工作就是把这个jar打包成exe控制台程序了。这还得借助于另一个工具的帮忙，我使用的是exe4j，你从网络上去下载就可以了。不过它是共享软件，非注册版本打包的exe在运行前会弹出一个提示，告诉你是这个exe是用什么打包的。宣传一下，有点讨厌。

　　打包exe，需要创建exe4j的工程文件。还有一个麻烦的就是要指定它所引用的所有第三方包的路径，而且设置输出路径，版本，运行环境等等这么信息。为了方便起见，我也把这个文件放在附件的示例中了。安装了exe4j后就可以打开这个文件了，打开了点击Finish就在编译了。

图五：exe4j工程文件

图六：引用的第三方包

图七：编译中

　　经过这一系列的步骤后，你所得到的exe文件，就是一个可用的控制台程序了。这时候除了JRE外，不需要其它的插件的支持了。

写在最后

　　做为一个.NET平台的开发人员，以上的步骤对我们来说确实是太过于烦杂了。在寒冬季节我写这样的一篇文章都快要满头大汗了，我相信各位看官如果能坚持看到这里那么你一定是非常有耐力了。但是没有办法，我们需要忍受。如果有时间，有精力，我还是很愿意以LumaQQ为样本，开发一个开源的QQ开发包，这样大家就不用再这么麻烦了。