> For the complete documentation index, see [llms.txt](https://docs.splexit.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.splexit.de/system/system-architektur.md).

# System Architektur

**Splexit besteht aus wenigen Komponenten, die zusammenspielen: der Companion App als zentralem Werkzeug, dem Viewer auf den XR-Headsets und einem lokalen WLAN-Netzwerk, das alle Geräte verbindet.**

<figure><img src="/files/uzYar9repFr9s9PhV5xx" alt=""><figcaption></figcaption></figure>

### Companion App

Die Companion App ist das Herzstück von Splexit. Sie läuft auf Tablets und Smartphones (iOS und Android) und vereint alle wesentlichen Funktionen in einer Anwendung. Du findest sie in den App Stores zum freien Download oder als Apk direkt hier:\
<https://splexit.de/downloads.html>&#x20;

#### Unterstützte Geräte

<table><thead><tr><th width="158">OS</th><th>Geräte</th><th>Version</th></tr></thead><tbody><tr><td><strong>iOS</strong></td><td>iPhone, iPad (ARKit fähig)</td><td>iOS ab Version 13</td></tr><tr><td><strong>Android</strong></td><td>Smartphone, Tablet (ARCore fähig)</td><td>Android ab Version 10</td></tr></tbody></table>

Der Viewer basiert auf Unity mit OpenXR und AR Foundation 6— das bedeutet plattformübergreifende Kompatibilität ohne Vendor Lock-in. Die Anwendung ist Open Source. Du kannst deine eigenen interaktiven Welten erstellen und das Splexit Core SdK integrieren.&#x20;

#### Inhalte erstellen und verwalten

Das **Content Management System** (CMS) und der Projekt-Editor sind direkt in die Companion App integriert. Du erstellst Projekte, baust Splexes, organisierst sie, fügst Media-Slides hinzu und verwaltest deine Medienbibliothek — alles in der App.

{% hint style="info" %}
**Auch im Browser verfügbar**\
Das CMS und der Editor sind zusätzlich über [app.splexit.de](https://app.splexit.de) im Browser erreichbar. Das ist praktisch, wenn du am Desktop-Rechner mit großem Bildschirm arbeiten möchtest. Die App bleibt aber der primäre Einstiegspunkt.
{% endhint %}

#### Präsentation steuern

Du navigierst durch dein Projekt, wählst Splexes aus, blendest Media-Slides ein und aus und steuerst den Ablauf der Präsentation — alles von deinem Tablet oder Smartphone aus. Die App zeigt dir in Echtzeit, welche Endgeräte verbunden sind und ob alle Inhalte heruntergeladen sind. Sie ist dein Navaigator

#### Inhalte herunterladen

Bevor eine Präsentation starten kann, lädt die Companion App die Projektdaten auf sich selbst und auf alle verbundenen Endgeräte herunter. Danach funktioniert alles offline im lokalen WLAN.

#### Host-Server

Technisch fungiert die Companion App als lokaler Server. Sie hostet die Multi-User-Session und steuert bis zu 50 Endgeräte gleichzeitig — ohne Internetverbindung. Es reicht bereits ein mobiler Router oder Hotspot, den du mit einem weiteren Smartphone eröffnest, um bis zu 10 Geräte zu steuern.

#### Integrierter Viewer

Die Companion App enthält auch einen Viewer für Tablets und Smartphones. Damit können Teilnehmende die Inhalte direkt auf ihrem mobilen Gerät in AR sehen — ohne ein XR-Headset zu benötigen. Sie können die App frei asu dem Appstore laden und auch ohne Account teilnehmen.

#### Als Gast beitreten

Teilnehmende brauchen keinen eigenen Splexit-Account. Über die Funktion **„Beitreten als Gast"** in der Companion App können sie sich direkt mit der laufenden Präsentation verbinden und die Inhalte auf ihrem Tablet oder Smartphone miterleben.

### Viewer (XR-Headsets)

Der Viewer ist die Anwendung auf den XR-Brillen. Er empfängt die Inhalte und Steuerdaten von der Companion App und stellt sie räumlich dar — als Mixed Reality im echten Raum oder als 3D/360°-VR-Umgebung.

#### Unterstützte Geräte

<table><thead><tr><th width="99">Hersteller</th><th>Geräte</th><th>Status</th></tr></thead><tbody><tr><td><strong>Meta</strong></td><td>Quest 3, Quest 2, Quest Pro</td><td>Vollständig unterstützt</td></tr><tr><td><strong>Pico</strong></td><td>Pico 4 E, Pico 4 Ultra Enterprise</td><td>Vollständig unterstützt</td></tr><tr><td><strong>Pico</strong></td><td>Pico Neo3,  G3</td><td>Unterstützt (nicht alle Features verfügbar)</td></tr><tr><td><strong>HTC</strong></td><td>Vive Focus 3, Vive XR Elite</td><td>In Beareitung</td></tr><tr><td><strong>Samsung</strong></td><td>Galaxy XR (Android XR)</td><td>In Aussicht</td></tr><tr><td><strong>Apple</strong></td><td>Vision Pro</td><td>In Entwicklung</td></tr></tbody></table>

Der Viewer basiert auf Unity mit OpenXR — das bedeutet plattformübergreifende Kompatibilität ohne Vendor Lock-in. Die Anwendung ist Open Source. Du kannst deine eigenen interaktiven Welten erstellen und das Splexit Core SdK integrieren. So machst du deine VR Welt Multi-User kompatibel und von außen steuerbar.&#x20;

### Netzwerk

Alle Geräte müssen sich im selben WLAN-Netzwerk befinden. Die Companion App fungiert als Host-Server und kommuniziert direkt mit den Viewern. Die automatische Verbindung der Geräte wird durch eine Broadcast Discovery Funktion erzeugt.

#### Firewall/Router-Konfiguration:

* **Eingehend (Server):** UDP 7777
* **Ausgehend (Client):** UDP 7777
* **(LAN Discovery):** UDP 4777&#x20;

#### Typische Setups

**Im Klassenzimmer.** Schul-WLAN nutzen, wenn Ports freigegeben und erlaubt sind. Alle Geräte verbinden sich mit dem bestehenden Netzwerk. Eine Internetverbindung wird nur einmalig zum Herunterladen der Projektdaten benötigt. Andernfalls alle Geräte mit einem zusätzlichen Router verbinden und diesen gesondert mit dem Internet WLAN Access Point verbinden.

**Mobil / Outdoor / ohne Schul-WLAN.** Einen mobilen WLAN-Router (Taschenrouter) oder ein weiteres Smartphone mit Tethering Funktion mitbringen. Die Companion App und die Viewer mit diesem Router / Phone verbinden. Internet ist nicht nötig, solange die Inhalte vorher heruntergeladen wurden.

{% hint style="warning" %}
**Vor der Präsentation herunterladen**\
Lade alle Projektdaten auf die Endgeräte, solange eine Internetverbindung besteht. Danach funktioniert die Präsentation vollständig offline — auch im Museum, auf dem Schulhof oder im Wald.<br>
{% endhint %}

#### Netzwerk-Anforderungen

* Alle Geräte im selben WLAN (2,4 GHz oder 5 GHz)
* Kein Internet nötig während der Präsentation, nur während der Editierung
* Der Router muss keine besondere Konfiguration haben — ein einfacher Hotspot reicht- keine Firewall
* Für größere Gruppen (> 7-10 Geräte) empfiehlt sich ein dedizierter WLAN-Router statt eines Smartphone-Hotspots

### Zusammenspiel der Komponenten

Der typische Ablauf sieht so aus:

1. **Vorbereiten** — In der Companion App (oder im Browser) erstellst du dein Projekt mit Splexes und Media-Slides.
2. **Herunterladen** — Über die Companion App lädst du das Projekt auf alle Geräte herunter (Internet nötig und alle Geräte eingeschaltet, App geöffnet und verbunden).
3. **Verbinden** — Alle Geräte kommen ins selbe WLAN. Die Companion App erkennt die Viewer automatisch.
4. **Präsentieren** — Du steuerst die Präsentation über die Companion App. Die Viewer zeigen die Inhalte synchron an.

### Weiterführende Informationen

Detaillierte technische Informationen zu Tech Stack, unterstützten Standards (OpenXR, glTF, WebXR), Integrationen und Self-Hosting findest du unter [splexit.de/technologie](https://splexit.de/technologie).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.splexit.de/system/system-architektur.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
