UCMA4初体验

来源：互联网发布：nginx window安装配置编辑：程序博客网时间：2024/05/05 00:21

进入新公司需要新技能。以前从来没用过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的连接搭建流程很清晰，直接看代码。下面的代码和视频里的基本一致：

C#代码 
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类。视频里很详细的说了怎么引入该类：

C#代码 
using Microsoft.Rtc.Collaboration.Sample.Common;  
...  
namespace Microsoft.Rtc.Collaboration.Sample.Common  
{  
    class UCMASampleHelper  
    {  

你可以把using子句去掉，改成：

C#代码 
namespace xxx//xxx和Program类是一样的  
{  
    class UCMASampleHelper  
    {  

completeEvent是多线程里的一个信号量。我刚刚接触C#，UCMA里用到不少异步、委托、多线程的技能，我不是很了解他们和java中的区别，所以不多说了。估计看这篇文章的都比我懂。

在主要的Run方法里，操作如下：

C#代码 
...  
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里：

C#代码 
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里：

C#代码 
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中：

Java代码 
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是这样的：

Java代码 
<?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>  

这些参数不配置的话可以在控制台里交互。如果提供的话去掉注释就好，当然自己要改参数值。比如：

Java代码 
<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"/>  

注意不要删掉数字后缀。

如果你提供的参数都是正确的，那就可以通信和发消息了。

0 0