进入新公司需要新技能。以前从来没用过C#，但是现在的项目是Lync API开发，只能抓紧从头开始了。
网络上关于UCMA4的文章并不多，微软的网站上可能有不少，还有一些视频，不过并不适合入门。有一个视频除外，我也是从这个视频开始学的：http://channel9.msdn.com/posts/UCMA-Hello-World-Send-an-Instant-Message （UCMA Hello World - Send an Instant Message）
虽然入门教程不多，但是概念讲解的还不少。比如这个：http://www.cnblogs.com/vipyoumay/archive/2012/01/12/2320801.html
http://msdn.microsoft.com/library/office/dn465943(office.15)
你可以选择先看看上面的东西，详细了解下，然后接着读这篇文章。
UCMA4和UCMA3有什么区别我不知，因为我每接触过后者，不过后者的用户群应该远大于前者。
UCMA4的连接搭建流程很清晰，直接看代码。下面的代码和视频里的基本一致：
class Program
{
string conversationSubject = "let's go";
string messageText = "it's a sunny day.";
InstantMessagingCall imCall;
InstantMessagingFlow imFlow;
UserEndpoint userEndpoint;
UCMASampleHelper helper;
AutoResetEvent completeEvent = new AutoResetEvent(false);
...
在使用之前先来几个变量。字符串的不说了，你看下哪里用到就知道干什么的了。
ucma中有两种“终端”：USERENDPONT和APPLICATIONENDPOINT。第二个功能更强大也更难用，目前也不需要。可以自己看一下：http://blog.thoughtstuff.co.uk/2014/01/ucma-endpoints-choosing-between-application-and-user-endpoints/
因为我们使用UCMA是希望和Lync客户端进行通信，所以需要一个发起通信的客户端（当然是用API模拟的）。这个对象对应的类就是UserEndpoint，所以我们建立一个他的对象userEndpoint。上面的两个对象，imCall是InstantMessagingCall的实例，用了建立连接的（是和另一个客户端的连接，不是和服务器的）。imFlow是InstantMessagingFlow的实例，用了处理业务的，比如这里要发送的消息。
为了简化，这里用到了UCMASampleHelper类。视频里很详细的说了怎么引入该类：
using Microsoft.Rtc.Collaboration.Sample.Common;
...
namespace Microsoft.Rtc.Collaboration.Sample.Common
{
class UCMASampleHelper
{
你可以把using子句去掉，改成：
namespace xxx//xxx和Program类是一样的
{
class UCMASampleHelper
{
completeEvent是多线程里的一个信号量。我刚刚接触C#，UCMA里用到不少异步、委托、多线程的技能，我不是很了解他们和java中的区别，所以不多说了。估计看这篇文章的都比我懂。
在主要的Run方法里，操作如下：
...
private void Run()
{
helper = new UCMASampleHelper();
userEndpoint = helper.CreateEstablishedUserEndpoint("hello_world");
Console.WriteLine("the endpoint is owned by " + userEndpoint.OwnerUri);
ConversationSettings conversationSettings = new ConversationSettings();
conversationSettings.Subject = conversationSubject;
Conversation conversation = new Conversation(userEndpoint, conversationSettings);
imCall = new InstantMessagingCall(conversation);
imCall.InstantMessagingFlowConfigurationRequested += new EventHandler<InstantMessagingFlowConfigurationRequestedEventArgs>(imCall_InstantMessagingFlowConfigurationRequested);
string targetUri = "sip:a.b.c@def.com";
imCall.BeginEstablish(targetUri, null, CallEstablishCompleted, null);
completeEvent.WaitOne();
}
...
工具类里的CreateEstablishedUserEndpoint方法用于和服务器进行连接。下面再说这里。
终端连接后，就把他传给一个会话Conversation。UCMA里的对象多数建立的时候需要配置信息，所以这个会话也要一个ConversationSettings的实例。会话conversation生成后用来生成imCall。imCall中包含了第一个客户端的信息，所以还需要对方。通过sip协议指定一个对象targetUri（估计需要是同域的，不然连lync都连不上吧），然后调用imCall的BeginEstablish方法进行请求，成功后就调用CallEstablishCompleted方法。imcall一建立就会调用InstantMessagingFlowConfigurationRequested，我们给他委托一个事件，定义在方法imCall_InstantMessagingFlowConfigurationRequested里：
void imCall_InstantMessagingFlowConfigurationRequested(Object sender,InstantMessagingFlowConfigurationRequestedEventArgs e)
{
imFlow = e.Flow;
imFlow.StateChanged += new EventHandler<MediaFlowStateChangedEventArgs>(imFlow_StateChanged);
imFlow.MessageReceived += new EventHandler<InstantMessageReceivedEventArgs>(imFlow_MessageReceived);
}
imFlow状态改变时也有一个事件，定义在imFlow_StateChanged里：
void imFlow_StateChanged(object sender, MediaFlowStateChangedEventArgs e)
{
if (e.State == MediaFlowState.Active)
{
imFlow.BeginSendInstantMessage(messageText, SendMessageCompleted, imFlow);
}
}
MediaFlowState有三个枚举：Idle，Active，Terminated。当变成Active时就发消息it's a sunny day.
收到消息时的事件处理定义在imFlow_MessageReceived中：
void imFlow_MessageReceived(object sender, InstantMessageReceivedEventArgs e)
{
if (e.TextBody.Equals("using lync", StringComparison.OrdinalIgnoreCase))
{
Console.WriteLine("success,,, hello.");
}
else if (e.TextBody.Equals("bye", StringComparison.OrdinalIgnoreCase))
{
imFlow.BeginSendInstantMessage("shutting down...", SendMessageCompleted, imFlow);
helper.ShutdownPlatform();
}
else
{
imFlow.BeginSendInstantMessage("ECHO: " + e.TextBody, SendMessageCompleted, imFlow);
}
}
很简单，对方给你回复using lync时控制台打印success,,, hello.回复bye时你自动回复shutting down...然后关掉；回复其他内容，你都自动回复ECHO:加他的内容。
其他回调方法为空。
上面主要是这个视频的内容。但是有一部分很需要留意：终端登录时怎么设置参数？
既然你要模拟一个客户端，你就需要一个用户名和他的密码，还要提供你要登录哪个服务器，你是在哪个域。
视频里没有讲到这一块，他演示了怎么获得一个App.config。
一个短的App.config是这样的：
<?xml version="1.0" encoding="utf-8" ?>
<configuration>
<appSettings>
<!-- Please provide parameters necessary for the sample to run without
prompting for input -->
<!-- Provide the FQDN of the Microsoft Lync Server -->
<!--<add key="ServerFQDN1" value="ServerFQDN"/>-->
<!-- The user name of the user that the sample logs in as -->
<!-- You may leave this value as blank to use credentials of the currently
logged on user -->
<!--<add key="UserName1" value="user"/>-->
<!-- The user domain of the user that the sample logs in as -->
<!-- You may leave this value as blank to use credentials of the currently
logged on user -->
<!--<add key="UserDomain1" value="domain"/>-->
<!-- The user URI of the user that the sample logs in as, in the format
user@host -->
<!--<add key="UserURI1" value="user@host"/>-->
</appSettings>
<runtime>
...
</runtime>
</configuration>
这些参数不配置的话可以在控制台里交互。如果提供的话去掉注释就好，当然自己要改参数值。比如：
<add key="ServerFQDN1" value="lync.miclozoft.com"/>
<add key="UserName1" value="c.b.a"/>
<add key="UserDomain1" value="ads.adsk.com"/>
<add key="UserURI1" value="b.c.a@adsk.com"/>
注意不要删掉数字后缀。
如果你提供的参数都是正确的，那就可以通信和发消息了。
