Amazon AppStream 2.0
Administration Guide

Redirect a Streaming Session from the Web Browser to the AppStream 2.0 Client

You can configure AppStream 2.0 to redirect a streaming session from a web browser to the AppStream 2.0 client. That way, when your users sign in to AppStream 2.0 and start a streaming session in their web browser, their session is redirected to the AppStream 2.0 client. To do so, perform these steps.

  1. Use the AppStream 2.0 CreateStreamingURL API action to generate a streaming URL.

  2. Add the following prefix for the custom AppStream 2.0 client handler to the streaming URL: amazonappstream:

    Together, the prefix and streaming URL are formatted as follows:

    amazonappstream:base64encoded(streamingURL)

  3. When users are redirected to the streaming URL, their browser detects that the link must be opened by the AppStream 2.0 client.

  4. Users are prompted to choose whether they want to start the streaming session by using the AppStream 2.0 client.

  5. After the prompt, either of the following occurs:

    • If the AppStream 2.0 client is installed by the user, they can choose to continue the streaming session by using the AppStream 2.0 client.

    • If the AppStream 2.0 client is not installed, the browser behavior varies as follows:

      • Chrome — No message displays.

      • Firefox — A message states that the user will need a new app to open Amazon AppStream.

      • Microsoft Edge — No message displays.

      • Internet Explorer — A message notifies the user that the AppStream 2.0 client is not installed.

        In this case, users can select the Download AppStream Client link to download the client. After they download the client, they can install it, and refresh their browser to start the streaming session by using the client.