SDK

HDX SDK

La aplicación Citrix Workspace mejora la compatibilidad con sesiones de HDX y SDK al permitirle personalizar su modelo de entrega de escritorios y aplicaciones alojadas de Citrix a través de su sitio web.

Esta función resulta útil para proporcionar una experiencia positiva con las aplicaciones en sus portales de empresa y como servicio para los usuarios. Puede ofrecer la experiencia cuando aloja la aplicación Citrix Workspace para HTML5 en un servidor web mientras las aplicaciones y escritorios alojados en Citrix se inician desde su sitio web.

Para ver la documentación del SDK de HDX de la aplicación Citrix Workspace para HTML5, consulte HDX SDK para HTML5.

Para ver ejemplos de HDX SDK, consulte la página de descargas de Citrix.

Disponible la actualización automática para la aplicación Citrix Workspace para HTML5 mediante el SDK de HDX para HTML5

Citrix HDX SDK para HTML5 mejora la API setPath para usar la compilación más reciente de la aplicación Citrix Workspace para HTML5 desde la CDN. Esta mejora permite que la aplicación Citrix Workspace para HTML5 se ejecute sin problemas en la versión más reciente. Para los usuarios existentes del SDK de HDX para HTML5, cambie citrix.receiver.setPath en el código del cliente para usar la versión más reciente de la CDN. Para los usuarios nuevos, la API setPath proporciona la opción de forma predeterminada.

La CDN se proporciona como opción predeterminada. En caso de que haya algún problema con la CDN, la ubicación alojada sirve de ruta de reserva. Para obtener más información, consulte HDX SDK for HTML5.

La versión más reciente del SDK de Citrix HDX para HTML5

Compruebe que está usando la versión más reciente del SDK de Citrix HDX para HTML5 para iniciar las sesiones. De lo contrario, es posible que la sesión no se inicie.

Para obtener más información, Citrix Workspace app for HTML5 HDX SDK.

Compatibilidad con Virtual Channel SDK

El SDK de Citrix Virtual Channel (VC) admite la escritura de aplicaciones del lado del servidor y controladores del lado del cliente que usan el protocolo ICA. Las aplicaciones de canal virtual del lado del servidor se encuentran en el servidor Citrix Virtual Apps and Desktops.

VC SDK admite la escritura de nuevos canales virtuales y la aplicación Citrix Workspace para HTML5 puede admitir hasta 20 canales virtuales personalizados.

Limitaciones conocidas de la función

• Si la configuración de los canales virtuales es incorrecta, puede observarse una demora de 30 segundos.
• Cuando cree un canal virtual personalizado, comience ‘streamName’ con algo distinto de ‘CTX’.

Para obtener más información, consulte Citrix Virtual Channel SDK para la aplicación Citrix Workspace para HTML5.

Compatibilidad con el SDK de comunicación unificada (UC)

El SDK de comunicación unificada de Citrix permite a los proveedores de comunicación unificada, proveedores de centros de contacto en la nube, proveedores de plataformas de comunicaciones como servicio (CPaaS) o cualquier proveedor de comunicaciones basado en WebRTC integrarse perfectamente con aplicaciones de explorador o de escritorio basadas en Electron.

Para obtener más información, consulte el artículo sobre el SDK de comunicación unificada (UC) de Tech Zone.

Redirección de las API de WebHID

El SDK de comunicación unificada para la aplicación Citrix Workspace para HTML5 implementa la redirección de las API de WebHID tal como se define en Citrix-WebRTC, con ciertas limitaciones conocidas. Ellos son:

• Si existen varios dispositivos HID del mismo tipo, el usuario no puede seleccionar un dispositivo específico para las pruebas.
• En las máquinas Mac, cuando usa la aplicación Citrix Workspace para HTML5, es posible que la aplicación no pueda obtener el “compositeId” personalizado antes de que un dispositivo multimedia recién conectado esté listo.
• En sistemas Windows y Mac, al usar la aplicación Citrix Workspace para HTML5, es posible que los usuarios necesiten conceder nuevamente permisos de acceso para los dispositivos reconectados. Este proceso incluye dispositivos que usan un receptor USB de teclado o mouse inalámbrico. La necesidad de conceder nuevamente los permisos se debe a la ausencia de un evento de conexión.

Nota:

Esta función está inhabilitada de forma predeterminada.

Modo de configuración

Puede habilitar la función mediante:

• Configuration.js
• Global App Configuration Service

Configuration.js

En la aplicación Citrix Workspace para HTML5, el archivo configuration.js se encuentra en la carpeta C:\Program Files\Citrix\Receiver StoreFront\HTML5Client. Modifique este archivo para habilitar la función.

Notas:

• Citrix recomienda hacer una copia de seguridad del archivo configuration.js antes de modificarlo.
• Se requieren credenciales de nivel de administrador para modificar el archivo configuration.js.

Para habilitar la funcionalidad:

1. Vaya al archivo configuration.js que se encuentra en la carpeta HTML5Client.

2. Asegúrese de establecer el atributo webHID en true. A continuación, se muestra un ejemplo de datos JSON:

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

3. Establezca el atributo hidDeviceBlockList con el formato correcto. Si quiere bloquear algunos dispositivos HID, a continuación se muestra un ejemplo de datos 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. Guarde los cambios.

Global App Configuration Service

Los administradores pueden habilitar la función desde Configuración de Workspace > Configuración de aplicaciones > HDX y Multimedia > MS Teams > Habilitar refirección webHID y Lista de bloque de dispositivos HID. Seleccione la casilla de verificación y el botón de alternancia correspondiente para habilitar la función.