Skip to main content
Skip table of contents

Embed Stream using E3DS SDK

This guide explains how to embed an Unreal Engine Pixel Streaming session directly into your webpage using the Eagle 3D Streaming (E3DS) Frontend SDK. The steps are straightforward and designed to help you complete the integration quickly, securely, and reliably.

Why Use the Frontend SDK?

The E3DS SDK provides a secure and optimized integration layer for embedding your Unreal Pixel Streaming applications into any website.
It manages:

  • Secure token generation

  • Authentication

  • Connection handling

  • Stream initialization

  • Modern, production-ready embed workflow

This removes the need to manually handle browser scripts or low-level streaming logic.

Demo Project Overview

In this guide, we demonstrate the SDK integration using a simple demo project available on GitHub. We strongly recommend starting with this demo project to validate your configuration before integrating the SDK into your own production application.

Step-by-Step Integration Guide:

Step 1. Download the Demo Project with SDK

Download the demo project that includes the E3DS Frontend SDK from GitHub: Get the Simple Project with SDK from GitHub

image-20260122-050840.png

Figure 1. Downloading the demo project

Step 2. Extract the Downloaded Project

Extract the downloaded ZIP file to a local directory on your machine.

image-20251205-041801.png

Figure 2. Extracted demo project folder

Step 3. Open the extracted project folder using your preferred code editor

image-20251205-041852.png

Figure 3. Opening the Project Folder in Editor

Step 4. Open tokenManager.js

Locate and open the file:

CODE
/tokenManager.js

This file is responsible for generating and managing authentication tokens required to access the Pixel Streaming session.

image-20251205-042309.png

Figure 4. Opening tokenManager.js

Step 5. Configure Authentication Details

Update the following values in tokenManager.js:

Note: There are two types of API keys. Ensure you are using the Streaming API Key.

image-20251205-042426.png

Figure 5. Updating API Key and Username

Step 6. Update Required Streaming Information

Inside the configuration file, update the following fields:

  • domainconnector.eagle3dstreaming.com
    Note: If you are using Enterprise Plan, please replace this with your custom domain provied by Eagle 3D Streaming. If you are unsure which domain to use, please contact support@eagle3dstreaming.com

  • appName → Name of the app you want to embed

  • configurationName → Configuration name for the app

  • versionlatest (recommended to use the latest build)

b3285808-2f2e-47b4-9c40-74f9764daf17.png

Figure 6. Updating Stream Configuration

Step 7. Run the Demo HTML Locally

Open the following file:

CODE
e3ds_streaming_FE.html

Run it via a live server (VS Code Live Server, or any local web server).

Once running, the page will load the hosted Pixel Streaming experience using your configured settings.

image-20251205-043024.png

Figure 7. Running the Demo HTML Locally

image-20251205-043627.png

Figure 8. Running the Frontend Locally

Notes & Best Practices

This guide demonstrates the simplest and fastest way to set up the E3DS Frontend SDK. After validating the demo project, you can:

  • Integrate the SDK into your existing web application

  • Customize UI and layout

  • Deploy your webpage on any hosting environment (company servers, cloud hosting, or modern static hosting platforms)

To explore additional SDK capabilities, such as event callbacks, UI customization, stream lifecycle control, reconnection logic, and advanced embed behaviors, please refer to the detailed guide below:

Runtime Events & Utility Functions

Advanced Features & SDK Behavior

It is recommended to review these document after completing the basic integration steps to fully leverage the Frontend SDK.


Troubleshooting


Issue

Possible Cause

Solution

Token not generated / Authentication fails

Wrong API key, wrong username, or invalid token duration

Use Streaming API Key, verify username, check tokenExpiryDuration, remove extra spaces/quotes

Stream not loading

Incorrect domain/app/config names

Set domain to connector.eagle3dstreaming.com, verify appName and configurationName exactly as shown in the Control Panel

Black screen / Stuck on connecting

Network or browser blocking WebRTC

Try another network, disable VPN, use Chrome/Edge/Firefox

Local page not working

Opened using file path (file://) instead of a server

Run using Live Server or any local server tool

Console errors

CORS issues, missing values, wrong API key, incorrect version

Open DevTools → Console; fix the specific error shown

App not responding or inactive

App not deployed or not ready in the Control Panel

Confirm the app is uploaded & shown in the Control Panel

 


Need help?

🛠️ Contact our Support Team

💬 Join the Community on Discord

🆓 Get Started for free

 

Follow us on:

Facebook | GitHub | LinkedIn | YouTube

JavaScript errors detected

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

If this problem persists, please contact our support.