SDK

HDX™ SDK

Citrix Workspace app améliore la prise en charge des sessions HDX et SDK en vous permettant de personnaliser votre modèle de livraison pour les applications et bureaux hébergés par Citrix via votre site web.

Cette fonctionnalité est utile pour créer une expérience d’application riche dans vos portails d’entreprise, et pour les utilisateurs en tant que service. Vous pouvez offrir cette expérience lorsque vous hébergez Citrix Workspace app pour HTML5 sur votre serveur web tout en lançant des applications et bureaux hébergés par Citrix depuis votre site web.

Pour la documentation du HDX SDK pour Citrix Workspace app pour HTML5, consultez HDX SDK pour HTML5.

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

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

Le Citrix HDX SDK pour HTML5 améliore l’API setPath pour consommer la dernière version de Citrix Workspace app pour HTML5 depuis le CDN. Cette amélioration permet à Citrix Workspace app pour HTML5 de fonctionner de manière transparente sur la dernière version. Pour les utilisateurs existants du HDX SDK 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 offre l’option par défaut.

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

Dernière version du Citrix HDX SDK pour HTML5

Vérifiez que vous utilisez la dernière version du Citrix HDX SDK pour HTML5 pour démarrer les sessions. Dans le cas contraire, la session pourrait ne pas démarrer.

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

Prise en charge du SDK de canal virtuel

Le SDK Citrix Virtual Channel (VC) prend en charge l’écriture d’applications côté serveur et de pilotes 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 VC prend en charge l’écriture de nouveaux canaux virtuels et Citrix Workspace app pour HTML5 peut prendre en charge jusqu’à 20 canaux virtuels personnalisés.

Limitations connues de la fonctionnalité

• Si la configuration des canaux virtuels est incorrecte, vous pouvez observer un décalage de 30 secondes.
• Lorsque vous créez un VC personnalisé, commencez le ‘streamName’ par autre chose que ‘CTX’.

Pour plus d’informations, consultez Citrix Virtual Channel SDK pour l’application Citrix Workspace pour HTML5.

Améliorations du SDK de canal virtuel

À partir de la version 2305, l’application Citrix Workspace pour HTML5 prend en charge les API de gestion de fenêtre dans le SDK de canal virtuel. Les API Web permettent aux administrateurs informatiques de créer des applications interactives et de les personnaliser pour leurs utilisateurs finaux.

Prise en charge du SDK de communications unifiées (UC)

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

Pour plus d’informations, consultez SDK de communications unifiées (UC), qui est un article de la zone technique.

Redirection des API WebHID

Le SDK de communications unifiées pour l’application Citrix Workspace™ pour HTML5 implémente la redirection des API WebHID telle que définie dans Citrix-WebRTC, avec certaines limitations connues. Celles-ci sont :

• S’il existe plusieurs périphériques HID du même type, l’utilisateur ne peut pas sélectionner un périphérique spécifique pour les tests.
• Sur les machines Mac, lorsque vous utilisez l’application Citrix Workspace pour HTML5, l’application peut ne pas réussir à récupérer le ‘compositeId’ personnalisé avant qu’un nouveau périphérique multimédia 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 clavier sans fil ou un récepteur USB de souris. La nécessité de réaccorder les autorisations est due à l’absence d’événement de connexion.

Remarque :

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

Comment configurer

Vous pouvez activer la fonctionnalité en utilisant :

• Configuration.js
• Service de configuration globale des applications

Configuration.js

Dans l’application Citrix Workspace pour HTML5, le fichier configuration.js se trouve dans 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.
• Des 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. Voici un exemple de données JSON :

   'features' : {
       'msTeamsOptimization' : {
           'webHID' : true
           }
           }
   <!--NeedCopy-->
   

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' : []
       }
   }
   <!--NeedCopy-->
   

4. Enregistrez les modifications.

Service de configuration globale des applications

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