# QR-Code

Den QR-Code setzen Sie ein, wenn das Display etwas an das Telefon in der Hand weitergeben soll — eine Web-Adresse, den Zugang zum Gäste-Netz, eine Kontaktkarte oder einen kurzen Text.

> **Typ:** app
> **Für wen:** alle, die Szenen gestalten und Betrachtern einen Scan anbieten wollen.
> **Voraussetzung:** Die App ist installiert (installieren darf der Inhaber), und Sie dürfen Szenen bearbeiten. Die Marke im Store lautet **In jedem Paket**.
> **Ort im Portal:** **Apps** › **Apps entdecken** › **QR-Code**; nach der Installation im Szenen-Editor in der Palette unter **Text & Gestaltung**.

## Was die App zeigt

Die App bringt ein Widget mit. Der Code entsteht auf dem Gerät, aus den Einstellungen des Widgets: kein fremder Bilddienst, kein Aufruf nach außen, und keine Adresse, die dabei einen Dritten passiert. Das Widget ruft nichts ab und speichert keine eigenen Daten.

Vier Arten stehen zur Wahl, und mit der Art wechseln die sichtbaren Felder:

- **Web-Adresse** — die Adresse, auf die der Scan führt. Fehlt `https://`, wird es ergänzt.
- **WLAN** — Netzname, Schlüssel und Verschlüsselung. Wer scannt, verbindet sich, ohne den Schlüssel abzutippen.
- **Kontakt** — Name, Telefon, E-Mail und Firma als Kontaktkarte fürs Adressbuch.
- **Text** — ein kurzer Text, der beim Scannen einfach angezeigt wird.

Unter dem Code steht auf Wunsch eine **Beschriftung**, die in wenigen Worten sagt, was der Scan bringt. Der Code sitzt immer mittig im größten Quadrat, das die Fläche hergibt; die Beschriftung skaliert mit seiner Kantenlänge. Beim Einfügen bietet der Editor die Platzierungen **Zentriert**, **Vollbild** und **Kachel** an. Die Ansichten im Store tragen die Namen der Arten, **Web-Adresse** und **WLAN**.

Zwei Beispiele: Ein Restaurant zeigt neben der Tageskarte einen Code auf die Speisekarte im Netz, beschriftet mit **Speisekarte**. Ein Verein stellt im Eingang einen Code für das Gäste-Netz auf, damit niemand den Schlüssel am Tresen erfragen muss.

## Einstellungen

Die Einstellungen finden Sie im Reiter **Inhalt** des Eigenschaften-Panels, sobald das Widget ausgewählt ist. Sichtbar sind immer nur die Felder der gewählten **Art**; die Werte der anderen Arten bleiben erhalten, wenn Sie hin- und herschalten.

![Das Einstellungs-Fenster eines QR-Codes im Szenen-Editor, Art WLAN: der Umschalter Art mit seinen vier Werten (1), das Feld WLAN-Name (SSID) (2), der Netzwerk-Schlüssel (3) und im Abschnitt Darstellung der Rand samt Fehlerkorrektur (4)](/docs/apps/bilder/74bffe56-qr-code-art-waehlen.png)

| Einstellung | Bedeutung | Standard |
|---|---|---|
| **Art** | **Web-Adresse**, **WLAN**, **Kontakt** oder **Text**. Bestimmt Inhalt und sichtbare Felder. | Web-Adresse |
| **Web-Adresse** | Nur bei **Web-Adresse**, Pflichtangabe: die vollständige Adresse, höchstens 500 Zeichen. | leer |
| **WLAN-Name (SSID)** | Nur bei **WLAN**, Pflichtangabe: exakt wie im Netz geschrieben, Groß- und Kleinschreibung zählt, höchstens 64 Zeichen. | leer |
| **Netzwerk-Schlüssel** | Nur bei **WLAN**: der Schlüssel, höchstens 64 Zeichen. Bei offenen Netzen leer lassen. | leer |
| **Verschlüsselung** | Nur bei **WLAN**: **WPA/WPA2**, **WEP** oder **Offen**. | WPA/WPA2 |
| **Name** | Nur bei **Kontakt**: der angezeigte Name, höchstens 80 Zeichen. Mindestens eine Kontaktangabe ist nötig. | leer |
| **Telefon** | Nur bei **Kontakt**: eine Telefonnummer, höchstens 80 Zeichen. | leer |
| **E-Mail** | Nur bei **Kontakt**: eine Adresse, höchstens 80 Zeichen. | leer |
| **Firma** | Nur bei **Kontakt**: der Name der Firma oder Einrichtung, höchstens 80 Zeichen. | leer |
| **Text** | Nur bei **Text**, Pflichtangabe: höchstens 500 Zeichen, unverändert kodiert. | leer |
| **Beschriftung** | Zeile unter dem Code, höchstens 80 Zeichen. Leer lassen blendet sie aus. | leer |
| **Codefarbe** | Farbe der Module. Je stärker der Kontrast zur Codefläche, desto zuverlässiger scannt der Code. | Dunkles Blaugrau (`#0f172a`) |
| **Codefläche** | Farbe hinter den Modulen und im Rand. | Weiß (`#ffffff`) |
| **Rand** | **Kein**, **Schmal** oder **Breit**. Der Rand ist die Ruhezone des Codes. | Breit |
| **Fehlerkorrektur** | **Mittel**, **Hoch** oder **Sehr hoch**. Höhere Stufen verzeihen mehr, machen die Module aber kleiner. | Mittel |

## Grenzen

- *Bei der Art Web-Adresse nur Ziele im Web.* Kodiert werden dort ausschließlich Ziele mit `http` oder `https`, alles andere ergibt keinen Code. Was hinter einem Ziel steckt, sieht vor dem Scannen niemand. **WLAN**, **Kontakt** und **Text** kodiert die App in ihrem eigenen Format.
- *Ohne Pflichtangabe kein Code.* Fehlt die Angabe der gewählten Art, zeigt das Widget eine gestrichelte Kachel mit dem Hinweis **Adresse hinterlegen**, **WLAN-Name hinterlegen**, **Kontaktdaten hinterlegen** oder **Text hinterlegen** — im Editor eine Aufforderung, auf der Fläche der sichtbare Hinweis, dass etwas unfertig ist.
- *Der Rand ist die Ruhezone.* Steht **Rand** auf **Kein**, reicht der Code bis an die Kante des Widgets; dann muss die Fläche ringsum selbst hell und ruhig sein, sonst scannt er nicht.
- *Kontrast wird nicht erzwungen.* Ein heller Code auf hellem Grund lässt sich nicht scannen, ein umgekehrter Code dagegen meistens schon. Die Farbwahl bleibt Ihnen überlassen, das Ergebnis auch.
- *Lange Inhalte platzen.* Passt die Angabe nicht mehr in einen Code, bleibt die Fläche leer statt einen halben Code zu zeigen. Lange Adressen kürzen.
- *Takt:* Der Code ist ein Standbild und ändert sich nie von selbst. Er zeigt, was in der veröffentlichten Szene steht; eine Änderung erreicht das Display mit der nächsten Veröffentlichung.
- *Offline:* Die App braucht keine Verbindung nach außen. Ob das Ziel des Scans erreichbar ist, prüft sie nicht.

## Typische Fehler

| Symptom | Bedeutung | Lösung |
|---|---|---|
| Statt des Codes steht **Adresse hinterlegen** auf der Fläche. | Das Feld **Web-Adresse** ist leer, oder das Ziel ist keine Web-Adresse. | Eine vollständige Adresse mit `https://` eintragen. |
| Statt des Codes steht **WLAN-Name hinterlegen** auf der Fläche. | Das Feld **WLAN-Name (SSID)** ist leer. | Den Netznamen eintragen, genau so wie er im Netz geschrieben steht. |
| Der Code lässt sich nicht scannen. | Zu wenig Kontrast zwischen **Codefarbe** und **Codefläche**, oder die Ruhezone fehlt. | Dunkle Module auf heller Fläche wählen und **Rand** auf **Schmal** oder **Breit** stellen. |
| Der Code scannt aus der Nähe, aus fünf Metern nicht. | Die Module sind zu klein für die Entfernung. | Dem Widget mehr Fläche geben und **Fehlerkorrektur** auf **Mittel** belassen — höhere Stufen verkleinern die Module. |
| Bei Spiegelungen scannt der Code unzuverlässig. | Die Fehlerkorrektur verzeiht zu wenig Verdeckung. | **Fehlerkorrektur** auf **Hoch** oder **Sehr hoch** stellen und dem Code zugleich mehr Fläche geben. |
| Das Telefon verbindet sich nicht mit dem Netz. | Netzname, Schlüssel oder **Verschlüsselung** stimmen nicht; im Netznamen zählt Groß- und Kleinschreibung. | Angaben abgleichen; bei einem offenen Netz **Offen** wählen und den Schlüssel leer lassen. |
| Die Fläche bleibt ganz leer. | Der Inhalt passt in keinen Code mehr. | Adresse oder Text deutlich kürzen. |
| Im Adressbuch steht der Nachname falsch. | Der Nachname wird aus dem letzten Wort des Feldes **Name** abgeleitet. | Den Namen als Vorname und Nachname schreiben, ohne Titel am Ende. |
| Die Felder der anderen Art sind verschwunden. | Sichtbar sind immer nur die Felder der gewählten **Art**. | Nichts zu tun — beim Zurückschalten sind die Werte wieder da. |
| Das Widget lässt sich nicht einsetzen. | Die App ist nicht installiert, ein Update wartet auf Ihre Entscheidung, oder sie steht auf **Nicht in Ihrem Paket**. | Unter **Apps** den Status prüfen ([Wenn eine App nicht läuft](/docs/apps/wenn-eine-app-nicht-laeuft)). |

## Weiterführendes

- [Widgets konfigurieren](/docs/inhalte/widgets-konfigurieren) — der Reiter **Inhalt** und die Vorschau im Editor.
- [Aushang](/docs/apps/notice-board) — der geschriebene Text, der neben dem Code steht.
- [Widgets auf der Bühne platzieren und anordnen](/docs/inhalte/widgets-platzieren) — wie viel Fläche ein Code bekommt.