Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Learn to use the feature ‘'Should Append Parameters from URL with existing one to override’'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.

Panel
panelIconIdatlassian-info
panelIcon:info:
bgColor#F4F5F7

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

Prerequisites

Info

For this document, you need :

  1. Access to the Control Panel ;

  2. At least one uploaded application.

Instructions

Follow these instructions :

Step 1. Prepare the setup

FollowStep 1of this tutorial first then see the steps below.

...

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

...

Info

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

...

Image RemovedImage Added

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

Info

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

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

Open the game to check the color of the sphere.

Info

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

The color of the sphere changed to green.

Step 5. Copy the App URL to the clipboard

Info

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

This is the URL you would get:

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

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

Panel
panelIconIdatlassian-info
panelIcon:info:
bgColor#F4F5F7

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

...

...

  • Example 1 :

Add '?exeLunchArgs=-blue' to the end of it like so : the URL

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

Info

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. PanelpanelIconIdatlassian-

Info

...

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)

Panel
panelIconIdatlassian-info
panelIcon:info:
bgColor#F4F5F7

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

...

atlassian-infopanelIcon:info:bgColor#DEEBFFOn 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

(this link will not work and is for demonstration purposes only).

Panel
panelIconIdatlassian-info
panelIcon:info:
bgColor#F4F5F7

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:

Info

%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

Panel
panelIconIdatlassian-info
panelIcon:info:
bgColor#E6FCFF

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

Add these Commands in Parameters to Pass to App.

...

Step 10. Get this Output

...

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

...