SDK

HDX SDK

Citrix Workspaceアプリでは、Webサイトを介してシトリックスがホストするアプリおよびデスクトップの配信方式をカスタマイズでき、これによりHDXおよびSDKセッションのサポートが強化されています。

この機能は、エンタープライズポータルに豊富なアプリエクスペリエンスを構築する場合に役立ち、サービスとしてユーザーにとって有用です。 Webサイトからシトリックスがホストするアプリやデスクトップを起動する一方で、Webサーバー上ではHTML5向けCitrix Workspaceアプリをホストして、エクスペリエンスを提供できます。

HTML5向けCitrix WorkspaceアプリのHDX SDKドキュメントについては、HDX SDK for HTML5を参照してください。

HDX SDKの例については、Citrixダウンロードページを参照してください。

HDX SDK for HTML5を使用したHTML5向けCitrix Workspaceアプリ自動更新のサポート

Citrix HDX SDK for HTML5によりsetPath APIが拡張されたため、CDNから配信されるHTML5向けCitrix Workspaceアプリの最新ビルドを使用します。 この機能強化により、HTML5向けCitrix Workspaceアプリが最新バージョンでシームレスに実行されます。 HDX SDK for HTML5の既存のユーザーの場合、CDNから配信される最新バージョンを使用するように、顧客コードのcitrix.receiver.setPathを変更します。 新規ユーザーの場合、setPath APIによりこのオプションが提供されます。

CDNはデフォルトで提供されています。 CDNに問題がある場合は、ホストされる場所がフォールバックパスを提供します。 詳しくは、「HDX SDK for HTML5」を参照してください。

Citrix HDX SDK for HTML5の最新バージョン

セッションを開始するには、最新バージョンのCitrix HDX SDK for HTML5を使用していることを確認してください。 そうしないと、セッションを開始できない可能性があります。

詳しくは、「Citrix Workspace app for HTML5 HDX SDK」を参照してください。

仮想チャネルSDKのサポート

Citrix仮想チャネル（VC）SDKは、ICAプロトコルを使用して、サーバー側アプリケーションやクライアント側ドライバーの作成をサポートします。 サーバー側仮想チャネルアプリケーションは、Citrix Virtual Apps and Desktopsサーバー上にあります。

VC SDKは新しい仮想チャネルの作成をサポートし、HTML5向けCitrix Workspaceアプリは最大20のカスタム仮想チャネルをサポートできます。

この機能の既知の制限事項

• 仮想チャネルの構成が正しくない場合、30秒の遅延が発生することがあります。
• カスタムVCを作成するときは、「CTX」以外で「streamName」を開始します。

詳しくは、「Citrix Virtual Channel SDK for Citrix Workspace app for HTML5」を参照してください。

Unified Communications（UC）SDKのサポート

Citrix Unified Communications SDKを使用すると、UCベンダー、クラウドコンタクトセンタープロバイダー、Communications Platform as a Service（CPaaS）プロバイダー、または任意のWebRTCベースコミュニケーションベンダーが、Electronベースのデスクトップまたはブラウザーベースのアプリケーションとシームレスに統合できます。

詳しくは、Tech Zoneの記事「Unified Communications (UC) SDK」を参照してください。

WebHID APIのリダイレクト

HTML5向けCitrix WorkspaceアプリのUnified Communications SDKは、Citrix-WebRTCで定義されているWebHID APIのリダイレクトを実装しますが、いくつかの既知の制限があります。 それらの問題は、以下のとおりです：

• 同じ種類のHIDデバイスが複数存在する場合、ユーザーはテスト用に特定のデバイスを選択できません。
• MacマシンでHTML5向けCitrix Workspaceアプリを使用すると、新しく接続されたメディアデバイスの準備が整う前に、アプリがカスタムの「compositeId」を取得できない場合があります。
• WindowsシステムとMacシステムの両方で、HTML5向けCitrix Workspaceアプリを使用する場合、ユーザーは再接続されたデバイスに対してアクセス権限を再度付与する必要がある場合があります。 このプロセスには、ワイヤレスキーボードまたはマウスのUSBレシーバーを使用するデバイスが含まれます。 接続イベントがないため、権限を再度付与する必要があります。

注

この機能はデフォルトでは無効になっています。

構成方法

この機能を有効にするには、以下を使用します：

• Configuration.js
• Global App Configuration Service

Configuration.js

HTML5向けCitrix Workspaceアプリでは、configuration.jsファイルはC:\Program Files\Citrix\Receiver StoreFront\HTML5Clientフォルダーにあります。 このファイルを編集して、この機能を有効にします。

注：

• Citrixでは、configuration.jsファイルに変更を加える前に、バックアップを作成することをお勧めします。
• configuration.jsファイルを編集するには、管理者レベルの資格情報が必要です。

この機能を有効にするには：

1. HTML5Clientフォルダーのconfiguration.jsファイルに移動します。

2. 属性webHIDをtrueに設定してください。 このようなJSONデータの例を次に示します：

     'features' : {
         'msTeamsOptimization' : { 
             'webHID' : true 
             } 
             }
    

3. 属性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' : [] 
         }
     }
    

4. 変更を保存します。

Global App Configuration Service

管理者は、［ワークスペース構成］ > ［アプリ構成］ > ［HDXとマルチメディア］ > ［MS Teams］ > ［Enable webHID redirection］および［HID Device Blocklist］に移動して、この機能を有効にできます。 機能を有効にするには、チェックボックスとそれぞれのトグルボタンを選択します。