# 360° / Foto Hotspot-Editor

<span style="white-space: pre-wrap;">Mit dem </span>**Hotspot-Editor**<span style="white-space: pre-wrap;"> platzierst du klickbare Punkte direkt in einem </span>**360°-Panorama**<span style="white-space: pre-wrap;"> oder </span>**normalen Foto**. Hotspots können Szenen öffnen, Infos zeigen oder eigenes JS ausführen.

---

[![grafik.png](https://docs.scenario.app/uploads/images/gallery/2025-09/scaled-1680-/JLcgrafik.png)](https://docs.scenario.app/uploads/images/gallery/2025-09/JLcgrafik.png)

## Bild &amp; View

- **Bild-URL / Bild wählen**  
    Wähle ein 360°-Bild (equirectangular) oder ein normales Foto. Upload über die Medienauswahl ist möglich.
- **HFOV**  
    <span style="white-space: pre-wrap;">„Horizontal Field of View“ – Zoomstufe der Startansicht (z. B. </span>**100**).
- **Kompass (Ja/Nein)**  
    Blendet einen Kompass/Heading-Indikator ein.

**Tipp:**<span style="white-space: pre-wrap;"> Das Kreuz </span>**„Hier Hotspot erstellen“**<span style="white-space: pre-wrap;"> setzt einen neuen Hotspot an der angeklickten Stelle.</span>

---

[![grafik.png](https://docs.scenario.app/uploads/images/gallery/2025-09/scaled-1680-/XtXgrafik.png)](https://docs.scenario.app/uploads/images/gallery/2025-09/XtXgrafik.png)

## Hotspot bearbeiten

**Label**  
Beschriftung (z. B. „Weiter“, „Info“).

**Typ**

- **Button**<span style="white-space: pre-wrap;"> – Rechteckiger Button mit Text.</span>
- (Weitere Typen – z. B. Icon/Point – falls in deinem Projekt aktiv – verhalten sich entsprechend.)

**CSS-Klasse**  
<span style="white-space: pre-wrap;">Optionale Klasse zur Feinstilierung (z. B. </span>`<span class="editor-theme-code">hs-primary</span>`, eigenes Theme).

**Yaw / Pitch**  
Exakte Ausrichtung des Hotspots (horizontale/vertikale Winkel). Diese Werte werden beim Platzieren automatisch gesetzt und können feinjustiert werden.

**Zielszene (optional)**  
<span style="white-space: pre-wrap;">Szene, die beim Klick geöffnet wird. Leer lassen = </span>**keine Navigation**<span style="white-space: pre-wrap;"> (nur Popup/JS).</span>

**Farben &amp; Stil**

- **Text/Icon-Farbe**
- **Hintergrund**<span style="white-space: pre-wrap;"> (z. B. </span>`<span class="editor-theme-code">rgba(0,0,0,.5)</span>`<span style="white-space: pre-wrap;"> für halbtransparent)</span>
- **Border-Farbe**
- **Schriftgröße**<span style="white-space: pre-wrap;">, </span>**Radius**<span style="white-space: pre-wrap;">, </span>**Padding**

**Popup verwenden**  
<span style="white-space: pre-wrap;">Zeigt beim Klick ein kleines Popup (Titel/Label). In der Vorschau mit </span>**Shift-Klick**<span style="white-space: pre-wrap;"> testen.</span>

**onClick JS (optional)**  
Eigener JavaScript-Code, der beim Klick ausgeführt wird  
<span style="white-space: pre-wrap;">(z. B. </span>`<span class="editor-theme-code">console.log('clicked')</span>`, Tracking, komplexe Logik).

> <span style="white-space: pre-wrap;">Für Standard-Navigation </span>**nicht nötig**<span style="white-space: pre-wrap;"> – dafür reicht die Zielszene.</span>

**Editor-Shortcuts**

- **Alt-Klick**: onClick-JS sofort testen (im Editor).
- **Shift-Klick**: Popup-Vorschau öffnen.

---

## Verhalten in der App

- <span style="white-space: pre-wrap;">Hotspots liegen </span>**über**<span style="white-space: pre-wrap;"> dem 360°/Foto und folgen der Perspektive.</span>
- Klick/Tap auf den Hotspot:
    1. <span style="white-space: pre-wrap;">führt </span>**onClick JS**<span style="white-space: pre-wrap;"> aus (falls vorhanden),</span>
    2. <span style="white-space: pre-wrap;">öffnet optional das </span>**Popup**,
    3. <span style="white-space: pre-wrap;">navigiert – wenn gesetzt – in die </span>**Zielszene**.
- Kompass und Start-HFOV werden aus den Einstellungen übernommen.

---

## Praxis-Tipps

- **Assets**<span style="white-space: pre-wrap;">: 360° equirectangular </span>**2:1**<span style="white-space: pre-wrap;"> (z. B. 4096×2048). Normale Fotos gern 1920 px Breite+.</span>
- **Lesbarkeit**: Halbtransparente Hintergründe (`<span class="editor-theme-code">rgba</span>`) und ausreichender Kontrast.
- **Fokus**: Wichtige Hotspots nicht zu nah am Zenith/Nadir (starke Verzerrung).
- **Mobile UX**: Wenige, klare Hotspots; Abstand zwischen Hotspots für Touch-Ziele.
- **Navigation**<span style="white-space: pre-wrap;">: Für „Weiter“-Ketten reicht </span>**Zielszene**<span style="white-space: pre-wrap;"> – JS nur bei Sonderfällen.</span>
- **Testing**: HFOV &amp; Startblick einmal am Gerät prüfen; ggf. Yaw/Pitch leicht nachstellen.

---

## Kurz-Workflow

1. **Bild wählen**<span style="white-space: pre-wrap;"> → </span>**HFOV/Kompass**<span style="white-space: pre-wrap;"> setzen.</span>
2. <span style="white-space: pre-wrap;">Im Viewer </span>**„Hier Hotspot erstellen“**<span style="white-space: pre-wrap;"> klicken.</span>
3. **Label**<span style="white-space: pre-wrap;">, </span>**Typ**<span style="white-space: pre-wrap;">, </span>**Zielszene**<span style="white-space: pre-wrap;"> (optional) und </span>**Stil**<span style="white-space: pre-wrap;"> einstellen.</span>
4. <span style="white-space: pre-wrap;">(Optional) </span>**Popup**<span style="white-space: pre-wrap;"> aktivieren oder </span>**onClick JS**<span style="white-space: pre-wrap;"> hinterlegen.</span>
5. **Übernehmen**<span style="white-space: pre-wrap;"> → weitere Hotspots hinzufügen → </span>**Speichern**.