Get started with Lync 2013 SDK
Learn about getting started using Microsoft Lync 2013 SDK, the essential features of the SDK, and how you can use those features to give your application enhanced unified communication features that are supported by Microsoft Lync Server 2013.
Applies to: Lync 2013 | Lync Server 2013
|
.gif){kind=icon}
.gif){kind=icon}
.gif){kind=icon}
What is Microsoft Lync 2013 SDK?
Microsoft Lync 2013 SDK includes a comprehensive managed API, documentation, and a set of sample applications that show how to build unified communication features into your application. The API includes classes that represent the Lync client platform, contacts, conversations, online meetings, and conversation modalities. Modalities manage the actual modes of communication within a conversation or meeting. Use the API to sign a user in to Lync, show lists of Lync contacts, or start conversations. Within a conversation, you programmatically interact in conversations by managing conversation modalities.
The Lync platform components of the API are used to sign a user in and out of Lync 2013, maintain the settings and properties of the local user, and publish the user’s availability and notes (personal and OOF). The platform also lets you automate Microsoft Lync 2013 to the extent that you can programmatically open a new conversation window, start an online meeting, or add a contact to the user’s contact list.
Get started with Microsoft Lync 2013 SDK
The supported development environment for creating applications with Microsoft Lync 2013 SDK is described in this section.
Supported operating system software
Microsoft Windows Server 2008 R2
Microsoft Windows 7 (64-bit)
Microsoft Windows 7 (32-bit)
Typical current hardware configurations with a minimum of 2 GB of RAM are recommended for the supported operating systems.
.gif "Important note") Important |
|---|
In the Microsoft Visual Studio development system, select Any CPU as your custom application build platform target to ensure your application runs on 32-bit and 64-bit operating systems. The default installation path for Lync SDK is the %root%\Program Files (x86) folder. |
Application development
To develop Lync SDK applications, the following requirements must be fulfilled:
Microsoft Windows Forms or Microsoft Windows Presentation Foundation (WPF) development: Microsoft Visual Studio 2010 SP1 or Visual Studio 2012.
Microsoft Silverlight development: Visual Studio 2010 SP1 or Visual Studio 2012.
Microsoft .NET Framework 4.0.
Silverlight 4.0 runtime, installed with Microsoft Lync 2013.
Only Microsoft Internet Explorer 7 and later versions support Lync 2013 Silverlight controls.
Custom application deployment
To deploy a Lync SDK application, application users must be able to sign in to Lync 2013 and the following components must appear on the target computer:
Lync SDK redistributable components:
Microsoft.Office.uc.dll
Microsoft.Lync.Model.dll desktop version
Microsoft.Lync.Model.dll Silverlight version
Lync 2013
Microsoft .NET Framework 4.0
Microsoft Lync 2013 SDK essentials
Although an inexperienced programmer who understands basic .NET coding concepts can be successful programming with Microsoft Lync 2013 SDK, more robust and scalable applications can be developed if you're familiar with the following programming concepts.
Concept |
Description |
|---|---|
Learn about event-based programming in Lync SDK. |
|
Learn about the System.AsyncCallback method in Lync SDK. |
|
Learn how to migrate an existing application to Lync SDK from previous SDK versions. |
|
Learn how to run a Microsoft Lync 2013 API-enabled application on a computer where multiple versions of the Lync client are installed. |
What can you do with Microsoft Lync 2013 SDK?
Microsoft Lync 2013 SDK gives you the ability to add a wide range of Lync features to your Windows Forms, WPF, or Silverlight application. These features can be as simple as dropping a presence gumdrop onto an existing Silverlight application for showing the current presence of a user to complex tasks such as creating a full-featured Lync client as a stand-alone application or hosted within your application.
If you want to add a set of Lync features to your WPF or Silverlight application and do not have the time to learn about the Lync 2013 API object model, you can use the suite of Microsoft Lync 2013 Controls to populate contact list and conversation features in your application. To do this, leverage your knowledge of XAML syntax and C# to set control properties at either design or runtime. The Lync Controls requires that Microsoft Lync 2013 is installed and running on each computer that runs your application.
You can also automate the starting of Lync 2013 conversations and docking Lync conversation windows within your application by using a few simple method calls from the Microsoft.Lync.Model.Extensibility namespace. If you use this method to automate conversations, all you need is the SIP address of a Lync user to start a conversation, a container control in your application that hosts the docked conversation window, and a small amount of C# code to manage docking the conversation window.
If you want to extend the functionality of the Lync conversation window, you can use the full power of the Lync 2013 API object model to create conversation context-aware Silverlight applications that are hosted in an extension pane of the conversation window itself. The object model gives you read-write access to conversation modalities as well as the conversation participant list. Although the Conversation Window Extension (CWE) application is a Silverlight browser application, it has the practical complexity limitations that any browser application has when hosted in a Browser control on a form.
Other tasks that you can do with Microsoft Lync 2013 SDK include:
Extending a Persistent Chat window by creating and hosting a Silverlight browser add-in in the chat window.
Building a meeting management console application that controls a Lync 2013 meeting window sharing stage and meeting participant list.
Building a public-facing conversation client in a building lobby kiosk that is branded with your company logo and locks new conversations down to the modalities that you set and limits conversations to a predefined set of participants.
The following table lists basic tasks that are the building blocks of the previously discussed features.
Task |
Description |
|---|---|
Shows how to code the sign in/sign out process using the Lync 2013 API in both UI-suppressed and non UI-suppressed scenarios. |
|
Shows how to add event logging to your Lync Controls-based application. |
|
Shows two basic scenarios where Lync Controls-based applications generate error log entries. |
|
Gets you started using Microsoft Lync 2013 Controls in a WPF or Silverlight browser application. |
|
Gets you started publishing the local user’s presence by using the Lync 2013 API and Lync Controls. |
|
Gets you started displaying Lync contacts and groups in your application by using the Lync 2013 API or Lync Controls. |
|
Gets you started creating and managing Lync 2013 by using the Lync 2013 API or Lync Controls. |
|
Builds on Lync 2013 API conversation concepts and shows how to manage conversations as online meetings by using the Lync 2013 API. |
|
Gets you started creating add-in applications for Lync 2013 Persistent Chat room windows. |
|
Gets you started with resource sharing management in conversations and online meetings by using the Lync 2013 API. |
|
Gets you started sharing whiteboards, PowerPoint decks, and file attachments in conversations and online meetings by using the Lync 2013 API. |
Beyond the basics: Learn more about Microsoft Lync 2013 SDK
Many of the same Lync options that can be set by the user can also be set by your application. The following table lists advanced concepts for setting many of these Lync options by using the Lync 2013 API.
Concept |
Description |
|---|---|
Describes the coding patterns that are used to sign a user in to Lync 2013 when the Lync UI is suppressed. |
|
Describes how to use the sign-in configuration manager to change the Microsoft Lync Server 2013 connection settings. |
|
Describes how to publish the local user’s phone number list. |
|
Describes how to get a localized set of availability states for display and publication. |
|
Describes how to set the privacy relationship of the local user with another Lync user. |