Append Parameters to URL

Add Command parameters to the end of your App URL.

Overview

After Passing a Command to your App from the Control Panel Config “Parameters to Pass to App”, you can append Parameters to your App URL by enabling the Feature from the New Control Panel and adding CMD Line arguments to the end of your App URL.

Prerequisites

Make sure you :

1. Have access to the New Control Panel.

2. Have an Eagle 3D’s User Account.

Instructions

Step 1. Prepare the setup

To prepare the setup for this tutorial, refer to this document and follow the instructions.

The steps explained in the document are :

1. Download the sample App “E3DSFeatures Template”.

2. Upload “E3DSFeaturesTemplate” on the New Control Panel.

3. Select the App and create a New Streaming Link.

4. Create a New Config and call it “CMDLineDemo”.

5. Enable “Parameters to Pass to App”.

6. Add -green in the text box of “Parameters to Pass to App”.

7. Play the “E3DSFeaturesTemplate” game and run to the 12th Bay.

8. Check the color of the Sphere which should be green (i.e. same color as the Command -green).

After completing the steps above from the document, you are now ready to move to Step 2 of this tutorial to Append Parameters To your App URL.

Step 2. Enable Append Parameters To URL

1. Select “E3DSFeaturesTemplate” from the New Control Panel from the List of Apps in “Applications”.

2. Go to :

Streaming Link >Edit Config > Advanced Options > Developer.

3. Enable “Append Parameters To URL”.

4. Click Save.

Step 3. Copy the App URL to the Clipboard

Once you save the changes, you will be redirected to the Streaming Links page.

1. On the Streaming Link created in “step 1 : Prepare the Setup”, click “Copy Streaming URL”. (See image below).

2. This URL will be copied to the Clipboard (Username is your Eagle 3D Account user name) :

https://connector.eagle3dstreaming.com/v5/Username/E3DSFeaturesTemplate/CmdLineDemo

Step 4. Add the Command Lines to the copied App URL

We are going to add '?exeLunchArgs=-[variable]' to the end of the URL. Follow the examples below.

• Example 1 :

In this example, we are adding ?exeLunchArgs=-blue to the end of the URL :

https://connector.eagle3dstreaming.com/v5/Username/E3DSFeaturesTemplate/CmdLineDemo?exeLunchArgs=-blue

The system has now appended the Command and has sent both the Command added into the Config (i.e. -green) and the Command added into the URL (i.e. ?exeLunchArgs=-blue) to the UE game.

• Example 2 :

In this example, we are adding ?exeLunchArgs=-green pink red to the end of the URL :

https://connector.eagle3dstreaming.com/v5/Username/E3DSFeaturesTemplate/CmdLineDemo?exeLunchArgs=-green pink red

The system has now appended the ?exeLunchArgs=-green pink red Command and has sent both the Command added into the Config (i.e. -green) and the Command added into the URL (i.e. ?exeLunchArgs=-green pink red) to the UE game.

Step 5. Open the game. Run to the 12th bay

Paste the App URL from the Clipboard to the Browser :

https://connector.eagle3dstreaming.com/v5/Username/E3DSFeaturesTemplate/CmdLineDemo?exeLunchArgs=-blue

Warning 🛑

DO NOT run the game by clicking “Play App” from the Streaming Link in the Control Panel !!!

That causes you to ONLY see the changes made to the “Parameters to Pass to App” Config from the Control Panel (i.e. the green color) and not the ones made to the App URL.

In the game, 2 values will be getting parsed from 2 places in the CMDLine arguments (image below):

1. From the “Parameters To Pass to App” Config Feature (the green color).

2. From the additional Command added to the end of the URL (the blue color).

Now that we are familiar with how the appending system works, we can explore how this is used for Authentication. Refer to this document.

Was this article helpful? Comment Below. Let us know your feedback. 

Need help? Contact Support

Submit a new request at E3DS support portal.

Requests sent on weekends will not be addressed until the following business day.