SDK

SDK HDX

L’application Citrix Workspace améliore la prise en charge des sessions HDX et SDK en vous permettant de personnaliser votre modèle de mise à disposition pour les applications et les bureaux hébergés par Citrix via votre site Web.

Cette fonctionnalité est utile pour enrichir l’expérience dans vos portails d’entreprise et pour permettre aux utilisateurs d’accéder aux applications en tant que service. Vous pouvez offrir cette expérience lorsque vous hébergez l’application Citrix Workspace pour HTML5 sur votre serveur Web tout en lançant des applications et des bureaux hébergés par Citrix depuis votre site Web.

Pour accéder à la documentation relative au SDK HDX pour l’application Citrix Workspace pour HTML5, consultez la section SDK HDX pour HTML5.

Pour obtenir des exemples de SDK HDX, consultez la page de téléchargement de Citrix.

Prise en charge de la mise à jour automatique de l’application Citrix Workspace pour HTML5 à l’aide de HDX SDK pour HTML5

Le SDK Citrix HDX pour HTML5 améliore l’API setPath pour consommer la dernière version de l’application Citrix Workspace pour HTML5 à partir du CDN. Cette amélioration permet à l’application Citrix Workspace pour HTML5 de s’exécuter sur la dernière version de manière transparente. Pour les utilisateurs existants du SDK HDX pour HTML5, modifiez citrix.receiver.setPath dans le code client pour utiliser la dernière version du CDN. Pour les nouveaux utilisateurs, l’API setPath fournit l’option par défaut.

Le CDN est fourni en tant que paramètre par défaut. En cas de problème avec le CDN, l’emplacement hébergé est fourni en tant que chemin de secours. Pour plus d’informations, consultez SDK HDX pour HTML5.

Dernière version de Citrix HDX SDK pour HTML5

Assurez-vous d’utiliser la dernière version du SDK Citrix HDX pour HTML5 pour démarrer les sessions. Dans le cas contraire, la session risque de ne pas démarrer.

Pour plus d’informations, consultez Application Citrix Workspace pour HTML5 HDX SDK.

Prise en charge du SDK du canal virtuel

Le SDK du canal virtuel Citrix prend en charge l’écriture d’applications du côté serveur et de pilotes du côté client à l’aide du protocole ICA. Les applications de canal virtuel côté serveur se trouvent sur le serveur Citrix Virtual Apps and Desktops.

Le SDK du canal virtuel prend en charge l’écriture de nouveaux canaux virtuels ; l’application Citrix Workspace pour HTML5 peut prendre en charge jusqu’à 20 canaux virtuels personnalisés.

Limites connues de cette fonctionnalité

• Si la configuration des canaux virtuels est incorrecte, vous pouvez observer un délai de 30 secondes.
• Lorsque vous créez un canal virtuel personnalisé, donnez un nom à « streamName » en commençant par une valeur autre que « CTX ».

Pour plus d’informations, accédez à la page Citrix Virtual Channel SDK for Citrix Workspace app for HTML5.

Prise en charge du SDK Unified Communications (UC)

Le SDK Citrix Unified Communications permet aux fournisseurs de communications unifiées, aux fournisseurs de centres de contacts cloud, aux fournisseurs de plate-forme de communication en tant que service (CPaaS) ou à tout fournisseur de communications basées sur WebRTC de s’intégrer de manière transparente aux applications de bureau électroniques ou basées sur un navigateur.

Pour plus d’informations, consultez l’article de Tech Zone Unified Communications (UC) SDK.

Redirection des API WebHID

Le SDK Unified Communications pour l’application Citrix Workspace pour HTML5 implémente la redirection des API WebHID telles que définies dans Citrix-WebRTC, avec certaines limitations connues. Ces problèmes sont les suivants :

• Si plusieurs périphériques HID du même type existent, l’utilisateur ne peut pas sélectionner un périphérique spécifique à tester.
• Sur les machines Mac, lorsque vous utilisez l’application Citrix Workspace pour HTML5, celle-ci peut ne pas parvenir à récupérer le “compositeId” personnalisé avant qu’un périphérique multimédia nouvellement connecté ne soit prêt.
• Sur les systèmes Windows et Mac, lors de l’utilisation de l’application Citrix Workspace pour HTML5, les utilisateurs peuvent avoir besoin de réaccorder les autorisations d’accès pour les périphériques reconnectés. Ce processus inclut les périphériques utilisant un récepteur USB pour clavier ou souris sans fil. La nécessité de réaccorder les autorisations est due à l’absence d’un événement de connexion.

Remarque

Cette fonction est désactivée par défaut.

Comment configurer

Vous pouvez activer la fonctionnalité en utilisant :

• Configuration.js
• Service Global App Configuration

Configuration.js

Dans l’application Citrix Workspace pour HTML5, le fichier configuration.js se trouve sous le dossier C:\Program Files\Citrix\Receiver StoreFront\HTML5Client. Modifiez ce fichier pour activer la fonctionnalité.

Remarques  :

• Citrix vous recommande de sauvegarder le fichier configuration.js avant de le modifier.
• Les informations d’identification de niveau administrateur sont requises pour modifier le fichier configuration.js.

Pour activer la fonctionnalité :

1. Accédez au fichier configuration.js dans le dossier HTML5Client.

2. Assurez-vous de définir l’attribut webHID sur true. Exemple de données JSON :

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

3. Définissez l’attribut hidDeviceBlockList avec le format correct. Si vous souhaitez bloquer certains périphériques HID, voici un exemple de données 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. Enregistrez les modifications.

Service Global App Configuration

Les administrateurs peuvent activer la fonctionnalité en accédant à Configuration de l’espace de travail > Configuration d’applications > HDX et multimédia > MS Teams > Activer la redirection webHID et Liste de blocage des périphériques HID. Sélectionnez la case à cocher et le bouton bascule correspondant pour activer la fonctionnalité.