UCMA 4.0 building blocks

Lync 2013

Last modified: August 16, 2013

Applies to: Lync 2013 | Lync Server 2013

In this article
Key features and UCMA classes
In this section

To understand the Microsoft Unified Communications Managed API 4.0 architecture, it is helpful to understand the classes that represent the key features of the architecture as described in Key features of UCMA 4.0. It is also helpful to recognize that the architecture has been designed to enable these features.

UCMA 4.0 is divided into layers, as shown in the following illustration. At the top level are the classes that enable communication and collaboration. The next level below that provides classes that represent the collaboration platform, the foundation of UCMA 4.0 applications, and endpoints, which represent users or applications that can impersonate users. The lowest level exposed by UCMA is the signaling layer, which provides classes that encapsulate low-level Session Initiation Protocol (SIP) functionalities.

Each of the layers shown in the illustration is described in UCMA 4.0 details.

Major components of UCMA 4.0

In UCMA 4.0, the entry point class is CollaborationPlatform. An application can create multiple CollaborationPlatform instances, and each platform instance can host multiple endpoints.

An endpoint (represented as a UserEndpoint or ApplicationEndpoint instance) acts as a gateway to communication and collaboration functionality in UCMA, providing access through its methods and properties to the classes that implement these functionalities.

An endpoint can use this functionality to:

The following illustration shows the relationships among the principal objects of the architecture as well as the personas (see Personas) involved in each type of object. The numbers shown between two objects indicate the kind of pairing between the two objects that can occur. For example, one local endpoint can be associated with zero or more Conversation objects, but can be associated with only one Presence Subscription object.

Contacts and Groups are present only on UserEndpoint instances.

Principal objects of the UCMA architecture

Each of the top-level feature areas described in Key features of UCMA 4.0 is implemented in a UCMA 4.0 class. The following table lists the top-level feature areas and the class that implements the area.



Main Class Name




Conference scheduling and management



Presence publishing


LocalEndpointPresenceServices and LocalOwnerPresence

Presence subscription



Contacts and groups