• 發行項

開發人員參考

上次修改主題的時間： 2009-05-14

Office Communications 群組提供下列 SDK 和 API 集：

  • Office Communications Server 2007 R2 Server SDK
  • Unified Communications Managed API 2.0 Core SDK
  • Unified Communications Managed API 2.0 Speech SDK
  • Unified Communications Managed API 2.0 Windows Workflow Activities
  • Office Communicator 2007 Automation API SDK
  • Unified Communications Client 1.0 SDK
  • Unified Communications AJAX 2007 SDK
  • Office Live Meeting Service API
  • Office Live Meeting Service Portal API

下列各節會簡要說明每個 SDK 和 API 集。在本主題最後的「請參閱」一節中，會提供每個 SDK 和 API 集的 MSDN 文件連結。

Office Communications Server 2007 R2 Server SDK

Microsoft () 包含兩個 API 集：

  • 應用程式 API
  • 管理 API

Communications Server 應用程式 API

開發人員可以使用 應用程式 API，建立能夠擴充和增強 SIP 功能的應用程式。從開發自訂的訊息篩選和路由應用程式，到多執行緒交易式模式和安全登入功能，這個 API 集是以想要實作 自訂行為的開發人員為目標。這些 API 可以在 SIP 訊息通過 時，監控和變更其訊息，但不能用來從伺服器建立 SIP 訊息。例如，您不能使用這些 API 撰寫可以建立立即訊息的應用程式。

應用程式 API 提供一組工具，供開發人員實作自訂 SIP 訊息篩選器，並且將訊息分派至已向 Office Communications Server 註冊的應用程式。主要有三項工具：

  • 應用程式資訊清單 - 定義基本的訊息篩選和 Proxy 行為。
  • Microsoft SIP Processing Language (MSPL) - 對篩選和 Proxy 行為提供更細微的控制，並提供功能將特定訊息分派至交易式 SIP 應用程式。
  • Microsoft.Rtc.Sip 命名空間 - 讓應用程式在執行路由和篩選作業時，能存取位於 外部的資源。

當要建立的應用程式是只用 提供的資源 (如顯示狀態功能) 進行路由和篩選作業，則可使用 MSPL 來建立。您可以使用 MSPL 來撰寫會封鎖含有 HTTP 參考之所有立即訊息的應用程式。

若應用程式需要 外部的資源 (如網域資訊或資料庫存取)，則應用程式的 MSPL 程式碼就必須要將 SIP 訊息分派至使用 Microsoft.Rtc.Sip 命名空間的另一個處理序。如果應用程式允許含有企業信任網站 HTTP 參考的立即訊息，但是會封鎖非信任網站或外部網站參考的訊息，那麼除了 MSPL 之外，還需要另一個應用程式。

如需上述工具的詳細資訊，請參閱本文件下列各節：

  • SIP 應用程式資訊清單 – 這是 XML 文件，會對執行 SIP 應用程式的 電腦描述該 SIP 應用程式。
  • 使用 SIP Managed 應用程式 API - 說明如何建立可在 上執行的交易式 SIP 應用程式。
  • SIP Managed 應用程式 API 參考文件 - 包含 Microsoft.Rtc.Sip 命名空間和其他 SIP 特定資源的參考文件。

Communications Server 管理 API

管理 API 包含一組 Windows Management Instrumentation (WMI) 類別，可用於管理 元件。WMI 使用 Common Information Model (CIM) 業界標準，來表示系統、應用程式、網路、裝置和其他 Managed 元件。大部分類別屬性都會公開在 管理主控台中。所有屬性都可使用支援 ActiveX® 指令碼裝載功能的指令碼語言存取，如 Microsoft Visual Basic Scripting Edition (VBScript)。

您可以使用 WMI 指令碼在 部署中自動化系統管理工作，也可以使用 WMI 以遠端方式讀取或變更 WMI 屬性，但執行指令碼的電腦必須是 電腦或已經安裝 系統管理工具的電腦。

如需有關 WMI 的詳細資訊，請參閱 MSDN 上的 Windows Management Instrumentation (WMI)。

Unified Communications Managed API 2.0 Core SDK

Microsoft Unified Communications Managed API 2.0 Core SDK 是 Managed 程式碼平台，提供對即時訊息、電話語音、音訊/視訊會議和顯示狀態的存取與控制能力。它可支援以 Microsoft Office Communicator 和 Microsoft Office Communications Server 2007 R2 為目標之中介層應用程式的開發工作。

UCMA 2.0 Core SDK 是從大多數的 Office Communications Server 通訊協定抽離而來，方法是提供幾乎供應所有通訊協定功能的 API，但更容易了解及使用。例如，使用者的連絡人和群組可以使用 ContactGroupServices 類別加以取用。使用 ConferenceServices 類別則可以排程會議。使用者或應用程式可以使用 Conversation 類別啟始與其他使用者或應用程式的交談。應用程式可以透過 LocalOwnerPresence 和 RemotePresence 類別訂閱其他使用者或應用程式的顯示狀態。

Unified Communications Managed API 2.0 Speech SDK

Microsoft Unified Communications Managed API 2.0 Speech SDK 可讓開發人員建置可運用語音辨識及文字轉語音功能的 Office Communications Server 應用程式。

Unified Communications Managed API 2.0 Windows Workflow Activities

UCMA 2.0 Windows Workflow Activities 可用來在 OCS 上快速建置啟用工作流程的語音和即時訊息應用程式。UCMA 2.0 Windows Workflow Activities 可用來提供簡單案例的方案，例如呼叫路由傳送，或者為大型企業會遭遇的複雜案例提供方案，例如音訊共同作業及商務程序工作流程整合。

Office Communicator 2007 Automation API SDK

Microsoft () 包含一組 COM 介面、物件、事件、列舉型別和其他相關的程式開發實體。 可以讓您在協力廠商應用程式中開發 () 執行個體，並且撰寫能提供 的擴充和自訂使用者經驗的應用程式。

例如，您可以呼叫 IMessenger::Signin 方法來登入 。這個做法等同於在執行中的 執行個體中，按一下 [連線] 功能表中的 [登入] 進行登入。除此之外，您可以將 的功能整合至其他應用程式，並視特殊應用程式的需要，擴充或自訂這些功能。排程應用程式可利用 來充分運用連絡人管理和查詢功能，讓使用者可以組織、顯示或查詢他們的連絡人。

因為 為支援 Automation 的 COM API，因此在以 Microsoft Visual Basic®、C/C++、VBScript 和其他許多指令碼語言撰寫的應用程式中，都可以呼叫 tkn-oca。為了安全考量，某些 API 是不讓指令碼語言呼叫的。如需這些限制的完整說明，請參閱 參考。

因為有 .NET Framework 中的 System.Runtime.Interop 命名空間的協助，因此也可以在以 .NET 程式語言撰寫的應用程式中呼叫 API，這些 .NET 程式語言包括 Microsoft Visual C#® 開發工具、Visual Basic .NET、Visual J#® 開發工具等。

Unified Communications Client 1.0 SDK

應用程式開發人員可以建立下列類型的 API 應用程式，以進行即時通訊和共同作業：

  • 功能齊全的通訊用戶端，如 Microsoft ()。實際上， 是使用 API 建置的。這類型應用程式可支援將立即訊息、會議、IP 網路語音或視訊和電話語音功能整合在一起。因為平台支援一般的發行和訂閱架構，所以也可用來追蹤使用者連絡人的顯示狀態 (Presence) 和其他應用程式特定資料。
  • 著重特定功能的應用程式，能和 交互操作，並提供增強型功能或自訂服務。這類型的應用程式能讓服務提供者利用企業內部大量已安裝 的優勢。但是，這些應用程式在發行資料和建立或接受工作階段時，要注意不要干擾到 的正常運作。
  • 整合式的企業營運 (LOB) 應用程式，將顯示狀態和通訊功能嵌入至現用的 LOB 應用程式。例如，客戶關係管理 (Customer Relations Management，CRM) 應用程式可整合顯示狀態追蹤功能，以決定如何將客戶的要求分派至最合適的服務人員。

開發人員可以使用 API 建立能夠在網路界限內或跨網路界限啟用整合式多模式即時通訊的應用程式。這類型應用程式可讓本機電腦成為即時商務通訊的中心。音訊和視訊通話、立即訊息 (IM) 和共同作業功能都整合在電腦的單一使用者工作階段中。除了電腦對電腦通訊工作階段，使用者也可以建立電腦對電話通話、電話對電話通話或純文字 IM 工作階段。

有了登錄器伺服器的協助，使用者可根據顯示狀態資訊，即時了解某連絡人的狀態。因此使用者可以使用這類型應用程式撥電話給連絡人，而不用找出連絡人確切的位置，也不用選擇要撥打的正確電話號碼。例如，如果您撥打某連絡人工作地點的號碼，而顯示狀態資訊指出該連絡人目前在家中使用電腦上線，則您的通話會自動轉接到該位置。使用者為了保護自己的隱私，也可以封鎖他們的顯示狀態資訊不讓來電者知道。

這一類適用於商務應用程式的即時通訊，可能也適用於您應用程式使用者的自訂通訊。例如，就像 CRM 應用程式可以讓所有對銷售契機有興趣的人齊聚一堂舉行視訊會議，並分享有關客戶的資訊。

目前推出 IM 服務的廠商有 Microsoft MSN® 網際網路服務網路、Yahoo! 和 AOL，全球約有數億使用者。

Microsoft Unified Communications AJAX 2007 SDK

Microsoft® () 包含下列元件：

  • 是 應用程式發展介面。API 由方法和事件組成。用戶端會將方法當做要求傳給 伺服器，且會收到伺服器當做事件傳回的資料。要求和事件都會指定為 XML 項目。在個別的案例中，主要是由 HTTP POST 要求和 HTTP GET 要求來進行通訊。不像設計做為 Web 服務的應用程式， 伺服器不會剖析 SOAP 訊息，也不會提供 WSDL 文件讓用戶端應用程式開發工具來處理。這種做法有兩個優點。最重要的優點，是可以省掉 JavaScript 程式碼必須產生或剖析大型 SOAP 文件時產生的負荷。另一個優點，是只要具備一般 XML 知識，而不用懂得有關 SOAP 訊息的知識，即能順利使用 。
  • 以 AJAX 服務為基礎的 Unified Communications JavaScript Libraries。這些 JavaScript 類別封裝了 Unified Communications JavaScript Libraries 用戶端常用的必要功能。這些常用的功能包含建立和維護通訊通道、登入伺服器、將使用者的顯示狀態內嵌顯示在網頁中，以及啟動 IM 通訊等等。應用程式開發人員使用這個程式庫，就可建立 Unified Communications JavaScript Libraries 用戶端，方法是只要具現化程式庫、設定適當的屬性，以及叫用需要的方法。

伺服器可讓您存取 Unified Communications 功能。

Office Live Meeting Service 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 Service Portal API

Microsoft () 會補足 Service Pack 2 的不足。

(Portal) 是使用 ASP.NET 的 Microsoft Internet Information Services (IIS) Web 應用程式。Portal 是安裝在 Microsoft Windows® 網頁伺服器上。Portal 透過從網際網路傳來的 XML API 呼叫與 Live Meeting 服務通訊。

使用者可以從 Web 瀏覽器存取 Portal 的 Web 網頁，以執行下列作業：

  • 建立新的 Live Meeting 帳號。
  • 登入 Live Meeting 服務。
  • 變更 Live Meeting 帳戶密碼。
  • 允許使用者存取有關 Live Meeting 的豐富內容。

程式或指令碼呼叫 Portal 的 Web 方法，可以將 Live Meeting 的帳戶管理自動化。您可以使用 Web 方法執行下列作業：

  • 建立或刪除 Live Meeting 帳戶。
  • 啟動或停用 Live Meeting 帳戶。
  • 變更 Live Meeting 帳戶密碼。
  • 取得 Live Meeting 帳戶的狀態。