开发人员参考
上一次修改主题： 2009-05-14
Office Communications 组提供下列 SDK 和 API 集合：
- Office Communications Server 2007 R2 Server SDK
- 统一通信托管 API 2.0 核心 SDK
- 统一通信托管 API 2.0 语音 SDK
- 统一通信托管 API 2.0 Windows 工作流活动
- Office Communicator 2007 自动化 API SDK
- 统一通信客户端 1.0 SDK
- 统一通信 AJAX 2007 SDK
- Office Live Meeting 服务 API
- Office Live Meeting 服务门户 API
以下各节概述每个 SDK 和 API 集合。有关每个 SDK 和 API 集合的 MSDN 文档链接，请参阅本主题末尾的**“另请参阅”**一节。
Office Communications Server 2007 R2 服务器 SDK
Microsoft （）包含两个 API 集合：
- 应用程序 API
- 管理 API
Communications Server 应用程序 API
开发人员可以使用 应用程序 API 创建能够扩展和增强 中基于 SIP 的功能的应用程序。此 API 集合面向希望在 中实现自定义行为的开发人员，从开发自定义的消息筛选器和路由应用程序，到开发多线程事务模型和安全日志记录功能，所需功能应有尽有。这些 API 可监控并更改通过 的 SIP 消息流，但不能用于创建来自服务器的 SIP 消息。例如，这些 API 不能用于编写创建即时消息的应用程序。
应用程序 API 提供了一系列工具，可用于实现自定义 SIP 消息筛选器，以及将消息调度至在 Office Communications Server 中注册的应用程序。它包含三大工具：
- 应用程序清单 - 定义基本消息筛选和代理行为。
- Microsoft SIP 处理语言 (MSPL) - 可对筛选和代理行为提供更精细的控制，同时提供了一些工具，用于将特定消息调度至基于事务的 SIP 应用程序。
- Microsoft.Rtc.Sip 命名空间 - 允许应用程序在执行路由和筛选时，访问 外部的资源。
使用 MSPL 可创建仅使用 提供的资源（例如状态）来提供路由和筛选功能的应用程序。用于阻止所有包含 HTTP 引用的即时消息的应用程序可完全通过 MSPL 来编写。
如果应用程序需要 外部的资源（例如域信息或数据库访问），则需要让其 MSPL 代码将 SIP 消息调度至使用 Microsoft.Rtc.Sip 命名空间的单独进程。如果应用程序允许即时消息中包含对企业受信任站点的 HTTP 引用，但阻止引用非受信任站点或外部站点的消息，则除了 MSPL 应用程序外，还需要编写一个单独的应用程序。
有关上面所列工具的信息，请参阅本文档中的以下几节：
- “SIP 应用程序清单”- 描述 计算机上运行的 SIP 应用程序的 XML 文档。
- “使用 SIP 托管应用程序 API”- 详细说明如何创建在 上运行的基于事务的 SIP 应用程序。
- “SIP 托管应用程序 API 参考”- 包含 Microsoft.Rtc.Sip 命名空间及其他 SIP 专用资源的参考文档。
Communications Server 管理 API
管理 API 由一系列用于管理 组件的 Windows Management Instrumentation (WMI) 类组成。WMI 使用通用信息模型 (CIM) 行业标准表示系统、应用程序、网络、设备及其他托管组件。大多数类属性均在 管理控制台中公开。所有属性均可使用支持 ActiveX® Script Hosting 的脚本语言（例如 Microsoft Visual Basic Scripting Edition (VBScript)）进行访问。
使用 WMI 脚本可自动处理 部署中的管理任务。此外，WMI 还可用于远程读取或更改 WMI 属性，但运行脚本的计算机必须是 计算机，或已安装 管理工具。
有关 WMI 的详细信息，请参阅位于 MSDN 上的 Windows Management Instrumentation (WMI)（英文）。
统一通信托管 API 2.0 核心 SDK
Microsoft 统一通信托管 API 2.0 核心 SDK（简称为 UCMA 2.0 核心 SDK）是一个托管代码平台，可提供对即时消息、电话、音频/视频会议和状态的访问和控制。该平台旨在支持面向 Microsoft Office Communicator 和 Microsoft Office Communications Server 2007 R2 的中层应用程序的开发。
UCMA 2.0 核心 SDK 提供的 API 几乎公开了 Office Communications Server 协议的所有功能，从而提取了该协议的大部分功能；此外，该平台易于理解和使用。例如，可以使用 ContactGroupServices 类来处理用户的联系人和组。也可以使用 ConferenceServices 类来安排会议。用户或应用程序可以使用 Conversation 类发起与其他用户或应用程序的对话。应用程序可以使用 LocalOwnerPresence 和 RemotePresence 类来订阅其他用户或应用程序的状态信息。
统一通信托管 API 2.0 语音 SDK
使用 Microsoft 统一通信托管 API 2.0 语音 SDK，开发人员可以构建利用语音识别功能与文本到语音转换功能的 Office Communications Server 应用程序。
统一通信托管 API 2.0 Windows 工作流活动
使用 UCMA 2.0 Windows 工作流活动，可以在 OCS 上快速构建支持工作流的语音应用程序和即时消息应用程序。使用 UCMA 2.0 Windows 工作流活动，不仅可以为简单应用场景（如，呼叫路由）提供解决方案，而且也可以为大型企业遇到的复杂应用场景（如，语音协作与业务流程工作流集成）提供解决方案。
Office Communicator 2007 自动化 API SDK
Microsoft （）包含一系列 COM 接口、对象、事件、枚举类型以及其他相关编程实体。.使用 可基于第三方应用程序编写 () 实例，及创建提供扩展和自定义的 用户体验的应用程序。
例如，可通过调用 IMessenger::Signin 方法登录 。这与从正在运行的 实例中，单击**“连接”菜单上的“登录”**进行登录的效果类似。此外， 功能可集成到其他应用程序中，还可以根据特殊的应用需要加以扩展或自定义。计划应用程序可使用 来发挥其联系人管理和查询功能，以便用户组织、显示或查询联系人。
作为一种支持自动化的基于 COM 的 API， 可从使用 Microsoft Visual Basic®、C/C++、VBScript 以及许多其他脚本语言编写的应用程序中进行调用。出于安全考虑，已针对脚本语言禁用某些 API 调用。有关这些限制的完整说明，请参阅“ 参考”。
借助 .NET Framework 中的 System.Runtime.Interop 命名空间，还可以从用任意基于 .NET 的编程语言（包括 Microsoft Visual C#® 开发工具、Visual Basic .NET、Visual J#® 开发工具等）编写的应用程序中调用此 API。
统一通信客户端 1.0 SDK
应用程序开发人员可创建下列类型的 API 应用程序来进行实时通信和协作：
- 全面通信客户端，例如 Microsoft ()。实际上， 是在 API 基础上构建而成的。这种应用程序可支持即时消息、会议、IP 语音或视频，以及电话集成。由于此平台支持一般发布和订阅框架，因此它还可以用于跟踪用户联系人的状态以及其他应用程序特有的数据。
- 可与 交互，并提供扩展功能或自定义服务的面向功能的应用程序。这种应用程序可使服务提供程序利用企业中现有的 安装基础。但是，这些应用程序在发布数据以及创建或接受会话时，必须注意避免影响 。
- 在现有业务线 (LOB) 应用程序中嵌入状态和通信功能的集成式 LOB 应用程序。例如，客户关系管理 (CRM) 应用程序可集成状态跟踪功能，以确定如何向最适当的服务代表调度自定义请求。
开发人员可使用 API 创建在网络边界内部或跨网络边界启用集成的多模式实时通信的应用程序。得到的应用程序有助于使相关计算机成为实时业务通信的中心。音频和视频呼叫以及即时消息 (IM) 和协作将全部集成到计算机上的同一个用户会话中。除了计算机到计算机的通信会话外，用户还可以创建计算机到电话的呼叫、电话到电话的呼叫，或仅文本的 IM 会话。
借助注册服务器，用户可通过状态信息实时了解自己联系人的状态。因此，用户可使用此类应用程序直接呼叫联系人，而无需查找联系人的确切位置或选择要呼叫的适当号码。例如，如果按工作单位信息拨打联系人，而状态信息指示该联系人正在使用家中的计算机，则呼叫可以自动重定向至联系人的家。用户还可以阻止呼叫者访问自己的状态信息，以保护自己的隐私。
为您应用程序的用户自定义通信体验，就是使用业务应用程序进行上述实时通信的一个示例；例如，CRM 应用程序可以将销售机会的相关各方组织到视频会议中，并共享客户数据。
目前，Microsoft MSN® Internet 服务网络、Yahoo! 以及 AOL 在全球有数以亿计的用户在使用 IM 服务。
Microsoft 统一通信 AJAX 2007 SDK
Microsoft® ()包括下列组件：
- 是 的应用程序编程接口。此 API 由一系列方法和事件组成。客户端将方法作为请求发送至 服务器，并以事件形式接收来自服务器的数据。请求和事件均指定为 XML 元素。在各种方案中，通信主要以 HTTP POST 请求和 HTTP GET 请求的形式进行。与设计为 Web 服务的应用程序不同，服务器并不解析 SOAP 消息，也不提供由客户端应用程序开发工具使用的 WSDL 文档。这种方式有两个优点。最重要的一点是，它可以避免在 JavaScript 代码必须生成或解释大型 SOAP 文档时产生的开销。其次，只需大致了解 XML 就足以成功运用 ，而不需要专门掌握有关 SOAP 消息的知识。
- 统一通信 JavaScript 库基于 AJAX 服务。有些 JavaScript 类封装了统一通信 JavaScript 库客户端所需的常用功能。这些常用功能包括创建和维护信道、登录服务器、在网页中嵌入用户状态的显示功能、启动 IM 对话等。借助这些库，应用程序开发人员只需实例化库、设置适当的属性并调用所需方法，即可创建统一通信 JavaScript 库客户端。
服务器提供了对统一通信功能的访问。
Office Live Meeting 服务 API
使用 Microsoft （），可通过编程方式访问基于 Windows 和 Web 的 Office Live Meeting 客户端能够提供的大多数功能。
文档包括两部分：
- 一般指南，旨在通过示例和教程为刚入门的编程人员介绍 Live Meeting 和应用程序编程接口 (API) 的概念。
- 详细的 API 参考信息，包括有关公共支持的消息、所含 XML 元素以及错误代码的信息，此外还包括其他技术信息。
API 文档适用于负责设计、实现和测试基于 Live Meeting 技术的 Web 会议解决方案的工程师、开发人员和编程人员。您应该对 HTTP 和 XML 有基本的了解。
开发人员可使用 Live Meeting 服务来管理联机会议。管理任务包括：安排会议；邀请他人加入会议；将用户帐户添加至 Live Meeting 会议中心；上载演示文稿和其他资源；管理记录、用户首选项和通讯簿；报告会议出席情况及其他统计信息。其中有很多任务可通过编程方式执行。
Live Meeting 服务可通过 Live Meeting Web 用户界面或 API 处理器进行访问。用户可使用 Web 用户界面执行所有会议相关活动。Live Meeting 服务 API 处理器可充当以编程方式访问 Live Meeting 服务及管理用户、资源和会议时的网关。
Office Live Meeting 服务门户 API
Microsoft （）可作为 Service Pack 2 的补充。
（以下简称“门户”）是一种使用 ASP.NET 的 Microsoft Internet Information Services (IIS) Web 应用程序。门户安装在 Microsoft Windows® Web 服务器上。门户通过在 Internet 上发送的 XML API 调用来与 Live Meeting 服务通信。
用户可以从 Web 浏览器访问门户网页，以执行下列操作：
- 创建新的 Live Meeting 帐户。
- 登录 Live Meeting 服务。
- 更改 Live Meeting 帐户的密码。
- 允许用户访问与 Live Meeting 相关的丰富内容。
调用门户 Web 方法的程序或脚本能够实现 Live Meeting 帐户的自动管理。使用 Web 方法可以：
- 创建或删除 Live Meeting 帐户。
- 激活或停用 Live Meeting 帐户。
- 更改 Live Meeting 帐户的密码。
- 获取 Live Meeting 帐户的状态。