Menu
Amazon AppStream
Developer Guide

This documentation is for an older version of Amazon AppStream. For information about the latest version, see the Amazon AppStream 2.0 Developer Guide.

Displaying Mouse Pointers

Because your streaming application runs on a Windows instance running on Amazon EC2 and your users interact with your streaming application using a client application, you have two mouse pointers to consider:

  • The mouse pointer of the streaming application.

  • The mouse pointer of the client application.

This topic explains how to configure the remote and local mouse pointers.

Remote mouse pointer

The remote mouse pointer is the mouse pointer of the streaming application that runs on a Windows instance running on Amazon EC2. When you deploy your streaming application, the remote mouse pointer is disabled. If the remote mouse pointer is displayed, your users may get the perception of sluggish performance. The perception may occur because the user input from the client application must go through the network before the streaming application can process the input.

However, some streaming applications may require the remote mouse pointer. For example, your streaming application uses the remote mouse pointer for context sensitive tasks. If your streaming application requires a remote mouse pointer, set the environment variable VDI_CAPTUREMOUSECURSOR to true when you deploy your streaming application. For more information about setting this environment variable, see Using Environment Variables.

This environment variable has the following effects on the client applications:

  • Chrome App – the local mouse pointer, the remote mouse pointer, or both mouse pointers appear depending on the settings in Mouse cursor in Settings. For more information, see Chrome App.

  • Android and Fire OS – the remote mouse pointer appears.

  • iOS – the remote mouse pointer appears.

  • OS X – the local mouse pointer and the remote mouse pointer appear.

  • Windows – the local mouse pointer and the remote mouse pointer appear.

The next section explains how to display the local mouse pointers in the client application.

Local mouse pointer

The local mouse pointer is the mouse pointer in the client application. Which mouse pointer appears depends on the client application.

Chrome App

The Chrome App can display the local mouse pointer, the remote mouse pointer, or both local and remote mouse pointers.

To set which the mouse pointer appears, choose Settings and then select an option in Mouse Cursor.

The following table summarizes what appears when you choose a setting. The Default Deployment column lists which mouse pointer appears when the streaming application is deployed using the default settings. The VDI_CAPTUREMOUSECURSOR is true column lists which mouse pointer appears after the environment variable VDI_CAPTUREMOUSECURSOR is set to true during the streaming application deployment.

Chrome App Mouse Pointer Settings

Dialog Box Setting Default Deployment VDI_CAPTUREMOUSECURSOR is true
Local only Local mouse pointer Local mouse pointer
Remote only No mouse pointer Remote mouse pointer
Local and Remote Local mouse pointer Local and remote mouse pointers (Two mouse pointers)

For more information about setting the environment variable, see Using Environment Variables.

Android and Fire OS

No mouse pointer appears because mobile devices rely on touch for user input.

To display a mouse pointer, set the environment variable VDI_CAPTUREMOUSECURSOR to true during streaming application deployment.

For more information, see Remote mouse pointer and Using Environment Variables.

iOS

No mouse pointer appears because mobile devices rely on touch for user input.

To display a mouse pointer, set the environment variable VDI_CAPTUREMOUSECURSOR to true during streaming application deployment.

OS X

The local mouse pointer appears because the operating system displays a mouse pointer in all applications.

Both the local and remote mouse pointers appear if you set the environment variable VDI_CAPTUREMOUSECURSOR to true during streaming application deployment.

Windows

The local mouse pointer appears because the operating system displays a mouse pointer in all applications.

Both the local and remote mouse pointers appear if you set the environment variable VDI_CAPTUREMOUSECURSOR to true during streaming application deployment.