Webcams
By default, optimum webcam performance is provided by HDX RealTime Webcam Video Compression. In some circumstances, however, you might require users to connect webcams using USB support. To connect webcams using USB support, disable HDX RealTime Webcam Video Compression.
Webcam redirection
The following are a few points on webcam redirection:
-
Webcam redirection is compatible with and without RTME.
-
Webcam redirection works for 32-bit and 64-bit applications. For example, Skype, GoToMeeting. Use a 32-bit browser or 64-bit browser to verify webcam redirection online. For example,
https://webcamtests.com/
. -
Webcam usage is exclusive to applications. For example, when Skype is running with a webcam and you launch GoToMeeting, exit Skype to use the webcam with GoToMeeting.
Webcam redirection for 64-bit apps
Starting with the 2305 release, webcam redirection is supported for 64-bit applications.
System requirements
-
GStreamer
framework version 0.1.x or 1.x depending on the current version installed in the system. -
ICAClient
version greater than 2106 in case it is usingGStreamer
1.x -
Gstreamer
version and plug-ins:gstreamer1.0-plugins-base
gstreamer1.0-plugins-bad
gstreamer1.0-plugins-good
gstreamer1.0-plugins-ugly
-
gstreamer1.0-vaapi plugin
andlibva
library - x264 library
Note:
The version of the
GStreamer
plug-in must be consistent with the version of theGStreamer
framework. For example, if you install theGstreamer
1.2.4, the version of allGstreamer
1.x plug-ins must be 1.2.4.
Webcam redirection configuration
Do the following steps to activate and configure the webcam redirection feature for 64-bit apps on Citrix Workspace app for Linux.
Step 1: Verify the ICAClient
configuration
Set the AllowAudioInput
value to True to enable the webcam redirection feature. By default, this value is set to True during the installation of ICAClient
.
If the AllowAudioInput
value is set to False, do the following to enable the webcam redirection feature:
- Navigate to the
~/.ICAClient/wfclient.ini
configuration file and edit it. -
Set the
AllowAudioInput
value to True.AllowAudioInput=True
Step 2: Verify the Theora encoder configuration
After you have successfully installed the ICAClient
and the AllowAudioInput
value is set to True, by default the Theora encoder is configured. This encoder is a software-based encoder with acceptable performance. However, this encoder supports only 32-bit apps on a VDA.
Do the following to verify that the Theora encoder supports 32-bit apps:
- Install Firefox 32-bit on a VDA.
- Access the webcam test site at
https://webcamtests.com/
The Theora encoder does not support the webcam redirection feature for 64-bit apps on a VDA. Configure the H264 encoder option to support the webcam redirection feature for 64-bit apps on VDA.
Step 3: Configure H264 encoder
H264 encoder supports the webcam redirection feature for 64-bit apps on the VDA. To enable the H264 encoder, you must do the following:
- Navigate to the
~/.ICAClient/wfclient.ini
configuration file and edit it. -
Set the
HDXH264InputEnabled
value to True.HDXH264InputEnabled=True
Do the following to verify that the H264 encoder supports 64-bit apps:
- Install Firefox 64-bit on a VDA.
- Access the webcam test site at
https://webcamtests.com/
.
Step 4: Verify system dependencies
After configuring the H264 encoder, if the webcam redirection feature does not support 64-bit apps on the VDA verify the system dependencies.
The webcam redirection feature for the 64-bit app is based on the GStreamer
framework. The ICAClient
uses GStreamer
framework version 0.1.x or 1.x depending on the current version installed in your system.
Step 4.1: Verify ICAClient
version
Verify whether the ICAClient
version is greater than 2106 in case it is using GStreamer
1.x. Previous versions of ICAClient
might fail.
Do the following steps to verify the ICAClient
version is based on the GStreamer
framework installed in your system:
-
Enter the following commands in a command-line:
cd /opt/Citrix/ICAClient/util <!--NeedCopy-->
ls -alh <!--NeedCopy-->
-
Verify whether the
gst_read symlink
is linked togst_read1.0
orgst_read0.1.
as shown in the following image:
You can also run the workspaceappcheck.sh
script in the util
directory and verify the output of the section referring to GStreamer
dependencies.
Citrix recommends using the ICAClient
version greater than or equal to 2106 and GStreamer
1.x.
Step 4.2: Verify GStreamer
version and plug-ins
Apart from the GStreamer
1.x framework, you must install the following required plug-ins:
Gstreamer1.0-plugins-base
Gstreamer1.0-plugins-bad
Gstreamer1.0-plugins-good
Gstreamer1.0-plugins-ugly
Gstreamer1.0-vaapi plugin
ibva library
x264 library
For more information to install the preceding plugins
, see the GStreamer
installation guide.
Note:
The version of the
GStreamer
plug-in must be consistent with the version of theGStreamer
framework. For example, if you installGstreamer1.2.4
, the version of allGstreamer1.x
plug-ins must be 1.2.4.
Run the following command to check the current version of the GStreamer
framework:
gst-inspect-1.0 --gst-version
<!--NeedCopy-->
For information about troubleshooting, see Webcam in the troubleshooting section.
Background blurring for webcam redirection
From the 2303 version and later, Citrix Workspace app for Linux supports background blurring for webcam redirection. To enable this feature, do the following:
- Navigate to the
~/.ICAClient/wfclient.ini
configuration file. -
Add the following entry in the wfclient.ini file:
HDXWebCamEnableBackgndEffect=True <!--NeedCopy-->
Note:
The configuration setting enables the background blurring for webcam redirection feature for UI and UI-less clients.
To disable background blurring inside the session for webcam redirection using the graphical user interface:
- Click Preferences from the Desktop Viewer. The Citrix Workspace – Preferences dialog box appears.
-
Click the Webcam tab. The following dialog box appears.
- Select the Disable Background Blur Effect check box to disable background blurring for webcam redirection.
- Click OK.
Support for MJPEG webcams
Starting with the Citrix Workspace app for Linux 2308 version, MJPEG webcams are supported in the H264 stream. The Webcam performs MJEPG compression internally which provides better image quality and a higher frame rate. This feature is enabled by default. However, if Webcam doesn’t support MJPEG, this feature is disabled.
Multiple webcam resolutions support
Previously, only the VGA resolution was supported for webcam redirection.
Starting with the 2408 release, Citrix Workspace app for Linux supports high-definition webcam streaming for all webcam resolutions that are available on the client side. If media type negotiation fails, HDX now defaults back to the default VGA resolution (640 x 480 pixels). For more information, see High-definition webcam streaming.
This feature is enabled by default. To disable this feature, do the following:
- Navigate to the
$HOME/.ICAClient/wfclient.ini
file. - Go to the [WFClient] section and add the following entry:
HDXWebCamEnablePnp=False
<!--NeedCopy-->