SDK
HDX™ SDK
Citrix Workspaceアプリは、Webサイトを通じてCitrixホスト型アプリおよびデスクトップの配信モデルをカスタマイズできるようにすることで、HDXおよびSDKセッションのサポートを強化します。
この機能は、エンタープライズポータルで豊富なアプリエクスペリエンスを構築したり、サービスとしてユーザーに提供したりするのに役立ちます。WebサイトからCitrixホスト型アプリおよびデスクトップを起動しながら、WebサーバーでCitrix Workspaceアプリ for HTML5をホストすることで、このエクスペリエンスを提供できます。
Citrix Workspaceアプリ for HTML5のHDX SDKのドキュメントについては、HDX SDK for HTML5を参照してください。
HDX SDKの例については、Citrixのダウンロードページを参照してください。
HDX SDK for HTML5を使用したCitrix Workspaceアプリ for HTML5の自動更新サポート
Citrix HDX SDK for HTML5は、CDNからCitrix Workspaceアプリ for HTML5の最新ビルドを使用するために
setPath APIを強化します。この機能強化により、Citrix Workspaceアプリ for HTML5は最新バージョンでシームレスに実行できます。既存のHDX SDK for HTML5ユーザーは、顧客コードのcitrix.receiver.setPathを変更してCDNから最新のものを使用してください。新規ユーザーの場合、setPath APIはデフォルトでこのオプションを提供します。
CDNはデフォルトで提供されます。CDNに問題がある場合、ホストされている場所がフォールバックパスを提供します。詳細については、HDX SDK for HTML5を参照してください。
Citrix HDX SDK for HTML5の最新バージョン
セッションを開始するには、Citrix HDX SDK for HTML5の最新バージョンを使用していることを確認してください。そうしないと、セッションが開始に失敗する可能性があります。
詳細については、Citrix Workspaceアプリ for HTML5 HDX SDKを参照してください。
仮想チャネルSDKのサポート
Citrix Virtual Channel (VC) SDKは、ICAプロトコルを使用してサーバー側アプリケーションとクライアント側ドライバーを作成することをサポートします。サーバー側仮想チャネルアプリケーションは、Citrix Virtual Apps and Desktopsサーバー上にあります。
VC SDKは新しい仮想チャネルの作成をサポートし、Citrix Workspaceアプリ for HTML5は最大20個のカスタム仮想チャネルをサポートできます。
この機能の既知の制限事項
-
仮想チャネルの設定が正しくない場合、30秒の遅延が発生する可能性があります。
-
カスタムVCを作成するときは、「streamName」を「CTX」以外の文字で始めてください。
詳細については、「Citrix Virtual Channel SDK for Citrix Workspace app for HTML5」を参照してください。
仮想チャネルSDKの機能強化
2305リリース以降、Citrix Workspaceアプリfor HTML5は、仮想チャネルSDKでウィンドウ管理APIをサポートしています。Web APIを使用すると、IT管理者はインタラクティブなアプリケーションを作成し、エンドユーザー向けにカスタマイズできます。
ユニファイドコミュニケーション（UC）SDKのサポート
CitrixユニファイドコミュニケーションSDKを使用すると、ユニファイドコミュニケーションベンダー、クラウドコンタクトセンタープロバイダー、Communications Platform as a Service（CPaaS）プロバイダー、またはWebRTCベースの通信ベンダーは、Electronベースのデスクトップアプリケーションやブラウザーベースのアプリケーションとシームレスに統合できます。
詳細については、Tech Zoneの記事である「Unified Communications (UC) SDK」を参照してください。
WebHID APIのリダイレクト
Citrix Workspace™アプリfor HTML5用ユニファイドコミュニケーションSDKは、Citrix-WebRTCで定義されているWebHID APIのリダイレクトを、いくつかの既知の制限付きで実装しています。それらは次のとおりです。
-
同じ種類のHIDデバイスが複数存在する場合、ユーザーはテスト用に特定のデバイスを選択できません。
-
MacマシンでCitrix Workspaceアプリfor HTML5を使用すると、新しく接続されたメディアデバイスの準備が整う前に、アプリがカスタムの「compositeId」を取得できない場合があります。
-
WindowsとMacの両方のシステムでCitrix Workspaceアプリfor HTML5を使用する場合、ユーザーは再接続されたデバイスのアクセス許可を再付与する必要がある場合があります。このプロセスには、ワイヤレスキーボードまたはマウスのUSBレシーバーを使用するデバイスが含まれます。アクセス許可の再付与が必要なのは、接続イベントがないためです。
注：
-
この機能はデフォルトで無効になっています。
-
Microsoft Teamsに最適化されたセカンダリ着信音が有効になっている場合、Citrix Workspaceアプリfor HTML5クライアントでは着信音が再生されません。新しいMicrosoftアセットURLを利用するには、Citrix Workspaceアプリfor HTML5 SDKを更新する必要があります。Microsoft Content Delivery Network（CDN）からのメディア読み込みを有効にするには、
HDXEngine.htmlのContent Security Policy（CSP）メタタグ内のmedia-srcディレクティブに<https://*.onecdn.static.microsoft>を追加します。
構成方法
この機能は、以下を使用して有効にできます。
-
Configuration.js
-
グローバルアプリ構成サービス
Configuration.js
Citrix Workspaceアプリ for HTML5では、configuration.jsファイルは
C:\Program Files\Citrix\Receiver StoreFront\HTML5Clientフォルダーの下にあります。このファイルを編集して機能を有効にします。
注記:
-
Citrixは、configuration.jsファイルを変更する前にバックアップすることを推奨します。
-
configuration.jsファイルを編集するには、管理者レベルの資格情報が必要です。
この機能を有効にするには：
-
HTML5Client フォルダー内の configuration.js ファイルに移動します。
-
属性
webHIDをtrueに設定してください。以下はJSONデータの例です。'features' : {
'msTeamsOptimization' : {
'webHID' : true
}
} -
属性hidDeviceBlockListを正しい形式で設定します。一部のHIDデバイスをブロックしたい場合は、以下はJSONデータの例です。
'features' : {
'msTeamsOptimization' : {
// The format of the blocklist is ["VID:PID", "VID:PID", "VID:PID", ...]
// Each VID and PID is an up to 4-digit hexadecimal number with an optional "0x" prefix.
// The VID is a required field. The PID is optional, so the colon and PID can be omitted.
// example ["35ab:21ff", "45ac", "0x567:123a", "0x1234:0x5678"]
'hidDeviceBlockList' : []
}
} -
変更を保存します。
グローバルアプリ構成サービス
管理者は、Workspace Configuration > App Configuration > HDX and Multimedia > MS Teams > Enable webHID redirection および HID Device Blocklist に移動して機能を有効にできます。チェックボックスとそれぞれのトグルボタンを選択して、機能を有効にします。