Default

Developing MSN/WLM Add-in Part.I

微软的Messenger SDK分为面向多人应用的Activity SDK和面向单人应用的 Add-in SDK（Windows Live Messenger Add-In API）。不过Live时代的WLM Add-In SDK相较于之前的MSN Messenger API，开放的接口反而少了。自微软实行.NET战略以来，Windows平台应用程序开发的主流逐渐由以往的VC++与Platform SDK搭配的方式转由.NET Framework与C#。然则.NET Framework由于设计的目的与一般普适的Platform SDK并不完全一致或者包容后者，在开发许多real world scenario 下的具体应用时，仍需要依赖Inter OP来使用现有COM组件的接口（关于.NET的本质是COM的论述，实际上也有不少相关文章可供参考，读者可自行利用谷歌雅虎百度搜寻，亦可于水木社区dotNET讨论区的精华文章中寻找。）

事实上，无论是新的WLM SDK，或者旧的Messenger API，皆是安装有WLM后才注册在系统中的COM组件。而WLM Add-in与MSN Messenger API最大的不同，就是开发语言必须是基于.NET Framework 2.0的C#，C++/CLI，VB#，J#，抑或IronPython等脚本语言。本文将会以一个实际的例子来探讨如何以C#来开发WLM的 Add-In。

要启用插件功能，首先需要修改注册表项。在HKCU\Software\Microsoft\MSNMessenger新建DWORD项，名为AddInFeatureEnabled，值设置为1。或者将以下四行文本存为reg文件导入。




Windows Registry Editor Version 5.00





[HKEY_CURRENT_USER\Software\Microsoft\MSNMessenger]


“AddInFeatureEnabled”=dword:00000001

修改了注册表之后，登录WLM，在Option菜单中就会出现Add-ins选项，点击Add to Messenger，找到Add-In dll就可以加载了

打开VS 2005（亦可使用Visual C# 2005 Express Edition），建立Class Library工程，名为WLMAddintest，添加引用Messenger API（Project，Add Reference，COM，Messenger API Type Library），添加引用Messenger Client（Project，Add Reference，Browse，C:\Program Files\MSN Messenger\MessengerClient.dll）。

将CS文件改名为test.cs，并新建一个名为TestFrm的新窗体。

更改输出assembly的文件名为WLMAddintest.Test（Project，WLMAddintest Properties，Application，Assembly Name）。因为WLM Add-In对于文件名有着严格的限制，必须是namespace.classname.dll的方式，否则将不能加载。当然你可以使用匿名命名空间，这样就可以只生成test.dll让WLM加载。

Frame代码先省略，其中test.cs代码如下：




using System;


using System.Collections.Generic;


using System.Text;


using System.Windows.Forms;


using Microsoft.Messenger;





namespace WLMAddintest


{


public class Test: IMessengerAddIn


{


public MessengerClient m_client;


public Form frm;


public void Initialize(MessengerClient client)


{


m_client = client;


m_client.Shutdown += new EventHandler(this.Shutdown);





m_client.AddInProperties.Url = new Uri(“http://dev.feuvan.net/“);


m_client.AddInProperties.FriendlyName = “test add-in”;


frm = new TestFrm();


frm.Show();


}


public void Shutdown(object sender, EventArgs e)


{


frm.Close();


}


}


}

在以上部分代码中，我们建立了一个名为test的类，实现了IMessengerAddIn接口，而Initialize则是Add-In的入口。另外我们绑定了Shutdown事件，Shutdown事件是在Add-In被unload，用户登出WLM或者关闭WLM发生的。读者可以使用VS的Object Browser来浏览MessengerClient提供的接口（选中Reference中的MessengerClient，双击或者右键View in Object Browser）。

MessengerClient类共有五种事件，皆可绑定到自己定义的事件响应函数上。





















事件



事件描述



参数描述



EventHandler
IncomingTextMessage



文本消息传入时发生



IncomingTextMessageEventArgs有两个属性


string TextMessage和User UserFrom



EventHandler
OutgoingTextMessage



文本消息传出时发生



OutgoingTextMessageEventArgs有两个属性


string TextMessage和User UserTo



EventHandler
ShowOptionsDialog



用户点击Add-In的Settings时发生



N/A



EventHandler
Shutdown



Add-In被unload时发生



N/A



EventHandler
StatusChanged



有用户的状态改变时发生，如登入登出。



StatusChangedEventArgs有一个属性


User User

其中User类的属性有昵称，email，个人状态信息，状态，唯一ID，并有一个方法GetGroupNames，可以得到用户所在的组名。

MessengerClient类有三种属性：















属性



限制



作用



AddInProperties
AddInProperties



读写



设置Add-In的信息如名称，作者，描述，URL等



User
LocalUser



只读



当前登录用户的属性，包括昵称，email，个人状态信息，状态，唯一ID



string
SavedState



读写



提供Add-In存储空间。


由于WLM Add-In的安全限制，Add-In不能访问本地文件。所以配置等信息可以串行化之后保存在SavedState变量中，下次启动从这里读取。

MessengerClient类有三个方法：











方法



作用



void
SendActionMessage(string
actionText, **Microsoft.Messenger.User
userTo)



发送动作

void SendNudgeMessage(Microsoft.Messenger.User
userTo)



发送震动信息

void SendTextMessage(string
text, **Microsoft.Messenger.User
userTo)



发送文本

至于这里的User参数，基本上都是相应IncomingTextMessage的时候传进来的UserFrom参数。例如：




void messenger_IncomingTextMessage(object sender, IncomingTextMessageEventArgs e)


{


Microsoft.Messenger.User from = (Microsoft.Messenger.User)e.UserFrom;


messenger.SendTextMessage(output, from);


}

从上面的例子我们可以看到，WLM Add-In SDK还是很弱的，基本上只能拿来写机器人用，当然了，现在MSN机器人层出不穷，也不新鲜了。

接下来，就让我们来看看Messenger API能干点什么，以及更高级的话题。

后续内容更精彩，敬请继续关注。

see also: Developing MSN/WLM Add-in Part.II