This document outlines the difference between the dedicated and shared game views and controls.
Prepare to execute instruction
To go further and understand the concepts in this document you will need:
1. to understand the CCU concept from this document:
https://docs.eagle3dstreaming.com/ccus-from-a-conceptual-point/
2. To understand how to generate URLs from the Control Panel 4. STEP3: Generate URLs from the Control Panel
3. this document to know how to generate a meeting URL from the Control Panel
https://docs.eagle3dstreaming.com/5-generate-meeting-urls-experimental-system/
In this document, we will only work with:
1. STEP 3 : Generate URLs
2.STEP 4: Generate meeting URLs in the Control Panel.
To complete this guide, your working environment must meet all the requirements above. If you have not completed any of the points, follow the link to the appropriate instruction and complete it first.
Instructions
Section 1. Dedicated game view and control
1.1. Generate URLs
Refer to this document for a tutorial on how to Generate a URL and to understand the use and functionality of the features of STEP3: Generate URLs on the Control Panel 4. STEP3: Generate URLs from the Control Panel
Let’s use this URL for demonstration purposes.
https://connector.eagle3dstreaming.com/v5/demo/CarConfigurator427_reimport/E3DS-Iframe-Demo
In this section we will see how opening above URL will make sure that each visitor of that URL gets a dedicated game view and control.
Upon opening the link above, User 1 (CCU#1) will see this view in (image 2) that explains the process of what happens right after he clicks on the link to have a completely dedicated game views and control from other users or CCUs.
Image 2. Link opening: Each visitor to this URL will receive a dedicated game view and controls
1.1.1. What happens when User 1 and User 2 connect to the URL
1. User 1 or CCU#1
these steps represent respectively what happens when User 1 opens the URL above :
As shown in (image 1) , the user copies the URL in their browser’s address bar from the ‘’Copy App URL’’ button on STEP 3: Generate URLs. Upon hitting the Enter button from the keyboard or even clicking the ”Play button” from STEP 3 of the Control Panel , a connection with our system is initiated.
Our system receives the connection request from the browser and assigns a machine (1 of the servers) to serve the user’s needs based on the URL hit. The URL helps our system identify the specific app or configurator that the user wants to access.
Once the system identifies the requested app or configurator, it ensures that all the required resources are set up properly beforehand. This includes preparing a machine with GPU (Graphics Processing Unit) and installing the necessary app or configurator on our shared drive.
The prepared app or configurator, which is built using the Unreal Engine, establishes communication with the browser.
The browser acts as the intermediary between the user and the unreal app or configurator. It receives the video output from the app or configurator and displays it on the user’s screen.
Additionally, the browser receives input from the user’s keyboard and mouse actions. It then forwards these inputs to the unreal app or configurator, allowing the user to interact with the application.
During this process, User 1 utilizes 1 CCU. SO if you for example had 10 CCUs, then 9 CCUs can be used by 9 amount of users.
In simpler terms, the example above, we presented what happens when 1 CCU or 1 user establishes a connection with our platform by clicking the streaming link that we provided above.
So if we have for example 10 CCUs trying to establish a connection with our system, then 9 of them can access the game and interact with it and have a dedicated game view and control.
In this case, communication between the unreal app and the browser is bidirectional, but communication with the mouse and keyboard is unidirectional. Only one user is allowed to connect with the app at a time, and that user controls the unreal app and receives its output.
2. User 2 or CCU#2
Upon opening the link above, User 2 (CCU#2) will see this view in (image 3) that explains the process of what happens right after he clicks on the link to have a completely dedicated game views and control from other users or CCUs.
In (image 3) , User 2 requests the same app as User 1, but our system assigns a different machine. The behavior of the app remains the same, but the output may vary depending on the user’s input. Each User has their own corresponding view based on the input given to the unreal app.
During this process, User 2 is CCU#2 . So if u had for example 10 CCUs then 8 CCUs can be used by 8 users now in this case. (since we have 2 users)
In simpler terms, in the example above we showed how User 2 established a connection with our system. So, now we have 2 users connected on the platform.
So for example, if we had 10 CCUs, then there will only be 8 other CCUs remaining waiting for users to open the app and interact with our system. (to understand the concept of CCUs, refer to the document ‘'CCU’s from a conceptual point’' initially provided in the ‘' Prepare to execute instructions’' section).
Section 2. Shared game view and control (Meeting system)
2.1. STEP 4 : Generating Meetings URLs
We generate that above URL by following STEPS 1, 2 and 4 from the Control Panel as it is presented in the image below.
Everything about STEP4 : Generate meetings URLs is explained with details in this document
https://docs.eagle3dstreaming.com/5-generate-meeting-urls-experimental-system/
Image 4. Control Panel: STEP 4: Generate Meetings URLs
Just like it is presented in (Image 4) above, There are 2 links that a user can copy from. The link on top is the Host’s link and the one under is the guest’s URL who would use it to join the Host’s meeting.
The Host shares link 2 with his guests (CCUs) so they can have a shared game view and control.
Shared game view and control (Meeting system):
Host URL :
https://connector.eagle3dstreaming.com/v5/demo/CarConfigurator427_reimport/E3DS-Iframe-Demo?hostMeetingId=3456777
Guest URL :
https://connector.eagle3dstreaming.com/v5/demo/E3DS-Iframe-Demo?GuestMeetingId=3456777
This (image 5) below represents what happens when the guests open the link that the Host gave them for a shared game view.
In the (image 5) above, there is 1 Host and 2 Guests.
The Host represents the 1st CCU and his Guests are sharing the 1st CCU experience with the Host.
This means that the CCU gets to have a full control of the game and his Guests are there just to share his experience.
2.2. Functionalities of the Host and the Guest
In (image 6) that we see above, we have on the right the Guest’s screen and on the left the Host’s.
To understand every functionality of both of them, we put them together in (image 6) for comparison.
Every single Guest has an ID number just like it is shown in the Image above (In this example it is 138).
The Guest who is on the right, cannot click or do anything from their side while the Host on the left has full capabilities.
We can see from the Host’s side that he has the ability to see his Guest list.
He can kick them out from the ‘’kick selected Guest’’ feature if he wanted to, or kick all of his Guests from the feature ‘’kick all Guests’’.
When a Guest is kicked, he will see a message displayed on the screen : You have been removed from the meeting.
He can also give control to his Guest from the ‘’ Give Control to this Guest’’ feature which will give the Guest the ability to control the experience.
He can Disable the Guest’s control from the feature ‘’ Disable All other Control’’.
If the Host leaves the meeting, then a message will be shown for the Guests : ‘' Meeting Ended’'
If you try to join the meeting after the Host left, by clicking the ‘’join Meeting button’’ you will get this message from the Browser in the image below.
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 Community Forum today.