互动状态的实现指南腾讯科技（深圳）有限公司2004年11月3日目录一、用户的状态获取-3-1、获取单个用户的状态:-3-2、获取多个用户的状态-4-二、点击用户的状态给用户发送消息-5-三、互动状态的接口参考-9-1、复杂接口（含有点击操作的）-9-2、简单接口（无点击操作）-10-1）返回在线状态图片-10-2）返回在线状态文字-10-四、ASP应用实例-11-1、ASP的应用环境-11-2、ASP实例详解-11-1）应用场景-11-2）技术方案-12-3）编码实现-12-A、访问数据库-12-B、编写网页元素-13-一、用户的状态获取在您开发的互动空间程序中，有时需要查询某个QQ用户或某批QQ用户的在线状态，腾讯公司为此提供了一个简便的接口，该接口是一个URL地址。根据获取单个和多个的不同，该URL地址有所不同，服务器返回的形式也有所不同。注意，该URL地址是大小写敏感的。目前只返回在线和离线两种状态，注意，没有离开状态和隐身状态，当用户处于离开状态时，视同在线；当用户处于隐身状态时，视同离线状态。1、获取单个用户的状态:获取单个用户的状态的URL地址是：http:/webpresenee.qq.com/getonline?Type=1&qq=3621277&resulttype=3后三项您可以随意定制，具体含义为：Type项：对于获取单个用户的情况，是保留项，可以填写任意值或者不要该项http:/webpresenee.qq.com/getonline?qq=3621277&resulttype=3qq项：代表您要查询的QQ用户的号码；resulttype项：表示您希望获得的是QQ还是TM的状态，值为1代表返回的是TM类型的状态，值为3代表返回的是QQ类型的状态。把上述URL地址拷贝到IE的地址栏，回车，返回的页面显示如下值：document.write(imgsrc=http:/219.133.40.106/qq1_offline.gifborder=0)可见，这个查询的返回结果是一条显示某个图片的命令，http:/219.133.40.106/qq1_offline.gif就是表示图片所在的位置以及文件名，不同的图片代表了不同的状态。根据您填写的resulttype的值不同，用不同的图片代表不同的状态，具体如下表：表1状态一览表Resulttype的值图片文件名代表的含义1tn盅鱷tm_offline.gifTM用户离线1I同TMWfil11tm_online.gifTM用户在线2Q老板留言rtx_offline.gifs-buddy用户离线2Q即时诰谈rtx_online.gifs-buddy用户在线3qq1_offline.gifQQ用户离线3qq1_online.gifQQ用户在线0或4qq_offline.gifQQ用户离线0或4qq_online.gifQQ用户在线下面是一段获取单个用户的在线状态的完整示例代码：示例网页这里显示的是QQ用户的状态，如果要更新，请刷新网页。TM:3621277的在线状态从上面的代码可以看出，获取状态的命令是这句话：服务器返回命令是：document.write(imgsrc=http:219.133.40.106/qq1_offline.gifborder=0)该命令执行的结果将会在获取状态的命令的位置绘制一个图片，以代表客户的在线状态2、获取多个用户的状态获取多个用户状态的URL地址是：http:/webpresence.qq.com/getonline?Type=1&154195734:240285461:14137743其中Type=1是表示获取多个用户的状态，“Type=1&”后面紧跟着的是您要查询的用户的QQ号码，各个号码之间必须用冒号“：”隔开，并且必须以冒号“：”结尾。把上述URL地址拷贝到IE浏览器的地址栏中，回车，可以看到返回结果是:online0=0;online1=1;online2=0;您可以在网页中编写脚本来读取这些返回结果，编写时，您必须声明一个名为online的数组，用于读取你所要查询的QQ用户的状态。online数组中的序号0，1，2的值分别对应URL地址中的先后QQ号码，数组的值0表示离线，1表示在线。按照上面的例子则：online0=0表示154195734用户离线；online1=1表示240285461用户在线；online2=0表示14137743用户离线。根据这些返回值，您可以用图标显示他们的状态，这些图标都在http:/219.133.40.106/地址下，具体的文件名以及他们所代表的图片及含义请参见“表1状态一览表”。脚本示例代码：varonline=newArray();if(online0=0)document.write(imgSRC=http:/219.133.40.106/qq_offline.gifV);elsedocument.write(imgSRC=http:/219.133.40.106/qq_online.gif);1、点击用户的状态给用户发送消息在所显示的状态图标上，可以编写脚本，使鼠标点击该图标弹出给该用户发送消息的窗口，达到实时沟通的效果。前提是：您的机器必须安装了QQ或TM，如果您的QQ或TM还没启动,会提示您先启动，提示如下:ij蠶篥鬻錨點矍露留黑功能.y您现在要启动购吗？例如，在网页上显示了以下图标:I点击发毘消息给对方点击后，将出现以下会话窗口:在显示图标的标签IMG啲响应函数里的相应参数上填写如下参数：tencent:/Message/?Menu=yes&Exe=tm&Uin=259966199该参数大小写不敏感，其中Uin项表示要与之会话的QC用户的号码；Menu及Exe项的含义如下：名4參数值说明QYes/HOp当有多个QQ/BI启动时，是否出现UIN耒单进行选择匸没有此参数时不出规选扌罩T而是竊近运行的QQ/TN-QQ/W启动TM还是d没有此参数时启动最近运行的程序，如果没有运行，则启动脚本示例：vscriptIanguage=javascriptfunctionSendMsg(sUrl)try/支持varxmlhttp=newActiveXObject(TimwpDII.TimwpCheck);this.location.href=sUrl;catch(e)/不支持returnfalse;imgSRC=http:/219.133.40.106/qq_online.gifalt=点击发送消息给对方onClick=SendMsg(Tencent:/Message/?Menu=YES&Exe=QQ&Uin=14137743)完整的示例代码如下：获取互动状态及实时发送消息示例functionSendMsg(sUrl)try支持varxmlhttp=newActiveXObject(TimwpDll.TimwpCheck);this.location.href=sUrl;catch(e)/不支持alert(您没有安装QQ/TM或者您的版本过旧，请到腾讯网站下载);window.location=http:/www.qq.com;returnfalse;varonline=newArray();K购物熟悉香港赛马的请进QQ:14137743if(online0=0)document.write();elsedocument.write();6-1111:57K体育6月12日天涯泡泡队比赛取消!TM:240285461if(online1=0)document.write(imgSRC=http:/219.133.40.106/tm_offline.gifalt=点击发送离线消息onClick=SendMsg(