Multimedia policy settings
The Multimedia section contains policy settings for managing streaming HTML5 and Windows audio and video in user sessions.
HTML5 video redirection
Controls and optimizes the way XenApp and XenDesktop servers deliver HTML5 multimedia web content to users.
By default, this setting is disabled.
To configure HTML5 video redirection:
- Copy the file, HdxVideo.js, from %Program Files%/Citrix/ICA Service/HTML5 Video Redirection on the VDA install to the location of your internal web page.
- Insert this line into your web page (if your web page has other scripts, include HdxVideo.js before those scripts):
Note: If HdxVideo.js is not in the same location as your web page, use the src attribute to specify the full path to it.
For redirection of HTML5 videos to work, allow Windows Media Redirection. This policy is mandatory for Server Fetch Client Render, and necessary for Client Side Fetching (which in turn also requires Windows Media client-side content fetching to be Allowed).
Microsoft Edge doesn’t support this feature.
HdxVideo.js replaces the browser HTML5 Player controls with its own. To check that the HTML5 video redirection policy is in effect on a certain website, compare the player controls to a scenario where the HTML5 video redirection policy is Prohibited:
(Citrix custom controls when the policy is Allowed)
(Native webpage controls when the policy is Prohibited or not configured)
The following video controls are supported:
- full screen
You can view an HTML5 video redirection test page at https://www.citrix.com/virtualization/hdx/html5-redirect.html.
TLS and HTML5 video redirection
HdxVideo.js uses Secure Websockets to communicate with WebSocketService.exe running on the VDA. This process runs on the Local System, and performs SSL termination and user session mapping.
WebSocketService.exe is listening on 127.0.0.1 port 9001.
Limit video quality
This setting applies only to Windows Media and not to HTML5. It requires you enable Optimization for Windows Media multimedia redirection over WAN.
This setting specifies the maximum video quality level allowed for an HDX connection. When configured, maximum video quality is limited to the specified value, ensuring that multimedia Quality of Service (QoS) is maintained within an environment.
By default, this setting is not configured.
To limit the maximum video quality level allowed, choose one of the following options:
Playing multiple videos simultaneously on the same server consumes large amounts of resources and may impact server scalability.
This setting allows or prevents the use of optimized webcam redirection technology by video conferencing applications.
By default, video conferencing support is allowed.
When adding this setting to a policy, ensure that the Windows Media redirection setting is present and set to Allowed (the default).
When using multimedia conferencing, ensure that the following conditions are met:
- Manufacturer-supplied drivers for the webcam used for multimedia conferencing are installed on the client.
- Connect the webcam to the user device before initiating a video conferencing session. The server uses only one installed webcam at any given time. If multiple webcams are installed on the user device, the server attempts to use each webcam in succession until a video conferencing session is created successfully.
This policy is not needed when redirecting the web cam using Generic USB redirection. In that case, install the webcam drivers on the VDA.
Optimization for Windows Media multimedia redirection over WAN
This setting applies only to Windows Media and not to HTML5. The setting enables real-time multimedia transcoding, allowing audio and video media streaming to mobile devices over degraded networks, and enhancing the user experience by improving how Windows Media content is delivered over a WAN.
By default, the delivery of Windows Media content over the WAN is optimized.
When adding this setting to a policy, make sure the Windows Media Redirection setting is present and set to Allowed.
When this setting is enabled, real-time multimedia transcoding is deployed automatically as needed to enable media streaming, providing a seamless user experience even in extreme network conditions.
Use GPU for optimizing Windows Media multimedia redirection over WAN
This setting applies only to Windows Media and enables real-time multimedia transcoding to be done in the Graphics Processing Unit (GPU) on the Virtual Delivery Agent (VDA). It improve server scalability. GPU transcoding is available only if the VDA has a supported GPU for hardware acceleration. Otherwise, transcoding falls back to the CPU.
Note: GPU transcoding is supported only on NVIDIA GPUs.
By default, using the GPU on the VDA to optimize the delivery of Windows Media content over the WAN is prohibited.
When adding this setting to a policy, make sure the Windows Media Redirection and Optimization for Windows Media multimedia redirection over WAN settings are present and set to Allowed.
Windows media fallback prevention
This setting applies to both HTML5 and Windows Media. For it to work with HTML5, set the HTML video redirection policy to Allowed.
Administrators can use the Windows media fallback prevention policy setting to specify the methods that will be attempted to deliver streamed content to users.
By default, this setting is not configured. When the setting is set to Not Confgured, the behavior is the same as Play all content.
To configure this setting, choose one of the following options:
- Play all content. Attempt client-side content fetching, then Windows Media Redirection. If unsuccessful, play content on the server.
- Play all content only on client. Attempt client-side fetching, then Windows Media Redirection. If unsuccessful, the content does not play.
- Play only client-accessible content on client. Attempt only client-side fetching. If unsuccessful, the content does not play.
When the content does not play, the error message “Company has blocked video because of lack of resources” displays in the player window (for a default duration of 5 seconds).
The duration of this error message can be customized with the following registry key on the VDA. If the registry entry does not exist, the duration defaults to 5 seconds.
Editing the registry incorrectly can cause serious problems that may require you to reinstall your operating system. Citrix cannot guarantee that problems resulting from the incorrect use of Registry Editor can be solved. Use Registry Editor at your own risk. Be sure to back up the registry before you edit it.
The registry path varies depending on architecture of the VDA:
Range: 1 - up to DWORD limit (default = 5)
Windows Media client-side content fetching
This setting applies to both HTML5 and Windows Media. The setting enables a user device to stream multimedia files directly from the source provider on the internet or intranet, rather than through the XenApp or XenDesktop host server.
By default, this setting is Allowed. Allowing this setting improves network usage and server scalability by moving any processing on the media from the host server to the user device. It also removes the requirement that an advanced multimedia framework such as Microsoft DirectShow or Media Foundation be installed on the user device. the user device requires only the ability to play a file from a URL
When adding this setting to a policy, make sure the Windows Media Redirection setting is present and set to Allowed. If Windows Media Redirection is disabled, the streaming of multimedia files to the user device direct from the source provider is also disabled.
Windows Media redirection
This setting applies to both HTML5 and Windows Media and controls and optimizes the way servers deliver streaming audio and video to users.
By default, this setting is Allowed. For HTML5, this setting doesn’t take effect if the policy HTML5 video redirection is Prohibited.
Allowing this setting increases the quality of audio and video rendered from the server to a level that compares with audio and video played locally on a user device. The server streams multimedia to the client in the original, compressed form and allows the user device to decompress and render the media.
Windows Media redirection optimizes multimedia files that are encoded with codecs that adhere to Microsoft DirectShow, DirectX Media Objects (DMO), and Media Foundation standards. To play back a given multimedia file, a codec compatible with the encoding format of the multimedia file must be present on the user device.
By default, the Enable audio policy is not configured on the client. To allow users to run multimedia applications in ICA sessions, turn on audio or give users permission to turn on audio in their client interface.
Select Prohibited only if playing media using Windows Media redirection appears worse than when rendered using basic ICA compression and regular audio. This is rare but can happen under low bandwidth conditions, for example, with media with a very low frequency of key frames.
Windows Media Redirection buffer size
This setting is a legacy and does not apply to HTML5.
This setting specifies a buffer size from 1 to 10 seconds for multimedia acceleration.
By default, the buffer size is 5 seconds.
Windows Media Redirection buffer size use
This setting is a legacy and does not apply to HTML5.
This setting enables or disables using the buffer size specified in the Windows Media Redirection buffer size setting.
By default, the buffer size specified is not used.
If this setting is disabled or if the Windows Media Redirection buffer size setting is not configured, the server uses the default buffer size value (five seconds).
In this article
- HTML5 video redirection
- Limit video quality
- Multimedia conferencing
- Optimization for Windows Media multimedia redirection over WAN
- Use GPU for optimizing Windows Media multimedia redirection over WAN
- Windows media fallback prevention
- Windows Media client-side content fetching
- Windows Media redirection
- Windows Media Redirection buffer size
- Windows Media Redirection buffer size use