Skip to main content
Skip table of contents

Append Parameters from your App URL

Information on how to append Parameters to your App URL from the Old Control panel and how to use that to authenticate by appending a user’s Email address.

It is possible to append CMD Line Arguments with existing ones. This can be used for authentication / token purposes.

Follow these instructions :

Step 1. Prepare the setup

Follow Step 1 of this tutorial to prepare the setup to Pass Parameters to get our E3DSFeaturesTemplate UE Project and upload it on your Control panel and to create a CmdLineDemo Config.

Step 2. Enter -green in the text field of Parameters to Pass to App

Go to: Control Panel > Step 2: Config Selection > Edit > Developer Option > Parameters to Pass to App > Enter -green

image-20240515-145230.png

Image 1. Enter -green in the Parameters to Pass to App text field

Step 3. Enable Should append parameters from URL with existing one to override. Click Save

In Developer Options Tab, under ‘Parameters to Pass to App’ text field, enable ‘Should append parameters from URL with existing one to override

UE will receive the command during runtime. The color of the sphere should be green when you run the game.

Image 2. Enable Should append parameters from URL with existing one to override

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

Open the game to check the color of the sphere.

Go to: Control Panel > Step 3: Generate URLs > Play App > Run to the 12th bay

The color of the sphere changed to green.

Image 3. Launching E3DSFeaturesTemplate Application: Sphere Сolor changed to green

Step 5. Copy the App URL to the clipboard

Go to : Control Panel > Step 3: Generate URLs > Copy App URL

This is the URL you would get (demo is a username we used as an example here) :

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

Step 6. Add additional command lines to the copied App URL

Add '?exeLunchArgs=-[variable]' to the end of the URL.

  • Example 1 :

Add '?exeLunchArgs=-blue' to the end of the URL

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

The system has now appended the additional command and has sent both the command added into the config and the command added into the URL to the UE game.

  • Example 2 :

Add ‘?exeLunchArgs=-green pink red’ to the end of the URL

https://connector.eagle3dstreaming.com/v5/demo/E3DSFeaturesTemplate/E3DS-Iframe-Demo?exeLunchArgs=-green pink red

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

Open the game again to see the additional Command Lines you have added.

Go to : Control Panel > Step 3 : Generate URLs > Play App

When you click on :

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

2 values will be getting parsed from two places in CMDLine arguments in the game. (See image below)

Image 4. '?exeLunchArgs=-blue' at the end of the App URL

Now that we are familiar with how the appending system works, we can explore how this is used for authentication.

Step 8. Authenticate by a user’s Email address

On the URL side, append the user’s email address to the URL, so that it looks like this:

(assuming that you know how to do this programmatically)

https://connector.eagle3dstreaming.com/v5/demo/E3DSFeaturesTemplate/CmdLineDemo?exeLunchArgs=-user=myEmailAddress@gmail.com

Note : This link will not work and is for demonstration purposes only.

By adding the email address into the URL (the '@' sign is an accepted character),

you will be able to pass the email address into your UE app where you can then proceed with the authentication.

Within the E3DSFeaturesTemplate App (source https://bitbucket.org/Eagle3DStreaming/e3dsfeaturestemplate/), there is a blueprint showing how to receive a value

(in the E3DSFeaturesTemplate example we show how to use the Command Line to get an IP Address for multiplayer). (Check this document).

Special Data:

%ip_streamer% will pass the IP address of the machine where UE app is running

%ip_ss% will pass the IP address of the Signaling server

%port_streamer2ss% will pass the port of the Signaling server through which UE app communicates with the signaling server

Step 9. Add these Commands to Parameters to Pass to App

Add these Commands -bb=%ip_streamer% and -aa=%ip_ss%:%port_streamer2ss%

Image 5. Parameters To Pass to App

Step 10. Get this Output

Image 6. Parameters passed to the App: Output


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

Need help? Contact Support

If you still need help, contact support to get your issue resolved quickly.

Submit a new request at E3DS support portal or send an Email at support@eagle3dstreaming.com.

Seek advice. Connect with others. Share your experiences. Join our lively E3DS Community Forum today.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.