Teradici PCoIP protocol

The PCoIP (PC over IP) protocol supports testing on the Teradici Pervasive Computing Platform and VMware HorizonView.

Only images are passed from the server, so the user can perform connect, disconnect, mouse click, and key press actions only.

PCoIP client

The PCoIP client is shipped with VuGen (resides in <VuGen root>\bin\pcoip). The PCoIP client supports VMWare HorizonView.


  • The VuGen PCoIP client does not support connections to application pools (published applications). You can only connect to desktop pools.
  • Several third party libraries used by the client, such qt5 and ssl, are not installed with VuGen due to security considerations. They are located in the DVD\lrunner\Common\PCoIP or DVD_PC\Setup\Common\PCoIP\ folders. If you are using the client, manually copy these libraries to the <VuGen root>\bin\pcoip folder.

Back to top

Record a PCoIP test

  1. Click the Start Recording button.
  2. In the Start Recording dialog, select Windows Application under Recording mode and enter the PCoIP client path name in the Application field. For example,

    <VuGen root>\bin\pcoipo\pcoip_client.exe

  3. Enter other information as appropriate to your test and click Start Recording.
  4. Follow the directions on the Teradici client screens to connect to the server.
  5. Record your business process from within the client.

Note: A call to Copy image to the clipboard from the snapshot context menu may throw an OpenClipboard Failed exception. In that event, close all open PCoIP clients.

Back to top

Enhance the recorded script

During recording, strings (alphanumeric keyboard presses) are recorded until some other type of activity occurs, such as mouse clicks or non-alphanumeric key presses.

When typing is slow, VuGen may break up a typing session into a number of invocations of pcoip_type() interleaved with lr_think_time(). By manually editing the script, these calls can be concatenated. This will facilitate parameterization if you need the string to be substituted with a parameter.

Back to top

Add a timeout for finding an area of a snapshot

Use the pcoip_sync_on_bitmap_ex function to add a timeout period for finding the desired area (hash) of a snapshot.

  1. Click the pcoip_mouse_click function that contains snapshot.

  2. In the Snapshot panel, right-click the snapshot and select Insert sync on bitmap.

  3. Using the mouse, select the desired zone.

  4. In the dialog box that opens, define a timeout period (in seconds), and click OK.

    The pcoip_sync_on_bitmap_ex is inserted before the pcoip_mouse_click function.

    Note: The hash value is automatically generated.

Back to top

Sample Script

This script enters "Hello World" in an open application.


	pcoip_set_auth("alex-qa", "mydomain", lr_unmask("56ec1f82347be574b867f74a72"));

	pcoip_connect("MYD-SERVER", "123.456.789.abc", "MYD-SERVER", "4172", 1);

	pcoip_set_display(980, 556);

	pcoip_key("NUM_LOCK_KEY", 0);

	pcoip_mouse_click(18, 537, LEFT_BUTTON, 0, "snapshot3");

	pcoip_key("ENTER_KEY", 0);

	pcoip_key("h", MODIF_SHIFT);

	pcoip_type("ello", 0);

	pcoip_key("w", MODIF_SHIFT);

	pcoip_type("orlx", 0);

	pcoip_key("BACKSPACE_KEY", 0);

	pcoip_key("d", 0);

	pcoip_key("ENTER_KEY", 0);

	pcoip_key("TAB_KEY", 0);


	return 0;

Back to top