Unified Communications SDK の最適化

最終公開日 : Nov 13, 2026

はじめに

Citrix Virtual Apps and Desktops は、幅広いエンドポイントデバイスでユーザーにアプリケーションを配信できます。これらのアプリケーションの多くには、オーディオおよびビデオ会議のようなリアルタイム通信 (RTC) 機能が含まれています。しかし、仮想化環境でこれらのアプリケーションを配信する際には、課題が生じる可能性があります。従来の配信方法では、メディアストリーム (オーディオ/ビデオ) をクライアントデバイスからデータセンター内のVDIサーバーにルーティングし、その後エンドポイントに送り返します。この「ヘアピン化」は、特に帯域幅を大量に消費するオーディオおよびビデオ通話において、サーバーに不要なトラフィックと処理オーバーヘッドをもたらします。
Citrix Unified Communications SDK (UCSDK) は、テクノロジーベンダーがこれらのRTCアプリケーションをCitrix環境で使用するために最適化できるようにするテクノロジーです。アプリケーションが最適化されると、ローカルデスクトップで実行されているアプリケーションと同等か、それ以上のユーザーエクスペリエンスを提供できます。今日の世の中では、シームレスなリアルタイム通信は生産性とコラボレーションに不可欠です。仮想環境内でアプリケーションを使用する場合、音声通話やビデオ通話、画面共有、その他の通信機能がローカルデスクトップと同じくらいスムーズに動作することが重要です。最適化されたアプリケーションは、このエクスペリエンスを提供します。
この製品ドキュメントでは、Citrixのお客様がUCSDK最適化アプリケーションを学習し、展開するために必要なすべてを詳述しています。

動作の仕組み

Citrixは、VDI内のリアルタイム通信アプリケーション向けに最適化された配信方法を提供しています。このアプローチでは、Unified Communications SDK (UCSDK) を活用して、仮想化されたアプリケーションを次の2つの部分に分割します。
  • ユーザーインターフェイス (UI): ユーザーインターフェイスは仮想ホスト内に残り、仮想デスクトップまたはアプリケーションウィンドウ内にシームレスに表示されます。
  • メディアエンジン: メディア処理タスク (オーディオおよびビデオのエンコード/デコード) は、ユーザーのローカルデバイスにオフロードされます。これにより、サーバーの負荷が最小限に抑えられ、ネットワーク使用量が最適化されます。
通常、Citrixはリアルタイム通信分野のテクノロジーベンダーにUCSDKを提供し、それらのアプリケーションにUCSDKを統合するために協力しています。統合されると、UCSDK最適化アプリケーションを使用するCitrixのお客様は、強化されたエクスペリエンスを得ることができます。Citrix UCSDKは、カスタムの社内アプリケーションが構築されている場合にも、Citrixのお客様が利用できます。ただし、ほとんどの場合、お客様はUCSDKを利用して開発する必要はなく、最適化されたエクスペリエンスを実現するためにCitrix環境とアプリケーションを構成するだけで済みます。
注:
Citrix WebRTC SDK (または) HDX™最適化アプリケーションへの参照は、Citrix UCSDKとの統合を示しており、互換的に使用できます。

主な利点

Citrix UCSDKで最適化されたアプリケーションを使用する場合、次のことが期待できます。
  • プロセッサ集約型のメディアエンコード/デコードをCitrix Virtual Delivery Agent (VDA) からクライアントエンドポイントにオフロードすることにより、メディア処理パフォーマンスが向上し、エンドユーザーの全体的な応答性が向上します。
  • Citrix VDAでのCPUおよび帯域幅使用量の削減により、IT部門はホストあたりより多くの同時実行ユーザーをサポートできるようになり、企業はCitrix仮想デスクトップの展開を費用対効果の高い方法で拡張できます。
  • 最適化されたエンドポイントがレガシー仮想デスクトップの寿命を延ばし、ホストインフラストラクチャの必要性を削減するため、企業にとっての総所有コストが削減され、これにより設備投資と運用コストを長期的に削減できます。
  • Windows、Mac、Linux、ChromeOS、HTML5のエンドポイントプラットフォームに対応。

ユースケース

UCSDKは、WebRTC標準に準拠するリアルタイム通信アプリケーションを最適化するために特別に構築されています。以下に、主要なシナリオと、UCSDKを使用できる/すでに使用しているWebRTCベースのアプリケーションの種類を示します。
  • Contact Center as a Service (CCaaS) / クラウドコンタクトセンタープラットフォーム: 主に複数のチャネルにわたる顧客とのやり取りを管理し、エージェントのワークフローを最適化します。
    • 例: アマゾンコネクト, トゥイリオ, アバイア エクスペリエンス プラットフォーム, トークデスク, コンテンツグル
  • Unified Communications as a Service (UCaaS) / クラウドビジネスコミュニケーション: 音声、ビデオ、チームメッセージング、プレゼンスを統合し、包括的なビジネスコミュニケーションを実現します。
    • 例: リングセントラル、エイトバイエイト、インターメディア、アルカテル・ルーセント レインボー
  • Communications Platform as a Service (CPaaS): リアルタイム通信機能をカスタムアプリケーションに直接組み込むためのAPIを提供します。
    • 例: トゥイリオ、リボン・コミュニケーションズ
  • エンタープライズビデオ会議およびコラボレーション: 高品質のビデオ会議、カンファレンス、高度なコラボレーション機能のための専用プラットフォームです。
    • 例: Pexip
  • 金融取引通信: 金融市場の独自の、高性能でコンプライアンスに準拠した通信ニーズのために設計されています。
    • 例: IPC Unigy
  • 仮想学習およびトレーニングプラットフォーム: インタラクティブで高品質な仮想教室およびトレーニング体験のために設計されています。
    • 例: ビテロ
Citrix UCSDKの基盤となるWebRTCにより、その最適化機能はWebRTCベースのあらゆる通信アプリケーションに拡張できます。これにより、リアルタイムインタラクションにWebRTCを利用する幅広いアプリケーションの最適化が可能になります。これらのアプリケーションが現在UCSDKで最適化されているとリストされていなくても、最適化を希望するユースケースやアプリケーションがあれば、Citrixにお問い合わせいただくことをお勧めします。

UCSDK アーキテクチャ

UCSDK アーキテクチャ (/en-us/citrix-virtual-apps-desktops/2511/media/ucsdk-architecture.png)
  • ベンダーアプリケーション: これは、UCSDK を統合した、デスクトップベースまたはブラウザベースのサードパーティ製リアルタイム通信アプリケーションです。
  • UCSDK JS: UCSDK JS は、ベンダーアプリケーションがオーディオ/ビデオをエンドポイントにオフロードするために利用する API を提供します。
  • HdxRtcEngine: これは、Citrix Workspaceアプリに組み込まれたWebRTCメディアエンジンで、オフロードされたオーディオ/ビデオ通話を処理します。
SDKがロードされて使用されると、リダイレクトが成功した場合、クライアントエンドポイントでHdxRtcEngine.exeプロセスが起動します。クライアントエンドポイントでHdxRtcEngine.exeが起動すると、すべてのシグナリングおよびペイロードデータはCitrix VDAからクライアントエンドポイントに流れ、クラウドに到達し、クライアントエンドポイントに戻ってからVDAに転送されます。たとえば、フローの完全な往復は次のようになります。
Vendor App -> CitrxWebrtc.js SDK -> Citrix VDA components -> Citrix Client Endpoint components -> Cloud -> Citrix Client Endpoint components -> Citrix VDA components -> CitrxWebrtc.js SDK -> Vendor App

システム要件

システム要件は、UCSDKの最新バージョンである5.0.0で必要となるCitrixコンポーネントのさまざまなバージョンを示しています。SDKの以前のバージョンおよび特定の機能要件に関する互換性の詳細については、以下のバージョンと機能マトリックス表を参照してください。
注:
お客様が UCSDK に追加された機能を使用するには、ベンダーアプリケーションが適切な UCSDK バージョンを統合し、その機能を有効にしていること、および環境で適切な VDA および CWA バージョンを使用していることを確認してください。

完全な互換性のあるバージョン

「完全に互換性のあるバージョン」とは、これらのCitrixコンポーネントのバージョンを最新バージョンのUCSDKと組み合わせて使用することで、お客様が利用可能なすべての機能を利用できることを示します。現在の最新バージョンであるUCSDK 5.0.0の場合、Citrixコンポーネントの完全に互換性のあるバージョンは以下のとおりです。
  • シトリックス バーチャルアプリ™ および デスクトップ: 2603
  • シトリックス ワークスペースアプリ ウィンドウズ: 2603
  • Citrix Workspace App Mac: リリース予定
  • Citrix Workspace アプリ リナックス: 2603
  • Citrix Workspace App ChromeOS/HTML5: リリース予定
注:
UCSDK最適化は、すべてのエンドポイントプラットフォーム:Windows、Mac、Linux、ChromeOS、およびHTML5でサポートされています。上記のリストで特定のエンドポイントプラットフォームに対してリリース予定と表示されている場合、それは最新のUCSDK機能と完全に互換性のあるバージョンがまだリリースされていないことを意味します。したがって、お客様は、新しいUCSDKを使用している場合でも、既存の機能を引き続き使用するために、Citrix Workspaceアプリの古いバージョンを使用できます。

構成

UCSDKの機能は、ベンダーが統合したUCSDKのバージョンとベンダーが有効にした機能、Citrix Virtual Apps and Desktops、および使用中のCitrix Workspaceアプリのバージョンの3つの要因に依存します。
Citrix側では、最適化されたアプリケーションが最適化されるように、以下が構成されていることを確認してください。
  1. Microsoft Teamsリダイレクトポリシーがオンになっていることを確認します。詳細については、マルチメディアポリシー設定を参照してください。このポリシーはデフォルトでオンになっています。
  2. CitrixWebrtc.js SDKを利用するサードパーティのElectronまたはブラウザベースのアプリケーションは、デフォルトではサポートされていません。CtxHdxWebSocketService (WebSocketService.exe) は、許可リストにないアプリケーションからの接続を許可しません。目的のアプリケーションバイナリ実行可能ファイル名をホワイトリストレジストリキーに追加する必要があります。

VDA上

  • キーパスを作成します: HKLM\Software\WOW6432Node\Citrix\WebSocketService
  • キー名: ProcessWhitelist
  • タイプ: MULTISZ
  • キー値: Mytestapp.exe
複数のアプリケーションがある場合は、各アプリケーションを新しい行に入力します。テキストファイルからコピー&ペーストしたり、コンマを挿入したりしないでください。指定された名前がアプリケーションの実行可能ファイル名と一致していることを確認してください。このレジストリ値は大文字と小文字を区別しません。
アプリケーションが本格的なデスクトップアプリケーションではなくブラウザ経由でアクセスされる場合、レジストリ値で例えば chrome.exe を許可する必要があります。
上記のレジストリが正常に構成されたら、VDA を再起動するか、CtxHdxWebSocketService を再起動してホワイトリストの設定を完了します。

クライアント上

設定は不要です。Citrix Workspace アプリをインストールするだけです。
各ベンダーは非常に特定のアプリケーション名を持っている場合があります。したがって、WebSocketService で許可する必要があるアプリケーション名を特定するには、現在のベンダーサポート セクションにリンクされているベンダーのドキュメントを参照してください。

機能リファレンス

Smart Sync による通話接続時間の短縮

UCSDK 5.0.0 で導入された Smart Sync 機能は、VDA とクライアントエンドポイント間の通信を効率化することで、通話接続時間を短縮します。この機能強化により、全体的に通話設定が高速化され、特に高遅延ネットワーク環境で最も顕著なパフォーマンス向上をもたらします。
Citrix は、この機能を活用するために、顧客がアプリケーションベンダーに連絡して UCSDK 5.0.0 にアップグレードすることを推奨します。
注:
この機能は UCSDK 5.0.0 と Citrix Workspace アプリのみに依存します。正確なクライアントバージョンについては、バージョンと機能マトリックス を参照してください。VDA のバージョン依存性はないため、以前のサポート対象 VDA も引き続き使用できます。

パフォーマンスとユーザーエクスペリエンスを向上させる最適化されたオーバーレイクリッピング

CVAD 2511以降、HDX Microsoft Teams最適化やUCSDK最適化などの機能におけるリダイレクトされたビデオオーバーレイを処理するメカニズムは、ユーザーエクスペリエンスとサーバーパフォーマンスの両方を向上させるために再設計されました。

主な利点

  • 視覚的な正確性の向上: この機能強化により、ポップアップメニューや通知などのアプリケーション要素がビデオコンテンツの背後に誤って表示される視覚的な不具合が解消されます。新しいロジックにより、すべてのコンポーネントが正しい順序でレンダリングされ、よりシームレスで予測可能なエクスペリエンスが提供されます。
  • パフォーマンスの向上: この最適化により、Virtual Delivery AgentでのCPU使用率が大幅に削減されます。古いリソースを大量に消費するポーリング方法を、より効率的なグラフィックベースのアプローチに置き換えることで、この変更はサーバーのスケーラビリティを向上させ、より高いユーザー密度を可能にします。
注:
この機能は、将来のバージョンのMicrosoft Teams(またはその他のUCSDKパートナーアプリケーション)に依存し、Citrix Workspace App for Windows 2511が必要です。

バージョンと機能マトリックス

バージョン更新は頻繁に行われるため、特定のバージョンがサポートされていることを確認するには、Citrix Virtual Apps and Desktops および Citrix Workspace app の製品ライフサイクルページを参照してください。多くの古い機能については、表に記載されているバージョンは、このドキュメントの執筆時点での最終サポート対象のCurrent Release (CR) バージョンです。
機能 UCSDKバージョン VDA CWA ウィンドウズ CWA Mac CWA リナックス CWA ChromeOS/HTML5
オーディオ/ビデオ (P2P & 会議) 3.1.0 2203 LTSR 最新 CU / 2311 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 2312
画面共有 3.1.0 2203 LTSR 最新 CU / 2311 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 2312
DTMF 3.1.0 2203 LTSR 最新CU / 2311 CR 2402 LTSR 最新CU / 2311 CR 2311 2311 2312
プロキシサーバーのサポート 3.1.0 2203 LTSR 最新CU / 2311 CR 2402 LTSR 最新CU / 2311 CR 2311 2311 2312
アプリ共有 3.1.0 2203 LTSR 最新 CU / 2311 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 N/A
動的 e911 3.1.0 2203 LTSR 最新 CU / 2311 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 2312
マルチウィンドウ 3.1.0 2203 LTSR 最新 CU / 2311 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 2312
SDP 統合プランのサポート 3.1.0 2203 LTSR 最新 CU / 2311 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 2312
ストリーム解像度 / サイマルキャスト 3.1.0 2203 LTSR 最新 CU / 2311 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 2312
リモートオーディオ (ループ付き) 3.1.0 2203 LTSR 最新 CU / 2311 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 2405
ブラウザベースのUCSDK (ブートストラップサポート) 4.0.2 2407 CR 2402 LTSR 最新 CU / 2311 CR 2311 2311 2312
Web HID API 4.0.2 2203 LTSR 最新 CU / 2311 CR 2409.10 2411 2411 2505
ウェブオーディオAPI 4.0.2 2203 LTSR 最新 CU / 2311 CR 2405 2405 2405 該当なし
ICE の再起動 4.1.0 2203 LTSR 最新 CU / 2311 CR 2503.2 2503 2503 2502.10
画面録画 (プレビュー)¹ 4.1.0 2503 2503.2 該当なし 該当なし 該当なし
SmartSync 5.0.0 2203 LTSR 最新 CU / 2311 CR 2603 該当なし 2604 該当なし
注:
画面録画用の新しいポリシーを導入したため、CVAD 2503に付属するdelivery controller™のバージョン2503が必要です。

現在のベンダーサポート

複数のサードパーティベンダーが、Unified Communications SDK を自社製品に統合しています。ベンダーとそのサポートドキュメントの現在のリストを以下に示します。

トラブルシューティング

トラブルシューティング情報については、Citrix Unified Communications SDK で最適化されたアプリのトラブルシューティング ガイダンスを参照してください。

既知の問題と制限事項

このセクションでは、現在認識されている既知の問題と制限事項について説明します。