The PCoIP Client Software Development Kit (SDK) is a set of libraries and binaries provided to Teradici Cloud Access Platform customers who require the ability to customize and build a PCoIP client.
With control over how the PCoIP client is built, you can:
PCoIP Client SDK 3.2.0 for Mac introduces new fixes and updates to the previous release. This article provides a summary of key additions, compatibility notes, resolved issues, and known issues for this release.
To build additional functionality, such as extended peripheral support, you can utilize the Teradici PCoIP Virtual Channel SDK.
Fullscreen One Monitor
With this release, users now have the ability to switch to full-screen mode on a single monitor or on all available monitors using the new Show Fullscreen One Monitor or Fullscreen All Monitor commands listed under the View menu. Users can also toggle between windowed mode and last full-screen mode using the Ctrl+Alt+Enter (Windows) or Ctrl+Option+Return (Mac) hotkey.
Extended supported window alignments
Previously, display topology was limited to all monitors top, center, or bottom aligned. The display topology window alignment has been extended to any alignment provided all windows are connected.
Display resolution improvements
When a host requests a resolution change in full-screen mode, the host will be presented with supported client monitor resolutions only. Additionally, multiple monitor display topology handling has been improved with monitors that have different supported resolutions.
Added secondary default port 60443
The default port used to establish connections is port 443. If this port is already in use, the client will by default establish a connection on the secondary port 60443.
Force native display resolution
Added a new command line parameter 'force-native-monitor-resolution'. This command line parameter requests the PCoIP Software Client to set the resolution of the client monitor to the native resolution of the monitor. If this parameter is applied when launching the client, the best available resolution is used in a session regardless of the monitor resolution setting.
client_session.exe <connection_parms> full-screen force-native-monitor-resolution
Note: 'Full-screen' parameter would typically be used in conjunction with 'force-native-monitor-resolution' parameter.
Added a new command line parameter 'enable-scaling'. This command line parameter enables scaling on the client without having to specify the desktop resolution. Image scaling may be applied when the resolution of the client monitor is not the same as the current resolution provided by the host. Specifying the scaling command line parameter indicates that the client should scale the image to fit the current resolution when an application on the host requests a resolution change.
client_session.exe <connection_parms> full-screen maintain-aspect-ratio enable-scaling
Note: Image scaling is typically used in conjunction with 'full-screen' and 'maintain-aspect-ratio' parameters.
Set host resolution
Added a new command line parameter 'set-host-resolution' to specify the desired resolution the client should send to the host. This parameter replaces the desktop-resolution parameter but is independent of the enable-scaling parameter.
client_session.exe <connection_parms> full-screen maintain-aspect-ratio set-host-resolution=1920x1080 enable-scaling
Desktop resolution deprecated
The desktop resolution parameter has been deprecated and may be removed completely in later releases. The same functionality can be specified using the set-host-resolution and enable-scaling parameters.
client_session.exe <connection_parms> full-screen maintain-aspect-ratio desktop-resolution=1920x1080
client_session.exe <connection_parms> full-screen maintain-aspect-ratio host-resolution=1920x1080 enable-scaling
Both command lines are equivalent, except the first one will generate warnings regarding the deprecated command.
The PCoIP Client SDK is intended for Teradici Cloud Access Platform customers only.
The SDK is intended for customers who require some client customizations when PCoIP Software Client for Windows and Mac, PCoIP Zero Clients, and PCoIP Mobile Clients do not meet their needs.
The SDK is intended for customers with software development skills and knowledge, as well as a sound understanding of virtualization systems.
|July 2017||General availability release|
|PCoIP Client SDK for Windows||
PCoIP Client SDK for Windows is compatible with the following Windows operating systems:
Note: PCoIP clients are not supported with Windows Embedded Standard 7 or Windows Embedded Standard 8 systems.
|PCoIP Client SDK for Mac||
PCoIP clients for macOS are compatible with the following Apple operating systems:
|Teradici Cloud Access Platform|
macOS client may only minimize one display on OS X 10.11
If you launch the PCoIP Software Client in OS X 10.11 and you have not clicked anywhere within a display before using the minimize hot key (Ctrl+Alt+M), the display that has not been used will not be minimized. This does not occur in macOS 10.12 (Sierra). (61740)
Workaround: Click with the mouse on both displays of the client any time before pressing Ctrl+Alt+M, and both displays will be minimized.
Using an invalid or corrupt branding package crashes client
If the branding package does not match the hash value specified for the branding package, the session client will terminate. (61678)
Workaround: Replace the corrupt branding file or use the correct hash value.
Datalogic barcode scanner cannot be redirected when bridged in macOS
The Datalogic Quickscan QS6500 barcode scanner does not work when the device is bridged. (44028)
Workaround: Do not bridge the device. The device works as expected with the remote host when it is not bridged.
USB keyboards do not work in bridged mode
Keyboards do not work when bridged. This affects both Windows and macOS PCoIP Software Client. (40580)
Workaround: Do not bridge the keyboard. Keyboards function correctly when locally terminated.
PCoIP Software Client now sends correct monitor EDID in full-screen mode to host
Previously, when the client was in full-screen mode, PCoIP Software Client sent the host a default EDID that might contain resolutions that were not valid for the connected monitors. Now, when a host requests a resolution change in full-screen mode, the host will be presented with supported client monitor resolutions only. Additionally, multiple monitor display topology handling has been improved with monitors that have different supported resolutions. (62446)
Peer software version corrected in client log
The peer's PCoIP version has been corrected in the Peer Endpoint Advertisement section of the client log. (51943)
PCoIP Software Client no longer captures keystrokes when changing focus via macOS notifications
When a macOS notification window is overlayed on top of the PCoIP Client window, keystrokes entered into the notification window are no longer sent to the remote host. (35310)