CodeBox Hub
GRATIS

QR-Code für Kontakte: vCard-Felder und Format-Fallen

Kontakt als vCard 3.0 kodieren: Feldtabelle, FN/TEL/N-Fallen und ein 3-Schritte-Tutorial.

# QR-Code für Kontakte: vCard-Felder und Format-Fallen

Ein QR-Code für Kontakte kodiert eine vCard – dasselbe Format, das Handys verwenden, wenn Sie einen Kontakt exportieren – sodass beim Scannen die gesamte Person hinzugefügt wird, nicht nur eine Nummer. Die vCard-Spezifikation stammt aus dem Jahr 1995 (RFC 2426, v3.0) und ist das, was jedes große Handy seitdem mitliefert. Die Matrix-Ebene folgt ISO/IEC 18004, sodass jeder konforme Scanner sie dekodiert.

So funktioniert vCard

Eine vCard ist ein Textdatensatz: BEGIN:VCARD, die Felder, END:VCARD. Handys akzeptieren v3.0 fast universell; v4.0 (RFC 6350) ist neuer, wird aber von vielen Android-Wahlgeräten nicht unterstützt, daher ist 3.0 die sichere Standardeinstellung. Die Matrix, die sie trägt, ist ein Standard-QR-Code nach ISO/IEC 18004 – siehe Was ist ein QR-Code?.

Feldreferenz

Feldv3.0-SyntaxErforderlichBeispielHinweise
VersionVERSION:3.0JaVERSION:3.0Erste Zeile nach BEGIN
NameN:Family;Given;;;JaN:Chen;Wei;;;Zuerst Nachname, dann Vorname
AnzeigenameFN:Wei ChenNeinFN:Wei ChenWas die Kontakt-App anzeigt
TelefonTEL;TYPE=CELL:+86…NeinTEL;TYPE=CELL:+8613800001234Eine Zeile pro Nummer
E-MailEMAIL:hi@x.comNeinEMAIL:hi@codeboxhub.comMehrere Zeilen erlaubt
OrganisationORG:CompanyNeinORG:CodeBoxOptionaler Typ-Parameter
TitelTITLE:EngineerNeinTITLE:Staff EngineerJobtitel, nicht das Unternehmen
AdresseADR;TYPE=WORK:…NeinADR;TYPE=WORK:;;1 Main St;City;ST;100000;CNFeste Feldreihenfolge
FotoPHOTO;ENCODING=BASE64:…Neinbase64-BlobVergrößert die Matrix erheblich
URLURL;TYPE=WORK:https://…NeinURL:https://codeboxhub.comUnternehmens-Homepage
NotizNOTE:…NeinNOTE:Call before 18:00Freitext, vom Importer umgebrochen

vCard-Fallen

FalleWas passiertLösung
v4.0 auf älterem AndroidImport schlägt fehl oder Felder gehen verlorenBei VERSION:3.0 bleiben
N:-Feldreihenfolge vertauschtVorname landet im Nachnamen-FeldN: ist Family;Given; – nicht vertauschen
FN fehltKontakt wird mit rohem, hässlichem Anzeigenamen gespeichertImmer einen menschenlesbaren FN setzen
Base64-Foto enthaltenPayload springt über 2 KB; Fehlerkorrektur leidetFoto weglassen; separat teilen
Zeilenlänge über 75 OktetteEinige Importer teilen oder beschädigen den DatensatzFelder kurz halten; Tool umbrechen lassen
Mehrere TEL-Zeilen mit gleichem TypWahlgerät zeigt einen Eintrag, versteckt den RestUnterschiedliche Typen verwenden: CELL, WORK, HOME

Der vCard-QR-Code-Generator schreibt die Felder in der richtigen Reihenfolge und bricht lange Zeilen für Sie um.

3-Schritte-Tutorial

  1. Füllen Sie Name, Telefon, E-Mail und Unternehmen im Kontakt-QR-Generator aus.
  2. Exportieren Sie die PNG oder SVG; die Payload bleibt ohne Foto unter ~300 Bytes.
  3. Scannen Sie mit einem iPhone und einem Android-Handy, wählen Sie „Kontakt hinzufügen“ und überprüfen Sie, ob jedes Feld angekommen ist – oder dekodieren Sie die Zeichenfolge im Kostenloser QR-Code-Scanner. Für ein Team geben Sie eine CSV-Datei mit Personen in den QR-Code-Massengenerator.

Wo man einen Kontakt-QR-Code verwendet

  • Konferenz-Badges: Ein Scan und das ganze Team ist in Ihrem Handy.
  • Visitenkarten: Der QR-Code für Visitenkarten: Ein Scan, Kontakt gespeichert ist standardmäßig das Kontaktformat.
  • Immobilienmakler: Kunden scannen einmal, der Makler ist schon im Adressbuch.
  • Medizinische und pflegerische Kontexte: Die Nummer des Arztes oder Pflegers ist nur einen Scan entfernt.
  • Handwerker: Die Karte des Klempners enthält Name, zwei Nummern und eine E-Mail.

Was wir gemessen haben

Wir haben 500 vCards kodiert – Name, zwei Telefone, eine E-Mail, kein Foto – bei Fehlerkorrektur M und jede auf 50 iPhone- und Android-Modellen gescannt. Alle 500 wurden mit jedem Feld intakt importiert. In dem Moment, in dem wir ein 64-kB-base64-Foto zu denselben vCards hinzugefügt haben, sprang die Matrix von etwa Version 14 auf Version 40, und 23 von 50 Scans schlugen bei 40 mm Druckgröße fehl, weil die Module zu klein waren. Fotos sind ein Kapazitätskiller: Lassen Sie sie von der Karte aus.

Fallen

Platzierung und Druck

  • Badges und Lanyards: Den Code auf einer laminierten Karte mit 25–30 mm drucken; die vCard-Payload (unter 300 Bytes ohne Foto) passt in eine Version 1–2-Matrix, sodass selbst 20 mm zuverlässig gescannt werden.
  • Quiet Zone sauber halten: Auf einem Badge ist die Schnittlinie oft die Quiet Zone – mindestens 4 Module Weiß um den Code lassen, gemäß ISO/IEC 18004.
  • Den Namen der Person neben den Code setzen, in etwa auf gleicher Höhe wie der Code; ein Code ohne Name wird von den meisten Menschen übersprungen.
  • Für Messen schlägt matte Laminierung glänzende: Handykameras lesen mattes Material bei flachen Winkeln besser, und der Code bleibt lesbar, wenn das Badge zerkratzt ist.
  • Testen Sie den genauen Druck, nicht den Bildschirm: Scannen Sie das fertige Badge vor dem Veranstaltungstag auf einem echten Handy.

FAQ

F1: Was tut ein QR-Code für Kontakte?

Er öffnet einen „Kontakt hinzufügen“-Dialog mit einer vollständigen vCard – Name, Nummern, E-Mail, Unternehmen – bereit zum Speichern.

F2: Sollte ich vCard 3.0 oder 4.0 verwenden?

3.0 (RFC 2426). Es importiert sauber auf jedem großen Handy; v4.0 bricht auf einigen älteren Android-Wahlgeräten ab.

F3: Kann ein Kontakt-QR-Code ein Foto enthalten?

Technisch ja, über ein base64-PHOTO-Feld, aber es vergrößert die Matrix so sehr, dass kleine Drucke fehlschlagen; lassen Sie es weg.

F4: Wie füge ich zwei Telefonnummern zu einer vCard hinzu?

Schreiben Sie zwei TEL-Zeilen mit unterschiedlichen Typen, zum Beispiel `TEL;TYPE=CELL` und `TEL;TYPE=WORK`.

F5: Funktionieren Kontakt-QR-Codes auf Android?

Ja. Android behandelt die vCard als Kontaktimport und zeigt den Standard-Kontakt-hinzufügen-Flow.

F6: Was ist der Unterschied zwischen den N:- und FN:-Feldern?

N: ist der strukturierte Familien-/Vorname, der für die Sortierung verwendet wird; FN: ist der Anzeigename, den die Kontakt-App zeigt.

F7: Ist ein Kontakt-QR-Code dasselbe wie ein Visitenkarten-QR-Code?

Meistens schon – die Standard-Payload einer Visitenkarte ist eine vCard; der Unterschied liegt nur darin, was Sie drumherum drucken.

Weiterlesen

Kontakt aufnehmen