在Webpage上调用Windows Messenger API

来源:百度文库 编辑:神马文学网 时间:2024/05/01 14:46:29
最近在工作中遇到一个在WebPage上调用Windows Messenger API的需求,于是到MSDN上大搜一番,还是有所收获。相关链接如下:http://www.microsoft.com/china/MSDN/library/WebServices/WebServices/nacwebteam09032001.mspx?pf=true
其中包含了一段MSN Instant Messenger代码。首先要提出的一个大家容易混淆的概念:Windows Messenger 与 MSN Messenger 到底有什么区别和联系?
·MSN Messenger不是系统自带的,而Windows Messenger在非Windows 2003的Microsoft系统上都已经作为默认组件安装,这里我们要使用到的就是Windows Messenger API
·MSN Messenger只能用.Net Passport这个微软统一身份验证来登陆,也就意味着它只能在一台联入了互联网的电脑上登陆使用。而Windows Messenger则有三种登陆方式:a. Exchange身份验证 b. .Net Passport身份验证 c. SIP身份验证。其中c. SIP身份验证不太常用。而现在很多企业都已经建立了内部Exchange服务器,这样就经常会采用Windows Messenger的Exchange身份验证来进行登录后内部员工IM联系。而如果使用b. .Net Passport身份验证则功能上与MSN Messenger完全一样。
·Windows Messenger可以同时使用三种身份验证登陆,换句话说就是我可以同时登陆企业内网的Windows Messenger IM以及互联网上的MSN Messenger。其中的联系人列表是整合的。就有点像MyIM能整合MSN以及QQ、Yahoo IM等等IM软件一样。而MSN Messenger不行
·MSN Messenger的聊天记录可以保存,且通讯功能更加强大,如最新的7.5版本“传情动漫”以及“手写”功能已经完全超越了QQ等同类IM软件。而Windows Messenger聊天记录在关闭聊天窗口后消失不自动保存,只集成了一些最基本的通信方式。可以算作是简化版的MSN Messenger
有了以上的信息,我们已经可以开始试验了。将MSDN上的那段MSN Instant Messenger代码复制到本地,保存成.html文件,用IE打开。嗯。一切正常。请看下图(由于本人在台企上班,公司要求使用繁体操作系统,请大家见谅):
图一

然后,我们把这个文件复制到wwwroot发布目录下。再通过http://172.18.77.60/  (我电脑的IP地址)前缀来访问。如下图所示:
图二

大家可以看到。同样一段代码。直接访问与发布后访问执行结果不同。我本想将此功能制作成一个WebPart以便在SharePoint上的任意地点引用。但是现在的问题是,只有我直接双击该html文件才能正常显示“联系人名单”,而我无论使用http://127.0.0.1/ 或者http://localhost/ 或者 http://我的电脑IP地址/ 三种方式访问,联系人列表都会发生错误。但是通过点击“undefined”链接是可以实现对话功能的,通过查看源代码得知,其是通过枚举id来实现的,所以这里仅仅是一个显示上的问题。
下面让我们来看看完整的代码,完全使用JavaScript调用Windows Messenger API来实现。
1
2
3   Embedding MSN Messenger Test
4
5   6   CODEBASE="#Version=2,0,0,83"
7      CODETYPE="application/x-oleobject" ID="oMsgrObj" WIDTH="0"
8      HEIGHT="0" OnUserStateChanged="alert();">
9   
10   11   CODETYPE="application/x-oleobject"
12      ID="oMsgrApp" WIDTH="0" HEIGHT="0">
13   
14
15   
37
38
39
40
41
42
43// Here are the definitions for the Messenger enumerated values we use
44
45var MSTATE_OFFLINE = 1;
46var MSTATE_ONLINE = 2;
47var MSTATE_BUSY = 10;
48var MSTATE_BE_RIGHT_BACK = 14;
49var MSTATE_IDLE = 18;
50var MSTATE_AWAY = 34;
51
52function body_onLoad()
53{
54   // First, we need to make sure that the Messenger controls got instantiated correctly
55
56   if ("undefined" != typeof(oMsgrObj) && null != oMsgrObj.object && "undefined"
57   != typeof(oMsgrApp) && null != oMsgrApp.object)
58   {
59      // If so, let‘s check to see if we‘re online and (if so) populate our contacts UI
60
61      if (oMsgrObj.LocalState == MSTATE_ONLINE)
62      {
63         populateContacts();
64      }
65      else if (oMsgrObj.LocalState == MSTATE_OFFLINE)
66      {
67         btnLogon.disabled = false;
68      }
69   }
70   else
71   {
72      // Uh, oh - the controls didn‘t get instantiated correctly;
73      // the user probably needs to install Messenger
74
75      alert("You need to install the latest version of MSN Messenger!\nGo to http://messenger.msn.com right now!");
76   }
77}
78
79function populateContacts()
80{
81   var oList = oMsgrObj.List(0);
82   var oContact;
83   var i;
84
85   // To populate our contact list, we‘re going to iterate throught the
86   // default list collection, check the state of each contact,
87   // and add a DIV with the approppriate appearance to our UI
88
89   for (i = 0; i < oList.Count; i++)
90   {
91      oContact = oList.Item(i);
92
93      oNewElement = document.createElement("DIV");
94      oNewElement.innerText = oContact.FriendlyName;
95
96      switch (oContact.State)
97      {
98      case MSTATE_ONLINE:
99         // Don‘t need to do anything
100         break;
101      case MSTATE_OFFLINE:
102         oNewElement.innerText += " (Offline)";
103         oNewElement.style.color = "graytext";
104         break;
105      case MSTATE_BUSY:
106         oNewElement.innerText += " (Busy)";
107         break;
108      case MSTATE_BE_RIGHT_BACK:
109         oNewElement.innerText += " (Be Right Back)";
110         break;
111      case MSTATE_IDLE:
112         oNewElement.innerText += " (Idle)";
113         break;
114      case MSTATE_AWAY:
115         oNewElement.innerText += " (Away)";
116         break;
117      default:
118         oNewElement.innerText += "(Just plain not around!)";
119         oNewElement.style.color = "graytext";
120         break;
121      }
122      oNewElement.className = "clsContact";
123
124      // To enable us to respond to the onclick event,
125      // we‘re programmatically setting the event
126      // handler AND we‘re defining an expando property
127      // on the contact DIV whose value is set to
128      // the index of the contact in the default list (so we can find them later)
129
130      oNewElement.onclick = sendMessage;
131      oNewElement.setAttribute("CONTACTID", i.toString());
132
133      divContacts.appendChild(oNewElement);
134   }
135}
136function doLogon()
137{
138   // To logon, we just ask Messenger to display its logon UI
139
140   if (oMsgrObj.LocalState == MSTATE_OFFLINE)
141   {
142      btnLogon.disabled = true;
143      oMsgrApp.LaunchLogonUI();
144   }
145}
146
147function sendMessage()
148{
149   // To send a message, we likewise just ask Messenger to do the heavy
150   // lifting (we just have to
151   // pass it a contact from the default list)
152
153   var nContactID = parseInt(window.event.srcElement.getAttribute("CONTACTID"));
154   if (!isNaN(nContactID))
155   {
156      var oContact = oMsgrObj.List(0).Item(nContactID);
157      oMsgrApp.LaunchIMUI(oContact);
158   }
159}
160
161
162
163
164
165if (hr == 0)
166{
167   if (oMsgrObj.LocalState == MSTATE_ONLINE)
168   {
169      // Now we‘re online
170
171      window.setTimeout("populateContacts();", 3000);
172   }
173   else if (oMsgrObj.LocalState == MSTATE_OFFLINE)
174   {
175      // Now we‘re offline
176
177      divContacts.innerHTML = "";
178      btnLogon.disabled = false;
179   }
180}
181
182
183
184Contacts (click on a contact to send a message!)

185186 MARGIN-BOTTOM: 8px; BORDER: 1px solid steelblue">

187
188
189
190
作为代码本身是很简单的,不用过多解释,整个实现的原理就是:首先new了两个Windows Messenger实例,分别为oMsgrObj以及oMsgrApp。然后通过对好友列表oList = oMsgrObj.List(0);循环枚举,并利用DOM技术塞入新的Element来列出好友名称oNewElement.innerText = oContact.FriendlyName; 以及好友状态switch (oContact.State)。最后通过function sendMessage()函数来实现OnClick事件,调用对应的Windows Messenger实例弹出好友对话框。整段代码是清晰明了也很容易懂的。这里我们主要看看造成上面图二错误的代码段:
function populateContacts()
{
   var oList = oMsgrObj.List(0);
   var oContact;
   var i;

   for (i = 0; i < oList.Count; i++)
   {
      oContact = oList.Item(i);

      oNewElement = document.createElement("DIV");
      oNewElement.innerText = oContact.FriendlyName;
其中由oList变量得到oMsgrObj的实例后枚举oList的各个Item并存放到oContact变量中。种种现象表明oMsgrObj以及oMsgrApp两个实例已经创建成功,否则无法调用其内部方法如 oMsgrObj.List(0) 以及 oList.Count,但是现在出问题的方法是 oContact.FriendlyName。图二现象表明如果使用IP访问该网页则 oContact.FriendlyName 方法无法正常得到联系人名称,所以会显示为 undefined。而直接通过IE打开该页面则一切正常。
我百思不得其解,同样的方法难道只能在本地使用?那这段HTML代码不就没有意义了吗?恳请各位大虾指点迷津。m(_  _)m 拜..
附Windows Messenger下载地址:
http://nj.onlinedown.net/soft/3366.htm
posted on 2005-09-26 11:17Viva 阅读(281)评论(1)  编辑 收藏收藏至365Key 所属分类:求助
Feedback
# re: 在Webpage上调用Windows Messenger API 2005-09-26 11:38Viva
补充一点,有些朋友说是安全性的问题,我已经把几个地址都加入“信任的网站”了,问题依旧。请看下图:


_xyz