Cisco Unified Communications Manager のプロビジョニング インターフェイスには次のようなものがあります。

• Administrative XML

• Cisco エクステンション モビリティ サービス

Cisco Unified Communications Manager のデバイス モニタリングおよび呼制御インターフェイスは次の通りです。

Cisco Unified Communications Manager のサービスアビリティ インターフェイスには次のようなものがあります。

Cisco Unified Communication Manager 8.0(1) 以降は、外部コール制御（ECC）機能をサポートします。この機能では、補助ルート サーバが、Cisco Unified Routing Rules Interface を使用して、Cisco Unified Communications Manager の代わりにコールルーティングを決定します。外部コール制御の設定に際して、Cisco Unified Communications Manager は、発信側および着信側の情報が入ったルート要求を補助ルート サーバに発行します。補助ルート サーバは、要求を受信し、適切なビジネス ロジックを適用した後、Cisco Unified Communications Manager に対し、コールのルーティングとコールに適用すべきその他の取り扱い方法を指示するルート応答を返します。

詳細については、次の Cisco Developer Network の『Routing Rules Interface Tech Center』を参照してください。http:/​/​developer.cisco.com/​web/​curri/​home

アプリケーション コードにより呼び出しまたはサポートできる基本的な API が Microsoft 社により定義されています。Microsoft 社により定義されている、TAPI アプリケーションから使用できる API はいずれも TAPI.H ファイルで宣言されています。TAPI.H ファイルは VC++/VS2005 インストールに付属している標準的なライブラリ ファイルです。たとえば、C:\Program Files\Microsoft Visual Studio\VC98\Include\TAPI.H にあります。

Cisco TSP により追加または提供されている特定の API を使用するには、アプリケーションは LineDevSpecific API を使用してその API を呼び出す必要があります。

簡単なアプリケーション

#include <tapi.h>#include <string>
#include "StdAfx.h"
class TapiLineApp {
LINEINITIALIZEEXPARAMS mLineInitializeExParams;//was declared in TAPI.h files
     HLINEAPP    mhLineApp;
     DWORD       mdwNumDevs;
     DWORD dwAPIVersion = 0x20005
    
public:
    // App Initialization
    // Note hInstance can be NULL
    // appstr – value can be given the app name "test program"
    bool TapiLineApp::LineInitializeEx(HINSTANCE hInstance, std::string appStr)
{
    unsigned long lReturn = 0;
    mLineInitializeExParams.dwTotalSize = sizeof(mLineInitializeExParams);
    mLineInitializeExParams.dwOptions = LINEINITIALIZEEXOPTION_USEEVENT;
    lReturn = lineInitializeEx (&mhLineApp, hInstance, NULL, appStr.c_str),
 &mdwNumDevs,&dwAPIVersion,&LineInitializeExParams);
    if ( lReturn = = 0 ) {
        return true;
    }
    else {
        return false;
    }
}
//App shutdown
bool TapiLineApp::LineShutdown()
{
    return! (lineShutdown (mhLineApp));
}
};

Cisco TSP のコンポーネントは次の通りです。

• CiscoTSP dll：Cisco TSP によって提供される TAPI サービス実装。

• CTIQBE over TCP/IP：デバイスと回線のモニタと制御に使用する Cisco プロトコル。

• CTI Manager Service：CTI リソースとデバイスへの接続を管理。サードパーティ製アプリケーションから Cisco TSP や JTAPI API 経由でアクセス可能。

Cisco Media Driver を使用して、音声案内の再生またはコール メディアの記録を行うことができます。Media Driver のインストールの詳細については、Cisco Media Driver の選択を参照してください。

TAPI ブラウザは TAPI のデバッグ用アプリケーションです。このアプリケーションは、次の Microsoft MSDN Web サイトからダウンロードできます。ftp:/​/​ftp.microsoft.com/​developr/​TAPI/​tb20.zipTAPI ブラウザは、TAPI の初期化、TAPI 開発者による TAPI 実装のテスト、TSP の動作確認に使用できます。

CTI Manager は、Cisco Unified TSP と連携して、特定の Cisco Unified Communications Manager に認識されることなく、TAPI アプリケーションで Cisco Unified Communications Manager リソースをアクセスするための Cisco Unified Communications Manager クラスタの抽象化を提供します。また、Cisco Unified Communications Manager クラスタの抽象化により、CTI Manager リソースのフェールオーバー機能も強化できます。以下の図のように、フェールオーバー条件は、ノード、CTI Manager、または TAPI アプリケーションに障害が発生した際に発生します。

（注）	シスコではサードパーティ製デバイスに対する CTI デバイスのモニタリングや呼制御はサポートしていません。

図 2. クラスタ サポート アーキテクチャ

RTP イベントは、コール ハンドルの詳細を含む LINE_CALLDEVSPECIFIC イベントとして生成されます。この機能をアクティブにするには、アプリケーションは回線をオープンするときに、拡張バージョン 0x00040001 以上をネゴシエーションする必要があります。

回線の拡張バージョンに依存するため、アプリケーションに対するメディア イベント RTP_START/STOP のレポートが異なります。

• 拡張バージョンが EXTVERSION_FOUR_DOT_ZERO - 0x00040000 未満の場合：TSP は、Call オブジェクトの存在の有無に関係なく、LINE_DEVSPECIFIC イベントを回線上のアプリケーションにレポートします。この場合、IDLE 状態の後にコールの割り当てが解除されても、RTP_STOP イベントはアプリケーションへ配信されます。

• 拡張バージョンが EXTVERSION_FOUR_DOT_ZERO - 0x00040000 以上の場合：アプリケーションから Call オブジェクトの割り当てが解除されると、TSP はメディア イベントをレポートします。

したがって、下位互換性を保持するためには、拡張バージョンのチェックを追加する必要があります。そのため、RTP イベントが起きるのは常に IDLE イベントの前であるとは想定しないでください。

Cisco Unified TSP は、シスコの Quality of Service（QoS）ベースラインをサポートしています。Cisco Unified TSP は、TSP から CTI に送信される QBE 制御信号の IP DiffServ コード ポイント（DSCP）のマーキングとして、CTI が ProviderOpenCompletedEvent で送信した "DSCP IP for CTI Applications" というサービス パラメータの値を追加します。Cisco TAPI Wave ドライバは、CTI が StartTransmissionEvent で送信した値で、RTP パケットにマーキングします。StartTransmissionEvent で受信した DSCP 値は LINECALLINFO 構造体の DevSpecific 部分に保存され、QoS インジケータが指定された LINECALLINFOSTATE_DEVSPECIFIC イベントが発行されます。

（注）	既存のコールには RTP イベントがないため、コール中にモニタリングを開始した場合、QoS 情報は存在しません。

番号（発呼側番号、着信側番号など）の表示設定と実際の番号とは区別する必要があります。たとえば、IP フォンに番号が表示されない場合でも、その情報は Unity VM などの別のシステムで必要になる場合があります。したがって、表示名の番号/名前には、プレゼンテーション表示（PI）フラグを関連付けて、その情報をユーザに表示するかどうかを指定する必要があります。

この機能は、次のように設定できます。

Cisco Unified TSP を設定することにより、ファーストパーティまたはサードパーティの呼制御が可能になります。

サードパーティ コール制御

サードパーティ コール制御では、オーディオ ストリーム終端デバイスの制御は Cisco Unified Communications Manager に"ローカル"ではありません。このようなケースでは、デスク上の IP Phone や、アプリケーションで管理される IP Phone のグループがコントローラになります。

（注）	シスコではサードパーティ製デバイスに対する CTI デバイスのモニタリングや呼制御はサポートしていません。

ファーストパーティ呼制御では、Cisco Unified Communications Manager に CTI ポート デバイスがあることが条件です。ポートごとに処理できるアクティブなオーディオ ストリームを 1 回に 1 本だけなので、ほとんどの構成は、1 ポートにつき 1 回線になります。

TAPI アプリケーションを実行して、LINEMEDIAMODE_AUTOMATEDVOICE および LINEMEDIAMODE_INTERACTIVEVOICE を要求し、ポート デバイスの回線をオープンするまでの間、システム内に CTI ポート デバイスは実質的に存在しません。ポートがオープンされない限り、その CTI ポート デバイスに関連付けられたディレクトリ番号にコールしても、ビジー トーンまたはリオーダー トーンが返されます。

IP アドレスと UDP ポート番号は、静的に指定される（同じ IP アドレスと UDP ポート番号がすべてのコールに使用される）か、動的に指定されます。デフォルトでは、CTI ポートでは静的登録が使用されます。

ダイナミック ポート登録機能では、コールごとに IP アドレスと UDP ポート番号を設定できます。現状では、CTI ポートの登録時に IP アドレスと UDP ポート番号が指定され、その CTI ポートが登録されている間は静的に固定されています。その CTI ポートに対する確立要求をメディアが受け取ると、システムはすべてのコールで同じ静的 IP アドレスと UDP ポート番号を使用します。

ダイナミック ポート登録を使用する場合は、各コールで使用する IP アドレスと UDP ポート番号を指定する前に他の機能を呼び出さないでください。IP アドレスと UDP ポート番号の設定前に機能を呼び出すと正しく動作せず、メディアのタイムアウトの発生のタイミングに応じてコールの状態が設定されます。

CTI ルート ポイントの制御には、Cisco Unified TAPI を使用できます。CTI ルート ポイントを使用すると、Cisco Unified TAPI アプリケーションは、膨大なキュー中の着信コールをリダイレクトできます。これにより、コールの着信時に話中になるのを防ぐことができます。

CTI ルート ポイント デバイスには、LINEADDRCAPFLAGS_ROUTEPOINT というアドレス機能フラグがあります。このタイプの回線をオープンしたアプリケーションは、すべての着信コールを処理できます（接続解除、受信、または他のディレクトリ番号へのリダイレクト）。リダイレクションの決定は、発信者 ID 情報や、時刻など、プログラムで取得できるさまざまな情報を基準にして実行できます。

ルート ポイントでメディア終端機能を使用すると、ルート ポイントでアプリケーションからメディアを終了できます。この機能を利用すると、ルート ポイントにあるコールに対してメディアを確立する際に、IP アドレスとポート番号をアプリケーションから渡すことができます。

ルート ポイントでは次の機能がサポートされます。

• 応答

• 複数のアクティブ コール

• リダイレクト

• 保留

• 保留解除

• ブラインド転送

• DTMF ディジット

• トーン

Cisco Unified TSP は、コール パーク ディレクトリ番号（Call Park DN）上のコールのコール モニタリングをサポートしています。Cisco Unified TSP は、LINEDEVCAPS 構造体のデバイス固有拡張機能により、TAPI アプリケーションによるコール パーク DN 回線と他の回線との区別します。アプリケーションがコール パーク DN 回線をオープンすると、そのコール パーク DN で保留されているすべてのコールがアプリケーションに通知されます。アプリケーションは、コール パーク DN で保留されているコールに対して、呼制御機能を実行できません。

コール パーク DN 回線をオープンするには、Cisco Unified Communications Manager の Cisco Unified TSP ユーザの管理画面のユーザ設定で Monitor Call Park DNs にチェックマークを入れます。この権限が付与されていない場合には、初期化中に、アプリケーションがコール パーク DN 回線を認識できなくなります。

Cisco Unified TAPI ソリューションでは、TAPI アプリケーションと Cisco Unified TSP を同じマシンにインストールします。といっても、Cisco Unified TAPI アプリケーションと Cisco Unified TSP が、相互に直接通信するわけではありません。TAPI アプリケーションと Cisco Unified TSP の間には、Microsoft 社によって提供された中間レイヤがあります。このレイヤは TAPISRV と呼ばれ、これにより複数の TSP を同一マシン上にインストールできるようになります。このことは、Cisco Unified TAPI アプリケーション側から意識する必要はありません。TAPI アプリケーション側から見た唯一の相違点は、制御できる回線の数が増えることだけです。

たとえば、Cisco Unified TSP1 で 100 回線が利用され、Cisco Unified TSP2 でも 100 回線が利用されていると仮定します。Cisco Unified TSP が 1 つのアーキテクチャでは、Cisco Unified TSP としては Cisco Unified TSP1 のみをインストールします。このとき、Cisco Unified TSP1 は TAPISRV に対して、100 回線をサポートしていることを伝え、TAPISRV はアプリケーションに対して、100 回線を制御できることを伝えます。両方の Cisco Unified TSP をインストールするマルチ Cisco Unified TSP アーキテクチャでは、Cisco Unified TSP1 が TAPISRV に対して、100 回線をサポートしていることを伝え、Cisco Unified TSP2 も TAPISRV に対して、100 回線をサポートしていることを伝えます。TAPISRV が、この回線数を合わせて、200 回線をサポートしていることをアプリケーションに伝えます。アプリケーションは TAPISRV と情報を交換し、TAPISRV は適切な Cisco Unified TSP との情報交換を処理されます。

各 Cisco Unified TSP は、Cisco Unified Communications Manager ディレクトリで管理する異なるユーザ名とパスワードで設定してください。また、各ユーザに関連付けられているデバイスが重複しないように、各ユーザのデバイス関連付けの設定をします。マルチ Cisco Unified TSP システム内の各 Cisco Unified TSP 同士は、情報交換しません。マルチ Cisco Unified TSP のシステム内の各 Cisco Unified TSP は、次の図に示すように、CTI Manager との CTI 接続を個別に作成します。複数の Cisco Unified TSP を使用すると、スケーラビリティおよびパフォーマンスの向上につながります。

図 3. CTI Manager に接続されたマルチ Cisco Unified TSP

CTI デバイス/回線制限が実装されている場合は、CTIRestricted フラグがデバイスまたは回線ごとに設定されます。デバイスが制限されている場合は、そのデバイスに対して設定されているすべての回線が制限されていると見なされます。

Cisco Unified TSP は、制限されているデバイスおよび回線をアプリケーションにレポートしません。Cisco Unified Communications Manager の管理から CTIRestricted フラグを変更すると、Cisco Unified TSP は通常のデバイスまたは回線の追加または削除として処理します。