Pixel Streaming UI Automation Tests

This project contains automated tests for the Pixel Streaming web UI using Python, pytest, and Selenium.

Prerequisites

• Windows 10/11 machine
• Python 3.13
• Chrome browser installed

Setup

1. Clone repository:

   git clone https://github.com/JnProfile/unreal_auto.git

2. Download and unzip UE5 project

3. Start Pixel Streaming servers:

   # Run VehicleTouch50/PixelStreaming/WebServers/get_ps_servers.bat
   # Run VehicleTouch50/PixelStreaming\WebServers\SignallingWebServer\platform_scripts\cmd\setup.bat
   # Run Start_WithTURN_SignallingServer.ps1

4. Launch and test the application:

   • Run VehicleTouch50_Launch
   • Test the connection at http://127.0.0.1

5. Set up Python environment:

   # Create virtual environment
   python -m venv venv
   
   # Activate virtual environment
   # On Windows:
   venv\Scripts\activate
   # On Unix/MacOS:
   source venv/bin/activate

6. Install dependencies:

   pip install -r requirements.txt

Running Tests

Before running tests, make sure to:

1. Start Pixel Streaming servers manually(Start_WithTURN_SignallingServer.ps1 has to be lauched (Setup article 3)):
   • Run VehicleTouch50/PixelStreaming/WebServers/get_ps_servers.bat
   • Run VehicleTouch50/PixelStreaming\WebServers\SignallingWebServer\platform_scripts\cmd\setup.bat
   • Run Start_WithTURN_SignallingServer.ps1
2. Launch the UE5 project manually (VehicleTouch50_Launch has to be lauched (Setup article 4))

Once the UE5 project and Pixel Streaming servers are running, you can execute the tests:

To run all tests:

pytest

To run with detailed output:

pytest -v

To run with HTML report:

pytest --html=report.html

Project Structure

• conftest.py - Contains pytest fixtures and configuration
• pages/ - Contains page object classes
• tests/ - Contains test files
• baselines/ - Contains baseline screenshots for visual comparison

Test Scenarios

The main test scenario covers:

1. Page load and button availability check
2. Play button functionality
3. Fullscreen toggle
4. Settings panel
5. Stats panel
6. Disconnection test
7. Reconnection attempt test

Notes

• The first time you run the tests, baseline screenshots will be created automatically, next tests run will be with comparison of screenshots and baselines
• IMPORTANT: Pixel Streaming and UE5 project must be launched manually before running tests, as automated launch is currently disabled due to reliability issues
• Some tests include small delays to account for UI state changes