微软 Windows Live Messenger 8.0 开放了其 add-ins 开发接口,尽管功能有限,有些实验性质,但我们依然可以做很多事情。诸如自动回复、消息加密、MSN Mini 群等等。
运行/开发环境:
1. Windows Live Messenger 8.0
2. Microsoft .NET Framework 2.0
3. Visual Studio.NET 2005 (可选)
安装 Messenger 后(最好不要使用绿色版本,可能会出错。),你会在其安装目录(C:\Program Files\MSN Messenger)中找到一个名为 "MessengerClient.dll" 的文件,这就是我们需要的。创建一个 Class Library 项目,引用该文件,在VS2005解决方案资源管理器中双击该引用名称打开对象浏览器,你就能找到我们的目标——IMessengerAddIn。
public interface IMessengerAddIn
{
void Initialize(MessengerClient messenger);
}
IMessengerAddIn 接口非常简单,我们要开发的 add-ins 必须实现该接口。Messenger 通过调用 Initialize() 传入 MessengerClient 对象并初始化 add-ins。
相关类型信息
public sealed class MessengerClient : MarshalByRefObject, IPlugInNotifyInternal, IDisposable
{
// 接收到消息时触发
public event EventHandler<IncomingTextMessageEventArgs> IncomingTextMessage;
// 发送消息前触发
public event EventHandler<OutgoingTextMessageEventArgs> OutgoingTextMessage;
// 显示设置对话框时触发
public event EventHandler ShowOptionsDialog;
// 关闭 Messenger 时触发
public event EventHandler Shutdown;
// 好友(buddy)或者本地用户(local user)状态发生改变时触发
public event EventHandler<StatusChangedEventArgs> StatusChanged;
// 发送动作消息(前面不会添加"某某人说"字样),如 SendActionMessage("小机器人眼睛乱转...", args.UserFrom);
public void SendActionMessage(string actionText, User userTo);
// 发送闪屏
public void SendNudgeMessage(User userTo);
// 发送文本消息
public void SendTextMessage(string text, User userTo);
// Add-ins 信息
public AddInProperties AddInProperties { get; set; }
// 本地用户信息
public User LocalUser { get; }
// Add-ins 用来保存状态信息的属性。该信息保存到注册表,可在下次启动时读取。
public string SavedState { get; set; }
}
public sealed class User
{
// 获取用户所在组。(一般用来获取好友所在的组,对本地用户没意义。)
public string[] GetGroupNames();
// 登录所用的 Email 账号。
public string Email { get; }
// 用户名称
public string FriendlyName { get; }
// 个人状态消息(就是在线状态下面你输入的那行用来搞怪的文字。:-) )
public string PersonalStatusMessage { get; }
// 在线状态
public UserStatus Status { get; }
// 唯一用户编号
public string UniqueId { get; }
}
public class AddInProperties
{
// 作者
public string Creator { get; set; }
// 详细说明
public string Description { get; set; }
// 名称
public string FriendlyName { get; set; }
// 启用 Add-ins 时,设置本地用户个人状态消息。
public string PersonalStatusMessage { get; set; }
// 启用 Add-ins 时,设置本地用户在线状态。
public UserStatus Status { get; set; }
// 暂时无用。
public Uri Url { get; set; }
// 设置本地用户显示图片。
public Image UserTile { get; set; }
}
---------------------
在开始编写我们自己的 Add-ins 之前,还有些工作要做。
1. Messenger Add-ins 缺省并没有被启用,我们需要修改注册表打开。在 "HKEY_CURRENT_USER\Software\Microsoft\MSNMessenger" 中新建 "AddInFeatureEnabled DWORD 1"。再次启动 Messenger,登录后你会在选项对话框中看到 "加载项",这就是装载 Add-ins 的地方。
2. Add-ins 对文件名有严格限制,文件名必须是实现 IMessengerAddIn 接口类的全限定名(Namespace.ClassName.dll)。可以在项目属性对话框中修改程序集名称,使其符合该要求。
OK,我们开始编写我们自己的 Add-ins。
using System;
using System.Collections.Generic;
using System.Text;
using Microsoft.Messenger;
namespace MyMessenger
{
public class Bot : IMessengerAddIn
{
MessengerClient msn;
public void Initialize(MessengerClient messenger)
{
msn = messenger;
msn.AddInProperties.Creator = "Q.yuhen";
msn.AddInProperties.Description = "Copyright (c) RainTrail Studio. China 2006";
msn.AddInProperties.FriendlyName = "自动回复机器人";
msn.AddInProperties.Status = UserStatus.Away;
msn.IncomingTextMessage += new EventHandler<IncomingTextMessageEventArgs>(OnIncommingMessage);
}
public void OnIncommingMessage(object sender, IncomingTextMessageEventArgs args)
{
msn.SendTextMessage("[自动回复] 我暂时不在,有事请留言,我会尽快回复。", args.UserFrom);
}
}
}
编译该项目,获取程序集文件 MyMessenger.Bot.dll。接下来我们装载并进行测试。
1. 打开Messenger,登录。打开选项对话框,在装载项中单击 "添加至 Messenger (D)..." 按钮。
2. 在选择文件对话框中选择 MyMessenger.Bot.dll。
3. Add-ins 被成功装载。要启动 Add-ins 有两种方法,第一种就是装载项对话框中的自动运行,另外就是在状态菜单中启动。
4. 找个朋友给你发条消息试试看。
--------------------------
上面的例子虽然很简单,只要发挥你的想象力还是可以做出很多东西的。
更详细的信息请查看MSDN文档《
Messenger Add-In API》(英文)。
点击下载
分享到:
评论